第2章 安裝應用與第一次整理——把資料夾開啟為專案
必讀 想跟著這個階段學下去,一定要讀這一章。一句話總結:安裝 Antigravity 應用,用 Google 帳號登入,然後把整理工具資料夾作為專案開啟。 一開始用 Planning mode(先做計劃)來交代任務,讀完計劃後點 Proceed 繼續。
本指南還沒有在應用介面上實際練習過。介面上的按鈕名稱,原樣寫了官方文件裡的英文名稱。和你的介面有點不一樣也沒關係。找一個名稱相近的按鈕,跟著做就行。實際執行的結果在第3章(用終端執行)裡。[1]
安裝並登入
- 在 antigravity.google/download 下載適合你電腦的安裝檔案。如果是 macOS,開啟
Antigravity.dmg,把它拖進 Applications 資料夾。[2] - 開啟應用,點 Sign in。瀏覽器開啟後,用個人 Google 帳號登入。[3]
用量和可用的模型,由登入帳號的方案(免費、Pro、Ultra)決定(第1章)。
理解檢查
登入 Antigravity 應用的方法,哪項是對的?
把資料夾開啟為專案
Antigravity 應用裡的智慧體(Agent),在專案(Projects)裡幹活。專案決定智慧體可以動哪些資料夾,以及擁有什麼許可權。[4]
發出第一條指令時,要選一種工作方式。[6]
| 名稱 | 作用 |
|---|---|
| Local mode | 直接在當前資料夾裡工作 |
| New worktree mode | 在單獨分出來的 Git 工作空間裡工作 |
出處:Antigravity 官方文件[6:1]
整理工具請選 Local mode。它直接在當前資料夾裡工作,所以結果檔案馬上就能找到。
許可權(智慧體可以做什麼)在第4章講。現在不用改設定。
詳細說明(點選展開)
理解檢查
在 Antigravity 應用裡開啟「整理工具」資料夾,怎麼做?
先拿到計劃,再繼續
開始新對話時,要從兩種方式裡選一種。[9]
| 名稱 | 作用 | 什麼時候用 |
|---|---|---|
| Planning mode | 先做計劃再執行 | 第一次交代的事 |
| Fast mode | 不做計劃,直接執行 | 改名字這類小事 |
出處:Antigravity 官方文件(只摘錄了一部分)[9:1]
剛開始,建議用 Planning mode。計劃書(Implementation plan)出來後讀一讀,沒問題就點對話裡或計劃書上方的 Proceed,繼續往下做。[10] 它和 Claude Code 第5章的「計劃(계획)」模式、Codex 第4章的 /plan 起同樣的作用。
任務完成後,智慧體會生成整理報告(Walkthrough),概括改了什麼。[11]
剛開始,設成 Request review(等我批准的方式)比較安全。智慧體做出計劃後會停下來,一直等到我點 Proceed。[12] 審閱方式在設定的 Agent 標籤頁裡選擇。[12:1]
詳細說明(點選展開)
另一頭的 Always proceed 不會停下,直接執行。[13] 用熟之前最好不要選它。
理解檢查
第一次交給它的事,這份指南建議用哪種方式?
交代第一次整理
傳送和前面兩個工具一樣的請求。
把 inbox/meeting-2026-10-27-weekly.txt 這份筆記整理成會議記錄,作為新檔案儲存到 notes/ 資料夾裡。想指定檔案的話,也可以輸入 @ 來選。指定檔案並不會把內容貼上進去,而是把檔案路徑傳給智慧體,需要時它再去讀那個檔案。[14]
本指南用終端(agy)運行同樣請求得到的結果,在第3章裡。應用和終端用的是同一個智慧體(第1章)。
請把結果和原件對一對。 5個待辦都搬過來了嗎?負責人和截止日期和筆記一樣嗎?有沒有編造筆記裡沒有的內容?
理解檢查
在對話方塊裡用 @ 指到某個檔案,會怎麼樣?
檢視改動內容
應用的 Review 視窗會顯示專案 Git 倉庫裡的改動。[15] 預設檢視是所有還沒有記錄的改動(Uncommitted),所以我自己改的內容也會一起顯示。選 Agent Edits,就只看這次對話裡智慧體改過的檔案。[16]
Git 是把檔案什麼時候、怎樣改動的記錄下來的工具。Review 視窗會把這些記錄和現在的檔案對比後顯示出來。所以把整理工具資料夾也做成 Git 倉庫(開啟了 Git 記錄的資料夾)會比較方便。
- 如果你跟著 Claude Code 第3章或 Codex 第2章做過,它已經是 Git 倉庫了。
- 如果還不是,也不需要懂 Git 命令。拜託智慧體「給這個資料夾開啟改動記錄(Git)」的方法,寫在 Claude Code 第3章裡(選讀)。這是在 Claude Code 裡確認過的方法,在 Antigravity 裡是否同樣可行,本指南沒能確認。
在不是 Git 的資料夾裡,Review 視窗是什麼樣子,官方文件裡沒有寫。
理解檢查
在 Review 視窗裡,只想看代理在這次對話裡改過的檔案,該選什麼?
親自動手試試
- 安裝應用並登入。
- 用 New Project → Add Folder 開啟整理工具資料夾。
- 用 Planning mode 傳送上面的請求,讀完計劃後點 Proceed。
- 把生成的會議記錄和原始筆記對一對,並在 Review 視窗裡檢視改動過的檔案。
連續任務:第3章要測試,不用搬運規則(AGENTS.md)和技能,它是否也會遵守。
小結
- 應用:Sign in → 用個人 Google 帳號登入。
- 用 New Project → Add Folder 把資料夾開啟為專案。普通資料夾也行。
- 剛開始,用 Planning mode 和 Request review,讀完計劃再 Proceed。
- Review 視窗顯示 Git 改動。用 Agent Edits 可以只看智慧體的改動。
術語解釋
| 術語 | 中文名稱 | 一句話解釋 |
|---|---|---|
| Project | 專案 | 智慧體幹活的資料夾與許可權的組合 |
| Planning mode | 計劃模式 | 先做計劃再執行的方式 |
| Implementation plan | 實施計劃 | 智慧體做出的工作計劃書 |
| Walkthrough | 完成報告 | 任務做完後的整理報告 |
這一章讀完了嗎?
學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。
參考資料(16 則)
本章依據 2026年11月1日確認的 Antigravity 官方文件寫成。本指南還沒有在應用介面上實際練習過。 ↩︎
Antigravity 官方文件,「Get started」。"Open the downloaded
Antigravity.dmgdisk image and drag Antigravity into your Applications folder." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Authenticate」。"Click Sign in to open the browser authentication flow." / "Complete the browser-based OAuth flow using your personal Google Account (Free, Pro, or Ultra plan)." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Get started」。"Agents operate within Projects, which define the repository boundaries, file scopes, and security permissions for your workspaces." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Get started」。"Click the New Project icon (folder with a plus sign) in the left sidebar." / "Click Add Folder to select one or more local Git repositories or working directories." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Get started」。"Local mode: The agent operates directly in your active folders." / "New worktree mode: The agent operates in an isolated Git worktree." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Projects」。"New worktree mode: Creates a new Git worktree for the conversation. Best for complex tasks, keeping your active working folder untouched and preventing parallel subagents from conflicting." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Projects」。"Settings: When a project is created, it starts with the Inherit Global permission preset, following your global permission settings, with read and write access to all of your project’s folders." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Artifact review」。"Planning mode: The agent plans thoroughly before executing tasks." / "Fast mode: The agent executes tasks directly without a dedicated planning phase." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Implementation plan」。"You can click Proceed either in the conversation or in the artifact header to immediately continue with the agent’s plan." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Walkthrough」。"The agent creates walkthrough artifacts when it completes task implementation. This type of artifact includes a concise summary of the changes made to remind you of what happened in the active conversation." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Artifact review」。"You can customize the review workflow in the Agent tab of the Settings pane." / "The agent always halts and requests your explicit approval before proceeding with proposed changes:" antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Artifact review」。"The agent never halts for manual review and immediately proceeds with executing its plans:" antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Mentions and quoting」。"Mentioning a file or folder doesn’t paste its contents into your prompt." / "| A file or folder | Its full path. The agent reads it when it needs to. |" antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Review changes」。"In the Antigravity App, the Review pane shows the changes in your project’s Git repository, including the agent’s edits." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Review changes」。"| Agent Edits | The files the agent modified in this conversation, whether or not they’re committed. |" / "| Uncommitted | Staged and unstaged changes in your working tree, grouped under Staged Changes and Changes. This is the default. |" antigravity.google (確認日期 2026-11-01) ↩︎