Antigravity-Proxy

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

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

📖 目录 / Table of Contents

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

🚨 先看这个：对话报错先排 IP / Read This First

先说结论：如果 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”

你现在应该先看哪两份日志

1. DLL 日志：证明“不是注入失效”

• <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 限制错误，同时当前代理出口呈现机房/托管特征...

2. Antigravity 应用日志：证明“真正失败的是 agent 执行链路”

• %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 / 住宅出口，再重试
   • 同一个国家（例如新加坡）下，不同 ASN / 不同类型出口，结果可能完全不同。
4. 只有当 DLL 日志里根本没有注入成功、或根本没有代理握手成功时，才回头排 DLL。

一句话记忆点

Antigravity 对话报错时，先排出口 IP，再排 DLL。看到 location is not supported 基本优先看 IP。

📖 项目介绍 / Introduction

Antigravity-Proxy 是专门为 Antigravity 编辑器量身定制的 Windows 代理注入组件（DLL）。

它的目标很简单：让中国用户使用 Antigravity 时，不用开 Clash TUN 模式，也能把网络流量稳定交给你的 SOCKS5/HTTP 代理。

项目名 Antigravity-Proxy = Antigravity + Proxy：只把 Antigravity 相关进程的流量“拽”进代理里（别担心，不会全局接管）。

🎯 解决的痛点 / Problem Solved

你是否遇到过这些情况？

• 🔴 使用 Antigravity 时不走系统代理，只能被迫开启 Clash TUN 模式
• 🔴 开启 TUN 模式后全局流量都被代理，影响本地开发
• 🔴 TUN 模式需要管理员权限，某些环境不允许

Antigravity-Proxy 就是来专治这个的。 它可以：

• ✅ 仅代理指定程序（默认面向 Antigravity 相关进程），不影响其他流量
• ✅ 无需 TUN 模式，避免全局接管
• ✅ 透明代理，目标程序完全无感知

🌟 核心价值 / Core Value

⚠️ 环境要求 / Prerequisites

在使用本工具前，请确保系统已安装必要的运行库，否则可能无法正常启动目标程序。

常见问题：0xc0000142 错误

如果启动程序时遇到 错误代码 0xc0000142（如下图所示），通常是由于系统缺少 Windows 运行库导致的。

解决方案

请安装 微软常用运行库合集，该工具已包含在本仓库中：

📦 下载路径: microsoft\微软常用运行库合集-2025.exe

安装步骤：

1. 进入本仓库的 microsoft 目录
2. 运行 微软常用运行库合集-2025.exe
3. 按照安装向导完成安装
4. 重新启动目标程序

⚡ Antigravity 快速开始 / Quick Start

只想让 Antigravity 立刻能用？看这一节就够了。

Step 1: 准备代理 / Prepare a Proxy

启动你的代理软件（例如 Clash/Mihomo），确保本机有可用的 SOCKS5 或 HTTP 代理端口（如 127.0.0.1:7890）。

# 测试 SOCKS5 端口 (默认 7891)
Test-NetConnection -ComputerName 127.0.0.1 -Port 7891

# 测试 HTTP 端口 (默认 7890)
Test-NetConnection -ComputerName 127.0.0.1 -Port 7890

# 通过 SOCKS5 代理访问
curl -x socks5://127.0.0.1:7891 https://www.google.com -I

# 通过 HTTP 代理访问
curl -x http://127.0.0.1:7890 https://www.google.com -I

Step 2: 准备文件 / Get the Files

Release 按架构和运行目标提供四个独立压缩包，下载时只选实际使用的一套：

• antigravity-proxy-vX-ide-win-x64.zip / ...-x86.zip：包含 ide/（version.dll、config.json）。
• antigravity-proxy-vX-cli-win-x64.zip / ...-x86.zip：包含 cli/（dbghelp.dll、antigravity_proxy.dll、config.json）。

每个压缩包还包含通用的 config-web.html 与 使用说明.md；自行编译时仍会在本地 output/ide、output/cli 生成两套目录。

Step 3: 部署到 Antigravity / Deploy to Antigravity

