02 · 第一次安全运行 · AI 编程教程中文版

第一次打开 Antigravity，最重要的不是马上让它写功能，而是验证“它在你的机器上能被安全地控制”。先核对安装来源和系统要求，再跑只读、单文件小改、浏览器验收和回退检查。这个顺序比一上来打开真实生产仓靠谱得多。

第一天目标：确认 Antigravity 能启动、能登录、能在 workspace 内读项目、能按权限请求命令、能生成 diff、能用浏览器留下验收证据，并且能撤销小改动。

1. 第一天路线

flowchart LR
    Download["官方下载"] --> Check["系统要求检查"]
    Check --> Install["安装登录"]
    Install --> Policy["Review-first 设置"]
    Policy --> Workspace["测试 workspace"]
    Workspace --> ReadOnly["只读分析"]
    ReadOnly --> OneFile["单文件小改"]
    OneFile --> Browser["浏览器验收"]
    Browser --> Review["看 diff / artifacts"]
    Review --> Undo["验证回退"]

不要跳过只读分析。只读是你观察 agent 行为的最低风险方式。

2. 安装和登录

按官方路径从 Antigravity 下载页安装，不要用网盘包、镜像站或别人转发的安装器。Antigravity 会接触本地代码、终端和浏览器，安装包来源必须干净。

官方 Getting Started 文档当前列出的平台要求：

平台	官方要求	第一次判断
macOS	Apple 仍提供安全更新的 macOS 版本；通常是当前和前两个版本；最低 macOS 12 Monterey；不支持 x86	Apple Silicon 优先；Intel Mac 不要默认假设可用
Windows	Windows 10 64-bit	确认系统是 64 位
Linux	glibc >= 2.28，glibcxx >= 3.4.25，例如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8	先查运行库版本，再装

Linux 可以先查：

ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'

首次 setup 建议：

设置	第一天建议
导入 VS Code / Cursor 设置	fresh start
Agent 使用方式	Review-driven development
Terminal execution	Request Review
Artifact review	Asks for Review
JavaScript execution	Request Review 或 Disabled
File access	Workspace only

不要在第一天导入一堆旧扩展和旧配置。你还不知道问题来自 Antigravity、扩展、项目依赖，还是旧设置。

3. 理解第一天导航

官方 Getting Started 文档明确了基础切换方式：

从 Editor 顶部按钮打开 Agent Manager。
从 Editor 用 Cmd + E（Mac）/ Ctrl + E（Windows）打开 Agent Manager。
在 Agent Manager 中，从 workspace 下拉菜单的 Focus Editor 回到对应 Editor。
当聚焦某个 workspace 时，也可以用 Open Editor 按钮或 Cmd + E（Mac）/ Ctrl + E（Windows）回到 Editor。

Windows / Linux 用户以当前应用菜单和快捷键设置为准。第一天要记的是逻辑：Editor 负责单 workspace 的代码现场，Agent Manager 负责跨 workspace 的任务和 artifacts。

flowchart LR
    Editor["Editor<br/>单 workspace 代码现场"] -->|Top bar / Cmd+E (Mac) · Ctrl+E (Win)| Manager["Agent Manager<br/>任务与 artifacts"]
    Manager -->|Focus Editor / Open Editor| Editor

    style Editor fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Manager fill:#fef3c7,stroke:#f59e0b,stroke-width:2px

4. 建测试 workspace

第一次试用其实有两种起手方式，新手优先用前者：

方式	适合	怎么进
Playground（推荐第一天用）	只想试一个想法、对比两个 prompt、做一次只读分析；不想 setup 项目	Start Conversation 页点 Use Playground；做出有用产出再点 Move 搬到正式 workspace
测试 workspace（指定本地目录）	想跑完整安装→只读→改文件→浏览器验证全链路	新建一个干净目录，从 Editor `Open Folder` 或 Agent Manager 左侧 + 按钮打开

如果选测试 workspace，创建一个干净目录：

~/antigravity-lab/

里面放一个最小项目。可以是普通 HTML，也可以是小型 Python/Next.js demo。不要放：

.env
SSH key
浏览器 cookie
公司客户数据
真实生产仓库

5. 只读分析 prompt

第一条 prompt：

请只读分析当前 workspace，不要创建、修改或删除任何文件。
输出：
1. 目录结构
2. 项目类型判断
3. 如果后续要改，最小安全任务是什么
4. 你需要哪些权限才能继续

你要检查：

检查项	通过标准
没改文件	没有新增、删除、修改
有边界感	明确说需要权限才能继续
有下一步	给单文件或局部任务
没越权	没要求读 workspace 外路径

6. 单文件小改

第二条 prompt 可以这样写：

只修改首页标题文案，不要调整布局和样式。
修改后给出 diff，并说明如何手动验证。

这一步验证三件事：

它是否真的只改一个文件。
它是否生成可读 diff。
它是否乱动格式化、配置或依赖。

7. 浏览器验收

第三步再要求浏览器：

启动本地服务，打开首页，验证标题文案已变化。
请交付 screenshot 和 walkthrough。
执行任何 terminal 命令前先请求确认。

浏览器验收通过标准：

你看到了启动命令。
你批准了必要命令。
它打开的是本地页面或明确 allow 的 URL。
它留下 screenshot 或 walkthrough。
walkthrough 说明了如何复现验证。

第一天浏览器只允许 localhost 或你明确指定的官方文档页。不要让它登录真实后台、支付系统、广告后台、云控制台或生产 CMS。

8. 回退检查

Antigravity 支持任务级 undo，但真实项目仍然要看 Git diff。第一天至少做一次：

查看 diff。
尝试撤销本次修改。
确认文件回到原状态。
记录哪些动作需要人工确认。

能回退，才敢前进。不要把第一次成功改代码当成验收，把第一次成功撤销也当成验收。

9. 第一天不要做什么

不要做	原因
一上来打开生产仓	风险范围太大
打开非 workspace file access	可能读到私人和凭据文件
允许 `rm`、`ssh`、`git push`	副作用过大
登录真实后台让它点击	账号和业务风险高
同时派多个 agent	你还没建立验收习惯

10. 安装完成清单

安装不以“图标能打开”为结束。至少确认：

下载来自 antigravity.google/download。
系统满足官方平台要求。
应用能启动，并用 Google 账号完成 preview 阶段登录（或进入官方当前可用状态）。
能打开测试 workspace。
能从 Editor 切到 Agent Manager。
能从 Agent Manager 回到对应 Editor。
能完成只读 prompt 且没有修改文件。
单文件小改能产生 diff。
浏览器验收能留下 screenshot 或 walkthrough。
修改能撤销或通过 Git diff 回退。

官方来源

Google Antigravity Getting Started：官方下载入口、系统要求、更新和基础导航说明。
Google Antigravity Download：官方下载入口。
Getting Started with Google Antigravity：Google Codelab，补充安装、登录、Editor 配置、Command Line agy 和浏览器扩展流程。

02 · 第一次安全运行