Skip to content

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

第4章 許可權與撤銷——四種預設,丟棄要小心 ​

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

一句話總結:應用的許可權用四個預設(Request Review、Default、Auto、Turbo)來選。剛開始請從 Request Review 或 Default 用起。 Review 視窗裡的丟棄會不經確認直接生效。終端裡有 /rewind,但最可靠的安全網仍然是 Git 記錄。

許可權是智慧體不經我許可就可以做的事情的範圍。比如"改資料夾裡的檔案不用問,安裝程式一定要問"這樣的約定。為什麼需要許可權,在 Claude Code 第4章裡講得更詳細(選讀)。

本指南還沒有在應用介面上實際練習過。和你的介面不同時,以你的介面為準。本章以個人 Google 帳號為準。[1]

四種許可權預設 ​

預設執行命令什麼時候用
Request Review所有命令都要許可剛開始、需要謹慎的事
Default在圍欄內不問,要出圍欄時才問熟悉之後
Auto (Preview)安全的命令自動執行,只問有風險的命令試驗功能
Turbo不設限制,全部執行幾乎不用

出處:Antigravity 官方文件(只摘錄了一部分)[2]

Turbo 沒有圍欄,可以讀寫整臺電腦。[3] 整理筆記用不著它。

修改的地方有三處。[4]

  • 所有專案:Settings → General → Global Permissions → Permission Preset
  • 單個專案:Settings → Projects
  • 當前對話:輸入框裡的許可權選擇器

專案預設跟隨全域性設定(Inherit Global),也可以給每個專案單獨設定。[5] 意思是,信得過的專案可以放寬,信不過的資料夾可以收緊。[6] 個人帳號一開始用的是哪個預設,官方文件裡沒有寫。開啟應用後請先確認一下。

理解檢查

在 Antigravity 應用的許可權預設中,不受任何限制地執行所有命令的是哪個?

圍欄與預設規則 ​

應用裡有終端圍欄(沙箱,Sandbox)。這是把智慧體執行的命令能碰到的範圍擋起來的裝置。官方文件說它預設是開著的。[7]

不過各預設不一樣。[8]

  • 開:Default、Auto
  • 關:Request Review、Turbo

圍欄開著時,命令會被這樣限制。

  • 只能用工作資料夾和臨時資料夾。
  • 不能上網。[9]
  • ~/.ssh 或 .env 這類敏感檔案(裝著密碼、金鑰的檔案)也被擋住。[10]

比如在 Default 下,智慧體想用一條從網上下載東西的命令,就得走出圍欄。這時應用會自己判斷這條命令。安全、能撤回的命令不問就繼續;有風險或撤不回的命令會停下來,徵求我的許可。[2:1]

不管哪個預設,也有一些預設規則。

  • 專案資料夾內的檔案讀寫不會詢問。外面的檔案需要許可。[11]
  • 讀取和操作網頁,預設是"詢問"。[12]
  • 規則衝突時,按 拒絕(Deny)> 詢問(Ask)> 允許(Allow)的順序決定。[13] 比如同時定了"允許讀取網頁"和"攔截這個網站",那在這個網站上就是攔截勝出。現在不用急著定規則。

對話中給過的許可可能會保留下來,所以智慧體會漸漸學會哪些動作是可以信任的。[14] 雖然方便,但請記住自己許可過什麼。

終端(agy)的預設值不一樣。 終端在寫檔案、執行命令、用網頁工具之前會詢問[15],圍欄預設是關著的。[16] 第6章會講。

理解檢查

在應用的 Default 預設和終端(agy)裡,命令圍欄(沙盒)預設是怎樣的?

撤銷 ​

請小心 Review 視窗的丟棄。「Discard unstaged changes」是丟棄還沒用 git add 放進待記錄清單的改動的按鈕。這個按鈕會不經確認直接生效,甚至把從沒記錄過的新檔案也刪掉。[17]

預設視圖裡也包含我自己改的內容(第2章)。所以按下這個按鈕,不只是智慧體改的,連我改的內容也可能消失。丟棄之前一定要看一下裡面有什麼。

最可靠的撤銷是 Git 記錄。在這一階段,也沿用 Codex 第4章的同一個習慣。

  1. 交代任務之前:用 Git 把當前狀態記錄下來。
  2. 交代任務。
  3. 在 Review 視窗用 Agent Edits,只看改動的部分。
  4. 滿意就再記錄一次,不滿意就撤回。

不會 Git 命令也沒關係。請智慧體"把現在的狀態用 Git 記錄下來"就行(這是在 Claude Code 裡確認過的方法。在 Antigravity 裡,本指南還沒有確認)。

還有別的撤銷功能,但還沒確認它們會不會連檔案也一起撤銷。

詳細說明(點選展開)
  • 終端裡有 /rewind(或 /undo),能把對話退回到之前穩定的狀態。[18] 名字和 Claude Code 的回退很像,但官方文件只說它撤銷的是"對話"。是否連檔案也一起撤銷,文件裡沒有寫。
  • 應用裡似乎也有撤銷功能。官方更新記錄裡提到,"Confirm Undo"確認視窗多了一個只撤銷對話的選項。[19] 不過沒有找到講解用法的文件,本指南也沒能在應用裡確認。

理解檢查

點選 Review 視窗裡的 Discard unstaged changes 時,為什麼要小心?

親自動手試試 ​

  1. 在 Settings → General → Global Permissions 裡確認當前的預設。如果是第一次,就用 Request Review 或 Default。
  2. 用 Git 把整理工具資料夾當前的狀態記錄下來。
  3. 請它在第2章的會議記錄"最上面加一行'撰寫日期:今天的日期'"。
  4. 在 Review 視窗用 Agent Edits 檢視,確認改動過的那一行。

