Browser 与 Artifacts
Antigravity Browser Subagent、浏览器扩展、截图、录屏、task list、implementation plan、walkthrough 和 diff review 的使用边界。
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 的改动。