桌面端只复制 ide/ 内的文件到 Antigravity 主程序目录（与 Antigravity.exe 同级）。

如果使用 Antigravity CLI，只复制 cli/ 内的文件到 agy.exe 同级目录。dbghelp.dll 会在导出函数首次调用时加载唯一名称的 antigravity_proxy.dll，避开系统 version.dll 同名冲突。

ide/ 与 cli/ 不要混合复制；桌面端不需要 dbghelp.dll。

version.dll 与 config.json 必须来自同一次构建且架构一致。当前版本默认对宿主进程启用全量网络 Hook；启动日志应出现 使用全量模式，随后再以 OAuth 回调和业务请求日志做功能验收。

Antigravity 2.0 注意事项

Antigravity 2.0 新增/改名了关键进程，默认配置已覆盖：

"target_processes": [
  "agy.exe",
  "language_server.exe",
  "language_server_windows",
  "Antigravity.exe",
  "Antigravity IDE.exe",
  "node.exe"
]

如果你是从旧版本手动迁移 config.json，请确认 child_injection 仍为 true，并把上面的目标进程列表同步进去。2.0 环境如果存在多个启动目录，也要把 version.dll 和 config.json 放到实际启动的 Antigravity/IDE 目录中。

Antigravity 更新后可能清理安装目录里的劫持文件；如果更新后不走代理，请重新复制这些文件。若代理软件区分 mixed-port 和 SOCKS5 端口，也要确认 proxy.type 和 proxy.port 匹配本机实际监听端口。

更多现场记录见 docs/antigravity-2.0-issue-85.md。

Windows 常见目录 + 快速跳转

一般情况下 Antigravity 会装在：

例如：C:\Users\<用户名>\AppData\Local\Programs\Antigravity

如果你找不到这个目录：在桌面/开始菜单找到 Antigravity 图标，右键 → 打开文件所在的位置，跳出来的那个目录就是它的主程序目录。

想从命令行一键跳过去（少点鼠标，多点快乐）：

cd "$env:LOCALAPPDATA\Programs\Antigravity"

cd /d "%LOCALAPPDATA%\Programs\Antigravity"

（可选）你也可以自己设个环境变量，之后就能 cd 秒过去：

setx ANTIGRAVITY_HOME "%LOCALAPPDATA%\Programs\Antigravity"

设置完后：PowerShell 用 cd $env:ANTIGRAVITY_HOME，CMD 用 cd /d %ANTIGRAVITY_HOME%。

🔧 故障排查自查手册 / Troubleshooting Guide

代理不工作？按照本手册逐步排查，找到问题根源。

📋 快速诊断流程图

代理不工作？
    │
    ├── 检查日志是否存在 ───────────────────────────────────┐
    │       │                                               │
    │       ├── ❌ 无日志 → DLL未加载/位置错误               │
    │       │       └── 见「DLL 加载问题」                   │
    │       │                                               │
    │       └── ✅ 有日志 → 继续检查日志内容                │
    │               │                                       │
    ├── 日志中有 "SOCKS5: 隧道建立成功" 吗？ ────────────────┤
    │       │                                               │
    │       ├── ❌ 没有 → 代理连接失败                      │
    │       │       └── 见「代理软件排查」                   │
    │       │                                               │
    │       └── ✅ 有 → 隧道建立成功，问题在后续            │
    │               │                                       │
    └── 检查 Clash 日志和节点可用性 ──────────────────────────┘

🔍 第一步：检查日志文件

日志是排查问题的第一手资料。

日志位置（按优先级）：

1. <Antigravity安装目录>\logs\proxy-YYYYMMDD.log
2. %TEMP%\antigravity-proxy-logs\proxy-YYYYMMDD.log

快速打开：

# 打开 DLL 目录的 logs 文件夹
cd "$env:LOCALAPPDATA\Programs\Antigravity\logs"

# 或打开 TEMP 目录
cd "$env:TEMP\antigravity-proxy-logs"

日志关键行解读：

🌐 第二步：代理软件排查