連續任務:第5章要看計劃(/plan)、定時(/schedule、Automations)、瀏覽器(/browser)、目標(/goal)。

小結 ​

  • 應用許可權有四個預設。剛開始用 Request Review 或 Default,不要用 Turbo。
  • 應用的圍欄在 Default、Auto 預設裡是開的,會擋住網路。終端預設是關的。
  • 專案資料夾裡的檔案不問,外面的和網頁要問。
  • Review 視窗的丟棄不經確認直接刪除。交代任務之前先用 Git 記錄一下。

術語解釋 ​

術語中文名稱一句話解釋
Permission preset許可權預設一次性定好許可權的組合
Sandbox沙箱限制命令能動範圍的圍欄
Discard丟棄把改動的內容扔掉
/rewind回退在終端裡把對話退回之前狀態的命令

這一章讀完了嗎?

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

下一章:第5章. 計劃、定時、瀏覽器、目標

參考資料(20 則)
  1. 本章依據 2026年11月1日確認的 Antigravity 官方文件寫成。本指南還沒有在應用介面上實際練習過。公司、企業帳號的許可權介面不同。[20] ↩︎

  2. Antigravity 官方文件,「Agent settings」。"Request Review (“Every command requires approval.”): The sandbox is off and every terminal command requires approval." / "Default (“Ask before sensitive operations.”): Commands run without prompting inside the Terminal sandbox; running outside the sandbox requires approval." / "When a command needs to run outside the sandbox, Antigravity automatically evaluates it so safe, reversible commands proceed without prompting while risky or irreversible actions still pause for your approval." antigravity.google (確認日期 2026-11-01) ↩︎

  3. Antigravity 官方文件,「Agent settings」。"Turbo (“Run all commands without restrictions.”): All commands run without prompting with no isolation or restrictions, and the agent has full read and write access to your filesystem." antigravity.google (確認日期 2026-11-01) ↩︎

  4. Antigravity 官方文件,「Agent settings」。"For all projects: Open Settings > General > Global Permissions > Permission Preset." / "From the message box (v2.23.0+): Choose a preset from the permissions picker." / "For a single project: Override the global preset under Settings > Projects. Projects default to Inherit Global, which follows your global preset." antigravity.google (確認日期 2026-11-01) ↩︎

  5. Antigravity 官方文件,「Agent settings」。"Projects default to Inherit Global, which follows your global preset." antigravity.google (確認日期 2026-11-01) ↩︎

  6. Antigravity 官方文件,「Antigravity features」。"This means you can have a more permissive setting for a trusted project and a more restrictive security setting for an untrusted folder." antigravity.google (確認日期 2026-11-01) ↩︎

  7. Antigravity 官方文件,「Terminal sandbox」。"Antigravity includes a terminal sandbox, enabled by default, that isolates shell commands executed by agents." antigravity.google (確認日期 2026-11-01) ↩︎

  8. Antigravity 官方文件,「Terminal sandbox」。"| Default | On | Allowed in sandbox; ask outside |" / "| Turbo | Off | Allowed without prompting, unrestricted |" antigravity.google (確認日期 2026-11-01) ↩︎

  9. Antigravity 官方文件,「Agent permissions」。"Default (“Ask before sensitive operations.”): Terminal commands run inside the isolated Terminal sandbox with access restricted to your workspace and temp directories and no network access." antigravity.google (確認日期 2026-11-01) ↩︎

  10. Antigravity 官方文件,「Terminal sandbox」。"Sensitive files such as ~/.ssh and .env are blocked, anything not explicitly mounted is invisible inside the sandbox, and network access is limited to domains you’ve approved." antigravity.google (確認日期 2026-11-01) ↩︎

  11. Antigravity 官方文件,「Agent permissions」。"Workspace files: Reading and writing files inside your active project directory is allowed without prompting, while non-workspace files require approval." antigravity.google (確認日期 2026-11-01) ↩︎

  12. Antigravity 官方文件,「Agent permissions」。"Web browsing defaults to Ask: Actions for read_url and execute_url default to Ask." antigravity.google (確認日期 2026-11-01) ↩︎

  13. Antigravity 官方文件,「Agent permissions」。"Precedence rule: Conflicting rules are strictly evaluated in priority order: Deny > Ask > Allow." antigravity.google (確認日期 2026-11-01) ↩︎

  14. Antigravity 官方文件,「Antigravity features」。"Permissions manually granted during a conversation can persist, allowing the agent to learn trusted actions over time." antigravity.google (確認日期 2026-11-01) ↩︎

  15. Antigravity 官方文件,「Antigravity features」。"The default request-review permission asks before the agent writes files, runs shell commands, or uses web tools, unless one of your allow rules matches." antigravity.google (確認日期 2026-11-01) ↩︎

  16. Antigravity 官方文件,「Antigravity features」。"The terminal sandbox is off by default." antigravity.google (確認日期 2026-11-01) ↩︎

  17. Antigravity 官方文件,「Review changes」。"Discard unstaged changes takes effect immediately, without asking you to confirm. It also deletes untracked files from disk." antigravity.google (確認日期 2026-11-01) ↩︎

  18. Antigravity 官方文件,「CLI best practices」。"Type /rewind (or /undo) to roll back your conversation thread to a previous stable checkout." antigravity.google (確認日期 2026-11-01) ↩︎

  19. Antigravity 官方文件,「Changelog」。"The Confirm Undo dialog now offers an option to revert only the conversation." antigravity.google (確認日期 2026-11-01) ↩︎

  20. Antigravity 官方文件,「Agent settings」。"Business and enterprise accounts use the following settings instead of the permission presets above." antigravity.google (確認日期 2026-11-01) ↩︎