lbjlaq/Antigravity-Manager

Antigravity Tools 🚀

专业级 AI 账号管理与协议代理系统 (v4.7.13)

Antigravity Tools

多平台自动化运维与多账号矩阵调度控制台

核心功能 • 界面导览 • 技术架构 • 安装指南 • 快速接入

简体中文 | English

---

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

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

💖 赞助商 (Sponsors)

| 赞助商 (Sponsor) | 简介 (Description) | | :---: | :--- | | | 感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中转服务商，提供 Claude Code、Codex、Gemini 等多种服务的中转。PackyCode 为本项目的用户提供了特别优惠：使用此链接注册，并在充值时输入 “Ctrler” 优惠码即可享受 九折优惠。 | | | 感谢 APIKEY.FUN 赞助本项目！APIKEY.FUN 是一家专业的企业级 AI 中转站，致力于为企业和个人开发者提供稳定、高效、低成本的 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型，价格低至官方原价的 7%。通过本项目专属链接注册，还可享受最高 充值永久 95 折 专属优惠。 | | | 感谢 Claude API 对本项目的支持！claudeapi.com 是一家走官方与 AWS 渠道接入的 Claude API 中转站，专注 Claude，主打高稳定、低延迟，完整支持 Claude Code。为本项目用户提供专属福利：通过专属链接注册即送免费测试额度，零门槛跑通；充值再享 95 折专属优惠(联系客服）。 | | | 感谢 AICodeMirror 赞助了本项目！AICodeMirror 提供 Claude Code / Codex / Gemini CLI 官方高稳定中转服务，支持企业级高并发、极速开票、7×24 专属技术支持。 Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更有折上折！AICodeMirror 为 Antigravity-Manager 的用户提供了特别福利，通过此链接注册的用户，可享受首充8折，企业客户最高可享 7.5 折！ |

☕ 支持项目 (Support)

如果您觉得本项目对您有所帮助，欢迎打赏作者！

| 支付宝 (Alipay) | 微信支付 (WeChat) | Buy Me a Coffee | | :---: | :---: | :---: | | | | |

🚀 推荐项目 (Recommended Projects)

如果您喜欢本项目，可能也会对以下项目感兴趣：

• Antigravity-Tools-LS: 专为 AI 协议设计的语言服务器 (LSP)，为您提供更智能的代码补全、诊断和协议调试体验。

🌟 深度功能解析 (Detailed Features)

1. 🎛️ 智能账号仪表盘 (Smart Dashboard)

• 全局实时监控: 一眼洞察所有账号的健康状况，包括 Gemini Pro、Gemini Flash、Claude 以及 Gemini 绘图的 平均剩余配额。
• 最佳账号推荐 (Smart Recommendation): 系统会根据当前所有账号的配额冗余度，实时算法筛选并推荐“最佳账号”，支持 一键切换。
• 活跃账号快照: 直观显示当前活跃账号的具体配额百分比及最后同步时间。

2. 🔐 强大的账号管家 (Account Management)

• OAuth 2.0 授权（自动/手动）: 添加账号时会提前生成可复制的授权链接，支持在任意浏览器完成授权；回调成功后应用会自动完成并保存（必要时可点击“我已授权，继续”手动收尾）。
• 多维度导入: 支持单条 Token 录入、JSON 批量导入（如来自其他工具的备份），以及从 V1 旧版本数据库自动热迁移。
• 网关级视图: 支持“列表”与“网格”双视图切换。提供 403 封禁检测，自动标注并跳过权限异常的账号。

3. 🔌 协议转换与中继 (API Proxy)

• 全协议适配 (Multi-Sink):
• OpenAI 格式: 提供 /v1/chat/completions 端点，兼容 99% 的现有 AI 应用。
• Anthropic 格式: 提供原生 /v1/messages 接口，支持 Claude Code CLI 的全功能（如思思维链、系统提示词）。
• Gemini 格式: 支持 Google 官方 SDK 直接调用。
• 智能状态自愈: 当请求遇到 429 (Too Many Requests) 或 401 (Expire) 时，后端会毫秒级触发 自动重试与静默轮换，确保业务不中断。

4. 🔀 模型路由中心 (Model Router)

• 系列化映射: 您可以将复杂的原始模型 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 高清图识别绰绰有余。

📸 界面导览 (GUI Overview)

| | | | :---: | :---: | |
仪表盘 |
账号列表 | |
关于页面 |
API 反代 | |
系统设置 | |

💡 使用案例 (Usage Examples)

| | | | :---: | :---: | |
Claude Code 联网搜索 |
Cherry Studio 深度集成 | |
Imagen 3 高级绘图 |
Kilo Code 接入 |

🏗️ 技术架构 (Architecture)

graph TD
    Client([外部应用: Claude Code/NextChat]) -->|OpenAI/Anthropic| Gateway[Antigravity Axum Server]
    Gateway --> Middleware[中间件: 鉴权/限流/日志]
    Middleware --> Router[Model Router: ID 映射]
    Router --> Dispatcher[账号分发器: 轮询/权重]
    Dispatcher --> Mapper[协议转换器: Request Mapper]
    Mapper --> Upstream[上游请求: Google/Anthropic API]
    Upstream --> ResponseMapper[响应转换器: Response Mapper]
    ResponseMapper --> Client

安装指南 (Installation)

选项 A: 终端安装 (推荐)

跨平台一键安装脚本

自动检测操作系统、架构和包管理器，一条命令完成下载与安装。

Linux / macOS:

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

Windows (PowerShell):

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

支持的格式: Linux (.deb / .rpm / .AppImage) | macOS (.dmg) | Windows (NSIS .exe)

> 高级用法: 安装指定版本 curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.sh | bash -s -- --version 4.6.8，预览模式 curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.sh | bash -s -- --dry-run

macOS - Homebrew

# 1. 订阅本仓库的 Tap
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
2. 安装应用
brew install --cask antigravity-tools

Arch Linux

方式 1：一键安装脚本 (推荐)

curl -sSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/deploy/arch/install.sh | bash

方式 2：通过 Homebrew (如果您已安装 Linuxbrew)

brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
brew install --cask antigravity-tools

其他 Linux 发行版

选项 B: 手动下载

• macOS: .dmg (支持 Apple Silicon & Intel)
• Windows: .msi 或 便携版 .zip
• Linux: .deb 或 AppImage

选项 C: Docker 部署 (推荐用于 NAS/服务器)

# 方式 1: 直接运行 (推荐)
- API_KEY: 必填。用于所有协议的 AI 请求鉴定。
- WEB_PASSWORD: 可选。用于管理后台登录。若不设置则默认使用 API_KEY。
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
忘记密钥？执行 docker logs antigravity-manager 或 grep -E '"api_key"|"admin_password"' ~/.antigravity_tools/gui_config.json
🔐 鉴权逻辑说明
场景 A：仅设置了 API_KEY
Web 登录：使用 API_KEY 进入后台。
API 调用：使用 API_KEY 进行 AI 请求鉴权。
场景 B：同时设置了 API_KEY 和 WEB_PASSWORD (推荐)
Web 登录：必须使用 WEB_PASSWORD，使用 API Key 将被拒绝（更安全）。
API 调用：统一使用 API_KEY。这样您可以将 API Key 分发给成员，而保留密码仅供管理员使用。

🆙 旧版本升级指引
如果您是从 v4.0.1 及更早版本升级，系统默认未设置 WEB_PASSWORD。您可以通过以下任一方式设置：
1.  Web UI 界面 (推荐)：使用原有 API_KEY 登录后，在 API 反代设置 页面手动设置并保存。新密码将持久化存储在 gui_config.json 中。
2.  环境变量 (Docker)：在启动容器时增加 -e WEB_PASSWORD=您的新密码。注意：环境变量具有最高优先级，将覆盖 UI 中的任何修改。
3.  配置文件 (持久化)：直接修改 ~/.antigravity_tools/gui_config.json，在 proxy 对象中修改或添加 "admin_password": "您的新密码" 字段。
注：WEB_PASSWORD 是环境变量名，admin_password 是配置文件中的 JSON 键名。

[!TIP]
密码优先级逻辑 (Priority):
- 第一优先级 (环境变量): ABV_WEB_PASSWORD 或 WEB_PASSWORD。只要设置了环境变量，系统将始终使用它。
- 第二优先级 (配置文件): gui_config.json 中的 admin_password 字段。UI 的“保存”操作会更新此值。
- 保底回退 (向后兼容): 若上述均未设置，则回退使用 API_KEY 作为登录密码。
方式 2: 使用 Docker Compose
1. 进入项目的 docker 目录
cd docker
2. 启动服务
docker compose up -d

日志轮转: Compose 默认将 JSON 日志限制为单文件 100m、保留 3 个文件，避免日志无限增长。

访问地址: http://localhost:8045 (管理后台) | http://localhost:8045/v1 (API Base)

系统要求:

- 内存: 建议 1GB (最小 256MB)。

- 持久化: 需挂载 /root/.antigravity_tools 以保存数据。

- 架构: 支持 x86_64 和 ARM64。

详情见: Docker 部署指南 (docker)

---

Copyright © 2024-2026 lbjlaq

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

env WEBKIT_DISABLE_DMABUF_RENDERER=1 ANTIGRAVITY_FORCE_WAYLAND=1 antigravity-tools

🔌 快速接入示例

🔐 OAuth 授权流程（添加账号）

提示：授权链接包含一次性回调端口，请始终使用弹窗里生成的最新链接；如果授权时应用未运行或弹窗已关闭，浏览器可能会提示 localhost refused connection。

如何接入 Claude Code CLI?

export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude

如何接入 OpenCode?

• 创建独立 provider antigravity-manager（不覆盖 google/anthropic 原生配置）
• 可选：勾选 Sync accounts 导出 antigravity-accounts.json（plugin-compatible v3 格式），供 OpenCode 插件直接导入

快速验证命令：

# 测试 antigravity-manager provider（支持 --variant）
opencode run "test" --model antigravity-manager/claude-sonnet-4-5-thinking --variant high

若已安装 opencode-antigravity-auth 插件，验证 google provider 仍可独立工作
opencode run "test" --model google/antigravity-claude-sonnet-4-5-thinking --variant max

如何接入 Kilo Code?

• OpenAI 协议限制: Kilo Code 在使用 OpenAI 模式时，其请求路径会叠加产生 /v1/chat/completions/responses 这种非标准路径，导致 Antigravity 返回 404。因此请务必填入 Base URL 后选择 Gemini 模式。
• 模型映射: Kilo Code 中的模型名称可能与 Antigravity 默认设置不一致，如遇到无法连接，请在“模型映射”页面设置自定义映射，并查看日志文件进行调试。

如何在 Python 中使用?

import openai
client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)
response = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "你好，请自我介绍"}]
)
print(response.choices[0].message.content)

