---
title: "01 · Antigravity 是什么"
description: "理解 Google Antigravity 的定位：不是普通 AI IDE，而是围绕 Agent Manager、Artifacts、Browser 和权限治理设计的 agent-first 开发平台。"
verifiedAt: "2026-05-07"
---

Antigravity 最容易被误解成“Google 版 Cursor”或“Gemini 的 IDE 壳”。这个理解太浅。Google 官方文档把 Antigravity 定位为 **agentic development platform**：开发者不只在编辑器里和 AI 聊天，而是在更高的任务层级管理 agent，让 agent 跨 editor、terminal、browser 完成开发任务，并通过 artifacts 留下可审查的证据。

> [!NOTE]
> **本章目标**：读完后你应该能说清 Antigravity 和普通 AI IDE 的差异，知道为什么 Agent Manager、Artifacts、Browser Agent 和权限系统比模型列表更重要。

## 1. 先给结论

一句话：

```text
普通 AI IDE：你在代码旁边让 AI 辅助编辑。
Antigravity：你在任务层管理 agent，让它执行、验证并交付证据。
```

官方 Home 文档把 Antigravity 的能力拆到三个现场：Editor、Agent Manager、Browser。它还强调 artifacts，因为异步 agent 做完任务以后，用户不能只听它说“我完成了”，必须能看 plan、diff、screenshot、browser recording、walkthrough 这类证据。

## 2. 它到底改变了什么

假设你让工具修复一个登录页按钮。

传统 AI 编辑器通常是：

1. AI 改代码。
2. 你自己启动服务。
3. 你自己打开浏览器。
4. 你自己点击登录流程。
5. 你自己判断它到底修没修好。

Antigravity 想把这件事变成任务闭环：

1. Agent 先给 task list（任务清单）或 implementation plan（实现计划）。
2. Agent 在 editor、terminal、browser 里执行。
3. Agent 交付 diff（代码变更对比）、screenshot（截图）、browser recording（浏览器录屏）、walkthrough（任务总结报告）。
4. 你在 artifacts（产物证据）和代码 diff 上评论。
5. 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. 心智模型

```mermaid
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 的自治能力越强，越需要你设计边界。真正成熟的用法不是把权限全开，而是：

1. 复杂任务先要 plan。
2. 写操作先看 diff。
3. UI 任务必须要 screenshot 或 recording。
4. 删除、部署、付款、账号后台必须人工确认。
5. 能沉淀的经验写进 Rules（长期规则）、Workflows（按需流程）、Skills（专业能力包）。
6. Browser Agent 先限制在 `localhost` 或明确 allow 的站点。

> [!WARNING]
> 如果你把 Antigravity 理解成“让 AI 自动干完所有活”，它会很危险。如果你把它理解成“带证据交付的 agent 工作台”，它才有生产价值。

## 7. 适合与不适合

适合 Antigravity：

- UI 改动后需要浏览器验证。
- 一个任务要跨文件、terminal、browser。
- 需要多个 agent 异步处理不同 workspace。
- 需要把计划、diff、截图、录屏留给人审。
- 你愿意维护权限、Rules、Workflows、Skills。

不适合直接交给 Antigravity：

- 生产数据库变更。
- 真实账号后台提交。
- 支付、广告、权限授权。
- 没有边界的大范围重构。
- 你不打算看 plan、diff 和 artifacts。

<details>
<summary>深读：为什么 Artifacts 是 Antigravity 的核心</summary>

聊天回复很容易给人一种“已经完成”的错觉，但它不是证据。Artifacts 的价值在于把 agent 的计划、修改、视觉验证和操作过程变成可审查对象。只要任务超过局部补全，就应该要求 agent 交 plan、diff 和至少一种验证 artifact。没有证据的“完成”，不能进入生产工作流。
</details>

## 8. 本章自检

你应该能回答：

1. Antigravity 为什么不是单纯的 AI Editor？
2. Editor、Agent Manager、Browser 三个界面（surface）分别负责什么？
3. Artifacts 为什么比自然语言总结更适合验收？
4. 哪些任务必须限制权限或改用人工操作？

通过标准：你能把一个开发任务描述成“在哪个界面启动、由哪个 agent 执行、用哪些 artifacts 验收、受哪些权限限制”。

## 官方来源

- [Google Antigravity Documentation](https://antigravity.google/docs/home)：官方 Home 文档，定义产品定位、核心界面（surface）、Agent、Tab、Command 和 Artifacts。
- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)：Google Codelab，说明 agent-first platform、Mission Control、Agent Manager、Browser 和 Artifacts。
- [Google Antigravity](https://antigravity.google/)：官方产品入口，用于核对下载、文档和产品当前状态。

## 接下来去哪

<Cards>
  <Card title="第一次安全运行" description="按低风险顺序完成安装、只读分析、单文件小改和浏览器验收。" href="/docs/antigravity/understanding/02-install-first-safe-run" />
  <Card title="查官方入门" description="如果你只想查安装和 setup flow，去官方教程中文版。" href="/docs/antigravity/official/00-getting-started" />
</Cards>
