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 關係。