2.1 确认代理端口可用

# 测试 SOCKS5/混合端口
Test-NetConnection -ComputerName 127.0.0.1 -Port 7890

# 如果 TcpTestSucceeded: False，说明端口未监听

2.2 确认 Clash 配置正确

在 Clash 配置文件中检查：

# 必须开启混合端口或 SOCKS5 端口
mixed-port: 7890     # 混合端口（推荐）
# 或
port: 7890           # HTTP 端口
socks-port: 7891     # SOCKS5 端口

# 如果需要局域网访问
allow-lan: true

2.3 检查 Clash 日志

在 Clash 界面查看「日志」或「Logs」，确认：

• 是否有来自 daily-cloudcode-pa.googleapis.com、www.googleapis.com 的请求
• 请求是 DIRECT（直连）还是走了代理节点
• 是否有 REJECT 规则命中

2.4 测试节点可用性

最简单的方法：直接开启 TUN 模式，如果 TUN 模式下 Antigravity 正常，说明节点没问题。

💻 第三步：系统环境排查

3.1 检查 Windows 版本

winver

不同 Windows 11 小版本的 Winsock 行为可能有差异。请记录版本号备用。

3.2 检查 Winsock LSP 配置

某些安全软件会注入 LSP（分层服务提供程序），可能干扰 Hook。

# 以管理员身份运行
netsh winsock show catalog

正常情况下只应该有 Microsoft 的 Provider。如果看到第三方 Provider（如 360、火绒等），可能会有兼容性问题。

3.3 检查安全软件

以下软件可能干扰 DLL 注入或 Hook：

临时排查：尝试完全退出安全软件后测试（不只是退到托盘，要完全退出）。

3.4 检查 IPv6 配置

如果系统启用了 IPv6，某些连接可能尝试 IPv6 优先：

# 查看网络适配器 IPv6 状态
Get-NetAdapterBinding -ComponentID ms_tcpip6

如果日志中出现大量 IPv6 相关内容，可以尝试在 config.json 中设置：

"proxy_rules": {
    "ipv6_mode": "block"
}

🔄 第四步：对比排查（与正常环境对比）

如果你的环境正常，但朋友的不行，请对比以下信息：

📊 第五步：收集信息提交 Issue

如果以上排查都无法解决，请收集以下信息提交 GitHub Issue：

1. 日志文件：完整的 proxy-YYYYMMDD.log 内容
2. config.json：你的配置文件（隐藏敏感信息）
3. Windows 版本：winver 输出
4. Clash 版本和配置（端口设置部分）
5. 安全软件列表：已安装的杀软/安全软件
6. 问题描述：具体什么功能不工作？打开什么网站/功能时失败？

⚠️ 已知兼容性问题

❓ DLL常见问题与错误码 / Common Errors and Error Codes

遇到问题时，建议先确认目标程序位数（x86/x64），并查看目标程序目录下的日志文件（如 proxy-YYYYMMDD.log）。

已知错误码

其他常见错误码

✨ 功能特性 / Features

支持的代理协议 / Supported Protocols

• ✅ SOCKS5 (推荐 / Recommended)
• ✅ HTTP CONNECT

🔧 工作原理 / How It Works

整体架构 / Architecture

┌─────────────────────────────────────────────────────────────────────────┐
│                           目标程序 (Target Process)                       │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────────────────┐   │
│  │  应用代码     │───►│ Winsock API  │───►│  antigravity-proxy.dll   │   │
│  │  (App Code)  │    │ (ws2_32.dll) │    │  (Hook Layer)            │   │
│  └──────────────┘    └──────────────┘    └────────────┬─────────────┘   │
│                                                       │                  │
└───────────────────────────────────────────────────────│──────────────────┘
                                                        ▼
                                              ┌──────────────────┐
                                              │   代理服务器      │
                                              │  (SOCKS5/HTTP)   │
                                              │  Proxy Server    │
                                              └──────────────────┘

核心流程 / Core Flow

