Browser 與 Artifacts
Antigravity Browser Subagent、瀏覽器擴充套件、截圖、錄屏、task list、implementation plan、walkthrough 和 diff review 的使用邊界。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Browser & artifacts | 瀏覽器與工件 | 驗證和留痕的兩大能力。 |
| 證據驅動 | evidence | 用工件和截圖證明效果。 |
| 審查 | review | 據此判斷 agent 的工作。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你搞清 Antigravity 瀏覽器與工件這一組怎麼讀、怎麼用。
你是 Antigravity 瀏覽器工件導航顧問。
【角色】
Antigravity 瀏覽器工件導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 我想驗證 / 留痕什麼：___
- 涉及 UI 還是後端：___
- 專案關鍵路徑：___
- 審查習慣：___
- 經驗水平：___
【工作流程】
1. 說明這組的兩大能力
2. 給閱讀順序
3. 對應到我的驗證需求
4. 標出審查要點
5. 給第一步
【輸出規範】
▌一、兩大能力
▌二、閱讀順序
▌三、對應需求
▌四、審查 + 第一步
【硬約束】
- 靠證據審查不盲信
- 影響關鍵路徑額外核查
- 證據不足要求補
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法Antigravity 的瀏覽器能力和 Artifacts 是它最值得單獨學習的部分。傳統 agent 經常說“我修好了”，但你還得自己啟動服務、開啟頁面、點一遍流程。Antigravity 的目標是讓 agent 產出可審閱證據：截圖、瀏覽器錄屏、walkthrough、diff、task list 和 implementation plan。
這一頁解決什麼問題：UI 任務、網頁任務、端到端驗證任務，不能只看程式碼 diff。你應該要求 Antigravity 用 Browser 和 Artifacts 證明結果。
1. Browser Subagent 是什麼
Google Codelab 描述了一個 browser subagent：當主 agent 需要瀏覽器互動時，它會呼叫專門的瀏覽器子代理。這個子代理可以使用頁面控制工具，例如點選、滾動、輸入、讀取 console log，也可以透過 DOM、截圖或 markdown 解析頁面，還能錄製影片。
flowchart TD
Main["主 Agent"] --> NeedBrowser{"需要瀏覽器驗證?"}
NeedBrowser -->|是| Browser["Browser Subagent"]
Browser --> Open["開啟頁面"]
Browser --> Click["點選 / 輸入 / 滾動"]
Browser --> Observe["讀取 DOM / screenshot / console"]
Browser --> Record["截圖 / 錄屏"]
Record --> Artifact["Walkthrough Artifact"]
NeedBrowser -->|否| Terminal["檔案與 terminal 驗證"]2. 瀏覽器擴充套件
Codelab 中第一次觸發瀏覽器任務時，Antigravity 會引導安裝瀏覽器擴充套件。手動安裝入口也可以從 Agent Manager 或 Editor 中的 Chrome 圖示進入。
使用建議：
- 第一次只讓它訪問官方站或本地
localhost。 - 不要直接讓它登入後臺、付款頁、廣告後臺或賬號設定頁。
- 對真實賬號頁面，先明確只讀範圍。
- 對第三方網頁，先設定 Browser URL Allowlist。
瀏覽器能力是超能力，也是攻擊面。網頁可能包含 prompt injection，誘導 agent 洩露檔案、執行命令或訪問無關 URL。
3. Artifacts 型別
Codelab 與釋出文都強調 Artifacts。常見型別可以這樣理解：
| Artifact | 什麼時候看 | 你要審什麼 |
|---|---|---|
| Task List | 動手前 | 步驟是否過寬、是否漏驗收 |
| Implementation Plan | 複雜任務動手前 | 技術路線、影響範圍、回復點 |
| Code diff | 程式碼生成後 | 是否碰無關檔案、是否引入風險 |
| Screenshot | UI 修改後 | 視覺是否符合要求 |
| Browser Recording | 互動流程後 | 使用者路徑是否真的跑通 |
| Walkthrough | 完成後 | 它做了什麼、怎麼驗證、剩餘風險 |
4. Google Docs 風格反饋
Antigravity 支援對 artifact 或 code diff 留評論，讓 agent 根據評論繼續迭代。這個機制比“重新發一條長 prompt”更穩，因為反饋繫結在具體證據上。
示例：
在 walkthrough 的截圖上評論：
按鈕顏色符合，但 mobile 寬度下標題換行後遮擋了圖示。
請只調整該元件的 responsive 樣式，並重新截圖驗證。5. UI 任務的最低交付標準
UI 任務如果要商業級交付，至少要求：
- 改動前說明目標和影響範圍。
- 改動後有 screenshot。
- 有至少一個關鍵使用者路徑的 browser recording 或文字 walkthrough。
- 本地服務啟動命令和訪問 URL 寫清楚。
- 說明未覆蓋的瀏覽器、viewport 或許可權前提。
“頁面能開啟”不是驗收。“能按使用者路徑完成任務，並留下可複查證據”才是驗收。
6. Undo changes
Codelab 展示了可以在 chat 中選擇 Undo changes up to this point。這不是替代 Git 的版本管理，而是任務級回退工具。
建議：
- 小任務可用 Antigravity 的 undo 快速回退。
- 真實專案仍然要看 Git diff。
- 多 agent 並行時，不要用一個 conversation 的 undo 去處理另一個 conversation 的改動。