Antigravity 使用指南
Antigravity 是 Google DeepMind 开发的强大 AI 代理编程助手，能够理解整个项目上下文，通过自然语言对话帮你创建、编辑和重构代码。
🌟 核心特性
- 项目级理解 - 自动分析整个项目结构和依赖关系
- 自然语言交互 - 用人话描述需求，AI 帮你写代码
- 多文件操作 - 一次对话可以创建/修改多个文件
- 智能重构 - 理解代码架构，安全地进行大规模重构
- 上下文引用 - 使用
@符号引用文件、目录等
⚙️ 配置项目规范
为了让 Antigravity 更好地理解你的项目并遵循项目规范，有以下几种配置方法。
重要说明
Antigravity 使用 Google Gemini 的后端服务，本身没有独立的设置界面。配置需要通过 Gemini Web 界面或使用项目级配置。
方法 1: 通过 Gemini Web 配置（全局生效）
如果你有 Google Gemini 的 Web 访问权限，可以在那里配置 Memory：
- 访问 Gemini Web: 打开 gemini.google.com
- 打开设置: 点击右上角的设置图标 ⚙️
- 找到 Memory 选项: 在设置中找到 "Memory" 或 "Custom Instructions"
- 添加项目规范: 粘贴项目规范内容
配置示例：
项目名称: OmniStack
项目类型: VuePress 2.x 知识库
项目路径: /Users/dragon/DevCode/GitHub/sofos-wiki
文档规范:
1. 所有 Markdown 必须包含 frontmatter (title, date, category, tag)
2. 正文从 H2 开始，标题前后有空行
3. 代码块必须指定语言
配置规范:
1. CommonJS 格式，2 空格缩进，单引号
2. 更新 sidebar 时同步更新 navbar
详细规范: docs/ai/agents/AGENTS.md注意
通过 Gemini Web 配置的 Memory 会在所有使用 Gemini 的地方生效，包括 Antigravity。
方法 2: 创建项目级配置文件（推荐）
在项目根目录创建 .gemini/instructions.md 文件作为引导：
# 创建配置目录和文件
mkdir -p .gemini
cat > .gemini/instructions.md << 'EOF'
# OmniStack 项目 - Gemini 配置
完整规范请参考: docs/ai/agents/AGENTS.md
在对话中引用:
@docs/ai/agents/AGENTS.md 请遵循项目规范
EOF为什么这样做？
- ✅ 避免重复内容，规范只在
AGENTS.md中维护 - ✅
.gemini/instructions.md只作为引导文件 - ✅ 保持单一真相来源（Single Source of Truth）
然后在对话开始时引用完整规范：
@docs/ai/agents/AGENTS.md 请遵循项目规范或者先引用引导文件：
@.gemini/instructions.md方法 3: 在对话中直接引用（临时）
在每次需要时直接引用规范文档：
@docs/ai/agents/AGENTS.md 请按照这个规范帮我创建文档推荐做法
- 方法 1（全局）：适合个人项目，配置一次全局生效
- 方法 2（项目级）：适合团队协作，规范跟随项目
- 方法 3（临时）：适合临时需求或测试
验证配置是否生效
询问 Antigravity：
这个项目使用什么技术栈？文档规范是什么？期望回答：
- 技术栈：VuePress 2.x、Vue 3、Vite、vuepress-theme-hope
- 文档规范：包含 frontmatter、从 H2 开始、标题前后有空行等
如果回答正确，说明规范已生效。
🚀 快速开始
1. 打开项目
在 Antigravity 中打开你的工作目录（例如当前项目）：
# 方式一：从命令行启动（如果支持）
antigravity /path/to/your/project
# 方式二：在 UI 中打开文件夹
File > Open Folder > 选择项目目录2. 开始对话
打开项目后，你就可以开始与 Antigravity 对话了。
示例对话：
你：我想创建一个 GUIDE.md 文件，介绍这个项目的使用方法
Antigravity 会自动：
- 分析项目结构
- 创建
GUIDE.md文件 - 填充相关内容
💡 核心功能详解
创建文件
基础创建：
你：在 docs/guide/ 目录下创建一个 setup.md 文件指定内容创建：
你：创建一个 config.yaml，包含数据库配置，使用 PostgreSQL批量创建：
你：创建一个 Vue 组件，包含 .vue、.js 和 .css 文件编辑文件
简单修改：
你：在 @package.json 中添加 axios 依赖复杂重构：
你：把 @src/utils/helper.js 中的函数改成 TypeScript，
并添加类型定义引用上下文 (@mention)
使用 @ 符号告诉 AI 你在谈论什么：
| 引用类型 | 语法 | 示例 |
|---|---|---|
| 文件 | @filename | @README.md |
| 目录 | @dirname/ | @src/components/ |
| 代码块 | @file:line-range | @app.js:10-20 |
| 技术栈 | 直接提及 | "使用 Vue 3" |
示例：
你：参考 @docs/api/example.md 的格式，
为 @src/services/user.js 创建 API 文档项目级操作
初始化项目：
你：创建一个 Express + MongoDB 的项目结构重构架构：
你：把所有的 API 路由从 @app.js 中提取到
@routes/ 目录下，按功能模块分文件批量修改：
你：把项目中所有的 console.log 改成使用
winston 日志库🎯 最佳实践
1. 明确描述需求
❌ 不好的提问：
创建一个组件✅ 好的提问：
创建一个 Vue 3 Composition API 的用户卡片组件，
包含头像、姓名、邮箱，支持点击事件2. 充分使用上下文
❌ 缺少上下文：
添加一个新功能✅ 提供上下文：
参考 @src/components/ProductCard.vue 的样式，
在 @src/components/UserCard.vue 中添加相似的悬停效果3. 分步骤操作
对于复杂任务，分成多个步骤：
步骤 1: 先创建数据库模型
步骤 2: 然后创建 API 路由
步骤 3: 最后创建前端组件4. 验证结果
创建/修改文件后，检查一下：
你：检查一下 @config/database.js 的配置是否正确🔧 高级技巧
1. 工作流自动化
如果你的项目有 .agent/workflows/ 目录，可以创建自定义工作流：
你：创建一个 workflow，用于自动化部署流程2. 模板复用
你：根据 @templates/component.vue 模板，
创建一个新的 Dashboard 组件3. 代码审查
你：审查 @src/utils/validator.js，
找出可能的性能问题和安全隐患4. 文档生成
你：为 @src/api/ 目录下的所有文件生成 API 文档📂 项目管理示例
创建新项目
你：创建一个 VuePress 博客项目，包含：
1. 基础配置文件
2. 默认主题
3. 示例文章
4. README 文档重构现有项目
你：把这个项目从 JavaScript 迁移到 TypeScript，
保持所有功能不变添加新功能
你：在这个博客项目中添加评论功能，
使用 @docs/guide/features.md 中提到的 Waline🆚 与其他工具对比
| 特性 | Antigravity | Cursor | VSCode |
|---|---|---|---|
| 项目理解 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 多文件操作 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 自然语言 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 代码补全 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 学习曲线 | 简单 | 简单 | 中等 |
💡 详细对比请查看：工具对比分析
❓ 常见问题
Q1: Antigravity 能理解多大的项目？
A: Antigravity 可以处理几千个文件的项目，但会优先理解你 @mention 的部分。
Q2: 如何提高响应准确度？
A:
- 使用 @mention 明确指定文件
- 提供清晰的需求描述
- 对于复杂任务，分步骤进行
Q3: 如何撤销 AI 的修改？
A: 使用 Git 版本控制：
git diff # 查看修改
git checkout . # 撤销所有修改
git checkout file # 撤销单个文件Q4: 支持哪些编程语言？
A: 支持几乎所有主流语言：JavaScript/TypeScript、Python、Java、Go、Rust、C++、PHP、Ruby 等。
Q5: 如何创建特定格式的文件？
A: 明确说明格式要求：
你：创建一个 markdown 文档，使用 VuePress 的 frontmatter 格式，
包含 title、date、category 字段🔗 相关资源
下一步：查看 工具对比，了解如何根据场景选择合适的工具。