Windows + Antigravity 設置指南
引導您如何在 Windows 環境中安裝 Antigravity 代理,並通過 GIIP 平台遠端執行 AI 驅動的維運操作。
📋 概述
Antigravity 是一款與 GIIP 平台聯動的自主代理,可以直接在 Windows 伺服器內修改代碼或更改系統配置。通過本指南,您可以啟用該代理並配置安全連接。
🛠️ 安裝與設置步驟
1. 下載代理
從 GIIP 平台的 [代理管理] 頁面或官方倉庫下載
giipAgentWin.zip 文件。
2. 頒發並設置 API 密鑰
- 在 [帳戶設置] > [API Keys] 菜單中頒發一個新的代理密鑰。
- 打開下載資料夾中的
文件,輸入頒發的密鑰和伺服器地址。config.json{ "apiKey": "your-api-key-here", "serverUrl": "https://api.giip.io" }
3. 運行代理並註冊服務
打開 PowerShell(管理員權限),進入代理資料夾並執行以下命令:
- 運行:
.\giipAgentWin.exe start - 註冊服務 (後台運行):
.\install_service.ps1
4. 確認平台聯動
在 GIIP 的 [伺服器詳情] 頁面上,確認該伺服器的 Agent Status 圖示是否已變為綠色。
🚀 應用場景
- 自動解決問題: 針對已註冊的問題調用
裝,分析原始碼中的錯誤並立即應用補丁。Antigravity - 強化監控: 代理收集本地系統指標並即時傳輸至平台。
🚨 安全注意事項
- 密鑰管理: 請務必妥善保管 API 密鑰,避免洩露。
- 權限限制: 建議將運行代理的 Windows 帳戶權限維持在必要的最低水平。
疑難排解
| 症狀 | 原因 | 解決 |
|---|---|---|
| [伺服器詳情] 頁面的 Agent Status 圖示未變為綠色 | 中的 或 值輸入錯誤 | 重新開啟 核對數值,必要時在 [API Keys] 中重新頒發密鑰 |
執行 時出現「無法載入指令碼」錯誤 | PowerShell 執行原則 (ExecutionPolicy) 受限 | 在管理員權限的 PowerShell 中執行 後重試 |
執行 時認證失敗 | API 密鑰已過期或無效 | 在 [帳戶設置] > [API Keys] 中重新頒發密鑰並更新 |
| 代理啟動時出現設定檔解析錯誤 | 的 JSON 格式損壞(缺少引號、逗號等) | 驗證並修正 的 JSON 語法 |
版本: 1.0 最後更新: 2026-03-19 源文件:
giipv3/public/help/agent-setup-win-antigravity.zh-TW.md