如何使用图片生成 (Imagen 3)?

方式一：OpenAI Images API (推荐)

import openai
client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)
生成图片
response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="一座未来主义风格的城市，赛博朋克，霓虹灯",
    size="1920x1080",      # 支持任意 WIDTHxHEIGHT 格式，自动计算宽高比
    quality="hd",          # "standard" | "hd" | "medium"
    n=1,
    response_format="b64_json"
)
保存图片
import base64
image_data = base64.b64decode(response.data[0].b64_json)
with open("output.png", "wb") as f:
    f.write(image_data)

支持的参数：

• size: 任意 WIDTHxHEIGHT 格式（如 1280x720, 1024x1024, 1920x1080），自动计算并映射到标准宽高比（21:9, 16:9, 9:16, 4:3, 3:4, 1:1）
• quality:
• "hd" → 4K 分辨率（高质量）
• "medium" → 2K 分辨率（中等质量）
• "standard" → 默认分辨率（标准质量）
• n: 生成图片数量（1-10）
• response_format: "b64_json" 或 "url"（Data URI）

# OpenAI Chat API
response = client.chat.completions.create(
    model="gemini-3-pro-image",
    size="1920x1080",      # ✅ 支持任意 WIDTHxHEIGHT 格式
    quality="hd",          # ✅ "standard" | "hd" | "medium"
    messages=[{"role": "user", "content": "一座未来主义风格的城市"}]
)

