Skip to content

YesHub/Antigravity-Manager

BranchesTags
 
 

Repository files navigation

Antigravity Tools (2API 版本) 🚀

Antigravity Logo

不仅仅是账号管理，更是您的个人 AI 网关

完美代理 Gemini & Claude，兼容 OpenAI 协议，打破调用限制。

Version Tauri React License

📥 下载最新版 • 🔌 API 反代 (新!) • ✨ 账号管理

🇨🇳 简体中文 | 🇺🇸 English

Antigravity Tools 2API 次世代版本发布！这不仅仅是一个账号管理器，它将您的桌面变成了一个强大的 本地 AI 网关 (Local AI Gateway)。

通过内置的高性能 Rust 反代服务，您可以将浏览器中的 Web Session (sid, __Secure-1PSID 等) 转化为标准的 OpenAI API 接口。这意味着您可以在 Cherry Studio, NextChat, LangChain 等任何支持 OpenAI 协议的应用中，无缝调用 Gemini 和 Claude 的高级模型能力。（注：Cursor, Windsurf 暂不兼容）

寻找旧版文档? v2.0 纯账号管理版本的文档已移动至 README_v2.md。

🔌 深度解析：API 反代服务 (API Proxy)

Antigravity 的反代服务并非简单的请求转发，而是一个完整的 本地 AI 调度中心。

(极简配置，一键启动)

1. 🔄 智能账号轮询 (Smart Rotation)

当您添加了多个账号时，反代服务会自动接管调度：

  • 负载均衡: 自动在可用账号间轮询，避免单账号高频请求。
  • 自动故障转移 (Failover): 当某个账号触发 429 Too Many Requests 或 400 Bad Request 时，系统会 毫秒级 自动切换到下一个健康账号重试，用户端几乎无感。
  • 配额感知: 自动跳过配额耗尽的账号。

2. 🧠 完美上下文 (Context)

完全兼容 OpenAI messages 格式，支持多轮对话。无论您使用 NextChat, Chatbox 还是 Cursor，对话历史都能完美保留。

(多轮对话测试 @ NextChat)

3. 🛡️ 隐私与安全

  • 零日志: 我们不记录您的任何对话内容。
  • 直连 (可选): 默认通过本地代理直连 Google/Anthropic 服务器,数据不经过任何第三方中转（前提是您的网络环境允许）。

4. 🔗 多协议支持 (NEW!)

除了 OpenAI 协议,现在完美支持 Anthropic API 格式:

  • OpenAI 协议: /v1/chat/completions - 兼容 Cherry Studio, NextChat 等 (Cursor, Windsurf 暂不兼容)
  • Anthropic 协议: /v1/messages - 原生支持 Claude Code CLI 等工具
  • 自动转换: 无论使用哪种协议,底层都会自动转换为 Gemini 格式,实现完美兼容
📘 Claude Code CLI 配置指南

快速配置

临时使用 (每次打开终端时运行):

export ANTHROPIC_API_KEY="sk-antigravity"  # 使用应用生成的 API Key
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude "写一个快速排序算法"

永久配置 (一次设置,永久生效):

# 编辑配置文件 (macOS/Linux)
nano ~/.zshrc

# 添加以下内容到文件末尾
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"

# 保存后重新加载
source ~/.zshrc

使用示例

# 基本对话
claude "1+1 等于几"

# 多轮对话
claude "我问了什么问题"

# 代码生成
claude "用 Python 写一个快速排序算法"

注意事项

  1. 确保服务运行: 使用前确保 Antigravity API 代理服务正在运行
  2. API Key: 在 "API 反代" 页面复制生成的 API Key
  3. 端口配置: 默认端口 8045,如有修改需同步更新 ANTHROPIC_BASE_URL

🖼️ 能力展示 (Showcase)

Gemini 3 Pro Image (Imagen 3) Claude 3.5 Sonnet (Thinking)
NextChat - 图像编辑/生成 Windsurf/Cursor - 复杂代码生成

✨ 经典功能：账号管理

  • Token 自动保活: 自动刷新过期 Token，确保随时可用。
  • 可视化配额:
    • 文本额度: 精确显示 Gemini Pro / Claude 3.5 Sonnet 剩余百分比。
    • 图片额度 (新): 新增 Gemini Image (Vision) 额度监控，绘图/识图不再盲目。
  • 账号切换: 一键将账号 Token 注入到本地 Antigravity 数据库，实现无缝切换。
  • 托盘常驻: 极简托盘菜单，随时查看核心指标。