┌─────────────────────────────────────────────────────────────────────────┐
│ 1. DLL 劫持 (DLL Hijacking)                                              │
│    程序加载 version.dll → 加载我们的 DLL → 转发真实 version.dll 调用      │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 2. API Hook 安装 (Install Hooks)                                         │
│    使用 MinHook 拦截: connect, getaddrinfo, CreateProcessW 等           │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 3. DNS 拦截 (DNS Interception)                                           │
│    getaddrinfo("example.com") → 分配 FakeIP (198.18.x.x) → 记录映射       │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 4. 连接重定向 (Connection Redirect)                                       │
│    connect(198.18.x.x) → 查询映射还原域名 → 连接代理 → SOCKS5 握手         │
└─────────────────────────────────────────────────────────────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 5. 子进程传播 (Child Process Propagation)                                │
│    CreateProcessW → 挂起进程 → 注入 DLL → 恢复运行                       │
└─────────────────────────────────────────────────────────────────────────┘

Hook 的 API 列表 / Hooked APIs

🛠️ 编译构建 / Build

环境要求 / Prerequisites

在开始编译之前，请确保已安装以下工具：

💡 提示: 安装 Visual Studio 时，请确保勾选 "使用 C++ 的桌面开发" 工作负载。

依赖项 / Dependencies

一键编译 / Quick Build

项目提供了 PowerShell 编译脚本，支持一键编译：

# 默认编译 Release x64
.\build.ps1

# 编译 Debug 版本
.\build.ps1 -Config Debug

# 编译 32 位版本
.\build.ps1 -Arch x86

# 清理后重新编译
.\build.ps1 -Clean

# 输出详细编译日志
.\build.ps1 -Verbose

# 构建并运行 CTest（CI/Release 使用）
.\build.ps1 -RunTests

# 显式声明跳过测试（也是默认行为）
.\build.ps1 -SkipTests

# 查看帮助
.\build.ps1 -Help

手动编译 / Manual Build

如果你更喜欢手动编译，也可以使用以下命令：

# ========== x64 (64位) ==========
mkdir build-x64 && cd build-x64

# 配置 (使用 Visual Studio 2022)
cmake .. -G "Visual Studio 17 2022" -A x64

# 编译 Release 版本
cmake --build . --config Release

# 输出: version.dll


# ========== x86 (32位) ==========
mkdir build-x86 && cd build-x86

# 配置
cmake .. -G "Visual Studio 17 2022" -A Win32

# 编译
cmake --build . --config Release

# 输出: version.dll

常见编译错误 / Common Build Errors

# 手动下载
curl -o include/nlohmann/json.hpp https://raw.githubusercontent.com/nlohmann/json/develop/single_include/nlohmann/json.hpp

target_link_libraries(version PRIVATE ws2_32)

📝 使用方法 / Usage

快速开始 / Quick Start

只需 3 步，即可让目标程序走代理！

Step 1: 准备文件 / Prepare Files

编译完成后，你会在 output 目录得到：

• ide/version.dll 与 ide/config.json - 桌面端部署目录
• cli/dbghelp.dll、cli/antigravity_proxy.dll 与 cli/config.json - CLI 部署目录
• config-web.html 与 使用说明.md - 配置工具和说明

Step 2: 配置代理 / Configure Proxy

编辑 config.json：

{
    "proxy": {
        "host": "127.0.0.1",
        "port": 7890,
        "type": "socks5"
    },
    "fake_ip": {
        "enabled": true,
        "cidr": "198.18.0.0/15"
    },
    "timeout": {
        "connect": 5000,
        "send": 5000,
        "recv": 5000
    },
    "child_injection": true,
    "child_injection_mode": "filtered",
    "target_processes": [
        "agy.exe",
        "language_server.exe",
        "language_server_windows",
        "Antigravity.exe",
        "Antigravity IDE.exe",
        "node.exe"
    ],
    "proxy_rules": {
        "allowed_ports": [80, 443],
        "dns_mode": "direct",
        "ipv6_mode": "proxy"
    }
}

Step 3: 部署 DLL / Deploy DLL

将 version.dll 和 config.json 复制到目标程序的同一目录：

