giip

Windows + Antigravity 設置指南

引導您如何在 Windows 環境中安裝 Antigravity 代理,並通過 GIIP 平台遠端執行 AI 驅動的維運操作。

📋 概述

Antigravity 是一款與 GIIP 平台聯動的自主代理,可以直接在 Windows 伺服器內修改代碼或更改系統配置。通過本指南,您可以啟用該代理並配置安全連接。

🛠️ 安裝與設置步驟

1. 下載代理

從 GIIP 平台的 [代理管理] 頁面或官方倉庫下載

giipAgentWin.zip
文件。

2. 頒發並設置 API 密鑰

  1. 在 [帳戶設置] > [API Keys] 菜單中頒發一個新的代理密鑰。
  2. 打開下載資料夾中的
    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 圖示未變為綠色
config.json
中的
apiKey
serverUrl
值輸入錯誤
重新開啟
config.json
核對數值,必要時在 [API Keys] 中重新頒發密鑰
執行
.\install_service.ps1
時出現「無法載入指令碼」錯誤
PowerShell 執行原則 (ExecutionPolicy) 受限在管理員權限的 PowerShell 中執行
Set-ExecutionPolicy -Scope Process Bypass
後重試
執行
.\giipAgentWin.exe start
時認證失敗
API 密鑰已過期或無效在 [帳戶設置] > [API Keys] 中重新頒發密鑰並更新
config.json
代理啟動時出現設定檔解析錯誤
config.json
的 JSON 格式損壞(缺少引號、逗號等)
驗證並修正
config.json
的 JSON 語法

版本: 1.0 最後更新: 2026-03-19 源文件:

giipv3/public/help/agent-setup-win-antigravity.zh-TW.md