🚀 专为 Antigravity 编辑器打造：在中国也能无需 TUN 模式稳定走代理

🇬🇧 English Version | 🇷🇺 Русская версия

• 📖 项目介绍 / Introduction
• 🚨 先看这个：对话报错先排 IP / Read This First
• ⚡ Antigravity 快速开始 / Quick Start
• 🔧 故障排查自查手册 / Troubleshooting Guide
• ✨ 功能特性 / Features
• 🔧 工作原理 / How It Works
• 🛠️ 编译构建 / Build
• 📝 使用方法 / Usage
• 🐧 WSL 环境使用指南 / WSL Guide
• 🚀 进阶玩法 / Advanced Usage
• 📄 许可证 / License
• 👤 关于作者 / Author

先说结论：如果 Antigravity 的对话框里出现 Agent execution terminated due to error，请先排查代理出口 IP，不要先怀疑 DLL 没生效。

我们已经在真实现场里确认过，最容易误判的场景是：

• version.dll 已加载
• language_server_windows_x64.exe 已注入
• node.exe 也已注入
• oauth2.googleapis.com / daily-cloudcode-pa.googleapis.com 仍然可以通过 SOCKS5 正常连通
• 但 Antigravity 自己的 ls-main.log 仍然返回：
  • FAILED_PRECONDITION (code 400): User location is not supported for the API use.

这类问题的主因通常不是 DLL 失效，而是：

• 当前代理出口 IP 的国家/ASN/机房属性，被 Antigravity agent mode / Gemini CLI 路径判定为不可用
• 也就是说：“国家支持”不等于“当前这条 agent 执行链路一定接受这条出口 IP”

• <Antigravity安装目录>\\logs\\proxy-YYYYMMDD.log

如果你在这份日志里看到类似下面这些关键行，说明 DLL 本身已经在工作：

• [成功] 已注入目标进程: language_server_windows_x64.exe
• [成功] 已注入目标进程: node.exe
• SOCKS5: 隧道建立成功, 目标=oauth2.googleapis.com:443
• SOCKS5: 隧道建立成功, 目标=daily-cloudcode-pa.googleapis.com:443

在配置页开启 diagnostics.agent_ip_probe 后，DLL 会额外输出 IP 诊断日志：

• [诊断/IP] 当前代理出口探测完成: ...
• [诊断/IP] 当前代理出口呈现机房/托管特征...
• [诊断/IP] 最新 Antigravity 日志已命中 location 限制错误，同时当前代理出口呈现机房/托管特征...

• %APPDATA%\\Antigravity\\logs\\<最新时间目录>\\ls-main.log

如果你在这里看到：

• agent executor error: FAILED_PRECONDITION (code 400): User location is not supported for the API use.

那就说明：

• 当前失败点已经不是 DLL 注入或基本代理链路
• 而是 Antigravity 自己的 agent execution 路径被服务端按 location / egress 策略拦住了

1. 先看 proxy-YYYYMMDD.log
   • 如果注入和 SOCKS5 都成功，说明 DLL 大概率没问题。
2. 再看 %APPDATA%\\Antigravity\\logs\\<最新目录>\\ls-main.log
   • 如果有 User location is not supported for the API use.，优先排 IP。
3. 优先更换非机房 / 非托管 / 普通 ISP / 住宅出口，再重试