交互命令参考
按任务查找会话、上下文、权限、扩展、界面和诊断用的 slash commands。
以下命令输入在 Gemini CLI 的交互输入框中。它们与操作系统终端里的 gemini ... 参数不同;当前版本的 /help 和自动补全是确认可用入口的直接方式。
会话与上下文
| 命令 | 用途与边界 |
|---|---|
/resume、/chat | 打开自动保存会话浏览器,两者共用入口 |
/resume list | 列出手动保存的聊天标签;不同于浏览器中的自动会话列表 |
/resume save <tag> | 保存带标签的当前聊天检查点 |
/resume resume <tag> | 恢复带标签的聊天,load 为该子命令别名 |
/resume delete <tag> | 删除手动聊天检查点 |
/resume share [filename] | 导出当前聊天为 Markdown 或 JSON;省略文件名时自动生成 |
/resume debug | 导出最近一次 API 请求 JSON,官方标记为 nightly 功能 |
/clear | 清除活动对话上下文并开始新会话,也清理界面显示 |
/compress | 将聊天上下文替换成摘要,以减少后续使用的 token |
/init | 分析当前目录并生成项目 GEMINI.md |
/memory list | 显示已加载记忆文件的路径 |
/memory show | 显示已加载的合并记忆内容 |
/memory refresh | 命令参考中的记忆重载入口;部分配置页写为 reload,以当前版本为准 |
/directory add <path1>,<path2> | 加入工作区目录;限制较强的沙箱中需改为启动参数 |
/directory show | 显示附加工作区目录;/dir 为命令别名 |
Ctrl+L 只清理终端显示,保留活动上下文;它与 /clear 不同。/compress 是摘要化,也不等于保存可恢复的完整归档。手动聊天标签按项目隔离;文件恢复机制另见检查点与会话管理。
模型、计划与恢复
| 命令 | 用途与边界 |
|---|---|
/gemma | 查看实验性本地 Gemma 路由状态,配置见本地路由安装 |
/model manage | 打开模型配置对话框 |
/model set <model-name> [--persist] | 选择模型,可请求持久化 |
/plan | 切换计划模式并查看已有计划 |
/plan copy | 复制当前已批准计划 |
/permissions trust [<directory-path>] | 管理目录信任 |
/policies list | 按模式列出活动策略 |
/restore [tool_call_id] | 恢复工具前的文件检查点;省略 ID 列出候选,需启用 checkpointing |
/rewind | 选择回退对话、AI 文件修改或两者 |
计划模式具有具体工具例外和审批流程,不应仅凭命令说明中的 read-only 推断任何文件都绝不变化。恢复也不代表能够撤销任意 Shell 或外部系统操作。
工具和扩展
| 命令组 | 主要入口 |
|---|---|
/tools | desc / descriptions 显示完整说明;nodesc / nodescriptions 仅名称 |
/commands | list 查看自定义命令,reload 重载定义 |
/mcp | list / ls、desc、schema、enable、disable、reload、auth |
/skills | list、enable <name>、disable <name>、reload |
/agents | list、reload(refresh 别名)、enable <agent-name>、disable <agent-name> |
/hooks | list(show、panel 别名)、enable、disable、enable-all、disable-all |
/extensions | config、disable、enable、explore、install、link、list、restart、uninstall、update |
/ide | install、enable、disable、status |
/mcp auth <server-name> 启动指定服务 OAuth;不带名称时列出支持 OAuth 的服务。/mcp reload 重启服务器并重新发现工具;服务连接状态不等于模型已使用该工具。
命令参考列出的 /extensions restart 重启所有扩展,update 接受名称或 --all。扩展专页仍保留“管理操作需重启 CLI”的说明;可用交互子命令与重载效果应按当前版本核对,详情见扩展管理。不要假定终端管理参数可原样用于同名交互入口。
界面、统计和诊断
| 命令 | 用途 |
|---|---|
/about | 显示版本信息,便于报告问题 |
/help、/? | 查看命令帮助 |
/docs | 在浏览器中打开文档 |
/bug | 报告问题入口,可通过 advanced.bugCommand 定制 |
/auth | 打开认证设置 |
/settings | 打开设置编辑器;部分设置需重启 |
/editor | 选择支持的外部编辑器 |
/theme | 选择主题 |
/vim | 切换 Vi 输入模式并保存偏好 |
/terminal-setup | 为 VS Code、Cursor、Windsurf 配置多行输入键位 |
/copy | 将最近一次输出复制到剪贴板 |
/shells、/bashes | 查看后台 Shell |
/stats session | 查看会话时长、工具调用和性能,也是 stats 默认视图 |
/stats model | 查看模型 token 与配额信息 |
/stats tools | 查看工具统计 |
/privacy | 显示隐私声明和服务改进的数据收集同意选项 |
/upgrade | 打开 Code Assist 升级页面,仅 Google 登录可用 |
/setup-github | 进入 GitHub Actions 集成设置,提供 issue 分流和 PR 审阅工作流 |
/quit、/exit | 退出 CLI |
本地复制依赖系统剪贴板工具,Linux 需要 xclip 或 xsel,macOS 使用 pbcopy,Windows 使用 clip;SSH/WSL 远程复制依赖终端支持 OSC 52。
/quit --delete 或 /exit --delete 会永久删除当前会话历史和临时文件,包括聊天记录与工具输出。其范围是当前会话数据,不能据此推断项目文件、外部服务记录或另行保存的导出也被删除。