# Claude Messages API
curl -X POST http://127.0.0.1:8045/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-antigravity" \
  -d '{
    "model": "gemini-3-pro-image",
    "size": "1280x720",
    "quality": "hd",
    "messages": [{"role": "user", "content": "一只可爱的猫咪"}]
  }'

# 使用 imageSize 参数(最高优先级)
response = client.chat.completions.create(
    model="gemini-3-pro-image",
    size="16:9",           # 宽高比
    imageSize="4K",        # ✨ 直接指定分辨率: "1K" | "2K" | "4K"
    messages=[{"role": "user", "content": "一座未来主义风格的城市"}]
)

# Claude Messages API 也支持 imageSize
curl -X POST http://127.0.0.1:8045/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-antigravity" \
  -d '{
    "model": "gemini-3-pro-image",
    "size": "1280x720",
    "imageSize": "4K",
    "messages": [{"role": "user", "content": "一只可爱的猫咪"}]
  }'

response = client.chat.completions.create(
    model="gemini-3-pro-image-16-9-4k",  # 格式：gemini-3-pro-image-[比例]-[质量]
    messages=[{"role": "user", "content": "一座未来主义风格的城市"}]
)

📝 更新日志

最新版本 v4.7.13（2026-09-22）：新增「轻量模式」，关闭窗口或最小化到托盘时主动释放 WebView 渲染进程，后台常驻内存从约 160~250MB 骤降至约 30~35MB，反代网关 / 智能预热 / 额度监控 / 熔断器等核心服务 100% 常驻，托盘点击或二次启动应用即无感重建窗口；彻底解决账号切换后 IDE 自动重启偶发弹窗报错或无法拉起（严格过滤 language_server 引擎进程、跨平台启动参数安全清洗、macOS open --args 规范化传参）；修复 Gemini 系列账号无预热、流量日志缺失与倒计时不走动，解除未激活周配额冷启动死锁并联动自定义预热模型范围；默认过滤 GET /health 等高频探活请求，彻底杜绝探针刷屏淹没真实业务调用与 SQLite 存储膨胀，异常探活（5xx）仍完整保留用于故障诊断。

👉 查看完整更新日志 CHANGELOG.md →

• 版权许可: 基于 CC BY-NC-SA 4.0 许可，严禁任何形式的商业行为。
• 安全声明: 本应用所有账号数据加密存储于本地 SQLite 数据库，除非开启同步功能，否则数据绝不离开您的设备。