01 · Antigravity 是什么
理解 Google Antigravity 的定位：不是普通 AI IDE，而是围绕 Agent Manager、Artifacts、Browser 和权限治理设计的 agent-first 开发平台。
Antigravity 最容易被误解成“Google 版 Cursor”或“Gemini 的 IDE 壳”。这个理解太浅。Google 官方文档把 Antigravity 定位为 agentic development platform：开发者不只在编辑器里和 AI 聊天，而是在更高的任务层级管理 agent，让 agent 跨 editor、terminal、browser 完成开发任务，并通过 artifacts 留下可审查的证据。
本章目标：读完后你应该能说清 Antigravity 和普通 AI IDE 的差异，知道为什么 Agent Manager、Artifacts、Browser Agent 和权限系统比模型列表更重要。
1. 先给结论
一句话：
普通 AI IDE：你在代码旁边让 AI 辅助编辑。
Antigravity：你在任务层管理 agent，让它执行、验证并交付证据。官方 Home 文档把 Antigravity 的能力拆到三个现场：Editor、Agent Manager、Browser。它还强调 artifacts，因为异步 agent 做完任务以后，用户不能只听它说“我完成了”，必须能看 plan、diff、screenshot、browser recording、walkthrough 这类证据。
2. 它到底改变了什么
假设你让工具修复一个登录页按钮。
传统 AI 编辑器通常是：
- AI 改代码。
- 你自己启动服务。
- 你自己打开浏览器。
- 你自己点击登录流程。
- 你自己判断它到底修没修好。
Antigravity 想把这件事变成任务闭环：
- Agent 先给 task list（任务清单）或 implementation plan（实现计划）。
- Agent 在 editor、terminal、browser 里执行。
- Agent 交付 diff（代码变更对比）、screenshot（截图）、browser recording（浏览器录屏）、walkthrough（任务总结报告）。
- 你在 artifacts（产物证据）和代码 diff 上评论。
- Agent 根据反馈继续迭代。
这不是“更会补全代码”。这是把开发任务从手工步骤升级成可审查的 agent 执行链。
3. 四个核心层
它包含四个核心层：
| 层 | 作用 | 新手要学什么 |
|---|---|---|
| Editor | 传统 IDE 工作区 | 补全、命令、局部协作 |
| Agent Manager | agent 任务管理面 | 多 workspace、多 agent、conversation、review |
| Browser + Artifacts | 验收证据层 | screenshot、recording、walkthrough、diff、plan |
| Permission System | 风险控制层 | terminal、file、browser URL、MCP 的边界 |
Google 官方文档里的 key terms 也指向同一件事：Agent 是主要 AI modality；Tab 和 Command 是编辑器里的辅助 modality；Artifacts 是 agent 创建出来用于完成任务或向人类沟通成果的内容。
4. 心智模型
flowchart TD
User["开发者"] --> Goal["高层目标"]
Goal --> Manager["Agent Manager"]
Manager --> Plan["Task List / Implementation Plan"]
Plan --> Tools["Editor / Terminal / Browser / MCP"]
Tools --> Diff["Code Diff"]
Tools --> Proof["Artifacts: Screenshot / Recording / Walkthrough"]
Diff --> Review["人工 Review"]
Proof --> Review
Review --> Feedback["Artifact 评论 / 修改要求"]
Feedback --> Manager
style Manager fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
style Proof fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Review fill:#dcfce7,stroke:#22c55e看懂这个图，就能看懂 Antigravity 的产品取舍：它把开发者从“每一步都亲手做”推向“定义目标、审计划、看证据、收权限边界”。
5. 它不是 Gemini CLI，也不是只换壳的 VS Code
Gemini CLI 是 terminal-first。你在命令行里让 agent 读文件、跑命令、调用工具。Antigravity 是 workspace-first 和 manager-first。它更关注本地 IDE、浏览器验证和多 agent 编排。
| 工具 | 更像什么 | 优先场景 |
|---|---|---|
| Gemini CLI | 终端 agent | 脚本化、本地工具、命令行任务 |
| Antigravity | agent 工作台 | UI 验证、多任务编排、可视化验收 |
所以不要问“有 Gemini CLI 还要不要 Antigravity”。更好的问题是：这个任务是否需要浏览器、截图、录屏、walkthrough 和多 agent 管理。
Antigravity 的 Editor 基于 VS Code 代码库，官方文档也明确它保留打开文件、编辑、Tab、Command、Agent side panel、source control 和扩展生态。但它的 Agent Manager 和 Browser 是另一个层级，不应被简化成“VS Code 加聊天侧栏”。
6. 它也不是“全自动工程师”
Antigravity 的自治能力越强，越需要你设计边界。真正成熟的用法不是把权限全开，而是：
- 复杂任务先要 plan。
- 写操作先看 diff。
- UI 任务必须要 screenshot 或 recording。
- 删除、部署、付款、账号后台必须人工确认。
- 能沉淀的经验写进 Rules（长期规则）、Workflows（按需流程）、Skills（专业能力包）。
- Browser Agent 先限制在
localhost或明确 allow 的站点。
如果你把 Antigravity 理解成“让 AI 自动干完所有活”，它会很危险。如果你把它理解成“带证据交付的 agent 工作台”，它才有生产价值。
7. 适合与不适合
适合 Antigravity：
- UI 改动后需要浏览器验证。
- 一个任务要跨文件、terminal、browser。
- 需要多个 agent 异步处理不同 workspace。
- 需要把计划、diff、截图、录屏留给人审。
- 你愿意维护权限、Rules、Workflows、Skills。
不适合直接交给 Antigravity：
- 生产数据库变更。
- 真实账号后台提交。
- 支付、广告、权限授权。
- 没有边界的大范围重构。
- 你不打算看 plan、diff 和 artifacts。
深读：为什么 Artifacts 是 Antigravity 的核心
聊天回复很容易给人一种“已经完成”的错觉，但它不是证据。Artifacts 的价值在于把 agent 的计划、修改、视觉验证和操作过程变成可审查对象。只要任务超过局部补全，就应该要求 agent 交 plan、diff 和至少一种验证 artifact。没有证据的“完成”，不能进入生产工作流。
8. 本章自检
你应该能回答：
- Antigravity 为什么不是单纯的 AI Editor？
- Editor、Agent Manager、Browser 三个界面（surface）分别负责什么？
- Artifacts 为什么比自然语言总结更适合验收？
- 哪些任务必须限制权限或改用人工操作？
通过标准：你能把一个开发任务描述成“在哪个界面启动、由哪个 agent 执行、用哪些 artifacts 验收、受哪些权限限制”。
官方来源
- Google Antigravity Documentation：官方 Home 文档，定义产品定位、核心界面（surface）、Agent、Tab、Command 和 Artifacts。
- Getting Started with Google Antigravity：Google Codelab，说明 agent-first platform、Mission Control、Agent Manager、Browser 和 Artifacts。
- Google Antigravity：官方产品入口，用于核对下载、文档和产品当前状态。