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-CN.md