Antigravity Tools 🚀：专业级AI账号管理与协议代理系统

📋 学习目标

• 理解 Antigravity Tools 的核心定位与适用场景
• 掌握多平台安装部署方法（终端脚本/Homebrew/Docker）
• 熟悉 OAuth 2.0 授权流程与账号导入导出
• 理解三大协议转换原理（OpenAI / Anthropic / Gemini）
• 掌握模型路由配置与智能分级策略
• 完成 Claude Code、OpenCode 等工具的接入配置
• 了解 Docker 部署与安全加固最佳实践

📖 项目概述

什么是 Antigravity Tools

Antigravity Tools（曾用名 Antigravity Manager）是一个专为开发者和 AI 爱好者设计的全功能桌面应用，它将多账号管理、协议转换和智能请求调度完美结合，提供一个稳定、极速且成本低廉的本地 AI 中转站。

通过本应用，用户可以将常见的 Web 端 Session（Google Gemini / Anthropic Claude）转化为标准化的 API 接口，消除不同厂商间的协议鸿沟。

核心数据

技术架构

外部应用: Claude Code / NextChat / Kilo Code
        ↓
Antigravity Axum Server (Rust 高性能网络层)
        ↓
中间件: 鉴权 / 限流 / 日志
        ↓
Model Router (模型路由: ID映射 / 正则重定向 / 分级路由)
        ↓
账号分发器: 轮询 / 权重分配
        ↓
协议转换器: Request Mapper (请求转换)
        ↓
上游请求: Google Gemini API / Anthropic API
        ↓
响应转换器: Response Mapper (响应转换)
        ↓
返回给外部应用

🛠️ 安装指南

方式一：终端一键安装（推荐）

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.31/install.sh | bash

Windows (PowerShell)：

irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

高级用法：

# 安装指定版本
curl -fsSL ... | bash -s -- --version 4.1.31

# 预览模式（不实际安装）
curl -fsSL ... | bash -s -- --dry-run

方式二：Homebrew (macOS)

# 1. 订阅 Tap
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager

# 2. 安装应用
brew install --cask antigravity-tools

# 提示：遇到权限问题添加 --no-quarantine 参数
brew install --cask --no-quarantine antigravity-tools

方式三：Docker 部署（推荐用于 NAS/服务器）

# 方式1: 直接运行 (推荐)
docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-your-api-key \
  -e WEB_PASSWORD=your-login-password \
  -e ABV_MAX_BODY_SIZE=104857600 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

# 方式2: Docker Compose
cd docker
docker compose up -d

访问地址：

• 管理后台: http://localhost:8045
• API Base: http://localhost:8045/v1

系统要求：

• 内存：建议 1GB（最小 256MB）
• 架构：支持 x86_64 和 ARM64

方式四：手动下载

前往 GitHub Releases 下载对应系统的包：

🎛️ 核心功能详解

1. 智能账号仪表盘

全局实时监控： 一眼洞察所有账号的健康状况，包括 Gemini Pro、Gemini Flash、Claude 以及 Gemini 绘图的平均剩余配额。

最佳账号推荐 (Smart Recommendation)： 系统会根据当前所有账号的配额冗余度，实时算法筛选并推荐"最佳账号"，支持一键切换。

活跃账号快照： 直观显示当前活跃账号的具体配额百分比及最后同步时间。

2. 强大的账号管家

OAuth 2.0 授权（自动/手动）： 添加账号时会提前生成可复制的授权链接，支持在任意浏览器完成授权；回调成功后应用会自动完成并保存（必要时可点击"我已授权，继续"手动收尾）。

多维度导入：

• 单条 Token 录入
• JSON 批量导入（如来自其他工具的备份）
• 从 V1 旧版本数据库自动热迁移

网关级视图： 支持"列表"与"网格"双视图切换。提供 403 封禁检测，自动标注并跳过权限异常的账号。

3. 协议转换与中继

全协议适配 (Multi-Sink)：

智能状态自愈： 当请求遇到 429 (Too Many Requests) 或 401 (Expire) 时，后端会毫秒级触发自动重试与静默轮换，确保业务不中断。

