---
title: "Editor Surface 與工作分層"
description: "基於官方 Editor 文件理解 Antigravity Editor 的 VS Code 基礎、AI 入口、擴充套件能力和適用任務邊界。"
verifiedAt: "2026-05-06"
---

Antigravity 的 Editor 是主要入口，也是最像傳統 IDE 的介面。Google 官方 Editor 文件說明，它基於 VS Code codebase，同時加入 Tab、Command、Agent side panel、Review Changes 和 Source Control 等 AI-enabled features。

這意味著學習 Editor 時不要走兩個極端：不要把它當成普通 VS Code，也不要把所有任務都扔給 Agent Manager。Editor 最適合“程式碼現場明確、上下文可控、diff 可以快速審查”的任務。

> [!NOTE]
> **閱讀目標**：讀完本章，你應該能判斷哪些任務留在 Editor 裡處理，哪些任務應該上升到 Agent Manager 或 Planning 模式。

## 1. Editor 是熟悉的 IDE，不是普通 IDE

官方文件強調，Antigravity Editor 保留了熟悉的編輯器體驗：開啟檔案、在檔案間切換、直接編輯、使用擴充套件、接入 source control。

差異在於這些傳統入口都能接到 AI 工作流：

| Editor 能力 | 官方含義 | 實操價值 |
| --- | --- | --- |
| Tab | 在當前檔案附近給程式碼建議和導航 | 區域性加速，不打斷編碼流 |
| Command | 在編輯器或終端裡輸入自然語言指令 | 小範圍生成、改寫、解釋 |
| Agent side panel | 在右側面板直接和 agent 協作 | 當前 workspace 內的任務協作 |
| Review Changes | 檢視本 conversation 裡產生的改動 | 把 AI 輸出拉回 diff 審查 |
| Open VSX extensions | 繼續安裝語法、source control 等擴充套件 | 保留傳統 IDE 生態 |

## 2. Editor 與 Agent Manager 的邊界

先用任務範圍判斷入口，不要按個人習慣亂切。

```mermaid
flowchart TD
  Task["新任務"] --> Known{"是否知道主要檔案或錯誤位置"}
  Known -->|知道| Editor["留在 Editor"]
  Known -->|不知道| Manager["進入 Agent Manager / Planning"]
  Editor --> Small{"是否區域性、可快速讀完 diff"}
  Small -->|是| TabCommand["Tab / Command / Side Panel"]
  Small -->|否| Manager
  Manager --> Artifacts["要求 plan、artifacts、walkthrough"]
  TabCommand --> Review["Review Changes + Source Control"]
```

簡單說：

- 你知道要改哪一小塊，留在 Editor。
- 你需要跨檔案規劃、瀏覽器驗證、長任務追蹤，切到 Agent Manager。
- 你讓 AI 寫了程式碼，就必須回到 Review Changes 或 Source Control。

## 3. 什麼時候留在 Editor

Editor 適合這些任務：

| 任務 | 推薦入口 | 原因 |
| --- | --- | --- |
| 補一個函式體 | Tab 或 Command | 上下文區域性，結果可快速審查 |
| 修一個明確報錯 | Command 或 Agent side panel | 錯誤位置清楚 |
| 解釋當前檔案邏輯 | Agent side panel | 不需要跨 workspace 編排 |
| 生成 terminal 命令 | Terminal Command | 靠近 shell，但仍需審查 |
| 審查 AI 改動 | Review Changes | diff 是驗收入口 |

不適合只留在 Editor 的任務：

- 需要同時讀多個目錄。
- 需要先產出 implementation plan。
- 需要瀏覽器截圖、錄屏或 walkthrough。
- 會執行高副作用 terminal 命令。
- 涉及部署、賬號後臺、資料庫或生產環境。

> [!IMPORTANT]
> Editor 不是低風險區域。只要 agent 開始寫檔案或生成 terminal 命令，就要把它當成真實工程改動審查。

## 4. 擴充套件生態的正確位置

官方 Editor 文件提到可以繼續從 Open VSX marketplace 下載擴充套件，用於語法高亮、source control integrations 或其他補充能力。

擴充套件可以增強開發體驗，但不要把擴充套件當成 agent 安全邊界。真正的邊界仍然在：

- workspace 範圍。
- terminal command review。
- file access policy。
- Browser URL allowlist。
- Git diff 和 source control。

<details>
<summary>深讀：為什麼 Editor 任務也要寫驗收條件</summary>

很多人會把 Editor 裡的 AI 入口當成“區域性輔助”，於是放鬆審查。但官方 Editor 文件把 Tab、Command、Agent side panel、Review Changes 和 Source Control 放在同一個工作面裡，說明區域性生成最終仍然會落到程式碼改動。

所以即使是一個小改動，也建議在 prompt 裡寫明“只改這個檔案”“完成後給 diff”“不要執行部署命令”。這樣可以把 Editor 的便利性和工程審查習慣接起來。
</details>

## 5. 第一天的 Editor 使用順序

第一次用 Editor，不要直接把複雜需求交給 agent。按這個順序熟悉：

1. 開啟測試 workspace。
2. 手動瀏覽檔案樹，確認專案結構。
3. 用 Tab 接受一個區域性建議。
4. 用 Command 生成或解釋一小段程式碼。
5. 用 Agent side panel 做只讀解釋。
6. 讓 agent 做一個單檔案小改。
7. 開啟 Review Changes 審查 diff。
8. 回到 Source Control 決定是否保留。

## 本章自檢

完成本章後，用這 3 個問題檢查自己是否真正理解：

1. Editor 和 Agent Manager 的任務邊界是什麼？
2. 為什麼 Editor 裡的 AI 改動也必須看 Review Changes 或 Source Control？
3. Open VSX 擴充套件能增強什麼，不能替代什麼？

透過標準：你能把一個小任務安排在 Editor 內完成，並清楚說明用 Tab、Command、side panel 還是 Review Changes。

## 官方來源

- [Google Antigravity Editor](https://antigravity.google/docs/editor) —— 官方說明 Editor 基於 VS Code codebase，並整合 Tab、Command、Agent side panel、Review Changes、Source Control 和 Open VSX 擴充套件。

## 接下來去哪

<Cards>
  <Card title="Tab、Command 與 Review Changes" description="繼續把 Editor 的具體入口串成日常編碼閉環。" href="/zh-Hant/docs/antigravity/official/02-editor-workflow/01-tab-command-review" />
  <Card title="Agent Modes 與全域性設定" description="如果任務已經超出 Editor 區域性範圍，回到 Planning、Fast 和許可權策略。" href="/zh-Hant/docs/antigravity/official/01-agent-manager/01-agent-modes-settings" />
</Cards>
