關於這份指南的誠實聲明 以下「安裝」與「呼叫測試」的部分是在本機實際執行並確認成功的（版本 1.1.9）。 但「登入認證」畫面的部分，因為本機已經是登入狀態，沒有刻意登出重新測試整個流程 （這樣做會影響到本機正在使用中的環境），所以認證步驟是依據 CLI 的一般行為模式描述， 若實際畫面跟這裡描述的不完全一樣，請以畫面上的指示或 官方文件為準。

## 1安裝

Windows 11 內建 `winget`，開啟 PowerShell（不用系統管理員權限）執行：

    winget install Google.AntigravityCLI

安裝完成後關閉再重新開啟一個新的終端機視窗（讓 PATH 生效），確認安裝成功：

    agy --version

正常會顯示版本號，例如 `1.1.9`。

找不到 agy 指令？ winget 安裝完會把執行檔放在 `%LOCALAPPDATA%\Microsoft\WinGet\Packages\Google.AntigravityCLI_...\agy.exe`， 通常會自動加進 PATH。如果新開的終端機還是抓不到指令，執行 `agy install` 可以手動重新設定 PATH。

## 2登入認證

Antigravity CLI 目前沒有獨立的 `agy login` 或 `agy auth` 子指令（截至 1.1.9 版）。認證是跟 Google 帳號綁定的， 一般這類工具的認證方式是：

1. 第一次執行任何指令時（例如互動模式 `agy` 或非互動模式 `agy -p "你好"`），CLI 偵測到尚未登入，會自動開啟瀏覽器導向 Google 帳號登入頁面
2. 在瀏覽器裡用你的 Google 帳號完成登入、授權
3. 授權完成後回到終端機，CLI 會顯示登入成功，之後的指令就不會再要求登入

認證狀態與相關設定會存在使用者資料夾底下（本機實測觀察到的路徑，僅供參考， 不同版本可能調整）：

    %USERPROFILE%\.antigravity\
    %USERPROFILE%\.gemini\antigravity-cli\
    %USERPROFILE%\.gemini\antigravity\

如果沒有自動跳出瀏覽器 請直接查看終端機輸出的文字，通常會印出一個登入用的網址，複製貼到瀏覽器手動開啟即可。 若仍無法登入，以 官方文件 或 官方支援頁 的最新說明為準。

## 3驗證能不能正常讀圖回答

登入完成後，用一張隨便的圖片測試非互動模式（`-p` 是 `--print` 的縮寫）：

    agy -p "描述這張圖片的內容: C:\path\to\image.jpg"

如果 agy 提示需要權限才能讀取檔案，代表 headless／非互動模式下， 需要讀檔案這類動作預設會被擋下（沒有畫面可以互動確認）， 這時候加上 `--dangerously-skip-permissions` 讓它自動放行：

    agy -p "描述這張圖片的內容: C:\path\to\image.jpg" --dangerously-skip-permissions

這個旗標安全嗎？ `--dangerously-skip-permissions` 會讓 agy 自動放行所有工具權限請求， 範圍比「只允許讀檔」更廣。在 AUTOMOVIE 裡使用是可接受的，因為程式固定只會叫它 「讀一張截圖、描述內容」這一種操作，不會給它任意指令。若你要在其他場景手動使用 agy， 請自行評估這個旗標的風險。

## 4填進 AUTOMOVIE

回到 AUTOMOVIE 的「設定（AI CLI）」區塊，有兩種方式：

1. 按「🔍 自動偵測我電腦上裝了什麼」，找到 Antigravity CLI 後按「使用這個」 ——已經是驗證過能用的完整指令，直接套用即可
2. 或手動填入「AI 指令模板」欄位：

       agy -p "{prompt} 圖片路徑: {image}" --dangerously-skip-permissions

填好後按「測試」，會用一張內建的範例截圖實際呼叫一次，確認整條路徑真的通。