目标程序目录/
├── 目标程序.exe
├── version.dll      ← 放这里
└── config.json      ← 放这里

启动目标程序，完成！🎉

配置文件详解 / Configuration Reference

规则路由 / Routing Rules

路由规则由 proxy_rules.routing 管理，支持 CIDR/域名通配符/端口/协议分流，优先级可选 order(按顺序) 或 number(priority)。

{
  "proxy_rules": {
    "routing": {
      "enabled": true,
      "priority_mode": "order",
      "default_action": "proxy",
      "use_default_private": true,
      "rules": [
        {
          "name": "lan-direct",
          "action": "direct",
          "ip_cidrs_v4": ["10.0.0.0/8","172.16.0.0/12","192.168.0.0/16"],
          "ip_cidrs_v6": ["fc00::/7","fe80::/10","::1/128"],
          "domains": [".local","*.corp.example.com"],
          "protocols": ["tcp"]
        }
      ]
    }
  }
}

可视化配置工具：resources/config-web/index.html（本地打开即可使用；或构建后使用 output/config-web.html，支持导入/编辑/导出 config.json）。

说明：AUTHORS.txt 为内嵌的 MinHook 依赖作者名单，并非本项目维护者列表。

提示：

• 端口留空代表“全部端口”；域名留空仅按 CIDR 匹配；域名填 * 将匹配所有域名。
• 全量匹配可用 0.0.0.0/0 与 ::/0。
• 工具已支持 proxy.host / proxy.port / proxy.type 的编辑。

已知问题 / Known Issues

• 历史版本（已修复）：FakeIP 与 direct + domains + ports：在部分旧版本中，若启用 FakeIP，且 action=direct 的规则同时配置了 domains 与 ports，可能出现 DNS 阶段分配 FakeIP，随后 connect 阶段“直连虚拟地址”导致连接失败。若你仍在使用旧版本，建议升级；或临时规避：移除该规则的 ports 条件，或关闭 FakeIP。

IPv6 注意事项

当日志出现 SOCKS5: 读取认证响应失败, WSA错误码=10060，且目标是 IPv6 地址（如 2001:4860:4860::8888:443），表示代理没有及时响应该 IPv6 连接。

当前版本会在 IPv6 socket 创建且尚未 bind 时自动关闭 IPV6_V6ONLY，使 127.0.0.1 这类 IPv4 代理可通过 v4-mapped IPv6 地址连接。若应用之后重新启用 v6-only，日志会输出具体 WSA 错误码。

可选处理方式：

• 快速止血：将 proxy_rules.ipv6_mode 改为 block（阻止）或 direct（直连）。
• 原生 IPv6 代理：让代理监听 ::1，再把 proxy.host 改为 ::1。

优先级说明：当目标为纯 IPv6（非 v4-mapped）且 proxy_rules.ipv6_mode 为 direct/block 时，会在进入 routing 规则前直接直连/阻止；当 ipv6_mode=proxy 时才会继续进入 routing 匹配。

UDP/QUIC 注意事项

当目标程序使用 QUIC/HTTP3（UDP/443）时，默认 udp_mode=auto 会在 SOCKS5 下自动使用 UDP Associate。

推荐配置：

• 保持 proxy_rules.udp_mode=auto
• 将 proxy.type 设为 socks5（HTTP 代理没有标准 UDP 转发能力）
• 确保代理软件支持 SOCKS5 UDP Associate 并允许 UDP 转发（不同客户端/内核能力不同）
• 可选：当代理不支持 UDP 时，可将 proxy_rules.udp_fallback 设为 direct（⚠️ 可能导致 UDP 直连泄漏；默认 block 更安全）

示例：

{
  "proxy": { "host": "127.0.0.1", "port": 10808, "type": "socks5" },
  "proxy_rules": {
    "udp_mode": "auto",
    "dns_mode": "direct",
    "allowed_ports": [80, 443]
  }
}

说明：