4. 模型路由中心

系列化映射： 您可以将复杂的原始模型 ID 归类到"规格家族"（如将所有 GPT-4 请求统一路由到 gemini-3-pro-high）。

专家级重定向： 支持自定义正则表达式级模型映射，精准控制每一个请求的落地模型。

智能分级路由 (Tiered Routing)： 系统根据账号类型（Ultra/Pro/Free）和配额重置频率自动优先级排序，优先消耗高速重置账号，确保高频调用下的服务稳定性。

后台任务静默降级： 自动识别 Claude CLI 等工具生成的后台请求（如标题生成），智能重定向至 Flash 模型，保护高级模型配额不被浪费。

5. 多模态与 Imagen 3 支持

高级画质控制： 支持通过 OpenAI size 参数（如 1024x1024、16:9）自动映射到 Imagen 3 的相应规格。

超强 Body 支持： 后端支持高达 100MB（可配置）的 Payload，处理 4K 高清图识别绰绰有余。

🔌 快速接入示例

接入 Claude Code CLI

# 1. 启动 Antigravity，并在"API 反代"页面开启服务

# 2. 在终端配置环境变量
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"

# 3. 启动 Claude Code
claude

接入 OpenCode

# 配置方式与 Claude Code 类似
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"

# 启动 OpenCode
opencode

接入 Cherry Studio

1. 打开 Cherry Studio 设置
2. 添加自定义 API 路径：http://127.0.0.1:8045/v1
3. 输入 API Key：sk-antigravity
4. 选择模型即可使用

接入 Kilo Code

配置方式与其他工具类似，通过环境变量指定 ANTHROPIC_BASE_URL 即可实现多账号极速轮换与模型穿透。

🐳 Docker 部署详解

鉴权逻辑说明

场景 A：仅设置 API_KEY

• Web 登录：使用 API_KEY 进入后台
• API 调用：使用 API_KEY 进行 AI 请求鉴权

场景 B：同时设置 API_KEY 和 WEB_PASSWORD（推荐）

• Web 登录：必须使用 WEB_PASSWORD，使用 API Key 将被拒绝（更安全）
• API 调用：统一使用 API_KEY

密码优先级

旧版本升级指引

从 v4.0.1 及更早版本升级时，系统默认未设置 WEB_PASSWORD。可通过以下任一方式设置：

1. Web UI 界面 (推荐)：使用原有 API_KEY 登录后，在 API 反代设置 页面手动设置并保存

2. 环境变量 (Docker)：启动容器时增加 -e WEB_PASSWORD=您的新密码

3. 配置文件 (持久化)：直接修改 ~/.antigravity_tools/gui_config.json

🔧 常见问题排查

macOS 提示"应用已损坏，无法打开"？

由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示：

命令行修复（推荐）：

sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"

Homebrew 安装时规避：

brew install --cask --no-quarantine antigravity-tools

🆕 v4.x 新特性

根据 v4.0.0 及后续版本的更新日志：

📊 竞品对比

🎯 适用人群

• 开发者：需要频繁切换 AI 账号进行开发调试
• AI 爱好者：使用 Claude Code、OpenCode 等 CLI 工具
• 团队管理员：需要管理多个 AI 账号配额
• NAS/服务器用户：需要 Docker 部署方案
• API 集成开发者：需要统一接口对接多种 AI 服务

📚 资源链接

✅ 总结

Antigravity Tools 是一个功能完善的 AI 账号管理与协议代理系统，其核心价值在于：

1. 一站式管理：统一管理多个 AI 平台的账号配额
2. 协议转换：消除不同厂商间的协议差异，一个端点对接所有服务
3. 智能调度：自动选择最佳账号，保护高配额账号
4. 稳定可靠：自动重试与状态自愈，确保业务不中断
5. 部署灵活：支持桌面应用和 Docker 部署

无论您是个人开发者还是团队管理员，Antigravity Tools 都能有效提升 AI 服务的使用效率和稳定性。

🦞