---
title: "用例、排障与参考"
description: "Antigravity 适合的真实用例、不适合的任务、排障顺序、反馈入口和官方参考链接。"
verifiedAt: "2026-05-05"
---

Antigravity 最适合的不是“随便帮我写点代码”，而是有明确目标、有可验收路径、需要跨 editor、terminal 和 browser 的开发任务。官方发布文给出的典型方向包括复杂多工具任务、UI 迭代和后台长任务维护。

> [!NOTE]
> **判断标准**：如果任务可以用 plan、diff、test、screenshot、browser recording 和 walkthrough 证明完成，它就更适合 Antigravity。

## 1. 适合的任务

| 任务 | 为什么适合 |
| --- | --- |
| 修复 UI bug | 可以改代码、启动服务、打开浏览器、截图/录屏验证 |
| 给已有功能补测试 | 可以读代码、生成测试、跑命令、交付结果 |
| 小到中等范围重构 | 可以先 plan，再逐步 diff review |
| 文档重组 | 可以生成 task list、批量改文件、交付 walkthrough |
| 依赖升级排障 | 可以查 terminal 输出、改配置、跑测试 |
| 多页面交互验证 | Browser Subagent 可以点击、输入、观察页面 |

## 2. 不适合直接交给 agent 的任务

| 任务 | 风险 | 更好的方式 |
| --- | --- | --- |
| 生产数据库改动 | 不可逆、影响真实用户 | 先写迁移计划，人工执行 |
| 账号后台操作 | 登录态和权限风险 | 人工操作，agent 只做只读指导 |
| 密钥轮换 | 可能泄露凭据 | 用内部 SOP，不让 agent 接触明文 |
| 大范围无边界重构 | diff 无法审完 | 拆成模块级任务 |
| 涉及付款/广告投放 | 金钱和合规风险 | 人工审批和操作 |

## 3. 排障顺序

```mermaid
flowchart TD
    Symptom["出现问题"] --> Layer{"先定位层级"}
    Layer --> Install["安装 / 登录"]
    Layer --> Workspace["Workspace / file access"]
    Layer --> Permission["Permissions / sandbox"]
    Layer --> Browser["Browser extension / URL allowlist"]
    Layer --> Model["模型 / quota / pricing"]
    Layer --> Project["项目依赖 / 测试命令"]
    Project --> Evidence["保留日志、diff、artifact"]
    Evidence --> Feedback["必要时通过应用内反馈入口报告"]
```

不要一上来重装。先判断是安装、登录、权限、浏览器、模型额度，还是项目本身的问题。

## 4. 常见症状

| 症状 | 优先检查 |
| --- | --- |
| agent 不跑命令 | Terminal Execution policy、Allow/Deny/Ask、sandbox |
| agent 看不到文件 | workspace 是否正确、file access 是否限制 |
| 浏览器任务卡住 | 浏览器扩展、URL allowlist、JavaScript policy |
| 没有 screenshot 或 recording | prompt 是否要求 browser 验收，任务是否进入 Browser Subagent |
| 修改范围太大 | prompt 边界、Planning plan、workspace 是否过宽 |
| 模型不可用 | 官方 pricing / quota / model selector |

## 5. 反馈入口

Codelab 说明可以在 Agent Manager 或 Editor 内提交 Antigravity 产品反馈。反馈前准备：

1. Antigravity 版本和系统信息。
2. workspace 类型和任务描述。
3. 权限策略设置。
4. 错误截图或 artifact。
5. 可复现步骤。
6. 不包含密钥、token、私人路径的日志。

## 6. 官方参考

- Official Site：[https://antigravity.google](https://antigravity.google)
- Documentation：[https://antigravity.google/docs](https://antigravity.google/docs)
- Use cases：[https://antigravity.google/use-cases](https://antigravity.google/use-cases)
- Download：[https://antigravity.google/download](https://antigravity.google/download)
- Google Codelab：[https://codelabs.developers.google.com/getting-started-google-antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- Developers Blog：[https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)

## 接下来去哪

<Cards>
  <Card title="从原理到实战" description="如果已经查完功能，继续按学习路线理解 Antigravity 的完整工作方式。" href="/docs/antigravity/understanding" />
  <Card title="最佳实践清单" description="上线前用一张清单复核权限、Artifacts、浏览器和团队边界。" href="/docs/antigravity/understanding" />
</Cards>