• dns_mode="direct" 仍会放行 UDP/53（避免 DNS 超时）；若你希望 DNS 也走代理，请改为 dns_mode="proxy"。
• auto + socks5 的有效策略为 proxy；auto + http 按 udp_fallback 决定 block/direct。
• 显式 udp_mode=block 会阻断大部分 UDP，但仍放行 loopback 与 UDP/53。

验证是否生效 / Verification

1. 检查日志: 查看是否生成日志文件（格式：proxy-YYYYMMDD.log）
2. 查看代理软件: 观察代理软件的连接日志
3. 使用抓包工具: 使用 Wireshark 确认流量走向

📂 日志文件位置 / Log File Locations

日志文件按以下优先级存放：

💡 提示：如果在 DLL 目录无法创建 logs 文件夹（例如权限不足），日志会自动回退到系统 TEMP 目录。

快速打开 TEMP 目录：按 Win+R，输入 %TEMP%，回车即可。

🐧 WSL 环境使用指南 / WSL Guide

⚠️ 重要提示：Antigravity-Proxy（version.dll 劫持方案）无法直接代理 WSL 内部的流量。

为什么 DLL 劫持在 WSL 中不起作用？

这是由技术架构决定的根本性限制，无法通过修改代码来解决：

┌─────────────────────────────────────────────────────────────────┐
│                        Windows 主机                              │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │  Antigravity-Proxy (version.dll)                           │  │
│  │  ├── Hook: connect(), getaddrinfo(), WSAConnect()...      │  │
│  │  └── ✅ 可以拦截所有 Windows 进程的网络请求                 │  │
│  └────────────────────────────────────────────────────────────┘  │
│                              │                                    │
│                         ❌ 无法穿透                               │
│                              ↓                                    │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │               WSL2 (轻量级 Linux 虚拟机)                     │  │
│  │  ┌──────────────────────────────────────────────────────┐  │  │
│  │  │  language_server_linux_x64                           │  │  │
│  │  │  └── 使用 Linux socket() 系统调用 → 绕过 Winsock    │  │  │
│  │  └──────────────────────────────────────────────────────┘  │  │
│  └────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

替代方案

方案一：使用 antissh 工具（推荐 ⭐⭐⭐⭐⭐）

antissh 是专门为在 WSL 中代理 Antigravity Agent 设计的工具。

原理：在 WSL 内部使用 graftcp 对 language_server_linux_x64 进行代理包装。

快速开始：

# 在 WSL 中执行
curl -O https://raw.githubusercontent.com/ccpopy/antissh/main/antissh.sh
chmod +x antissh.sh
bash ./antissh.sh

脚本会引导你：

1. 输入代理地址（如 socks5://127.0.0.1:10808）
2. 自动安装依赖并编译 graftcp
3. 自动找到并包装 language_server_linux_x64

优点：

• 专门针对此场景设计
• 无需修改 Antigravity-Proxy 代码
• 社区持续维护

注意：IDE 升级后可能需要重新运行脚本。

方案二：WSL Mirrored 网络模式（推荐 ⭐⭐⭐⭐）

原理：让 WSL 共享 Windows 的网络栈，从而可以使用 127.0.0.1 访问 Windows 上的代理。

配置步骤：

1. 在 Windows 用户目录创建或编辑 .wslconfig 文件：

# PowerShell 执行
notepad "$env:USERPROFILE\.wslconfig"

2. 添加以下内容：

[wsl2]
networkingMode=mirrored

3. 重启 WSL：

wsl --shutdown

4. 在 WSL 中设置环境变量（添加到 ~/.bashrc 或 ~/.zshrc）：

export ALL_PROXY=socks5://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

要求：

• Windows 11 22H2 或更高版本
• WSL 版本 >= 2.0.0（运行 wsl --version 检查）

优点：

• 无需安装额外工具
• 配置简单

缺点：

• 环境变量方式可能对某些不读取环境变量的程序无效

方案三：TUN 模式全局透明代理（推荐 ⭐⭐⭐）

原理：使用 Clash/Mihomo 的 TUN 模式创建虚拟网卡，在 IP 层拦截所有流量。

操作：在 Clash/Mihomo 中开启 TUN 模式即可。

