💬 斜杠命令(/)
斜杠命令用于控制 Gemini CLI 本身的行为。
/bug
说明:提交有关 Gemini CLI 的问题报告。默认提交到 GitHub 仓库。你在 /bug 后输入的内容会成为问题标题。行为可通过 .gemini/settings.json 中的 bugCommand 设置进行修改。
/chat
说明:保存和恢复对话历史,用于状态分支或会话恢复。 子命令:
save:保存当前对话历史。需添加<tag>标签。 用法:/chat save <tag>resume:恢复指定标签的历史会话。 用法:/chat resume <tag>list:列出所有可用标签。
/clear
说明:清除终端屏幕和当前可见会话历史。底层历史数据可能仍被保留。
快捷键:按下 Ctrl+L 执行清屏。
/compress
说明:将整个聊天上下文替换为摘要,节省 token,同时保留内容概要。
/editor
说明:打开编辑器选择对话框。
/extensions
说明:列出当前会话中所有激活的扩展。详见“Gemini CLI 扩展”文档。
/help 或 /?
说明:显示 Gemini CLI 的帮助信息,包括所有命令及其用法。
/mcp
说明:列出已配置的 Model Context Protocol (MCP) 服务器及工具。
子命令:
desc/descriptions:显示工具详细描述。nodesc/nodescriptions:隐藏工具描述,仅显示名称。schema:显示每个工具的参数 JSON schema。
快捷键:Ctrl+T 可切换显示/隐藏工具描述。
/memory
说明:管理 AI 的记忆上下文(由 GEMINI.md 文件加载的分层记忆)。
子命令:
add <内容>:添加记忆内容。show:显示当前加载的完整分层记忆内容。refresh:重新从 GEMINI.md 文件中加载所有记忆内容。
/restore
说明:将项目文件恢复到某个工具执行前的状态。用于撤销工具执行所做的更改。
用法:/restore [tool_call_id]
仅在启用 --checkpointing 参数或配置时可用。
/stats
说明:显示当前会话的详细统计信息,包括 token 使用量、节省的 token(如有)和会话时长。 注意:仅 API Key 身份验证时支持缓存 token 统计,OAuth 不支持。
/theme
说明:打开界面主题选择对话框。
/auth
说明:打开身份验证方法选择对话框。
/about
说明:显示版本信息。提交问题时建议提供。
/tools
说明:显示当前可用工具列表。
子命令:
desc/descriptions:显示每个工具的详细信息。nodesc/nodescriptions:仅显示工具名称。
/privacy
说明:显示隐私声明,并允许选择是否同意收集数据用于改进服务。
/quit 或 /exit
说明:退出 Gemini CLI。
📄 @命令(@)
@命令用于将文件或目录的内容注入到你的提示中。它支持 Git 忽略文件过滤。
@<文件或目录路径>
说明:读取并注入指定文件或目录的文本内容,用于向 Gemini 询问或分析文件内容。
示例:
@path/to/file.txt Explain this text.@src/my_project/ Summarize the code in this directory.What is this file about? @README.md
细节说明:
- 可读取单个文件或目录(递归子目录)。
- 路径中有空格请用
\转义(如@My\ Documents/file.txt)。 - 使用
read_many_files工具实现内容读取。 - 默认忽略 Git 忽略的文件(如
node_modules/、.env等),可通过fileFiltering设置修改。 - 适用于文本文件。二进制或超大文件可能被跳过或截断。
- 终端会显示哪些文件被处理、跳过或读取失败。
错误处理
- 若路径不存在或无权限,会显示错误,可能不会注入内容或直接发送原始查询。
🖥️ Shell模式与!命令
!命令允许直接从Gemini CLI运行系统shell命令。
!<shell 命令>
说明:执行系统 shell 命令,并在终端显示输出或错误。
示例:
!ls -la:列出当前目录。!git status:查看 Git 状态。
!(单独使用)
说明:切换进入/退出 Shell 模式。
进入后:
- 使用不同颜色显示提示。
- 所有输入都被解释为shell 命令。
退出后:
- 恢复正常Gemini CLI输入状态。
注意:Shell模式下执行的命令拥有与在终端中执行相同的权限,请谨慎操作。