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 · 第一次安全執行