下載與基礎導航
根據 Google 官方 Getting Started 文件梳理 Antigravity 下載入口、平臺要求、更新機制，以及 Editor 與 Agent Manager 的基礎切換方式。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 下載安裝 | download | 拿到並裝好 Antigravity。 |
| 介面導航 | navigation | 找到關鍵面板入口。 |
| 首次設定 | setup | 初始登入和偏好。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你下載安裝 Antigravity 並認清主要介面入口。
你是 Antigravity 安裝導航顧問。
【角色】
Antigravity 安裝導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 我的系統：___
- 賬號 / 訂閱狀態：___
- 是否裝過類似工具：___
- 想先找到哪個功能：___
- 經驗水平：___
【工作流程】
1. 給下載安裝步驟
2. 介紹主要介面和入口
3. 完成首次登入設定
4. 排查常見安裝問題
5. 給第一步
【輸出規範】
▌一、安裝步驟
▌二、介面入口
▌三、首次設定
▌四、常見問題 + 第一步
【硬約束】
- 按我的系統給確切步驟
- 登入憑據安全處理
- 先認清入口再深入
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述安裝 Antigravity 不難，真正容易出錯的是兩個地方：系統環境不滿足官方最低要求，或者裝完以後分不清 Editor 和 Agent Manager 的切換關係。Google 官方 Getting Started 文件很短，本篇把它補成一條可執行的第一步路徑。
這一篇解決什麼問題：確認你應該從哪裡下載、目前系統是否適合安裝、更新應該怎麼處理，以及第一次進入產品後如何在 Editor 和 Agent Manager 之間來回切換。
閱讀目標：讀完本章，你應該能獨立完成官方下載安裝前檢查、第一次開啟測試 workspace，並用只讀 prompt 驗證基礎工作面。
1. 從官方下載入口開始
官方下載入口是：
https://antigravity.google/download不要從映象站、網盤包、第三方“漢化包”或別人轉發的安裝器開始。Antigravity 是本地開發工具，會接觸程式碼、終端和瀏覽器；安裝包來源必須乾淨。
安裝前先做三件事：
- 確認作業系統滿足官方最低要求。
- 關閉舊安裝器或舊版本殘留程序。
- 準備一個乾淨測試 workspace，不要第一次就開啟生產倉。
不要把下載頁面上的即時資訊寫死：版本號、安裝包名稱、可用平臺會更新。教學裡固定的是官方入口和判斷方法，不固定某一天的包名。
2. 官方平臺要求
官方 Getting Started 文件列出的可用平臺和最低要求如下。
| 平臺 | 官方要求 | 實操判斷 |
|---|---|---|
| macOS | Apple 仍提供安全更新的 macOS 版本；通常是目前和前兩個版本；最低 macOS 12 Monterey；不支援 x86 | Apple Silicon Mac 優先；Intel Mac 不要預設假設可用 |
| Windows | Windows 10 64-bit | 確認系統是 64 位，並準備常規開發工具鏈 |
| Linux | glibc >= 2.28，glibcxx >= 3.4.25，例如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8 | 先查發行版和 glibc 版本，再裝 |
Linux 使用者可以先查：
ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'如果你不確定機器是否滿足要求，不要直接用真實專案測試。先安裝到獨立環境，開啟空目錄，確認啟動、登入和基礎導航都正常。
3. 第一次安裝後的更新處理
官方文件說明：應用有可用更新時會提示使用者。也就是說，Antigravity 不是“裝完一個固定版本長期不動”的工具。
建議建立下面的更新習慣：
- 普通學習環境：跟隨自動更新。
- 生產專案環境：更新後先用測試 workspace 驗證。
- 錄課或寫教學時：標註驗證日期，不把 UI 截圖當永久事實。
- 需要停留舊版本時：後續去 Releases 頁面查舊版本，但預設不推薦長期固定舊版本。
AI 程式設計工具迭代很快。模型、許可權項、設定頁和 UI 位置都可能變。遇到教學截圖和本機不同，先以官方目前 UI 為準。
4. 先理解兩個入口：Editor 和 Agent Manager
Antigravity 有兩個第一天就會遇到的核心介面：
| 介面 | 你在這裡做什麼 |
|---|---|
| Editor | 開啟一個 workspace，讀寫程式碼、看檔案、用 Tab / Command / Agent |
| Agent Manager | 管理多個 workspace 和多個 agent 任務，檢視 conversation 與 artifacts |
官方 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。
教學要記的是邏輯：Editor 負責單 workspace 的程式碼現場，Agent Manager 負責跨 workspace 的任務管理。
flowchart LR
Editor["Editor<br/>單個 workspace"] -->|Top bar / Cmd+E (Mac) · Ctrl+E (Win)| Manager["Agent Manager<br/>任務與 artifacts"]
Manager -->|Focus Editor| Editor
Manager -->|Open Editor| Editor
style Editor fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
style Manager fill:#fef3c7,stroke:#f59e0b,stroke-width:2px深讀：為什麼第一次不要直接開啟生產倉
Antigravity 是本地 agentic development platform，它會圍繞 workspace、terminal、browser 和 artifacts 工作。第一次啟動時，你還不知道目前賬號、許可權、快捷鍵、更新狀態和 agent 預設行為是否符合預期。
用空測試目錄啟動，可以把變數壓到最小：只驗證安裝來源、系統相容、Editor 與 Agent Manager 導航、只讀 prompt 約束是否生效。確認這些基礎面正常後，再開啟真實專案會穩得多。
5. 第一次開啟應該怎麼走
第一次啟動後，不要馬上接真實專案。建議按這個順序：
- 開啟一個空測試目錄。
- 在 Editor 裡確認檔案區、終端區和 agent 面板都能顯示。
- 用頂部按鈕或
Cmd + E（Mac）/Ctrl + E（Windows）開啟 Agent Manager。 - 從 Agent Manager 裡找到目前 workspace。
- 用 Focus Editor 或 Open Editor 回到 Editor。
- 只讀讓 agent 解釋目前目錄，不允許改檔案。
第一條 prompt 可以這樣寫：
請只讀分析目前 workspace，不要建立、修改或刪除任何檔案。
請說明：
1. 你現在能看到哪些檔案或目錄。
2. 你判斷這是一個什麼專案。
3. 如果下一步要修改，應該先改哪個最小檔案。
4. 你需要哪些許可權才能繼續。這條 prompt 的目的不是得到多聰明的答案，而是確認 Antigravity 的基礎工作面正常：能讀 workspace、能響應限制、不會越權動檔案。
6. 用導航關係判斷任務應該放哪裡
分不清入口時，用下面的規則：
| 任務 | 更適合入口 |
|---|---|
| 改目前檔案、看 diff、處理區域性錯誤 | Editor |
| 同時管理多個儲存庫或多個 agent | Agent Manager |
| 追蹤一個長任務的計劃和產物 | Agent Manager |
| 看 browser screenshot、recording、walkthrough | Agent Manager 或相關 artifact |
| 手動審查程式碼細節 | Editor |
一句話：寫程式碼回 Editor，看任務和證據回 Agent Manager。
7. 安裝完成後的驗收清單
安裝不以“圖示能開啟”為結束，至少驗證下面幾項：
- 下載來自
antigravity.google/download。 - 目前系統滿足官方平臺要求。
- 應用能啟動並完成登入或進入可用狀態。
- 能開啟測試 workspace。
- 能從 Editor 切到 Agent Manager。
- 能從 Agent Manager 回到對應 Editor。
- 能完成一條只讀 prompt，且沒有修改檔案。
這些都透過後，再繼續學習 Agent、許可權、rules、skills、Browser Agent 和 artifacts。
本章自檢
完成本章後，用這 3 個問題檢查自己是否真正理解：
- 為什麼安裝包必須來自
antigravity.google/download？ - Editor 和 Agent Manager 之間應該怎樣來回切換？
- 第一條只讀 prompt 要驗證哪些基礎能力？
透過標準：你能在不接觸生產倉的情況下完成下載安裝、基礎導航和只讀工作面驗證。
官方來源
- Google Antigravity Getting Started —— 官方安裝、平臺要求、更新和基礎導航說明。
- Google Antigravity Download —— 官方下載入口，避免使用第三方安裝包。
- Google Antigravity Releases —— 官方舊版本和釋出資訊入口，用於核對版本變化。