� 快速开始

1. 添加账号

在 "账号列表" 页面，通过 OAuth 登录或手动粘贴 Token 添加您的 Google/Anthropic 账号。

2. 启动服务

进入 "API 反代" 页面：

  1. 配置端口 (默认 8045)。
  2. 点击 "启动服务"。
  3. 复制生成的 API Key (默认为 sk-antigravity)。

3. 连接使用

在任何 AI 应用中配置：

  • Base URL: http://localhost:8045/ (部分应用可能需要填写 http://localhost:8045/v1)
  • Key: sk-antigravity (任意不为空的字符串)
  • Model: 请使用以下支持的模型 ID

📚 支持的模型列表 (Supported Models)

模型 ID 说明
gemini-3-flash Gemini 3 Flash。最新一代闪电模型 (Native)。
gemini-3-pro-high Gemini 3 Pro。Google 最强 reasoning 模型。
gemini-3-pro-low Gemini 3 Pro (Low)。低配额消耗版。
gemini-2.5-pro Gemini 2.5 Pro。平衡型主力模型。
gemini-2.5-flash Flash 2.5。极速响应，超高性价比。
gemini-2.5-flash-lite Flash 2.5 Lite。轻量级极致速度。
gemini-2.5-flash-thinking Flash Thinking。具备思考能力的模型 (注意：易触发限流)。
claude-sonnet-4-5 Claude 3.5 Sonnet。(映射) 代码与逻辑推理首选 (Native)。
claude-sonnet-4-5-thinking Sonnet Thinking。开启了思维链的 Sonnet (Native)。
claude-opus-4-5-thinking Opus Thinking。Claude 最强思维模型 (Native)。
gemini-3-pro-image Imagen 3。绘图专用模型 (默认 1:1 正方形)。
gemini-3-pro-image-16x9 Imagen 3 横屏。生成 16:9 横向图片。
gemini-3-pro-image-9x16 Imagen 3 竖屏。生成 9:16 手机壁纸。
gemini-3-pro-image-4k Imagen 3 高清。生成 4K 超清图 (1:1)。

🎨 图片生成高级控制

针对 gemini-3-pro-image 模型,您可以通过以下方式控制生成图片的分辨率和比例:

方式 1: 使用模型后缀 (推荐,适用于 Cherry Studio 等客户端)

  • 直接选择带后缀的模型名即可自动应用配置
  • 例如: 选择 gemini-3-pro-image-16x9 即可生成横屏图片

方式 2: 使用 API 参数 如果您使用的客户端支持自定义参数,可以在请求中添加:

{
  "model": "gemini-3-pro-image",
  "size": "1792x1024",     // 控制比例 (可选: 1024x1024, 1792x1024, 1024x1792, 1024x768, 768x1024)
  "quality": "hd"          // 控制分辨率 (可选: standard, hd)
}

💡 提示: 反代服务支持透传所有 Google/Anthropic 官方模型 ID，您可以直接使用官方文档中的任何模型名称。

🔄 版本更新

v3.1.1 (2025-12-18)

🌐 全局上游代理支持

  • 系统级代理集成：新增全局上游代理设置，支持 HTTP 和 SOCKS5 协议。开启后，应用内所有的外部网络请求（包含 API 反代、Token 刷新、配额查询、更新检测等）都将通过配置的代理进行。
  • 一键热重载 (Hot-Reloading)：
    • 修改代理配置或模型映射后点击保存即可实时生效。
    • 正在运行的反代服务会自动加载新配置，无需重启服务即可应用。
  • 后端架构优化：
    • 集中管理 HTTP 客户端创建逻辑，提升连接稳定性。
    • 采用 Arc<RwLock> 实现配置的线程安全共享与动态更新。
  • UI 体验升级：在“设置”页面中新增独立的“代理设置”标签页，与“API 反代”配置清晰分离。

🧹 代码质量与优化

  • 解决了 server.rs 中 upstream_proxy 字段未使用的编译器警告。
  • 清理了冗余代码与过时的导入，提升应用运行效率。

v3.1.0 (2025-12-18)

🚀 Claude Code 深度支持

  • 全系模型适配：完美支持 Claude 3.5 Sonnet / Haiku / Opus 及其 4.5 预览版
  • Thinking 模型原生支持：
    • 自动识别并处理 thinking 思维链内容
    • 适配 Gemini 2.0 Flash Thinking 和 Claude Sonnet Thinking
    • 智能预算控制：默认 8k 思考预算，最大化推理能力
  • System Prompt 完美支持：
    • 正确解析并传递 system 角色提示词，确保复杂任务的角色设定生效
    • 完美兼容 Claude Code 的各类系统指令

