Skip to content

本頁由 AI 根據韓語原文翻譯,可能存在錯誤。

第2章 安裝應用與第一次整理——把資料夾開啟為專案 ​

必讀 想跟著這個階段學下去,一定要讀這一章。

一句話總結:安裝 Antigravity 應用,用 Google 帳號登入,然後把整理工具資料夾作為專案開啟。 一開始用 Planning mode(先做計劃)來交代任務,讀完計劃後點 Proceed 繼續。

本指南還沒有在應用介面上實際練習過。介面上的按鈕名稱,原樣寫了官方文件裡的英文名稱。和你的介面有點不一樣也沒關係。找一個名稱相近的按鈕,跟著做就行。實際執行的結果在第3章(用終端執行)裡。[1]

安裝並登入 ​

  1. 在 antigravity.google/download 下載適合你電腦的安裝檔案。如果是 macOS,開啟 Antigravity.dmg,把它拖進 Applications 資料夾。[2]
  2. 開啟應用,點 Sign in。瀏覽器開啟後,用個人 Google 帳號登入。[3]

用量和可用的模型,由登入帳號的方案(免費、Pro、Ultra)決定(第1章)。

理解檢查

登入 Antigravity 應用的方法,哪項是對的?

把資料夾開啟為專案 ​

Antigravity 應用裡的智慧體(Agent),在專案(Projects)裡幹活。專案決定智慧體可以動哪些資料夾,以及擁有什麼許可權。[4]

  1. 點左側邊欄的 New Project 圖示(帶加號的資料夾)。[5]
  2. 用 Add Folder 選擇整理工具資料夾。不是 Git 倉庫的普通資料夾也可以。[5:1]

發出第一條指令時,要選一種工作方式。[6]

名稱作用
Local mode直接在當前資料夾裡工作
New worktree mode在單獨分出來的 Git 工作空間裡工作

出處:Antigravity 官方文件[6:1]

整理工具請選 Local mode。它直接在當前資料夾裡工作,所以結果檔案馬上就能找到。

許可權(智慧體可以做什麼)在第4章講。現在不用改設定。

詳細說明(點選展開)
  • New worktree mode 只能在 Git 倉庫裡使用。想讓複雜的工作和當前資料夾分開進行時用它。[7]
  • 新專案一開始用 Inherit Global 許可權。這是可以讀寫專案資料夾裡全部內容的狀態。[8]

理解檢查

在 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 視窗裡,只想看代理在這次對話裡改過的檔案,該選什麼?

親自動手試試 ​

  1. 安裝應用並登入。
  2. 用 New Project → Add Folder 開啟整理工具資料夾。
  3. 用 Planning mode 傳送上面的請求,讀完計劃後點 Proceed。
  4. 把生成的會議記錄和原始筆記對一對,並在 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完成報告任務做完後的整理報告

這一章讀完了嗎?

學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。

下一章:第3章. 規則與技能——不用搬運也行

參考資料(16 則)
  1. 本章依據 2026年11月1日確認的 Antigravity 官方文件寫成。本指南還沒有在應用介面上實際練習過。 ↩︎

  2. Antigravity 官方文件,「Get started」。"Open the downloaded Antigravity.dmg disk image and drag Antigravity into your Applications folder." antigravity.google (確認日期 2026-11-01) ↩︎

  3. 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) ↩︎

  4. 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) ↩︎

  5. 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) ↩︎

  6. 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) ↩︎

  7. 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) ↩︎

  8. 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) ↩︎

  9. 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) ↩︎

  10. 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) ↩︎

  11. 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) ↩︎

  12. 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) ↩︎

  13. Antigravity 官方文件,「Artifact review」。"The agent never halts for manual review and immediately proceeds with executing its plans:" antigravity.google (確認日期 2026-11-01) ↩︎

  14. 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) ↩︎

  15. 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) ↩︎

  16. 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) ↩︎