Antigravity 完全使用指南
2026年1月更新Agent 优先Antigravity 是 Google 开发的 Agent 优先的敏捷开发平台，将 IDE 进化到 Agent 优先时代。开发者可以在更高的任务导向层面管理跨工作区的 Agent，同时保留熟悉的 AI IDE 核心体验。
一、🚀 Antigravity 是什么？
Antigravity 不是传统的 AI 代码补全工具，而是一个全新的开发范式：
| 传统 AI 辅助 | Antigravity Agent 优先 |
|---|---|
| 代码补全、建议 | Agent 自主规划、编写、测试、运行 |
| 开发者主导 | Agent 主导 + 开发者审核 |
| 单一文件操作 | 跨编辑器、终端、浏览器多维度操作 |
| 即时响应 | 异步执行 + Artifacts 交付 |
🎯 核心理念
"Agent 做事，开发者审核" —— Agent 不仅能写代码，还能启动应用、在浏览器中测试、验证功能是否正常。通过任务（Tasks）和 Artifacts 进行更高层次的沟通。
1.1 核心特性
| 特性 | 说明 |
|---|---|
| AI 驱动的 IDE | 集成 Agent、Tab 补全、Command 等开发者依赖的 AI 功能 |
| 异步 Agent | 本地异步 Agent，可在所有工作区并行工作 |
| Agent Manager | 全新的 Agent 管理视图，围绕规划模式、对话 UI 和 Artifact 审核构建 |
| 多窗口产品 | 包含 Editor、Manager 和 Browser 三个窗口 |
| Browser Agent | Agent 可操控浏览器完成开发任务，如仪表板读取、SCM 操作、UI 测试等 |
1.2 三大核心界面
| 界面 | 说明 |
|---|---|
| Editor | 功能完备的 AI 驱动 IDE，映射到单个工作区 |
| Browser | (预览中) 浏览器使用 Agent 能力，可读取和操作 IDE 之外的更多界面 |
| Agent Manager | (预览中) 编排"无代码"视图，在极简产品中启动和查看任务，聚焦对话和 Artifacts |
1.3 技术基础
- VS Code 内核：Antigravity 基于 Visual Studio Code 代码库构建，保留了熟悉的界面，支持 Open VSX 市场扩展
- 多模型支持：通过 Google Vertex Model Garden 提供 Gemini 3、Claude、GPT-OSS 等多种前沿模型
二、📥 快速入门
2.1 下载与安装
访问 antigravity.google/download 下载 Google Antigravity。
系统要求：
| 平台 | 要求 |
|---|---|
| macOS | 支持 Apple 安全更新的版本（通常为当前版本和前两个版本），最低版本 12 (Monterey)，不支持 X86 |
| Windows | Windows 10 (64 bit) |
| Linux | glibc >= 2.28, glibcxx >= 3.4.25 (如 Ubuntu 20, Debian 10, Fedora 36, RHEL 8) |
应用程序会在有更新时自动提示。
2.2 基本导航
视图切换：
| 操作 | 快捷键 |
|---|---|
| Editor ↔ Agent Manager | Cmd + E (Mac) / Ctrl + E (Windows/Linux) |
- 从 Editor 打开 Agent Manager：点击顶部栏按钮或使用键盘快捷键
- 从 Agent Manager 打开 Editor：通过工作区下拉菜单的 "Focus Editor" 选项
三、🤖 Agent 系统
Agent 是 Antigravity 的核心 AI 功能，是一个多步骤推理系统，由前沿 LLM 驱动，可：
- 对现有代码进行推理
- 使用广泛的工具（包括浏览器）
- 通过任务、Artifacts 等与用户沟通
3.1 核心组件
| 组件 | 说明 |
|---|---|
| 推理模型 | 核心 LLM，负责规划和执行 |
| 工具 | Agent 可调用的各种能力 |
| Artifacts | Agent 创建的可验证交付物 |
| Knowledge | 持久化知识系统 |
3.2 自定义配置
| 配置 | 说明 |
|---|---|
| Agent Modes / Settings | Agent 模式和设置 |
| MCP | Model Context Protocol 集成 |
| Rules / Workflows | 规则和工作流 |
你可以启动多个 Agent 对话，包括并行运行。通过 Agent Manager 中右键 "Delete Conversation" 或 Editor Agent 面板中的垃圾桶图标删除对话。
四、🧠 支持的 AI 模型
4.1 推理模型
Antigravity 通过 Google Vertex Model Garden 提供前沿模型：
| 模型 | 说明 |
|---|---|
| Gemini 3 Pro (high) | 高性能版本 |
| Gemini 3 Pro (low) | 标准版本 |
| Gemini 3 Flash | 快速响应 |
| Claude Sonnet 4.5 | Anthropic 模型 |
| Claude Sonnet 4.5 (thinking) | 带思考的版本 |
| Claude Opus 4.5 (thinking) | 高级推理 |
| GPT-OSS | 开源变体 |
💡 模型切换说明
在对话提示框下方的模型选择器中选择推理模型。模型选择在用户消息之间是持久的——如果在 Agent 运行时更改模型，它会继续使用之前选择的模型直到当前轮次完成。
4.2 其他内置模型
Antigravity 在后台使用的其他不可自定义模型：
| 模型 | 用途 |
|---|---|
| Nano Banana Pro | 生成式图像工具，用于 UI 模型、网页图片、系统/架构图等 |
| Gemini 2.5 Pro UI Checkpoint | 浏览器子 Agent 使用，执行点击、滚动、填充输入等操作 |
| Gemini 2.5 Flash | 后台用于检查点和上下文摘要 |
| Gemini 2.5 Flash Lite | 代码库语义搜索工具使用 |
五、⚙️ Agent 模式与设置
5.1 对话级别模式
启动新 Agent 对话时可选择模式：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Planning | Agent 在执行前先规划任务 | 深度研究、复杂任务、协作工作 |
| Fast | Agent 直接执行任务 | 简单任务如重命名变量、执行命令等 |
💡 Planning 模式特点
在 Planning 模式下，Agent 会：
- 以任务组（Task Groups）组织工作
- 产出 Artifacts
- 进行深入研究、思考和规划
5.2 全局设置
在设置面板的 "Agent" 标签页可配置全局设置：
Artifact 审核策略
| 选项 | 说明 |
|---|---|
| Always Proceed | Agent 从不请求审核 |
| Request Review | Agent 总是请求审核 |
当设置为 "Request Review" 时，Agent 在生成实现计划后会终止并等待用户审核和提供反馈。
终端命令自动执行
| 选项 | 说明 |
|---|---|
| Request Review | 从不自动执行（可配置允许列表例外） |
| Always Proceed | Agent 从不请求审核（可配置拒绝列表例外） |
⚠️ 注意
设置更改只对新消息生效，正在进行的响应将使用之前的设置值。
对于 Unix shell，允许/拒绝列表条目以空格分隔的 token 形式匹配命令前缀。对于 PowerShell，条目 token 可匹配命令 token 的任何连续子序列。
Agent 非工作区文件访问
允许 Agent 查看和编辑当前工作区之外的文件。默认情况下，Agent 只能访问工作区内的文件和应用程序根目录 ~/.antigravity/（包含 Artifacts、Knowledge Items 等数据）。
⚠️ 安全警告
谨慎使用此选项，可能会将本地敏感数据暴露给 Agent。
六、📜 Rules（规则）
Rules 是为 Agent 手动定义的约束，支持本地和全局两个级别。Rules 让用户可以引导 Agent 遵循特定用例和风格的行为。
6.1 创建 Rules
- 通过 Editor Agent 面板顶部的 "..." 下拉菜单打开 Customizations 面板
- 导航到 Rules 面板
- 点击 + Global 创建全局规则，或 + Workspace 创建工作区规则
6.2 规则级别
| 级别 | 位置 | 作用范围 |
|---|---|---|
| Global Rules | ~/.gemini/GEMINI.md | 所有工作区 |
| Workspace Rules | .agent/rules/ 文件夹 | 当前工作区或 git 根目录 |
6.3 规则激活方式
| 方式 | 说明 |
|---|---|
| Manual | 通过 Agent 输入框的 @ 提及手动激活 |
| Always On | 始终应用 |
| Model Decision | 基于规则的自然语言描述，模型决定是否应用 |
| Glob | 基于定义的 glob 模式（如 *.js, src/**/*.ts），对匹配文件应用 |
6.4 @ 提及
可以在 Rules 文件中使用 @filename 引用其他文件：
- 相对路径：相对于 Rules 文件位置解析
- 绝对路径：先尝试解析为真正的绝对路径，若不存在则解析为相对于仓库的路径
📝 限制
每个 Rules 文件限制为 12,000 字符。
七、🔄 Workflows（工作流）
Workflows 让你可以定义一系列步骤来引导 Agent 完成重复性任务，如部署服务或响应 PR 评论。
7.1 创建 Workflows
- 通过 Editor Agent 面板顶部的 "..." 下拉菜单打开 Customizations 面板
- 导航到 Workflows 面板
- 点击 + Global 创建全局工作流，或 + Workspace 创建工作区工作流
7.2 工作流格式
---
description: 部署应用到生产环境
---
# 部署工作流
1. 运行测试确保代码质量
// turbo
2. 构建生产版本
// turbo
3. 部署到服务器
4. 验证部署结果7.3 执行工作流
使用 /workflow-name 命令在 Agent 中调用：
/deploy → 执行 .agent/workflows/deploy.md💡 工作流嵌套
可以在工作流中调用其他工作流！例如 /workflow-1 可以包含 "Call /workflow-2" 和 "Call /workflow-3" 指令。
7.4 特殊标记
| 标记 | 说明 |
|---|---|
// turbo | 该步骤自动执行（无需确认） |
// turbo-all | 所有步骤自动执行 |
7.5 Agent 生成工作流
你可以让 Agent 为你生成 Workflows！这在手动与 Agent 完成一系列步骤后特别有效，Agent 可以使用对话历史创建工作流。
📝 限制
每个 Workflow 文件限制为 12,000 字符。
八、🛠️ Agent Skills（技能）
Skills 是扩展 Agent 能力的开放标准（agentskills.io）。每个 Skill 是一个包含 SKILL.md 文件的文件夹，包含 Agent 在特定任务时可遵循的指令。
8.1 Skills 是什么
Skills 是可复用的知识包，包含：
- 处理特定类型任务的指令
- 要遵循的最佳实践和约定
- Agent 可使用的可选脚本和资源
8.2 Skills 位置
| 位置 | 作用范围 |
|---|---|
<workspace-root>/.agent/skills/<skill-folder>/ | 工作区特定 |
~/.gemini/antigravity/skills/<skill-folder>/ | 全局（所有工作区） |
8.3 创建 Skill
- 在 skill 目录中创建文件夹
- 在该文件夹中添加
SKILL.md文件
.agent/skills/
└─── my-skill/
└─── SKILL.mdSKILL.md 格式
---
name: my-skill
description: Helps with a specific task. Use when you need to do X or Y.
---
# My Skill
Detailed instructions for the agent go here.
## When to use this skill
- Use this when...
- This is helpful for...
## How to use it
Step-by-step guidance, conventions, and patterns the agent should follow.Frontmatter 字段
| 字段 | 必需 | 说明 |
|---|---|---|
name | 否 | Skill 的唯一标识（小写，用连字符分隔），默认为文件夹名 |
description | 是 | 清晰描述 Skill 功能和使用场景，这是 Agent 决定是否应用的依据 |
8.4 Skill 文件夹结构
.agent/skills/my-skill/
├─── SKILL.md # 主要指令（必需）
├─── scripts/ # 辅助脚本（可选）
├─── examples/ # 参考实现（可选）
└─── resources/ # 模板和其他资源（可选）8.5 Agent 如何使用 Skills
Skills 遵循渐进披露模式：
- 发现：对话开始时，Agent 看到可用 Skills 列表及其名称和描述
- 激活：如果某个 Skill 与任务相关，Agent 读取完整的
SKILL.md内容 - 执行：Agent 在工作时遵循 Skill 的指令
8.6 最佳实践
| 实践 | 说明 |
|---|---|
| 保持 Skills 聚焦 | 每个 Skill 应该只做一件事 |
| 写清晰的描述 | 描述是 Agent 决定是否使用的依据 |
| 脚本作为黑盒 | 鼓励 Agent 先用 --help 运行脚本而不是阅读源码 |
| 包含决策树 | 对于复杂 Skills，添加帮助 Agent 根据情况选择正确方法的章节 |
九、📊 Task Groups（任务组）
当 Agent 处于 Planning 模式时，大型复杂任务通过 Task Groups 处理，将问题分解为更小、更易管理的工作单元。
9.1 结构
顶部组件：
- 指定此任务的总体目标
- 总结工作单元内的变更
- 已编辑文件列表，点击文件可查看变更后的状态
子任务：
- Agent 识别有助于模块化必要变更的子任务
- 默认情况下详情不直接展示，可通过切换展开查看步骤
9.2 待处理步骤
有时会在进度更新中创建待处理步骤（如浏览器设置或需要批准的终端命令）。Agent 会在任务组末尾提供特殊部分供审核。
十、📋 Artifacts 系统
Artifacts 是 Agent 创建的任何内容，用于完成工作或向用户传达其工作和思考。这是 Antigravity 的核心创新。
10.1 Artifacts 类型
| 类型 | 说明 |
|---|---|
| Task List | 任务列表，用于追踪进度的 Markdown 列表 |
| Implementation Plan | 实现计划，架构代码库变更以完成任务 |
| Walkthrough | 工作总结，完成任务实现后的变更摘要 |
| Screenshots | 屏幕截图，用于审核页面状态 |
| Browser Recordings | 浏览器录制，Agent 操作的回放 |
| Diff Views | 代码变更对比 |
| Architecture Diagrams | 架构图 |
| Images | 生成的图像 |
10.2 Artifacts 的价值
开发者 ← 审核 Artifacts ← Agent 产出
优势：
✓ 透明度：清楚了解 Agent 的思考过程
✓ 可验证：每个变更都有记录
✓ 可回溯：出问题时快速定位
✓ 协作式：可在 Artifacts 上评论反馈
✓ 异步通信：Agent 长时间运行时无需同步监控10.3 Implementation Plan 反馈
- Agent 生成计划后请求审核
- 点击 "Proceed" 继续执行
- 或在计划上添加评论提供反馈
- 通过 "Review" 按钮查看所有评论并发送消息
10.4 Walkthrough
Agent 完成任务实现后创建 Walkthrough artifacts，包含：
- 变更的简洁摘要
- 帮助用户了解代码库当前状态
- 对于浏览器任务，通常包含截图和录制
十一、🌐 Browser（浏览器）
Antigravity 可以打开、读取和控制 Chrome 浏览器，允许测试开发网站、读取互联网数据源和自动化浏览器任务。
11.1 Browser Subagent
当 Agent 想与浏览器交互时，会调用专门的浏览器子 Agent。该子 Agent：
- 运行专门优化的模型来操作页面
- 可使用点击、滚动、输入、读取控制台日志等工具
- 通过 DOM 捕获、截图或 Markdown 解析读取页面
- 可以录制视频
💡 控制指示
Agent 控制页面时会显示蓝色边框覆盖层和操作描述面板。此时用户无法与页面交互以避免干扰 Agent。
子 Agent 可以操作未聚焦的标签页，你可以自由打开其他标签页使用。
11.2 Chrome 扩展
Antigravity Browser Extension 是 Agent 访问网页所必需的。首次使用时会引导到 Chrome Web Store 安装。
功能：
- 让 Agent 能够查看和与网站交互
- 允许用户从浏览器取消当前对话
- 将焦点从 Web Agent 工作的页面切换回 Antigravity
- 与浏览器 Agent 并行工作
11.3 单独的 Chrome Profile
为了将 Antigravity Agent 与正常浏览隔离，它在单独的 Chrome profile 中运行：
- 不会共享正常浏览 profile 的 cookies 或登录信息
- 所有登录会持久化
- 如果正常 Chrome 已打开，会显示为单独的 dock 图标
- Chrome 扩展应安装在此 profile 中
可在设置的 Browser 部分修改 profile 位置。
11.4 允许列表 / 拒绝列表
浏览器使用两层安全系统控制可访问的 URL：
| 列表 | 说明 |
|---|---|
| Denylist | 通过 Google Superroots BadUrlsChecker 服务拒绝危险/恶意 URL |
| Allowlist | 本地文本文件，显式信任特定 URL |
⚠️ 默认行为
- 如果拒绝列表服务器不可用，默认拒绝访问
- 允许列表初始只包含 localhost
- 访问未允许的 URL 时会提示 "always allow" 按钮
- 拒绝列表始终优先：无法将拒绝列表中的 URL 加入允许列表
十二、🔐 Secure Mode（安全模式）
Secure Mode 为 Agent 提供增强的安全控制，限制其对外部资源和敏感操作的访问。
12.1 功能
浏览器 URL 允许/拒绝列表
启用 Secure Mode 时：
- 外部 Markdown 图像：Agent 只渲染允许的 URL 图像
- 读取 URL 工具：只对允许的 URL 自动执行
终端、浏览器和 Artifact 审核策略
| 设置 | 值 |
|---|---|
| 终端自动执行 | Request Review（终端允许列表被忽略） |
| 浏览器 JavaScript 执行 | Request Review |
| Artifact 审核 | Request Review |
文件系统访问
| 限制 | 说明 |
|---|---|
| Respect .gitignore | Agent 遵守 .gitignore 规则 |
| 工作区隔离 | 禁用工作区外文件访问 |
十三、🔌 MCP 集成
Antigravity 支持 Model Context Protocol (MCP)，这是一个允许编辑器安全连接本地工具、数据库和外部服务的标准。
13.1 什么是 MCP
MCP 充当 Antigravity 和更广泛开发环境之间的桥梁。无需手动粘贴上下文（如数据库架构或日志），MCP 允许 Antigravity 在需要时直接获取信息。
13.2 核心功能
| 功能 | 说明 | 示例 |
|---|---|---|
| Context Resources | AI 可读取连接的 MCP 服务器数据 | 编写 SQL 查询时检查实时 Neon 或 Supabase 架构 |
| Custom Tools | MCP 让 Antigravity 可执行特定安全操作 | "为此 TODO 创建 Linear issue" |
13.3 如何连接
- 访问 Store：通过 Editor 侧边栏 "..." 下拉菜单打开 MCP Store 面板
- 浏览和安装：从列表选择服务器并点击 Install
- 认证：按屏幕提示安全链接账户
13.4 连接自定义 MCP 服务器
- 通过 "..." 下拉菜单打开 MCP store
- 点击 "Manage MCP Servers"
- 点击 "View raw config"
- 修改 mcp_config.json 配置自定义服务器
13.5 支持的服务器
展开查看完整列表
- Airweave
- AlloyDB for PostgreSQL
- Atlassian
- BigQuery
- Cloud SQL for PostgreSQL
- Cloud SQL for MySQL
- Cloud SQL for SQL Server
- Dart
- Dataplex
- Figma Dev Mode MCP
- Firebase
- GitHub
- Harness
- Heroku
- Linear
- Locofy
- Looker
- MCP Toolbox for Databases
- MongoDB
- Neon
- Netlify
- Notion
- PayPal
- Perplexity Ask
- Pinecone
- Prisma
- Redis
- Sequential Thinking
- SonarQube
- Spanner
- Stripe
- Supabase
十四、✏️ Editor（编辑器）
Editor 是 Antigravity 的主要入口，基于 VS Code 代码库，充满丰富的 AI 功能。
14.1 核心功能
| 功能 | 说明 |
|---|---|
| 文件编辑 | 打开、切换、编辑文件 |
| Tab 补全 | 智能代码补全 |
| 内联命令 | 快速插入代码 |
| Agent 侧边栏 | 与 Agent 协作 |
| 源代码控制 | 审核变更、提交代码 |
| 扩展支持 | 通过 Open VSX 市场下载扩展 |
14.2 Tab 与导航
Supercomplete
在当前光标位置附近提供代码建议：
- 可修改整个文档的代码
- 按
Tab接受建议
Tab-to-Jump
流畅的导航工具，建议文档中下一个逻辑编辑位置：
- "Tab to jump" 图标提示移动光标位置
- 按
Tab立即跳转
Tab-to-Import
处理缺失依赖：
- 如果输入未导入的类或函数，Antigravity 建议导入
- 按
Tab完成单词并立即添加导入语句
Tab 设置
| 设置 | 说明 |
|---|---|
| Enable/Disable Features | 可单独关闭 Autocomplete、Tab-to-Jump、Supercomplete 或 Tab-to-Import |
| Tab Speed | 控制建议响应速度（Slow/Default/Fast） |
| Highlight Inserted Text | 高亮通过 Tab 插入的文本 |
| Clipboard Context | 使用剪贴板内容改善补全准确性 |
| Allow Gitignored Files | 在 .gitignore 文件中启用 Tab 功能 |
14.3 Command（命令）
将自然语言能力直接带入工作流，允许请求特定的内联补全或终端命令。
使用方法：
- 触发：
Cmd + I(Mac) /Ctrl + I(Windows/Linux) - 提示：文本输入框出现在当前光标位置
- 指令：用自然语言输入请求（如 "创建一个排序此列表的函数"）
- 执行：Antigravity 直接生成内联代码供审核和接受
使用场景：
| 场景 | 示例 |
|---|---|
| 编辑器中 | "创建一个用于登录表单的 React 组件" |
| 终端中 | "查找所有监听 3000 端口的进程并终止它们" |
14.4 Agent 侧边栏
使用编辑器右侧面板直接与 Agent 工作：
- 启动新对话
- 附加图像
- 切换 Agent 模式
- 选择不同模型
底部工具栏可跟踪：
- 打开的文件变更
- 运行中的终端进程
- Artifacts
14.5 Review Changes + 源代码控制
Agent 开始在对话中编写代码后，Agent 面板底部工具栏会显示 Review Changes 部分：
- 点击打开窗格，滚动查看所有变更
- 可以在文件 diff 上评论与 Agent 沟通
- 切换到 Source Control 标签页查看变更文件、暂存/取消暂存、提交代码
十五、📱 Agent Manager
Agent Manager 提供更高层次的视图来查看 Antigravity Agent 在你指导下的工作。
15.1 核心功能
| 功能 | 说明 |
|---|---|
| 多工作区 | 同时跨多个工作区工作 |
| 多 Agent 监控 | 同时监督多个 Agent |
| 编辑器管理 | 隐藏、聚焦或关闭编辑器窗口 |
15.2 Workspaces（工作区）
打开新工作区：
- 选择左侧边栏按钮
- 选择起始文件夹
切换工作区：通过左侧边栏在工作区间切换
新建对话：从 Start Conversation 标签页选择工作区，或点击工作区名称旁的 Plus 按钮
15.3 Playground（游乐场）
Playgrounds 是独立的工作区，允许立即开始对话探索想法，无需设置新工作区开销。
创建 Playground：
- 从 Start Conversation 页面点击输入框下方的 Use Playground 按钮
- 像正常一样发送消息
持久化工作：
- 可将 Playground 内容移动到专用工作区
- 保留对话历史和创建的文件
- 点击顶部栏的移动按钮并选择文件夹
15.4 Inbox（收件箱）
一站式跟踪所有对话：
- 查看哪些对话等待批准终端命令、使用浏览器或构建实现计划
- 使用搜索栏和待处理开关过滤对话
- 选择对话直接跳转并继续
15.5 对话视图
Agent Panel 在 Agent Manager 中居中显示：
- Agent 工作进展时可跟随查看
- 点击 "Following" 按钮关闭跟随模式
15.6 Browser Subagent 视图
Manager 有专门的侧边面板展开检查 Agent 的任务工作：
- 所有子 Agent 操作（点击、滚动、导航等）
- 显示点击发生位置的视觉反馈
- 每步捕获的截图
- 可点击按钮查看特定时刻的截图和交互
15.7 Panes（窗格）
可在 Manager 中直接打开文件、artifacts、knowledge items 等内容：
- 打开快速选择器（
Cmd + P/Ctrl + P）选择资源 - 或在对话标题中点击 "+"
- 窗格可调整大小、分割和拖放
使用 Cmd + Click 或 Cmd + Enter (Mac) / Ctrl + Click / Ctrl + Enter (非 Mac) 在新窗格中打开内容。
15.8 Changes Sidebar
Changes Sidebar 提供快速查看 Agent 创建的 artifacts 和修改的文件：
- 点击资源在窗格中打开内容
- 图标指示自上次审核以来是否有新变更
15.9 Terminal
Agent Manager 窗口有终端支持：
- 使用
Cmd/Ctrl + J打开底部窗格 - 终端附加到当前对话所在的工作区
⚠️ 注意
- Agent Manager 窗口的终端集成仅适用于本地工作区
- Agent 使用的终端在 Editor 窗口中运行
15.10 Files
在 Manager 中打开文件窗格时，可以为 Agent 留下评论以突出特定点。
十六、📚 Knowledge Items（知识项）
Knowledge Items 是 Antigravity 的持久化记忆系统，自动捕获和组织编码会话中的重要洞察、模式和解决方案。
16.1 什么是 Knowledge Item
每个 Knowledge Item 是特定主题的相关信息集合，包含：
| 组成部分 | 说明 |
|---|---|
| Title | 描述内容的标题和摘要 |
| Artifacts | 提供主题信息的集合（文档、代码示例、持久化记忆） |
16.2 如何生成
当与 Agent 交互时，Antigravity 自动分析对话并提取信息，用于创建新 KI 或更新现有 KI。
16.3 如何使用
- 所有 KI 的摘要对 Agent 可用
- 当 Agent 识别到相关 KI 时，会自动研究其 artifacts
- 将适用信息应用到当前对话
16.4 查看 Knowledge Items
在 Antigravity Agent Manager 中查看。
16.5 使用场景
| 场景 | KI 如何帮助 |
|---|---|
| 代码规范 | 记住团队的编码风格和约定 |
| 项目架构 | 积累项目结构和设计决策 |
| 常见问题 | 保存已解决问题的方案 |
| 用户偏好 | 记住你喜欢的技术栈和工具 |
| API 用法 | 积累常用 API 的使用模式 |
十七、💰 定价与配额
17.1 所有计划包含
- 使用 Gemini 3 Pro、Gemini 3 Flash 和其他 Vertex Model Garden 模型作为核心 Agent 模型
- 无限 Tab 补全
- 无限 Command 请求
- 所有产品功能，如 Agent Manager 和 Browser 集成
17.2 配额级别
| 计划 | 配额刷新 | 周限制 |
|---|---|---|
| Google AI Ultra / Workspace AI Ultra for Business | 每 5 小时（最高、最慷慨） | 无 |
| Google AI Pro | 每 5 小时（高、慷慨） | 更高 |
| 无 Google AI 计划 | 每周（有意义） | 有 |
💡 配额说明
这些速率限制主要基于容量确定，用于防止滥用。配额与 Agent 完成的工作量相关，每个提示可能不同。简单任务可获得更多提示，复杂任务则相反。
17.3 不支持的功能
- 自带密钥或端点以获取额外限制
- 通用可用性或合同形式的组织级别层
十八、🌍 地区可用性
Google Antigravity 目前在以下地区可用：
⚠️ 重要提示
请检查 Google 服务条款 页面上列出的国家。如果国家不正确，可以提交请求更改关联地区。
🌎 美洲
American Samoa, Anguilla, Antigua and Barbuda, Argentina, Aruba, The Bahamas, Barbados, Belize, Bermuda, Bolivia, Brazil, British Virgin Islands, Canada, Caribbean Netherlands, Cayman Islands, Chile, Colombia, Costa Rica, Curaçao, Dominica, Dominican Republic, Ecuador, El Salvador, Falkland Islands, Greenland, Grenada, Guatemala, Guyana, Haiti, Honduras, Jamaica, Mexico, Montserrat, Nicaragua, Panama, Paraguay, Peru, Puerto Rico, Saint Barthélemy, Saint Kitts and Nevis, Saint Lucia, Saint Pierre and Miquelon, Saint Vincent and the Grenadines, South Georgia and the South Sandwich Islands, Suriname, Trinidad and Tobago, Turks and Caicos Islands, United States, Uruguay, U.S. Virgin Islands, Venezuela
🌍 欧洲
Albania, Armenia, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Faroe Islands, Finland, France, Germany, Gibraltar, Greece, Guernsey, Hungary, Iceland, Ireland, Isle of Man, Italy, Jersey, Kosovo, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Montenegro, Netherlands, North Macedonia, Norway, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Ukrainian territories (other than Crimea, DNR, LNR), United Kingdom
🌍 非洲
Algeria, Angola, Benin, Botswana, Burkina Faso, Burundi, Cabo Verde, Cameroon, Central African Republic, Chad, Comoros, Côte d'Ivoire, Democratic Republic of the Congo, Djibouti, Egypt, Equatorial Guinea, Eritrea, Eswatini, Ethiopia, Gabon, The Gambia, Ghana, Guinea, Guinea-Bissau, Kenya, Lesotho, Liberia, Libya, Madagascar, Malawi, Mali, Mauritania, Mauritius, Morocco, Mozambique, Namibia, Niger, Nigeria, Republic of the Congo, Rwanda, Saint Helena, Ascension and Tristan da Cunha, São Tomé and Príncipe, Senegal, Seychelles, Sierra Leone, Somalia, South Africa, South Sudan, Sudan, Tanzania, Togo, Tunisia, Uganda, Western Sahara, Zambia, Zimbabwe
🌏 亚洲
Azerbaijan, Bahrain, Bangladesh, Bhutan, British Indian Ocean Territory, Brunei, Cambodia, Christmas Island, Cocos (Keeling) Islands, Georgia, India, Indonesia, Iraq, Israel, Japan, Jordan, Kazakhstan, Kuwait, Kyrgyzstan, Laos, Lebanon, Malaysia, Maldives, Mongolia, Nepal, Oman, Pakistan, Palestine, Philippines, Qatar, Saudi Arabia, Singapore, South Korea, Sri Lanka, Taiwan, Tajikistan, Thailand, Timor-Leste, Türkiye, Turkmenistan, United Arab Emirates, Uzbekistan, Vietnam, Yemen
🌏 大洋洲
Australia, Cook Islands, Fiji, Guam, Heard Island and McDonald Islands, Kiribati, Marshall Islands, Micronesia, Nauru, New Caledonia, New Zealand, Niue, Norfolk Island, Northern Mariana Islands, Palau, Papua New Guinea, Pitcairn Islands, Samoa, Solomon Islands, Tokelau, Tonga, Tuvalu, United States Minor Outlying Islands, Vanuatu, Wallis and Futuna
🇦🇶 南极洲
Antarctica
十九、❓ FAQ
19.1 认证问题
为什么无法登录 Google Antigravity？
Google Antigravity 目前仅对已批准地区的个人 Google 账号可用。如果 Workspace Google 账号有问题，请尝试使用 @gmail.com 邮箱。
为什么我的年龄未验证？
Antigravity 目前不对 18 岁以下用户开放。如果满足最低年龄要求，可以验证年龄继续使用。
19.2 配额问题
为什么即使订阅了 Google One AI 计划仍不符合配额条件？
可能需要验证年龄以获得增加的配额。部分地区目前无法通过 Google One 获得升级配额（将很快修复）。
为什么即使订阅了 Google Workspace AI Ultra 仍不符合配额条件？
部分地区无法通过 Google Workspace AI Ultra 获得升级配额。
19.3 功能问题
Google Antigravity 目前是否支持 worktrees？
目前不支持。
当我的电脑进入睡眠时会发生什么？
如果 Agent 正在运行，Antigravity 会阻止电脑进入睡眠。
19.4 数据与支持
Google Antigravity 对数据收集的立场是什么？
请参阅服务条款。可以随时在设置面板中退出数据收集。
如何获得支持？
在公开预览期间，可通过 antigravity-support@google.com 获得有限支持。
二十、⚙️ 设置
通过以下方式配置 Antigravity 设置：
| 方式 | 说明 |
|---|---|
| 快捷键 | Cmd + ,（任意界面） |
| Agent Manager | Settings 标签页或齿轮图标 |
| Editor | "Settings > Open Antigravity User Settings" |
20.1 数据收集设置
"Enable Telemetry" 设置在 Settings 面板的 "Account" 部分。启用时，Antigravity 收集交互数据用于评估、开发和改进 Antigravity 及支持模型。
二十一、✅ 最佳实践
✅ 推荐做法
| 实践 | 说明 |
|---|---|
| 审核 Artifacts | 仔细检查 Agent 的计划和实现 |
| 提供精确反馈 | 在 Artifacts 上标注具体问题 |
| 善用 Workflows | 将常见流程编码为可重用工作流 |
| 分阶段确认 | PLANNING → 确认 → EXECUTION |
| 利用浏览器验证 | 让 Agent 自己测试 UI 效果 |
| 利用 Manager View | 并行管理多个 Agent 任务 |
| 开启安全模式 | 防止 Agent 自主执行潜在风险操作 |
| 使用 Skills | 为常见任务创建可复用的 Skills |
⚠️ 注意事项
| 事项 | 说明 |
|---|---|
| 仍需审核 | Agent 可能出错，关键代码需人工审核 |
| 安全意识 | 敏感操作（如部署）需谨慎确认 |
| 上下文限制 | 超大项目可能超出上下文窗口 |
| 网络依赖 | 需要稳定网络连接 |
| 预览阶段 | 目前仍是预览版，可能存在不稳定性和 bug |
| 使用配额 | 免费版有使用限制，订阅用户配额更高 |
二十二、📊 与其他工具对比
| 特性 | Antigravity | Cursor | Windsurf | GitHub Copilot |
|---|---|---|---|---|
| 范式 | Agent 优先 | AI 原生编辑器 | Agentic IDE | 辅助编码 |
| 自主性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
| 终端访问 | ✓ 自主执行 | ✓ 用户确认 | ✓ Cascade 代理 | ✗ |
| 浏览器控制 | ✓ 内置 | ✗ | ✗ | ✗ |
| 任务编排 | ✓ Manager View | ✗ | ✓ Cascade | ✗ |
| Artifacts | ✓ 可验证产出 | ✗ | ✗ | ✗ |
| 多模型 | ✓ Gemini/Claude/GPT | ✓ GPT/Claude | ✓ GPT/Claude | GPT |
| 代码库理解 | ✓ 全局上下文 | ✓ 多文件 | ✓ 深度理解 | ✓ 有限 |
| 目标用户 | 企业、大型项目 | 个人开发者 | 团队、大型代码库 | 通用 |
| 价格 | 免费预览 | 付费 | 免费/付费 | 付费 |
| 性能 | 复杂任务优 | 简单任务快 | 中等 | 即时 |
二十三、🔗 相关资源
| 资源 | 链接 |
|---|---|
| 官网 | antigravity.google |
| 下载 | antigravity.google/download |
| 文档 | antigravity.google/docs |
| 服务条款 | antigravity.google/terms |
| 支持邮箱 | antigravity-support@google.com |
二十四、🔮 展望
Antigravity 代表了 AI 编程工具的新方向：
- 从辅助到主导：AI 不再只是建议，而是主动完成任务
- 真正的自主性：Agent 可在真实环境中操作，而非仅生成文本
- 持续学习：Agent 可从知识库学习，积累经验
- 多 Agent 协作：Manager View 支持多 Agent 并行工作
- 可扩展架构：通过 Skills、Workflows、MCP 实现高度定制化
尽管目前仍是预览版，但 Antigravity 展示了"宇宙级"的潜力，是软件开发未来的重要探索。