---
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="/docs/antigravity/official/04-rules-workflows-skills" />
  <Card title="Artifacts 验收工作流" description="从原理层设计 task list、plan、diff、screenshot 和 walkthrough 的验收闭环。" href="/docs/antigravity/understanding" />
</Cards>
