Antigravity 软件使用指南
Antigravity 是 Google Deepmind 团队开发的一款强大的代理式 AI 编程助手（Agentic AI Coding Assistant）。它不仅仅是一个聊天机器人，更是一个能够与你结对编程、规划任务、执行代码修改并验证结果的智能代理。
本文档将为您介绍 Antigravity 的安装、核心功能以及如何高效地使用它。
1. 简介
Antigravity 旨在解决复杂的编程任务。与传统的 AI 补全工具不同，Antigravity 具备"代理（Agentic）"能力，这意味着它可以：
- 主动规划：将大任务拆解为小步骤。
- 自主执行：使用终端、文件编辑器和浏览器等工具。
- 自我验证：运行测试并根据结果修复错误。
- 维护状态：通过"Artifacts（产物文档）"跟踪项目进度和上下文。
2. 安装与配置
(注：Antigravity 通常作为 IDE 插件或集成开发环境的一部分提供。)
- 获取软件：请确保您已安装支持 Antigravity 的最新版 IDE 或扩展程序。
- 环境检查 ：
- 操作系统：支持 Windows, macOS, Linux。
- 工具权限：Antigravity 需要权限访问您的文件系统、终端和（可选）浏览器以执行任务。
- 启动：在 IDE 中打开一个新的工作区（Workspace），Antigravity 将自动激活并准备好协助您。
3. 核心功能亮点
Antigravity 的强大之处在于其独特的"Agentic Mode（代理模式）"和丰富的工具集。
3.1 代理模式 (Agentic Mode)
这是 Antigravity 的核心工作流，分为三个阶段：
- PLANNING (规划) ：AI 阅读代码库，理解需求，并生成
implementation_plan.md（实施计划）。它会与用户确认计划细节。 - EXECUTION (执行)：AI 按照计划编写代码、进行重构或创建文件。它可以处理跨文件的复杂修改。
- VERIFICATION (验证)：AI 运行命令、测试或使用浏览器验证修改是否生效，并修复发现的问题。
3.2 Artifacts (智能产物)
Antigravity 会在工作过程中生成特殊的 Markdown 文档来管理任务，这些文档保存在 .gemini/antigravity/brain/ 目录下：
task.md：任务清单。实时追踪当前任务的进度（待办/进行中/已完成）。implementation_plan.md：技术设计文档。详细描述拟议的更改和验证步骤。walkthrough.md：验收文档。在任务完成后生成，展示已完成的工作和验证证据（截图/录屏）。
3.3 强大的工具箱
Antigravity 能够像人类工程师一样使用工具：
- Terminal (终端) ：可以直接运行 shell 命令（如
npm install,git status,pytest）。 - Browser (浏览器)：拥有内置浏览器代理，可以访问网页文档或在本地服务器上预览网页并进行交互测试。
- File Operations (文件操作)：支持创建、读取、大范围重构和精确的搜索替换。
4. 使用指南
4.1 启动任务
直接用自然语言告诉 Antigravity 您的目标。
示例："帮我重构登录模块，增加 OAuth2 支持，并更新相关文档。"
4.2 交互与评审
在 PLANNING 阶段，Antigravity 会生成计划。请务必：
- 仔细阅读
implementation_plan.md。 - 如果有异议，直接告诉它（例如："不要使用库 A，请使用库 B"）。
- 批准计划后，它才会进入 EXECUTION 阶段。
4.3 协助验证
在 VERIFICATION 阶段，如果涉及到 UI 调整，Antigravity 可能会请求您确认视觉效果，或者它会使用截图工具展示结果。
4.4 最佳实践
- 提供上下文：如果任务依赖特定的业务逻辑，请提前说明。
- 小步快跑：对于特别巨大的重构，建议拆分为几个独立的对话或子任务。
- 利用 Artifacts ：随时查看
task.md了解当前 AI 正在做什么，避免迷失方向。
Antigravity 致力于重新定义人机协作编程的体验，让您专注于创造，将繁琐的编码和验证交给 AI。