⚡ 核心反代重构

  • SSE 状态机重写：采用全新的状态机处理流式响应，彻底解决 Thinking 块与 Text 块的转换问题
  • 智能空响应处理：
    • 自动过滤无效的空 Chunk，解决 CLI 挂起问题
    • 增强的预检机制，提前拦截 404/403 错误
  • 模型热重载：修改模型映射配置后实时生效，无需重启服务

🐛 关键修复

  • 404 Not Found 修复：为 gemini-3-flash 等预览模型添加内部别名映射
  • UTF-8 编码修复：解决流式日志截断导致的 Panic 问题
  • Claude CLI 兼容性：修复 signature 字段导致的各种 CLI 报错

v3.0.3 (2025-12-17)

  • ✨ Refresh Token 批量导入: 支持 JSON 数组和 Regex 智能提取，一次性导入多个账号
  • 🐛 修复 Claude CLI 空响应: 彻底解决 MALFORMED_FUNCTION_CALL 和 thoughtSignature 导致的空文本问题
  • ⚡ API 代理优化: 提升 maxOutputTokens 至 16384，优化 403 错误处理

v3.0.2 (2025-12-17)

🔧 API 代理优化

  • 403 错误智能处理：账号遇到 403 Forbidden 时立即识别并标记,不再重试浪费时间

    • 自动标记为 "forbidden" 状态
    • 批量刷新时自动跳过 403 账号
    • 节省 3+ 秒响应时间

  • Claude CLI 响应优化：修复空响应和 JSON 格式问题

    • 增加 maxOutputTokens 从 8096 到 16384,支持更长回复
    • 移除 toolConfig 避免 MALFORMED_FUNCTION_CALL 错误
    • 添加详细诊断日志,记录 Gemini 原始响应

  • 日志系统增强：

    • 空文本响应时记录完整 candidates 数据
    • 日志显示长度从 60 增加到 100 字符
    • 区分空响应和正常响应的日志级别

🐛 Bug 修复

  • OAuth 环境检查优化：简化 Tauri 环境检查逻辑,只验证 invoke 函数可用性
    • 移除对 window.__TAURI__ 的检查
    • 避免在某些 Tauri 版本中的误报

v3.0.1 (2025-12-17)

🎉 新功能

  • Anthropic API 支持：新增 /v1/messages 端点,完美支持 Claude Code CLI 等原生 Anthropic 工具
    • 自动转换 Anthropic 请求格式为 Gemini
    • 支持完整的 SSE 流式响应（message_start, content_block_delta 等事件）
    • 兼容 system 提示词

🔧 Bug 修复

  • macOS 15.x 账号切换优化：重构进程关闭逻辑，采用 PID 精确控制 + SIGTERM → SIGKILL 渐进式策略，解决部分用户"无法关闭 Antigravity 进程"的问题
    • 超时时间从 10 秒增加到 20 秒
    • 添加详细日志输出便于诊断

✨ 功能增强

  • 图像生成能力提升：新增更多图片尺寸比例选项
    • 新增模型：gemini-3-pro-image-4x3, gemini-3-pro-image-3x4, gemini-3-pro-image-4k, gemini-3-pro-image-16x9-4k
    • 支持参数控制：size 参数新增 1024x768 (4:3) 和 768x1024 (3:4)
    • 支持 4K 高清：通过后缀 -4k 或参数 "quality": "hd" 启用

v3.0.0 (2025-12-16)

  • 🚀 首次发布 API 反代版本
  • 🔌 内置高性能 Rust 反代服务器
  • 🔄 智能账号轮询与故障转移
  • 🧠 完美支持 OpenAI 协议
  • 🖼️ 支持 Gemini Imagen 3 图像生成

📄 版权说明

Copyright © 2025 Antigravity. 本项目采用 CC BY-NC-SA 4.0 协议许可。 仅供个人学习研究使用，禁止用于商业用途。

About

Professional Antigravity Account Manager & Switcher. One-click seamless account switching for Antigravity Tools. Built with Tauri v2 + React (Rust).专业的 Antigravity 账号管理与切换工具。为 Antigravity 提供一键无缝账号切换功能。

Resources

Readme

License

View license
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 50.0%
  • Rust 48.9%
  • Other 1.1%