Tab、Command 与 Review Changes
把官方 Tab、Command、Agent Side Panel 和 Review Changes 文档串成 Antigravity Editor 的日常编码闭环。
Editor 里的 AI 入口可以分成三段：写代码时用 Tab 保持流畅，小范围指令用 Command，任务协作用 Agent side panel，最后用 Review Changes 和 Source Control 审查。
这套顺序比“哪里亮了点哪里”稳。它能让你在不离开 Editor 的情况下完成局部任务，同时保留 diff 和评论反馈。
阅读目标：读完本章，你应该能区分 Supercomplete（智能补全）、Tab-to-Jump（按 Tab 跳到下一编辑点）、Tab-to-Import（按 Tab 自动补依赖）、Command（行内自然语言指令）、Agent side panel（编辑器侧栏 agent）和 Review Changes（改动审查）的职责。
1. Tab：局部补全和导航
官方 Tab 文档把 Editor 的 Tab 能力拆成三类。
| 能力 | 官方说明 | 怎么用 |
|---|---|---|
| Supercomplete | 在光标附近提供代码建议，可能跨整个文档同步修改相关位置（如改一处变量名同时更新所有引用、改一个函数定义同步对应另一处） | 写代码时按 Tab 接受 |
| Tab-to-Jump | 推荐下一个合理编辑点 | 出现跳转提示后按 Tab 移动光标 |
| Tab-to-Import | 识别未导入的 class 或 function，并补 import | 输入符号后按 Tab 补全并添加 import |
Supercomplete 的"跨文档同步改"是新手最容易低估的能力——它不是只改光标附近一行。改变量名 / 函数签名时按一下 Tab，整个文件相关位置一起改完，比手动 rename 快得多。
Tab 的定位是“不打断编码流”。它适合连续写代码，不适合替代跨文件理解。
如果 Tab 建议开始影响你没预期的远处代码，先停下来读 diff 或撤销，不要连续按 Tab。
2. Tab 设置要按项目调
官方 Tab 文档列出这些设置：
| 设置 | 作用 | 建议 |
|---|---|---|
| Autocomplete / Tab-to-Jump / Supercomplete / Tab-to-Import | 单独开关相关能力 | 先保留默认，用项目体验再微调 |
| Tab Speed | 控制建议响应速度：Slow、Default、Fast | 新项目用 Default，误触多就降到 Slow |
| Highlight Inserted Text | 高亮 Tab 插入的文本 | 建议开启，方便审查 |
| Clipboard Context | 使用剪贴板内容提升补全准确性 | 涉及敏感信息时谨慎 |
| Allow Gitignored Files | 允许在 .gitignore 文件中使用 Tab 功能 | 涉及 .env、构建产物、私密文件时关闭 |
不要把“建议更快”当成唯一目标。对真实项目来说，看得见、可撤销、少误触更重要。
3. Command：自然语言的局部指令
官方 Command 文档说明触发方式：
| 系统 | 快捷键 |
|---|---|
| macOS | Command + I |
| Windows / Linux | Ctrl + I |
触发后，会在当前光标位置出现输入框，你可以用自然语言请求 inline completions 或 terminal commands。
适合在 Editor 使用：
Create a React component for a login form.适合在 terminal 使用：
Find all processes listening on port 3000 and kill them.第二个例子要特别谨慎。生成命令不等于应该自动执行命令，尤其是 kill、delete、deploy、push、migration 这类动作。
4. Agent side panel：当前工作区协作入口
官方 Agent Side Panel 文档说明，Editor 右侧面板可以：
- 开新 conversation。
- 附加图片。
- 切换 agent modes。
- 选择不同模型。
- 在底部 toolbar 跟踪打开的文件改动、运行中的 terminal processes 和 artifacts。
把它理解成“当前 workspace 的协作区”。当任务还没有大到需要 Agent Manager 编排时，side panel 很合适。
flowchart LR
Code["当前文件"] --> Tab["Tab 补全"]
Code --> Command["Command 局部指令"]
Command --> SidePanel["Agent side panel"]
SidePanel --> Toolbar["File changes / terminal processes / artifacts"]
Toolbar --> Review["Review Changes"]
Review --> SourceControl["Source Control"]5. Review Changes：把 AI 输出拉回 diff
官方 Review Changes 文档说明：当 agent 在 conversation 中开始写代码后，Agent panel 底部 toolbar 会出现 Review Changes。点击后可以在 Editor pane 中滚动查看你和 agent 在这个 conversation 中产生的所有改动。
你还可以像评论 artifacts 一样，在 file diff 上留评论，让 agent 继续迭代。
好的 review 评论应该绑定到具体 diff：
这里不要改公共 helper，当前任务只允许改登录组件。
请把 helper 的变更撤回，并在组件内部完成最小修复。Review Changes 是 conversation 视角，Source Control 是仓库视角。真实提交前，两者都要看。
深读：为什么 Command 生成的 terminal 命令也要审查
官方 Command 文档明确说明 Command 可以在 integrated Antigravity terminal 中生成复杂 shell commands。这是效率入口，但也是副作用入口。
自然语言生成命令时，模型可能选择更激进的命令组合，例如 kill 进程、删除文件、安装依赖或触发远端操作。真实项目里，Command 生成 terminal 命令后，先读命令含义，再判断是否运行。不要因为命令来自编辑器内置功能就跳过审查。
6. 日常闭环模板
可以把 Editor 日常任务写成这个顺序：
- Tab 补完局部片段。
- Command 处理小范围改写。
- Agent side panel 解释当前文件或错误。
- 需要修改时限制文件范围。
- 从 toolbar 打开 Review Changes。
- 在 diff 上评论并让 agent 迭代。
- 最后回到 Source Control 做仓库级审查。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Supercomplete、Tab-to-Jump、Tab-to-Import 分别解决什么问题？
- Command 在 Editor 和 Terminal 中的风险有什么不同？
- Review Changes 和 Source Control 为什么都需要看？
通过标准：你能完成一个局部修改，并用 Review Changes 评论 diff，而不是只接受聊天回复。
官方来源
- Google Antigravity Tab —— 官方说明 Supercomplete、Tab-to-Jump、Tab-to-Import 和相关设置。
- Google Antigravity Command —— 官方说明
Command + I/Ctrl + I、editor inline command 和 terminal command。 - Google Antigravity Agent Side Panel —— 官方说明右侧 Agent panel、conversation、图片、模式、模型和底部 toolbar。
- Google Antigravity Review Changes + Source Control —— 官方说明 Review Changes、file diff 评论和 source control 关系。