Gemini 中文文档使用 Antigravity CLI (Using AGY CLI)
设置 (Settings)
Antigravity CLI 提供了一个灵活的配置系统，用以自定义工作空间行为、安全限制、编辑器偏好、视觉风格和性能表现。
- 配置文件：存储在纯 JSON 文件
~/.gemini/antigravity-cli/settings.json中。 - 设置面板：输入
/config或/settings打开全屏覆盖菜单，其中列出了所有可用选项。- 选择某项设置以打开其选项列表或文本输入框。
- 修改后将立即保存到磁盘，并返回到主列表。
- 命令行覆盖 (Overrides)：某些设置可以在启动时通过 CLI 参数进行覆盖（例如
--sandbox或--dangerously-skip-permissions）。- 设置菜单中会显示一个指示器，标明覆盖参数的来源（例如：
Sandbox Mode on overridden by --sandbox）。 - 您仍然可以修改磁盘上的持久化设置，但当前会话将强制执行命令行覆盖，直到重启。
- 设置菜单中会显示一个指示器，标明覆盖参数的来源（例如：
快捷技巧 (Quick Tips)
| 操作/功能 (Action/Feature) | 技巧/命令 (Tip/Command) |
|---|---|
| 自动补全文件路径 | 输入 @ 触发路径建议建议 |
| 清空 Prompt | 输入 esc esc 清空您的 Prompt 输入框（在没有活跃的流式输出时） |
| 执行终端命令 | 在 Prompt 最开头使用 ! 以直接运行终端命令 |
| 帮助 | 输入 ? 获取帮助并列出所有斜杠命令 |
| 减少工具调用产生的噪音 | 在 /config 中将详细程度 (verbosity) 设置为 low，以尽量减少来自大量工具调用的输出 |
| 管理权限 | 通过 /config 或 /permissions 控制权限 |
| 回退对话历史 | 使用 /rewind 或 /undo 回退对话历史记录 |
| 分支对话 (Fork) | 使用 /fork 启动一个独立的工作空间，并从先前的某个时间点分支对话 |
| 清空对话 | 使用 /clear 清空输入框并开始一个新的对话会话 |
| 恢复对话 | 使用 /resume 列出并恢复以前的对话日志 |
| 自动保存恢复 | 当您关闭 CLI 时，它会自动打印出恢复该特定会话所需的精准命令 |
按键绑定 (Keybindings)
AGY CLI 允许自定义按键绑定。您可以通过输入 /keybindings 或直接修改 JSON 文件来进行编辑。
- 文件路径：
~/.gemini/antigravity-cli/keybindings.json。 - 重置默认：要重置为默认值，只需删除
keybindings.json文件即可。
默认按键绑定 (Default Keybindings)
| 操作/命令 (Action/Command) | 按键 (Keys) | 用途 (Purpose) |
|---|---|---|
| 清空 TUI 屏幕 | ctrl+l | 清除终端输出 |
| 回车 / 提交 | enter | 提交 Prompt 或确认选择 |
| Escape / 取消 | ctrl+c, esc | 停止流式输出、关闭菜单或清空输入框 |
| 退出 CLI | ctrl+d | 终止 CLI TUI 会话 |
| 挂起 CLI | ctrl+z | 将 CLI 会话推送到终端后台运行 |
| 编辑命令 | e | 打开编辑器以编辑提议的终端命令 |
| 确认否定 (No) | n | 拒绝终端命令的执行 |
| 确认肯定 (Yes) | y | 批准终端命令的执行 |
| 打开外部编辑器 | ctrl+g | 在您默认的 Shell 编辑器中编辑 Prompt |
| 粘贴文本 | ctrl+v | 从剪贴板粘贴文本 |
| 重做文本编辑 | ctrl+shift+z | 重做上一次撤销的文本修改 |
| 撤销文本编辑 | ctrl+_, ctrl+shift+- | 撤销上一次文本修改 |
| 复制 (Yank) | ctrl+y | 复制选中的文本 |
| 向下导航 | down | 在菜单列表中向下滚动 |
| 跳转至底部 | ctrl+end | 将 TUI 视图直接跳转至最底部 |
| 跳转至顶部 | ctrl+home | 将 TUI 视图直接跳转至最顶部 |
| 向左导航 | left | 向左移动 Prompt 光标 |
| 向下翻页 | pgdown, shift+down | 在 TUI 中向下翻页滚动 |
| 向上翻页 | pgup, shift+up | 在 TUI 中向上翻页滚动 |
| 向右导航 | right | 向右移动 Prompt 光标 |
| Tab / 聚焦 | tab | 自动补全选择项或切换组件焦点 |
| 向上导航 | up | 在菜单列表中向上滚动 |
| 插入换行 | alt+enter, ctrl+j, shift+enter | 在 Prompt 中增加换行而不提交 |
您可以在 JSON 文件中将单个操作映射到多个按键绑定。若要禁用按键绑定，请将列表设置为空（例如 []）。如果文件格式错误，CLI 将使用有效的部分，并在损坏的操作上回退到默认设置。
[!WARNING] 重要提示：按键绑定
cli.exit和cli.enter无法被禁用。