gemini使用指南

基础功能 (Basics)

启动

set https_proxy=http://127.0.0.1:7897 && gemini

• 添加上下文：使用 @ 指定文件或文件夹作为上下文（例如：@src/myFile.ts），以便 Gemini 聚焦于特定文件或文件夹来提供帮助。
• Shell 模式：使用 ! 执行 shell 命令（例如：!npm run start），或直接使用自然语言（例如：start server）让 Gemini 帮你执行相应操作。

---

命令 (Commands)

• /about - 显示版本信息

• /auth - 更改认证方式

• /bug - 提交一个 Bug 报告

• /chat - 管理对话历史

  • list - 列出已保存的对话检查点
  • save <tag> - 将当前对话保存为一个检查点，并加上标签 <tag>
  • resume <tag> - 从指定标签 <tag> 的检查点恢复对话
  • delete <tag> - 删除指定标签 <tag> 的对话检查点

• /clear - 清除屏幕和对话历史

• /compress - 通过生成摘要来压缩上下文

• /copy - 复制最后的结果或代码片段到剪贴板

• /corgi - 切换 corgi 模式

• /docs - 在浏览器中打开完整的 Gemini CLI 文档

• /directory - 管理工作区目录

  • add - 添加目录到工作区，多个路径用逗号分隔
  • show - 显示工作区中的所有目录

• /editor - 设置外部编辑器偏好

• /extensions - 列出当前激活的扩展

• /help - 获取 gemini-cli 的帮助信息

• /init - 分析项目并创建一个定制化的 GEMINI.md 文件

• /mcp - 列出配置的 MCP 服务器和工具，或用 OAuth 认证

  • list - 列出已配置的 MCP 服务器和工具
  • auth - 使用 OAuth 认证 MCP 服务器
  • refresh - 刷新 MCP 服务器和工具列表

• /memory - 与记忆功能交互

  • show - 显示当前记忆中的内容
  • add - 向记忆中添加内容
  • refresh - 从源头刷新记忆

• /privacy - 显示隐私声明

• /quit - 退出 CLI

• /stats - 查看会话统计信息，可选择 model 或 tools

  • model - 显示模型使用统计
  • tools - 显示工具使用统计

• /theme - 更改主题

• /tools - 列出所有可用的 Gemini CLI 工具

• /vim - 切换 Vim 模式开/关

• ! - Shell 命令的简写

---

键盘快捷键 (Keyboard Shortcuts)

• Alt+Left/Right - 在输入框中按单词跳转
• Ctrl+C - 退出应用
• Ctrl+Enter - 换行
• Ctrl+L - 清屏
• Ctrl+X - 在外部编辑器中打开输入内容
• Ctrl+Y - 切换 YOLO 模式
• Enter - 发送消息
• Esc - 取消当前操作
• Shift+Tab - 切换自动接受编辑
• Up/Down - 循环切换你的历史输入记录
• 更多快捷键请参阅 docs/keyboard-shortcuts.md。

YOLO 模式（"You Only Live Once" 的缩写，意为“你只活一次”）是 Gemini CLI 中的一个特殊模式，它让 AI 在执行任务时拥有更大的自主权，而无需在每个步骤都向你请求确认。

简单来说，当你在 Gemini CLI 中执行一些可能涉及敏感操作（如执行 shell 命令、写入文件等）的任务时，通常会有一个提示，询问你是否允许 AI 执行该操作。YOLO 模式的作用就是自动批准这些请求。

它的主要特点和用途是：

• 自动化和效率：对于那些你信任环境、且任务重复或定义清晰的工作，YOLO 模式可以大大提高效率。例如，修复代码中的 lint 错误、自动化项目设置或生成代码片段等，可以省去频繁确认的步骤。
• 无中断执行：在 YOLO 模式下，Gemini CLI 会像一个自主的代理一样，无缝地执行一系列操作，不会因等待你的批准而中断。
• 方便测试和实验：对于快速实验或非关键性的项目，这个模式非常方便，可以让你专注于结果，而不是过程中的每一步。

需要注意的重要事项：

• 安全风险：由于 YOLO 模式会跳过安全检查和确认步骤，它赋予了 AI 直接操作你的文件系统和终端的权限。因此，强烈建议只在安全、受控的环境中，并且你完全信任正在执行的任务时使用此模式。
• 控制权：如果你希望在执行过程中保持完全的控制，并对每一步操作都进行审查，那么不建议启用 YOLO 模式。

你可以通过在启动 Gemini CLI 时使用参数（例如 -y 或 --yolo），或者通过特定的命令（如 Ctrl+Y）来启用或切换 YOLO 模式。

可用的 Gemini CLI 工具

Edit - 编辑文件。

解释：这个工具允许 Gemini 直接在你的项目中修改文件内容。比如，你可以让它帮你修复代码中的一个 Bug，或者添加新的代码块。

FindFiles - 查找文件。

解释：这个工具让 Gemini 能够在你的项目目录中搜索特定文件。你可以让它根据文件名或路径查找文件，这在项目结构复杂时非常有用。

GoogleSearch - 谷歌搜索。

解释：这个工具赋予了 Gemini 访问互联网的能力，可以进行谷歌搜索。当它需要外部信息来回答你的问题或解决你的任务时，会使用这个工具。

ReadFile - 读取文件。

解释：这是让 Gemini 理解项目内容的核心工具之一。它可以读取特定文件的内容，并将其作为上下文来帮助你编程或回答问题。

ReadFolder - 读取文件夹。

解释：与 ReadFile 类似，这个工具可以读取一个文件夹的内容，了解其结构和包含的文件列表。

ReadManyFiles - 读取多个文件。

解释：这个工具是 ReadFile 的增强版，可以一次性读取多个文件的内容，这对于需要跨文件分析或重构的任务特别有用。

Save Memory - 保存记忆。

解释：这个工具可以让 Gemini 保存重要的信息或对话内容，以便在未来的会话中作为长期记忆来使用。

SearchText - 搜索文本。

解释：这个工具允许 Gemini 在指定的文件或文件夹中搜索特定的文本内容。比如，你可以让它在整个项目中查找某个函数的所有调用。

Shell - 执行 Shell 命令。

解释：这是 Gemini 最强大的工具之一，它可以执行系统命令。比如，你可以让它运行测试、安装依赖或启动服务器。这也是为什么使用 YOLO 模式 时需要特别小心，因为这个工具可以进行强大的操作。

WebFetch - 网页抓取。

解释：这个工具可以抓取网页内容。当 Gemini 需要访问某个网页来获取信息时，会使用这个工具。

WriteFile - 写入文件。

解释：这个工具允许 Gemini 将内容写入文件。你可以让它帮你创建新文件、更新文档或生成代码。