---
title: "Browser 與 Artifacts"
description: "Antigravity Browser Subagent、瀏覽器擴充套件、截圖、錄屏、task list、implementation plan、walkthrough 和 diff review 的使用邊界。"
verifiedAt: "2026-05-05"
---

Antigravity 的瀏覽器能力和 Artifacts 是它最值得單獨學習的部分。傳統 agent 經常說“我修好了”，但你還得自己啟動服務、開啟頁面、點一遍流程。Antigravity 的目標是讓 agent 產出可審閱證據：截圖、瀏覽器錄屏、walkthrough、diff、task list 和 implementation plan。

> [!NOTE]
> **這一頁解決什麼問題**：UI 任務、網頁任務、端到端驗證任務，不能只看程式碼 diff。你應該要求 Antigravity 用 Browser 和 Artifacts 證明結果。

## 1. Browser Subagent 是什麼

Google Codelab 描述了一個 browser subagent：當主 agent 需要瀏覽器互動時，它會呼叫專門的瀏覽器子代理。這個子代理可以使用頁面控制工具，例如點選、滾動、輸入、讀取 console log，也可以透過 DOM、截圖或 markdown 解析頁面，還能錄製影片。

```mermaid
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 圖示進入。

使用建議：

1. 第一次只讓它訪問官方站或本地 `localhost`。
2. 不要直接讓它登入後臺、付款頁、廣告後臺或賬號設定頁。
3. 對真實賬號頁面，先明確只讀範圍。
4. 對第三方網頁，先配置 Browser URL Allowlist。

> [!WARNING]
> 瀏覽器能力是超能力，也是攻擊面。網頁可能包含 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”更穩，因為反饋繫結在具體證據上。

示例：

```text
在 walkthrough 的截图上评论：
按钮颜色符合，但 mobile 宽度下标题换行后遮挡了图标。
请只调整该组件的 responsive 样式，并重新截图验证。
```

## 5. UI 任務的最低交付標準

UI 任務如果要商業級交付，至少要求：

1. 改動前說明目標和影響範圍。
2. 改動後有 screenshot。
3. 有至少一個關鍵使用者路徑的 browser recording 或文字 walkthrough。
4. 本地服務啟動命令和訪問 URL 寫清楚。
5. 說明未覆蓋的瀏覽器、viewport 或許可權前提。

> [!IMPORTANT]
> “頁面能開啟”不是驗收。“能按使用者路徑完成任務，並留下可複查證據”才是驗收。

## 6. Undo changes

Codelab 展示了可以在 chat 中選擇 `Undo changes up to this point`。這不是替代 Git 的版本管理，而是任務級回退工具。

建議：

- 小任務可用 Antigravity 的 undo 快速回退。
- 真實專案仍然要看 Git diff。
- 多 agent 並行時，不要用一個 conversation 的 undo 去處理另一個 conversation 的改動。

## 官方來源

- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- [Build with Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)

## 接下來去哪

<Cards>
  <Card title="Rules / Workflows / Skills" description="把臨時反饋沉澱成長期規則、按需流程和可複用能力包。" href="/zh-Hant/docs/antigravity/official/04-rules-workflows-skills" />
  <Card title="Artifacts 驗收工作流" description="從原理層設計 task list、plan、diff、screenshot 和 walkthrough 的驗收閉環。" href="/zh-Hant/docs/antigravity/understanding" />
</Cards>