优点：

• 真正的全局代理，覆盖所有应用
• 无需针对单个程序配置

缺点：

• 需要管理员权限
• 可能影响系统网络性能
• 与 Antigravity-Proxy 的定位（精准代理）有所重叠

方案对比

🚀 进阶玩法 / Advanced Usage

附加价值：本项目首先为 Antigravity 服务，但底层是通用的进程级强制代理方案，也可以用来强制代理其他不走系统代理的 Windows 程序，或基于此二次开发。

🎯 强制代理其他程序 / Force Proxy Other Programs

想让 Chrome、VS Code 或其他程序也走代理？只需修改配置文件！

示例 1: 强制代理 Chrome

{
    "proxy": {
        "host": "127.0.0.1",
        "port": 7890,
        "type": "socks5"
    },
    "child_injection": true,
    "target_processes": []
}

然后将 version.dll 和 config.json 复制到 Chrome 安装目录：

C:\Program Files\Google\Chrome\Application\
├── chrome.exe
├── version.dll      ← 放这里
└── config.json      ← 放这里

示例 2: 强制代理 VS Code

C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code\
├── Code.exe
├── version.dll      ← 放这里
└── config.json      ← 放这里

示例 3: 仅代理特定子进程

如果你只想代理程序的某些子进程，可以使用 target_processes 配置：

{
    "target_processes": [
        "node.exe",
        "npm.cmd",
        "language_server.exe"
    ]
}

🔧 二次开发入口 / Development Entry Points

如果你想基于此项目进行二次开发，以下是关键代码位置：

如何添加新的 Hook？

1. 在 src/hooks/Hooks.cpp 中定义函数指针类型和 Detour 函数
2. 在 Hooks::Install() 中添加 MH_CreateHookApi() 调用
3. 在 Hooks::Uninstall() 中处理清理逻辑

如何支持新的代理协议？

1. 在 src/network/ 下创建新的协议实现 (参考 Socks5.hpp)
2. 在 src/hooks/Hooks.cpp 的 DoProxyHandshake() 中添加协议分支

📄 许可证 / License

本项目基于 BSD-2-Clause License 开源。

MinHook 部分版权归 Tsuda Kageyu 所有。

👤 关于作者 / Author

📱 联系方式 / Contact

🎁 支持作者 / Support

如果这个项目对你有帮助，欢迎：

• ⭐ 给项目点个 Star
• 🔗 分享给需要的朋友
• 💬 提交 Issue 或 PR

添加微信交流

关注公众号

🔥 加入微信交流群

💰 打赏支持 / Donate

如果这个项目帮到了你，可以请作者喝杯咖啡 ☕

微信赞赏

支付宝打赏

🔍 伪代码（pseudocode_dll）来源说明 / Pseudocode Source Note

本仓库的 pseudocode_dll/ 目录收录了对某论坛帖中发布的 DLL进行反编译得到的伪代码（Binary Ninja / IDA Hex-Rays 输出），用途仅为：

• 排查我在 Windows 11 环境下遇到的 Antigravity 间歇性崩溃问题
• 学习/对照其 Hook 与强制代理的实现思路
• 作为研究记录留档（便于后续回溯）

⚠️ 重要声明

• pseudocode_dll/ 不参与本项目的构建与发布，只是学习与研究记录。
• 本项目当前代码为我从零实现与持续维护的版本，并非“原 DLL 的源码开源”。
• 本仓库不分发原帖中的成品 DLL；如需获取原始 DLL，请前往原帖。
• 若原帖作者认为该伪代码公开不合适、希望移除相关内容，请在仓库提 Issue，我会第一时间配合调整（移动到单独分支/移除/重写说明均可）。

来源（原帖含 DLL）：
https://linux.do/t/topic/1189424

本仓库伪代码文件：

• pseudocode_dll/BinaryNinja.txt（Binary Ninja 反编译输出）
• pseudocode_dll/Hex-Rays.txt（IDA Hex-Rays 反编译输出）

_{Made with ❤️ by 煎饼果子（86）}