Antigravity Tools 🚀

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

您的个人高性能 AI 调度网关

不仅仅是账号管理，更是打破 API 调用壁垒的终极解决方案。

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

简体中文 | English

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

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

💖 赞助商 (Sponsors)

赞助商 (Sponsor)	简介 (Description)
	感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中转服务商，提供 Claude Code、Codex、Gemini 等多种服务的中转。PackyCode 为本项目的用户提供了特别优惠：使用此链接注册，并在充值时输入 “Ctrler” 优惠码即可享受 九折优惠。
	感谢 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 折！
	感谢 VisionCoder 对本项目的支持。VisionCoder 开发平台 是一个可靠高效的 API 中继服务提供商，提供 Claude Code、Codex、Gemini 等主流 AI 模型，帮助开发者和团队更轻松地集成 AI 功能，提升工作效率。此外，VisionCoder 还提供 Claude Max 200 与 GPT Pro 200 高级成品号的独家售卖渠道，助力体验全网顶配 AI 的算力与体验。
	感谢 APIKEY.FUN 赞助本项目！APIKEY.FUN 是一家专业的企业级 AI 中转站，致力于为企业和个人开发者提供稳定、高效、低成本的 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型，价格低至官方原价的 7%。通过本项目专属链接注册，还可享受最高 充值永久 95 折 专属优惠。

☕ 支持项目 (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/v4.2.6/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 ... | bash -s -- --version 4.2.6，预览模式 curl -fsSL ... | bash -s -- --dry-run

macOS - Homebrew

如果您已安装 Homebrew，也可以通过以下命令安装：

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

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

Arch Linux

您可以选择通过一键安装脚本或 Homebrew 进行安装：

方式 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 发行版

安装后会自动将 AppImage 添加到二进制路径并配置可执行权限。

选项 B: 手动下载

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

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

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

如果您希望在容器化环境中运行，我们提供了原生的 Docker 镜像。该镜像内置了对 v4.0.2 原生 Headless 架构的支持，可自动托管前端静态资源，并通过浏览器直接进行管理。

# 方式 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

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

• 内存: 建议 1GB (最小 256MB)。
• 持久化: 需挂载 /root/.antigravity_tools 以保存数据。
• 架构: 支持 x86_64 和 ARM64。 详情见: Docker 部署指南 (docker)

Copyright © 2024-2026 lbjlaq

🛠️ 常见问题排查 (Troubleshooting)

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

由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示。您可以按照以下步骤快速修复：

1. 命令行修复 (推荐): 打开终端，执行以下命令：
   copy

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

2. Homebrew 安装优势: 现在通过 Homebrew (brew install --cask antigravity-tools) 安装时，系统会在安装末尾自动执行清理属性的操作，真正实现开箱即用。

🔌 快速接入示例

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

1. 打开“Accounts / 账号” → “添加账号” → “OAuth”。
2. 弹窗会在点击按钮前预生成授权链接；点击链接即可复制到系统剪贴板，然后用你希望的浏览器打开并完成授权。
3. 授权完成后浏览器会打开本地回调页并显示“✅ 授权成功!”。
4. 应用会自动继续完成授权并保存账号；如未自动完成，可点击“我已授权，继续”手动完成。

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

如何接入 Claude Code CLI?

1. 启动 Antigravity，并在“API 反代”页面开启服务。
2. 在终端执行：

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

如何接入 OpenCode?

1. 进入 API 反代页面 → 外部 Providers → 点击 OpenCode Sync 卡片。
2. 点击 Sync 按钮，将自动生成 ~/.config/opencode/opencode.json 配置文件：
   • 创建独立 provider antigravity-manager（不覆盖 google/anthropic 原生配置）
   • 可选：勾选 Sync accounts 导出 antigravity-accounts.json（plugin-compatible v3 格式），供 OpenCode 插件直接导入
3. 点击 Clear Config 可一键清除 Manager 配置并清理 legacy 残留；点击 Restore 可从备份恢复。
4. Windows 用户路径为 C:\Users\<用户名>\.config\opencode\（与 ~/.config/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?

1. 协议选择: 建议优先使用 Gemini 协议。
2. Base URL: 填写 http://127.0.0.1:8045。
3. 注意:
   • 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）

方式二：Chat API + 参数设置 (✨ 新增)

所有协议（OpenAI、Claude）的 Chat API 现在都支持直接传递 size 和 quality 参数：

# 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` 参数 > `quality` 参数 > 模型后缀

**✨ 新增 `imageSize` 参数支持**:

除了 `quality` 参数外,现在还支持直接使用 Gemini 原生的 `imageSize` 参数:

```python
# 使用 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": "一只可爱的猫咪"}]
  }'

参数说明:

• imageSize: 直接指定分辨率 ("1K" / "2K" / "4K")
• quality: 通过质量等级推断分辨率 ("standard" → 1K, "medium" → 2K, "hd" → 4K)
• 优先级: 如果同时指定 imageSize 和 quality,系统会优先使用 imageSize

方式三：Chat 接口 + 模型后缀

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

模型后缀说明：

• 宽高比: -16-9, -9-16, -4-3, -3-4, -21-9, -1-1
• 质量: -4k (4K), -2k (2K), 不加后缀（标准）
• 示例: gemini-3-pro-image-16-9-4k → 16:9 比例 + 4K 分辨率

方式四：Cherry Studio 等客户端设置

在支持 OpenAI 协议的客户端（如 Cherry Studio）中，可以通过模型设置页面配置图片生成参数：

1. 进入模型设置：选择 gemini-3-pro-image 模型
2. 配置参数：
   • Size (尺寸): 输入任意 WIDTHxHEIGHT 格式（如 1920x1080, 1024x1024）
   • Quality (质量): 选择 standard / hd / medium
   • Number (数量): 设置生成图片数量（1-10）
3. 发送请求：直接在对话框中输入图片描述即可

参数映射规则：

• size: "1920x1080" → 自动计算为 16:9 宽高比
• quality: "hd" → 映射为 4K 分辨率
• quality: "medium" → 映射为 2K 分辨率

📝 开发者与社区

• 版本演进 (Changelog):
  • v4.2.6 (2026-06-22):
    • [核心修复] 修复了 Gemini 函数调用在多轮对话中缺失 thought_signature 报错 400 的 Bug (Gemini Tool Calling Fix):
      • 问题修复: 修复了在使用工具调用（Function Calling）功能时，由于代理在第二轮请求中向 /v1internal 接口发送驼峰命名的 thoughtSignature 字段，而接口实际校验蛇形命名的 thought_signature，导致 API 返回 400 INVALID_ARGUMENT 报错（Function call is missing a thought_signature）的问题。
      • 双重兼容: 优化了 OpenAI 映射器、Claude 映射器以及 Gemini 包装层，对思维链签名进行双重注入（同时发送 thoughtSignature 和 thought_signature），并在响应反序列化中添加别名兼容，确保在多轮对话中，工具调用的签名能够被安全地往返传输 (Issue #3202)。
  • v4.2.5 (2026-06-20):
    • [代理修复] 过滤并移除了工具参数中的布尔子 Schema (Strip Boolean Sub-schemas):
      • 问题修复: 修复了由于 JSON Schema 规范中允许布尔子 Schema（如 "someProp": false），而 Gemini API 的 Schema 协议要求 properties 和 items 必须是对象，从而导致上游接口直接返回 HTTP 400 错误的问题。
      • 过滤清理: 在 Schema 递归清理逻辑 clean_json_schema_recursive 中，自动丢弃 properties 内的非对象（布尔）字段（并同步从 required 中移除），丢弃非对象 items 属性，确保请求能够完全兼容 Gemini 的 Schema 协议限制并返回 200 (PR #3197)。
    • [流式修复] 移除 OpenAI 协议流式接口中的 __cloudCodeMeta 元数据 (Remove __cloudCodeMeta):
      • 问题修复: 修复了第三方通用客户端（如 Cherry Studio 等）在调用 /v1/chat/completions 时，因代理服务在流头部强制注入非标准 Trace ID（{"__cloudCodeMeta": {"traceId": ...}}）导致前端 Zod 类型强校验报错崩溃（AI_TypeValidationError）的问题。
  • v4.2.4 (2026-06-17):
    • [核心修复] 修复 IDE 新版协议下切换账号丢失历史会话的 Bug (History Loss Fix):
      • 问题修复: 修复了由于在写入新的 OAuth 凭证时，暴力覆盖 antigravityUnifiedStateSync.oauthToken 导致原本与 Token 存放在同一个 Topic 中的 authStateWithContextSentinelKey 等状态被意外抹除的问题。
      • 合并注入: 重构了底层 Protobuf 二进制协议解析，实现了针对新版状态字典的安全合并注入逻辑（Merge）。现在切换账号时，系统能完美保留现有项目上下文与登录态记录，IDE 不再会因状态残缺而意外清空历史对话。
    • [核心修复] 解决 Antigravity CLI (agy) 账号切换时的状态同步冲突问题 (CLI Sync Isolation):
      • 状态隔离: 在底层账户索引中引入 current_target_ide 字段，精准跟踪账号切换的目标环境。
      • 冲突规避: 增强了自动同步逻辑，如果当前处于 agy 目标环境，系统将主动跳过状态的同步拉取与回写，避免 CLI 专用的临时凭据与 Manager 主界面环境互相覆盖串扰 (PR #3186)。
  • v4.2.3 (2026-06-16):
    • [体验优化] 优化 Homebrew 安装体验，彻底免除“应用已损坏”弹窗 (Brew Cask Quarantine Auto-Clear):
      • 问题修复: 为 macOS 的 Homebrew Cask 安装添加了自动清理 com.apple.quarantine 属性的脚本，彻底解决了由于系统安全机制导致初次打开应用时弹出“应用已损坏”拦截的问题 (PR #3180)。
      • 体验优化: Homebrew 用户现在可以真正实现无缝的“开箱即用”体验，无需再手动执行去除隔离属性的终端命令。
    • [核心修复] 支持 HTTP 代理池配置热更新 (Proxy Pool Hot Reload):
      • 问题修复: 修复了在应用内修改 HTTP 代理池配置（如代理 URLs、端口绑定、认证凭证等）或上游代理设置后，无法在运行时实时生效、必须重启应用的问题 (PR #3183)。
      • 体验优化: 现在保存代理配置时，系统会立即在后台重新应用并加载最新的代理池状态，无需手动重启。
    • [核心功能] 新增 Antigravity CLI (agy) 账号无缝切换 (CLI Account Switcher):
      • 一键同步: 在账号管理界面中新增了针对 Antigravity 命令行工具 (agy) 的专属切换支持 (PR #3184)。
      • 凭证注入: 当点击切换时，目标账号的 OAuth 凭证会自动写入系统的凭据管理器 (Keyring) 和设备配置文件中，使得 agy 命令行工具无需二次认证即可立即使用最新账号。
    • [核心修复] 移除冗余版本检测逻辑，优化 IDE 账号切换 (IDE Login Optimization):
      • 问题修复: 移除了在 IDE 环境下切换账号时多余的版本号检测步骤，解决了因 Windows 环境下执行 PowerShell 解析版本出错导致注入失败、无法登录的问题。
      • 效率提升: 直接强制采用最新的统一格式 (antigravityUnifiedStateSync.oauthToken) 注入到 SQLite 数据库，消除了老旧格式带来的兼容负担。
    • [核心修复] 修复了 Gemini 3.1 Pro High/Low 的 400 Invalid Argument 错误 (Gemini Thinking Fix):
      • 问题修复: 修复了 Claude Code 等上游客户端发送 thinking 相关配置对象时，由于 Gemini 3.1 Pro High/Low 尚不支持特定的思维配置被拒绝的问题。系统现已针对这些变体模型正确剥离不支持的 thinkingConfig 对象，从而解决了 API 响应 400 的错误 (Issue #3182)。
    • [核心功能] 将 Claude 详细配额组数据暴露给前端并优化展示 (Claude Quota UI Expose):
      • 功能新增: 在后端和接口层中新增了对模型分组配额（如 weekly 和 5h 窗口）的完整支持，并在账号详情页引入全新的 Tab 切换交互，使用户能直观查看各模型的详细双窗口配额分配情况 (PR #3185)。
      • 问题修复: 修复了由于缺少依赖 (BoringSSL 构建工具) 导致的本地分发版 Docker 编译报错问题，并添加了缺少的 Tauri 前端资源映射步骤。
  • v4.2.2 (2026-06-12):
    • [安全与稳定] 安全审计与错误修复 (Security & Bug Fixes):
      • 核心修复: 修复了当代理认证模式设置为 Off 时，管理接口存在权限绕过的漏洞 (PR #3134)。
      • 凭证保护: 修复了在 Headless 模式启动时明文打印敏感凭证的问题，现改为仅打印状态 (PR #3134)。
      • 路径隔离: 增加了基于绝对路径的安全校验逻辑，修复了文本文件读写命令中的路径遍历漏洞 (PR #3134)。
      • 加密加固: 修复了 AES-GCM 加密使用固定 Nonce 的漏洞，引入了安全的随机 Nonce 机制并向下兼容 (PR #3134)。
      • 前端安全: 修复了 Tauri CSP 策略允许不安全的 unsafe-eval 的问题，防范 XSS 攻击 (PR #3134)。
      • 协议兼容: 修复了在使用 Codex 时因混入不被支持的 tools 字段导致的 400 INVALID_ARGUMENT 错误 (PR #3148)。
• v4.2.1 (2026-05-20): - [核心修复] Windows 进程隔离与进程查杀优化 (Windows Process Segregation): - 问题修复: 解决了在 Windows 平台切换 Antigravity 与 Antigravity IDE 时导致双方进程意外互相误杀的问题。 - 严格路径过滤: 引入了基于可执行文件绝对路径 (canonicalize()) 的严格匹配机制。当用户在配置中显式指定路径后，系统将仅管理与该路径匹配的进程，避免由于模糊匹配引发意外查杀。 - ⚠️ 重要提示: Windows 用户务必在“设置 -> 高级”中，分别配置经典版自定义路径 (antigravity_executable) 和 IDE 自定义路径 (antigravity_ide_executable)，以激活严格的路径隔离机制。若未配置路径，系统将回退至模糊的进程名称匹配，这可能会在切换账号时导致意外关闭。

  • v4.2.0 (2026-05-20):

    • [核心功能] 新增 Antigravity IDE 账号一键切换与独立的双切换按钮:
      • 双通道一键切换: 在账号管理的操作面板中，针对经典版（Classic）与新版（IDE）分别提供了独立的账号切换按钮，支持用户在同一界面直接控制两个版本的账号状态。
      • 物理隔离与多版本共存: 实现了经典版与 IDE 版底层数据、state.vscdb 数据库及配置文件路径的完全物理隔离，保障两版本配置与凭证互不干扰、完美共存。
      • 进程智能避让控制: 重构了 Rust 后端的进程管理逻辑，确保在进行 IDE 切换或关闭操作时，能够精准定位对应进程，绝不误伤或错误关闭 Classic 版本的后台运行状态。
    • [多版本兼容性重构] 智能多版本切换与 OS Keychain 系统凭据管理器支持:
      • 原生 2.0.0+ 客户端 Keychain 注入: 针对 >= 2.0.0 以上的原生客户端，实现了将 OAuth 凭据以特定 JSON Base64 格式写入系统凭据管理器的功能，免除了对 storage.json 的强依赖，彻底解决因文件缺失导致的切换中断问题。
      • 跨平台无感静默写入: 针对 macOS 提供 security 命令行配合 -A 彻底打通本地应用免密读取权限，实现零弹窗无感切换；同时完美实现 Windows (cmdkey 静默命令) 与 Linux (secret-tool) 平台的原生 Keychain/Keyring 凭据极速注入。
      • 版本自动检测与平滑降级: 引入智能版本探测机制。检测到原生应用版本 < 2.0.0 时自动采用原有的 SQLite 数据库和机器指纹注入分支以向下兼容；若检测到版本 >= 2.0.0 则优雅执行 Keychain 注入；针对 Antigravity IDE 版则强制保持原有的 SQLite 注入机制绝对不变，达成完美的逻辑隔离。
    • [前端交互与动效升级] 独立的个性化切换图标与顺滑旋转微动效:
      • 差异化专属图标: 为新版 IDE 设计了独立且极具折角循环几何感的全新 Repeat2 切换图标，与 Classic 版的 ArrowRightLeft 箭头形成清晰直观的差异化，提升交互辨识度。
      • 旋转微动效升级: 将切换状态 (isSwitching) 下的动画从温和的 animate-pulse 升级为顺时针匀速旋转的 animate-spin 微动画，使得切换过程在视觉反馈上更具流畅度和动感质感。
    • [国际化缺陷修复] 全系统 12 国语言无缝对齐，彻底解决 Tooltip 汉字回退:
      • 多语言翻译对齐: 修复了此前非中文环境下，经典版和新版切换按钮悬停提示 Tooltip 回退为默认中文的缺陷。
      • 全语系包覆盖: 在 en.json, zh.json, zh-TW.json, ja.json, ko.json 等全部 12 个多语言翻译包 中精准补充并对齐了 accounts.switch_to_classic 与 accounts.switch_to_ide 翻译键，实现全球多语言悬停精准提示。

  • v4.1.33 (2026-05-01):

    • [核心修复] 解决 Antigravity IDE OAuth Token 刷新失效及 invalid_grant 报错问题。
    • [核心修复] 解决由于项目 ID 冲突导致的 403 报错，并实现企业/个人配额的自动重试降级。
    • [功能增强] 支持旧账号数据的自动兼容与静默升级，旧用户无需重新登录即可恢复功能。

  • v4.1.32 (2026-04-18):

    • [代理增强] Gemini 代理生产级稳定性重构:
      • 指纹同构化: 重写 requestId 生成逻辑，严格遵循官方 agent/{timestamp}/{hex8} 路径指纹。
      • 链路追踪注入: 在 OpenAI/Claude 协议转换层强制注入 __cloudCodeMeta 追踪 ID，实现协议级流量拟真。
      • 冗余重试窗口: 针对 10xx/503/529 等瞬时错误实现 1500ms 原地容错窗口，大幅提升高并发稳定性。
    • [核心修复] 修正反代服务拦截漏洞 (Issue #3027):
      • 修复了在应用启动但未点击“启动”按钮时，后端代理端口已处于活动状态并能处理请求的逻辑缺陷。
      • 现在服务初始运行状态默认为禁止，只有在显式启动（手动或自动）后才会放行代理流量，确保了 UI 状态与后端逻辑的严格一致。
      • 管理后台 API 路径已做豁免处理，确保基础管理功能不受影响。
    • [核心修复] 彻底解决账号切换时的“状态失效”与“指纹冲突”问题:
      • 指纹同步: 实现了 serviceMachineId 在磁盘配置与 state.vscdb 数据库间的同步注入，解决了切换账号后 VS Code 弹出“环境变更”并要求重新登录的顽疾。
      • 校验降级: 弱化了企业版账号的项目预检逻辑。当无法自动解析到 project_id 时，系统将改为记录警告而非抛错中断切换，确保权限受限账号依然可以完成切换并正常使用。
    • [重要提示] 账号切换与风险建议:
      • 自动重试提示: 如果在 Antigravity 客户端不停地出现 retry，请尝试切换账号使用即可。
      • 风险控制说明: 对于反代用户，虽然本次更新了部分增强，但使用第三方工具仍可能因违反服务条款而被暂停使用。如有必要，建议使用 Free 账号或企业 Free 账号。

  • v4.1.31 (2026-03-25):

    • [推荐项目] 支持新成员 Antigravity-Tools-LS: 专为 AI 协议设计的语言服务器，提供极致的开发辅助与调试体验。
    • [核心修复] 稳定企业切换与多 OAuth 客户端认证 (PR #2330):
      • 多客户端支持: 引入了对多 OAuth-client 的支持与 oauth_client_key 跟踪机制，支持主动切换。
      • 企业模式增强: 加格了企业模式切换时的预检（检测 project_id），并优化了失败提示。
      • 状态显示优化: 改进了需要验证 (Verification Required)、风险 (Risk)、受限 (Rate Limited) 等异常账号状态的 UI 显示。
      • API 访问回退: 为 fetchAvailableModels 接口添加了 Sandbox -> Daily -> Prod 的自动回退路径，在遇到 429 或 5xx 错误时自动尝试备选环境。
    • [代理修复] 修复使用 Gemini v1internal 协议时的 400 错误 (PR #2356):
      • 冲突避让: 解决了 v1internal 协议不支持同时使用 googleSearch 和 functionDeclarations 的限制。
      • 智能注入: 现在当请求中包含函数定义时，代理将自动跳过 Google 搜索工具的注入，确保请求成功率。
    • [代理修复] 标准化 Gemini SSE 错误格式，防止 IDE 崩溃 (Issue #2371):
      • 格式规范化: 将 Gemini 处理器的流式错误输出包装为标准 OpenAI choices 格式，彻底解决了 IDE 解析器因 TypeError 导致的 UI 冻结问题。
      • 连接自愈: 为 SSE 流添加了标准的 data: [DONE] 终止符，并优化了错误状态下的存储路径探测逻辑。

  • v4.1.30 (2026-03-15):

    • [核心优化] 引入 fetchAvailableModels 接口的多级降级机制 (PR #2329):
      • 端点降级策略: 为 fetchAvailableModels API 引入了 Sandbox -> Daily -> Prod 的端点自动降级机制。当请求遇到 429 (Too Many Requests) 或 5xx 服务器错误时，系统会自动平滑切换到备选端点，显著提升了配额刷新和模型列表获取的稳定性。
      • 逻辑对齐: 将配额获取的错误处理和重试逻辑与核心 API 处理器 (Handler) 进行了对齐，确保了请求管道在极端情况下的行为一致性。
    • [核心修复] 优化 Gemini SSE 流错误处理，防止传输编码错误 (PR #2322):
      • 错误封装导出: 修复了 Gemini SSE 流 en 遇到上游错误时直接抛出原始错误导致客户端触发 TransferEncodingError 的问题。系统现在会将流错误捕获并封装为标准的 JSON 格式数据帧输出，确保连接能够优雅关闭并向前端传递清晰的错误信息。
      • 多协议对齐: 该修复同步应用到了 Gemini 原生处理器与 Claude 协议映射器，确保了跨协议流式输出的一致性和健壮性。

  • v4.1.29 (2026-03-12):

    • [重要提醒] 谷歌风控与第三方工具使用风险:
      • 由于谷歌加强风控，第三方工具会违反服务条款而被暂停使用 Antigravity、Gemini CLI 或 Gemini Code Assist。
      • 使用第三方软件、工具或服务访问 Antigravity、Gemini CLI 或 Gemini Code Assist（例如，使用 OpenClaw 和 Antigravity OAuth）违反了适用的条款和政策。此类行为可能导致您的帐户被暂停或终止。建议只使用切换功能
      • 申诉链接: 如果您认为帐户被误封，请通过 此链接 进行申诉。
      • 如果你对新的反代功能感兴趣可以查看 TG 频道 获取最新动态。
      • 
    • [核心功能] 账号感知的动态模型重映射与回退 (PR #2286):
      • 动态回退逻辑: 解决了由于不同账号对 Gemini Pro 模型层级（如 high / low）访问权限不一致导致的 404/400 报错问题。系统现在会根据选中账号的实际权限，在同系列模型间自动执行平滑回退（例如：gemini-3.1-pro-high -> gemini-3.1-pro-low -> 默认层级）。
      • 账号权限实时校验: 在请求进入处理器前，动态通过账号文件数据校验目标模型的可用性，实现真正意义上的“账号感知”调度。
      • 重映射优先级优化: 确立了 API 弃用规则 > 账号感知回退 > 用户自定义映射 > 系统默认映射 的科学优先级链条。
      • 文档同步: 新增了 docs/model-remapping-logic.md，完整记录了复杂的重映射逻辑流程。
    • [核心修复] Windows CLI 探测增强与路径扫描优化 (PR #2298):
      • 路径主动扫描: 引入了对 APPDATA、LOCALAPPDATA 以及 NVM_HOME 等路径的自动扫描机制，确保即使 CLI 未正确配置在系统 PATH 中也能被精准识别。
      • 脚本处理优化: 改进了 Windows 环境下 .cmd 和 .bat 脚本的调用方式，解决了直接执行无法稳定获取版本号的问题。
      • 执行安全加固: 新增了路径安全性校验逻辑，通过绝对路径检查与危险字符过滤，有效防范命令注入风险。
    • [持续集成] 引入 GitHub Actions CI 工作流 (PR #2298):
      • 自动化质量控制: 构建了基础的 CI 流水线，涵盖 Rust 代码格式化检查、静态分析以及跨平台编译测试，提升了代码合规性与交付稳定性。

  • v4.1.28 (2026-03-03):

    • [重要提醒] 谷歌风控与第三方工具使用风险:
      • 由于谷歌加强风控，第三方工具会违反服务条款而被暂停使用 Antigravity、Gemini CLI 或 Gemini Code Assist。
      • 使用第三方软件、工具或服务访问 Antigravity、Gemini CLI 或 Gemini Code Assist（例如，使用 OpenClaw 和 Antigravity OAuth）违反了适用的条款和政策。此类行为可能导致您的帐户被暂停或终止。
      • 申诉链接: 如果您认为帐户被误封，请通过 此链接 进行申诉。
      • [后续规划] 关于未来版本更迭:
        • 我们计划在后续推送新版本，届时可能会将“账号切换”与“反代代理”功能解耦为独立的模块或工具。
        • 由于作者近期工作繁忙，发布可能会有延迟，感谢理解。
        • 欢迎关注公众号 Ctrler 或 TG 频道 获取最新动态。
      • 请谨慎使用本项目。
    • [核心修复] 全系列模型限流锁定修复 (Fix Issue #2209):
      • 统一归一化逻辑: 修复了 Claude 和 Gemini 系列模型在发生 429 (Too Many Requests) 错误时，由于限流 Key 未归一化导致负载均衡器无法识别锁定状态的问题。
      • 熔断器联动增强: 确保即使在禁用"额度保护"的情况下，内置熔断器也能通过归一化后的模型 ID（如 claude, gemini-3-flash 等）精确拦截已耗尽账号，消除 90s 的无效等待。
    • [核心修复] Gemini 系列模型 adaptive 模式下错误注入 thinkingLevel 导致 400 报错 (Fix Issue #2208):
      • 根因定位: 4.1.27 引入的自适应识别逻辑将 gemini-3.1-pro-high / gemini-3.1-pro-low 等 Gemini 系列模型误判为支持 thinkingLevel，而 thinkingLevel 是 Vertex AI Claude 原生协议专有参数，Gemini 系列底层走 v1internal 协议，仅接受 thinkingBudget，导致请求被 Google API 拒绝并返回 400 INVALID_ARGUMENT。
      • 条件收窄: 将注入 thinkingLevel 的触发条件从 contains("gemini-3") 修正为 contains("claude")，确保 thinkingLevel 仅在 Claude 协议路径下注入，Gemini 系列模型在 adaptive 模式下统一回落到安全的 thinkingBudget: 24576。
      • 零附带损伤: OpenAI 协议与 Gemini 原生协议路径本身无此问题，本次修复仅针对 Claude 协议映射器，影响范围最小。
    • [核心修复] 修复 Claude Code 4.1.27+ 联网搜索 (Internal Tool) 失效问题 (Issue #2224):
      • 混合工具支持: 克服了 Gemini v1internal API 对 googleSearch 与自定义 functionDeclarations 同时使用的限制。
      • 智能感知注入: 重构了工具注入引擎，实现在 Gemini 2.0+ 和 3.0 系列模型上自动同时开启内置搜索与自定义开发者工具。
      • 多协议对齐: 本次修复同步覆盖了 OpenAI 和 Gemini Native 协议，确保全协议栈在高性能模型下的联网能力一致性。
      • 后向兼容: 针对旧版 Gemini 1.5 模型保留了自动排他转换逻辑，规避 400 错误。
    • [核心修复] gemini-3-flash / gemini-3.1-flash 函数调用时缺少 thought_signature 导致 400 报错 (Fix Issue #2167):
      • 根因定位: 三个协议映射器（OpenAI / Claude / Gemini 原生）的模型识别逻辑均未将 gemini-3-flash 系列纳入 "thinking 模型" 范畴，致使在首次函数调用（无 Session 签名缓存）时，thoughtSignature 字段未被注入，Google v1internal API 返回 400 INVALID_ARGUMENT。
      • OpenAI 协议: 新增 is_gemini_flash_thinking 判断变量，在 functionCall 构建阶段，当 Session 缓存为空时自动注入哨兵值 skip_thought_signature_validator。
      • Claude 协议: 将 gemini-3-flash / gemini-3.1-flash 加入 target_model_supports_thinking 识别列表；无签名时 flash 模型不再强制禁用 thinking，改为依赖现有哨兵注入路径（build_contents L1249-1256），保留模型思考能力。
      • Gemini 原生协议: 在 wrap_request 的 functionCall 处理块中，当 Session 缓存为空时对 flash 模型补充哨兵 fallback，覆盖首次调用场景。
      • 零附带损伤: flash 模型不触发 thinkingConfig 注入逻辑，不影响非思考类请求的正常路径；顺带修复了 test_wrap_request_with_signature 单元测试中 session_id 参数位置错误的既有 Bug。
    • [核心修复] Token 统计时区偏差修复 (Fix Issue #2214):
      • 自动时区贴合: 将 Token 统计的基准时间从标准时间 (UTC) 切换为系统本地时间 (Local Time)。
      • 全球多时区支持: 引入了 SQLite 'localtime' 转换机制。无论用户身处全球何处，统计图表的时间轴都将自动与其系统时钟对齐，彻底解决了北京时间或其他非 UTC 时区下的数据错位问题。

  • v4.1.27 (2026-03-01):

    • [核心优化] 代理配置初始化与工具图片保留修复 (Issue #2156):
      • 补全默认配置: 修复了 ProxyConfig 默认初始化时缺失 global_system_prompt、proxy_pool 和 image_thinking_mode 字段导致的编译失败问题。
      • 模式匹配完善: 补充了 OpenAIContentBlock 枚举匹配中的未知类型兜底分支 (_ => {})，消除非穷尽匹配的编译警告/错误。
      • 图片无条件保留: 移除冗余的 preserve_tool_result_images 开关，现已强制保留 tool_result 中的图片数据结构，转为大模型支持的 inlineData 结构，大幅简化逻辑。
    • [功能增强] 修改 docker-compose.yml 的配置 (PR #2185):
      • 命名空间更新: 将构建的默认镜像名称从 antigravity-manager 更新为 lbjlaq/antigravity-manager。
      • 环境变量占位符: 为环境变量添加了带默认值的占位符语法，允许用户通过宿主机的环境变量或 .env 文件来灵活覆盖默认配置。
    • [核心修复] OpenCode thinking budget 参数全面兼容 (Issue #2186):
      • 架构支持：解决了 Vercel AI SDK (@ai-sdk/anthropic) 配合 OpenCode 使用时，因原生蛇形命名 budget_tokens 导致系统无法启动并抛出 AI_UnsupportedFunctionalityError: 'thinking requires a budget' 的问题。
      • 双字段输出：在向 OpenCode / Claude CLI 等外部客户端同步模型配置时，自动同时输出标准的 budget_tokens 与小驼峰的 budgetTokens 字段。
      • 服务端适配：后端配置解析器现已原生支持这两种命名变体。
    • [核心修复] 解决免费账号配额耗尽后的无限重试与路由死锁问题 (Issue #2184)：
      • 问题根源：修补了 Google API fetchAvailableModels 接口在特定负载下无法正确返回 remainingFraction 的缺陷。由于缺失 project 标识，导致接口错误地为已耗尽配额（HTTP 429）的账号返回 1.0（100%），进而导致智能路由算法将请求持续分配给不可用账号，引发长时间重试及配额显示错误。
      • 负载修复：修改配额刷新请求，在负载中精准注入正确的 {"project": project_id} 结构。恢复了配额信息的准确感知，并在未破坏原生字段（如 supportsThinking）的前提下实现了接口完全兼容。
      • 自愈恢复：通过读取真实配额，系统现已能够实时识别免费账号的耗尽状态并将其可用度置为 0%，无缝触发多账号自愈轮询（Smart Status Self-healing），解决请求受阻与长等待问题。
    • [核心修复] 解决首页 Gemini 绘图平均配额显示为 0 的问题 (Issue #2160)：
      • 匹配更新：将 Dashboard 中的绘图模型匹配逻辑从硬编码的 gemini-3-pro-image 更新为包含最新的 gemini-3.1-flash-image。
      • 配置同步：在 modelConfig.ts 中补全了新版绘图模型的 UI 定义，确保图标和标签正常渲染。
    • [核心功能] 全协议动态模型规格 (Model Specs) 集成 (Issue #2176)：
      • 动态引擎：实现了“动态优先、静态兜底”的规格引擎，优先识别 API 返回的 max_output_tokens 等硬限额数据。
      • 静态资源：引入 model_specs.json 集中管理 30+ 种模型的默认参数，彻底告别映射器中的硬编码逻辑。
      • 协议注入：统一了 OpenAI、Claude 和 Gemini 协议处理器对 Token 限额的注入方式，增强了跨版本兼容性。
    • [核心修复] 深度解决 Claude -> Gemini 3 路径下的 400 INVALID_ARGUMENT 异常：
      • 自适应识别：修正了自适应模式逻辑，确保映射后的 Gemini 3 模型能正确使用 thinkingLevel 支持，而非失效的 budget 逻辑。
      • 冲突规避：实现了参数排他性检查，在开启分级思维时自动剥离不兼容的 thinkingBudget。
      • Token 溢出保护：为 maxOutputTokens 自动提升补齐逻辑增加了 65536 的模型硬上限保护，根除参数越界导致的请求失败。

  • v4.1.26 (2026-02-27):

    • [功能增强] 优化配额刷新逻辑，支持同步禁用账号:
      • 逻辑放宽: “刷新所有”和“批量刷新”现在不再跳过标记为 disabled 或 proxy_disabled 的账号。
      • 自动恢复: 允许通过刷新操作尝试重新激活因 Token 过期或临时错误而被禁用的账号，提升了多账号管理的灵活性。
    • [核心修复] 修复 Windows 系统下后台任务导致 cmd 黑框闪烁的问题:
      • 静默执行: 通过为 std::process::Command 封装注入 CREATE_NO_WINDOW 标志，解决了在 Windows 端应用底层组件（如版本探测、重启更新等）调用系统命令时引发的命令行窗口一闪而过的视觉干扰，确保全过程无边框静默执行。

  • v4.1.25 (2026-02-27):

    • [核心功能] 动态画图模型与新架构支持:
      • 动态解析: 移除了针对 gemini-3-pro-image 的硬编码限制。通过新增的 clean_image_model_name 智能清洗后缀（如 -4k, -16x9），全面兼容如 gemini-3.1-flash-image 等任意未来新增的画图模型。
      • 配额自适应: 优化了 normalize_to_standard_id，使用 image 关键词宽泛匹配，确保新模型也能正确触发配额保护机制。
    • [核心功能] 聊天接口 (Chat Completions) 画图拦截支持:
      • 跨界融合: OpenAI 和 Claude 协议的对话流现在能智能探测画像生成意图。当使用带有 image 的模型名时，系统会将常规文本生成请求静默转移给高级画图引擎。
      • 流式回显: 生成完成后，通过 Markdown 格式（![Generated Image](https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/HEAD/url)）以 SSE 流式返回图片链接，完美适配所有支持 Markdown 的聊天客户端。
    • [核心修复] 彻底修复画图重定向 404 与参数穿透失效:
      • 404 移除: 移除了底层调用中残留的旧模型硬编码，根除因模型信息不一致导致的 404 Not Found 崩溃及账号受损。
      • 精准参数继承: 修复了未传参数时系统强制塞入默认 1024x1024 的行为。现在，如果模型名带有后缀（如 gemini-3-pro-image-16x9-4k），后台会严格优先解析后缀分辨率进行穿透绘图。

  • v4.1.24 (2026-02-26):

    • [功能调整] 禁用自动预热调度程序，保留手动预热:
      • 变更说明: 为了减少不必要的后台资源占用，本版本已注释掉自动预热（Smart Warmup）的后台调度逻辑。
      • 设置隐藏: 设置页面中的“智能预热”配置项已隐藏。
      • 手动保留: 账号管理页面的手动预热功能保持不变，仍可正常使用。
      • 恢复指引: 如果您需要自动预热功能，可以自行拉取本项目源代码，在 src-tauri/src/lib.rs 中取消 start_scheduler 的注释并解除 Settings.tsx 中相关 UI 的注释后重新编译使用。
    • [核心修复] 智能版本指纹选择与启动 Panic 修复 (Issue #2123):
      • 问题根源: 1) constants.rs 中的 KNOWN_STABLE_VERSION 硬编码了低版本号，当本地 IDE 检测失败时回退该版本作为请求头，导致 Google 拒绝 Gemini 3.1 Pro 模型。2) 新增的远端版本网络调用直接在 LazyLock 初始化（Tokio 异步上下文）中执行，导致 Cannot block the current thread 严重崩溃。
      • 修复方案: 1) 引入"智能最大版本"策略 max(本地版本, 远端版本, 4.1.27)，始终取最高值。2) 将网络探测逻辑移至独立 OS 线程并配合 mpsc 通道，安全避开异步运行时限制。保证无论本地版本新旧，指纹均不低于上游要求，且应用能稳定启动。
    • [核心修复] 动态模型 maxOutputTokens 限额系统 (替代 PR #2119 硬编码方案):
      • 问题根源: 部分客户端发送的 maxOutputTokens 超过模型物理上限（如 Flash 限制 64k），导致上游返回 400 错误。
      • 三层限额架构:
        • 第一层（动态优先）: 实时读取账号 quota.models 数据。
        • 第二层（静态默认表）: model_limits.rs 内置已知限额（如 Flash 65536）。
        • 第三层（全局兜底）: 默认 131072。
      • 实现细节: 在 wrap_request() 中注入裁剪逻辑，确保请求参数合法。

  • v4.1.23 (2026-02-25):

    • [安全增强] 优化与原生对齐应用层与底层特征指纹，提升请求稳定性与防拦截能力。
    • [核心修复] 将 v1beta thinkingLevel 转换为 v1internal thinkingBudget (PR #2095):
      • 问题根源: OpenClaw、Cline 等客户端发送 v1beta 格式的 thinkingLevel 字符串（"NONE" / "LOW" / "MEDIUM" / "HIGH"）到 generationConfig.thinkingConfig。当 AGM 通过 Google v1internal API 代理请求时，Google 会因为 v1internal 仅接受数字型 thinkingBudget 而拒绝请求，返回 400 INVALID_ARGUMENT。
      • 修复方案: 在 wrap_request() 的现有 budget 处理逻辑之前，新增一个早期转换步骤：检测 thinkingLevel 字符串，将其映射为对应的数字 thinkingBudget（NONE→0, LOW→4096, MEDIUM→8192, HIGH→24576），然后删除 thinkingLevel 字段并写入 thinkingBudget，确保下游所有 budget 处理逻辑（预算封顶、maxOutputTokens 调整、自适应检测）都能看到正确的数值预算。
      • 测试: 已验证 OpenClaw 发送 thinkingLevel: "LOW" 到 gemini-3.1-pro-high（Gemini 原生协议），请求现返回 200 OK，不再报 400 错误。
    • [核心修复] 账号数据损坏与后台任务无限循环修复 (PR #2094):
      • 问题根源: 当用户在设置中输入过大的刷新间隔值（如 999999999）时，interval * 60 * 1000 超过 JS 引擎 32 位有符号整数上限 2,147,483,647ms，浏览器会将 setInterval 延迟静默截断为 1ms，导致前端每秒触发数千次 refreshAllQuotas/syncAccountFromDb 请求，进而引发多线程并发写同一 [uuid].json 文件，造成字节流交错、JSON 尾部残留，账号数据永久损坏。
      • 原子文件写入 (account.rs): save_account 改为先写入 UUID 后缀的临时文件，再通过 fs::rename（POSIX）/ MoveFileExW（Windows）原子替换目标文件，与已有的 save_account_index 保持一致，从根本上消除并发写导致的 JSON 损坏。
      • setInterval 溢出保护 (BackgroundTaskRunner.tsx): 对 refresh_interval 和 sync_interval 两个定时器的延迟参数加上 Math.min(..., 2147483647) 上界限制，防止超过 INT32_MAX 后被浏览器截断为 1ms 无限循环。
      • 输入验证 (Settings.tsx): 将 refresh_interval 和 sync_interval 输入框的 max 属性从 60 更新为 35791（35791 min × 60000 < INT32_MAX），并在 onChange 中添加 NaN fallback（默认为 1）及范围夹紧 [1, 35791]，从源头阻断非法值输入。
    • [核心优化] OAuth 换票专属：剔除 JA3 指纹与动态 User-Agent 伪装:
      • 纯净请求: 仅针对 exchange_code（首次授权）和 refresh_access_token（静默续期）的换票请求，移除了底层网络库的 Chrome JA3 指纹伪装，恢复标准纯净的 TLS特征。
      • 动态 UA: 换票时自动提取编译时版本号 (CURRENT_VERSION) 构建专属的 User-Agent（如 vscode/1.X.X (Antigravity/4.1.27)），以匹配纯净 TLS 链路。
    • [功能增强] API 反代页面与设置页模型列表全面接入动态模型数据:
      • 问题根源: "API 反代 → 支持模型与集成"列表与"模型路由中心"的目标模型选择下拉框，以及"设置 → 固定配额模型"列表，此前均仅从静态 MODEL_CONFIG 读取硬编码模型信息，导致账号实际下发的动态新模型（如 GPT-OSS 120B、Gemini 3.1 Pro (High) 等）无法出现在这些列表中。
      • 修复方案:
        • 重构 useProxyModels Hook：以账号 quota.models 动态数据为第一优先数据源，聚合所有账号里所有模型的 display_name（为主展示名称）和 name（为模型 ID）；MODEL_CONFIG 仅作为图标/分组的样式补充，以及无账号数据时的静态兜底。
        • 新增自动懒加载逻辑：ApiProxy 页面本身不调用 fetchAccounts，现在 Hook 内部检测到 store 为空时自动触发，保证动态模型在任意导航路径下均可正常展示。
        • 重构 PinnedQuotaModels 组件：采用同等策略，从 useAccountStore 拉取全账号动态模型，并修复了已固定的 "thinking" 类型模型显示"未知"的问题，改为优先展示其真实 display_name。
      • 去重优化: 所有列表均基于模型原始 name（小写）去重，并额外过滤掉 -thinking 后缀的 MODEL_CONFIG 静态别名条目（这类变体已由账号数据中的 supports_thinking 标记覆盖）。

  • v4.1.22 (2026-02-21):

    • [重要提醒] 2api 风控风险提示:
      • 由于近期的谷歌风控原因，使用 2api 功能会导致账号被风控的概率显著增加。
      • 强烈建议: 为了确保您的账号安全与调用稳定性，建议减少或停止使用 2api 功能。目前更原生、更稳定的 gRPC (application/grpc) 或 gRPC-Web (application/grpc-web) 协议代理支持仍在积极测试中，如果您有相关的测试经验或想法，非常欢迎联系讨论，也欢迎您建立新分支一起探索！
      • 📸 点击查看 gRPC 实时转换 OpenAI 规范测试演示

        
    • [核心优化] Claude Sonnet 4.5 迁移至 4.6 (PR #2014):
      • 模型升级: 引入 claude-sonnet-4-6 及 claude-sonnet-4-6-thinking 作为主推模型。
      • 平滑过渡: 自动将 legacy 模型 claude-sonnet-4-5 重定向至 4.6。
      • 全局适配: 更新了全部 12 种语言的本地化文件、UI 标签（Sonnet 4.6, Sonnet 4.6 TK, Opus 4.6 TK）以及预设路由。
    • [核心优化] Gemini Pro 模型名称迁移 (PR #2063): 将 gemini-pro-high/low 迁移至 gemini-3.1-pro，确保与 Google 最新 API 命名对齐。
    • [重大架构] 国际化 (i18n) 与结构化模型配置集成 (PR #2040):
      • 架构重构: 引入了全新的 i18n 翻译框架，将硬编码的模型展示逻辑解耦至结构化 MODEL_CONFIG。
      • 逻辑适配: 在账号表格、详情弹窗和设置页面中集成了基于 i18n 标签的动态去重机制，修复了 Gemini 3.1 Pro 额度重复显示的 UI 问题。
      • 多语言提升: 优化并修正了所有 12 种语言的版本描述，将 Claude 4.5 描述全面升级为正式版 4.6，并将 G3 描述统一为 G3.1。
      • [核心修复] Claude Opus 4.6 思考模式 400 报错 (Claude 协议):
      • 参数专项对齐: 修复了 claude-opus-4-6-thinking 在 Claude 协议下返回 400 INVALID_ARGUMENT 的问题。通过强制对齐 thinkingBudget (24576) 与 maxOutputTokens (57344)，并剔除在该模式下不兼容的 stopSequences，确保其请求参数与 100% 成功的 OpenAI 协议完全一致，提升了对 Claude 原生协议客户端的兼容性。

  • v4.1.21 (2026-02-17):

    • [核心修复] Cherry Studio / Claude 协议兼容性 (Fix Issue #2007):
      • maxOutputTokens 限制: 修复了 Cherry Studio 等客户端发送超大 maxOutputTokens (128k) 导致 Google API 返回 400 INVALID_ARGUMENT 的问题。现在自动将 Claude 协议的输出上限限制为 65536，确保请求始终在 Gemini 允许的范围内。
      • Adaptive 思考模式对齐: 针对 Gemini 模型优化了 Claude 协议的 thinking: { type: "adaptive" } 行为。现在自动映射为 24576 的固定思考预算 (与 OpenAI 协议一致)，解决了 Gemini Vertex AI 对 thinkingBudget: -1 的不兼容问题，显著提升了 Cherry Studio 的思考模式稳定性。
    • [核心修复] 生产环境自定义协议支持 (PR #2005):
      • 协议修复: 默认启用 custom-protocol 特性，修复了生产环境下自定义协议 (如 tauri://) 加载失败的问题，确保本地资源和特殊协议请求的稳定性。
    • [核心优化] 托盘图标与窗口生命周期管理:
      • 智能托盘: 引入 AppRuntimeFlags 状态管理，实现了窗口关闭行为与托盘状态的联动。
      • 行为优化: 当托盘启用时，关闭窗口将自动隐藏而非退出应用；当托盘禁用时，关闭窗口将正常退出，提供了更符合直觉的桌面体验。
    • [核心增强] Linux 版本检测与 HTTP 客户端鲁棒性:
      • 版本解析: 增强了 Linux 平台的版本号提取逻辑 (extract_semver)，能从复杂的命令行输出中准确识别版本，提升了自动更新和环境检测的准确性。
      • 客户端降级: 为 HTTP 客户端构建过程增加了自动降级机制。当代理配置导致构建失败时，系统会自动回退到无代理模式或默认配置，防止因网络配置错误导致应用完全不可用。
    • [核心修复] Cherry Studio 联网搜索空响应修复 (/v1/responses):
      • SSE 事件补全: 重写了 create_codex_sse_stream，补全了 OpenAI Responses API 规范要求的完整 SSE 事件生命周期（response.output_item.added、content_part.added/done、output_item.done、response.completed），解决了 Cherry Studio 因事件缺失导致无法组装响应内容的问题。
      • 联网搜索注入修复: 过滤了 Cherry Studio 发送的 builtin_web_search 工具声明，防止其与 inject_google_search_tool 冲突，确保 Google Search 工具被正确注入。
      • 搜索引文回显: 为 Codex 流式响应添加了 groundingMetadata 解析，支持在联网搜索结果中回显搜索查询和来源引文。
    • [优化] Claude 协议联网与思考稳定性 (PR #2007):
      • 移除联网降级: 移除了 Claude 协议中针对联网搜索的激进模型降级逻辑，避免不必要的模型回退。
      • 移除思考历史降级: 移除了 should_disable_thinking_due_to_history 检查，不再因历史消息格式问题永久禁用思考模式，改为依赖 thinking_recovery 机制自动修复。
    • UI 优化 (Fix #2008): 改进了冷却时间的显示颜色 (使用蓝色)，提高了在小字体下的可读性。

  • v4.1.20 (2026-02-16):

    • [✨ 新春祝福] 祝大家马年一马当先，万事如意！Code 运昌隆，上线无 Bug！🧧
    • [Critical] 修复了 Claude Opus/Haiku 等模型在 Antigravity API 上的 400 INVALID_ARGUMENT 错误（通过恢复 v4.1.16 的核心协议格式）。
    • 增强了流式响应的健壮性，优化了对心跳包和非从零开始的 Thinking Block 的处理。
    • [核心修复] 修复图像生成配额同步问题 (Issue #1995)：
      • 放宽模型过滤：优化了配额抓取逻辑，增加了对 image / imagen 关键字的支持，确保图像模型的配额信息能正常同步。
      • 即时刷新机制：在图像生成成功后立即异步触发全局配额刷新，实现了 UI 侧剩余配额的实时反馈。
    • [核心修复] 修复 OpenAI 流式收集器工具调用合并 Bug (PR #1994)：
      • ID 冲突校验：在聚合流式片段时引入 ID 校验，防止多个工具调用因索引重叠而导致参数被错误拼接。
      • 索引稳定性优化：优化了流式输出中的索引分配逻辑，确保多轮数据传输下工具调用索引始终单向递增。
    • [核心优化] 极致拟真请求伪装 (Request Identity Camouflage):
      • 动态版本伪装: 实现了智能版本探测机制。Antigravity 现在会自动读取本地安装的真实版本号构建 User-Agent，彻底告别了硬编码的 "1.0.0" 时代。
      • Docker 环境兜底: 针对无头模式（Docker/Linux Server），内置了“已知稳定版”指纹库。当无法检测到本地客户端时，自动伪装为最新稳定版客户端（如 v1.16.5），确保服务端看到的永远是合法的官方客户端。
      • 全维度 Header 注入: 补全了 X-Client-Name, X-Client-Version, X-Machine-Id, X-VSCode-SessionId 等关键指纹头，实现了从网络层到应用层的像素级伪装，进一步降低了 403 风控概率。
    • [核心功能] 后台自动刷新开关与设置热保存:
      • 独立开关: 在设置页面新增了“后台自动刷新”的独立开关，允许用户更精细地控制后台任务。
      • 配置热保存: 实现了设置项（自动刷新、智能预热、配额保护）的热保存机制，无需手动点击保存按钮即可实时生效。
    • [逻辑优化] 智能预热与配额保护解耦:
      • 解除锁定: 彻底移除了“额度保护”对“智能预热”的强制绑定。现在开启额度保护仅会强制开启“后台自动刷新”（用于检测配额），而不会强制启动预热请求。
      • [重要建议]: 建议用户在当前版本暂时关闭“额度保护”和“后台自动刷新”功能，以避免因频繁请求导致的潜在问题。

  • v4.1.19 (2026-02-15):

    • [核心修复] 修复 Claude Code CLI 工具调用空文本块错误 (Fix #1974):
      • 字段缺失修复: 修复了 Claude Code CLI 在工具调用过程中，因发送空文本块 (text: "") 导致上游 API 报错 Field required 的问题。
      • 空值过滤: 在协议转换层增加了对无效空文本块的自动过滤与清理。
    • [核心功能] Gemini 模型 MCP 工具名模糊匹配支持:
      • 幻觉修复: 针对 Gemini 模型经常幻觉出错误的 MCP 工具名称（如显式调用 mcp__puppeteer_navigate 而非注册名 mcp__puppeteer__puppeteer_navigate）的问题，实现了智能模糊匹配算法。
      • 三级匹配策略: 引入了后缀匹配、包含匹配及 Token 重叠度评分机制，显著提升了 Gemini 模型调用 MCP 工具的成功率。
    • [核心修复] Opencode 同步逻辑修正 (Fix #1972):
      • 模型缺失修复: 修复了 Opencode CLI 同步时缺失 claude-opus-4-6-thinking 模型定义的问题，确保该模型能被客户端正确识别和调用。

  • v4.1.18 (2026-02-14):

    • [核心升级] JA3 指纹伪装 (Chrome 123) 全面实装:
      • 反爬虫突破: 引入 rquest 核心库并集成 BoringSSL，实现了像素级复刻 Chrome 123 的 TLS 指纹 (JA3/JA4)，有效解决高防护上游的 403/Captchas 拦截问题。
      • 全局覆盖: 指纹伪装已应用至全局共享客户端及代理池管理器，确保从配额查询到对话补全的所有出站流量均模拟为真实浏览器行为。
    • [架构重构] 通用流式响应处理 (Universal Stream Handling) (Issue #1955):
      • 双核兼容: 重构了 SSE 处理与调试日志模块，通过 Box<dyn Stream> 实现了对 reqwest (标准) 与 rquest (伪装) 响应流的统一兼容，消除了底层类型冲突。
    • [核心功能] 账号错误详情增强 (Account Error Details Expansion):
      • 详情解读: 为“已禁用”和“403 Forbidden”状态的账号引入了深度错误详情弹窗，自动展示底层 API 报错原因（如 invalid_grant 等）。
      • 验证链接识别: [新] 智能检测错误文本中的 Google 验证/申诉链接，支持在弹窗内直接点击跳转，加速账号修复流程。
      • 时间校准: 修复了由于单位转换错误导致的“检测时间”显示为未来的 Bug。
    • [i18n] 全球化多语言支持大满贯:
      • 全语言适配: 为全部 12 种支持语言（阿、西、日、韩、缅、葡、俄、土、越、英及简繁中）同步补全了账号详情与错误状态词条。
      • 本地化精修: 优化了各语言下的术语匹配（特别是日语、土耳其语和繁体中文），确保全球用户都能获得准确的母语提示。
    • [核心修复] 修复图像生成模型后缀导致的配额匹配失效 (Issue #1955):
      • 模式归一化: 修复了 gemini-3-pro-image 及其分辨率/比例后缀（如 -4k, -16x9）因归一化匹配不精确导致的配额校验失效问题。
      • 配额对齐: 确保所有图像模型变体都能正确映射到标准 ID，从而准确触发账号配额保护，解决了“无可用配额账号”的误报。

  • v4.1.17 (2026-02-13):

    • [用户体验] 自动更新体验升级 (PR #1923):
      • 后台下载: 实现了更新包的后台静默下载，下载过程中不再阻断用户操作。
      • 进度反馈: 新增下载进度条显示，实时反馈下载状态。
      • 重启提示: 下载完成后会弹出更友好的重启提示，支持“立即重启”或“稍后重启”。
      • 逻辑优化: 优先检查 updater.json，减少对 GitHub API 的直接依赖，提升检查速度。
    • [文档更新] 跨平台安装脚本 (PR #1931):
      • 一键安装: 在 README 中更新了 Option A 安装方式，推荐使用跨平台一键安装脚本。
    • [社区建设] 新增 Telegram 频道入口:
      • 社群卡片: 在“设置 -> 关于”页面新增了 Telegram 频道卡片，方便用户快速加入官方频道获取最新资讯。
      • 布局优化: 调整了关于页面的卡片网格布局，适配了 5 列显示，确保界面整洁美观。

  • v4.1.16 (2026-02-12):

    • [核心修复] 修复 Claude 协议 (Thinking 模型) 400 错误 (V4 方案):
      • 协议对齐: 彻底修复了 Claude 3.7/4.5 Thinking 等模型在通过代理调用时因参数结构不匹配导致的 400 Invalid Argument 错误。
      • 统一注入: 废弃了导致冲突的根目录 thinking 字段注入，现在统一使用 Google 原生协议推荐的 generationConfig.thinkingConfig 嵌套结构。
      • 预算适配: 为 Claude 模型适配了默认 16k 的思考预算 (Thinking Budget)，并解决了 Rust 借用检查导致的编译与运行时异常。
    • [Bug修复] 修复 OpenAI 流式响应 Usage 重复问题 (Issue #1915):
      • Token爆炸修复: 修复了在流式传输模式下 (stream=true)，usage 字段被错误地附加到每一个数据块 (Chunk) 中，导致客户端 (如 Cline/Roo Code) 统计的 Token 用量呈指数级虚高的问题。
    • [核心优化] 开启 Linux 平台原生自动更新支持 (PR #1891):
      • 全平台覆盖: 在 updater.json 中增加了对 linux-x86_64 和 linux-aarch64 平台的支持，使 Linux AppImage 用户现在也能正常收到自动更新通知。
      • 发布流优化: 自动匹配并读取 Linux 版本的 .AppImage.sig 签名文件，实现了 macOS、Windows 与 Linux 三大主流平台的自动更新能力闭环。
    • [新增功能] 跨平台一行命令安装脚本支持 (PR #1892):
      • 安装体验升级: 新增 install.sh (Linux/macOS) 和 install.ps1 (Windows) 脚本，支持通过极简的 curl 或 irm 命令实现全自动下载、安装与环境配置。
      • 智能适配: 脚本支持自动识别操作系统、架构、包管理器（DEB/RPM/AppImage/DMG/NSIS），并提供版本锁定与 Dry-Run 预览模式。
    • [核心优化] OpenCode 配置与本地二进制解耦及自定义网络支持 (Issue #1869):
      • 环境解耦: 后端不再强制校验 opencode 二进制是否存在，允许在 Docker 等隔离环境下仅通过配置文件管理同步状态。
      • 自定义 BaseURL: 前端新增 "Custom Manager BaseURL" 设置，支持手动指定 Manager 访问地址，完美解决 Docker Compose 容器互联与自定义反代场景下的连接问题。
      • 完全本地化: 为新功能补全了中、英双语 I18n 支持，并修复了 OpenCode 同步弹窗的 JSX 渲染异常。
    • [UI 修复] 修复 API 代理模板生成的 Python 代码缩进不一致问题 (PR #1879):
      • 显示优化: 移除了 Python 集成示例代码块中多余的行首空格，确保从界面复制的代码可以直接运行，无需手动调整缩进。
    • [核心修复] 解决 Gemini 图像生成因关键词匹配导致的 effortLevel 冲突 (PR #1873):
      • 逻辑冲突修复: 彻底修复了 gemini-3-pro-image 及其 4k/2k 变体因包含 gemini-3-pro 关键词，被系统错误判定为支持 Adaptive Thinking 从而误注入 effortLevel 导致的 HTTP 400 错误。
    • [文档更新] 发布 Gemini 3 Pro (Imagen 3) 图像生成全功能调用指南:
      • 深度指南: 新增 Gemini 3 Pro 图像模型调用指南，详细说明了宽高比自动映射、画质等级对应关系图表，以及新增的图生图 (Image-to-Image) 与后缀魔法用法。
    • [安装优化] 官方 Homebrew Cask 维护与更新:
      • 版本同步: 更新 antigravity-tools.rb Cask 配置至 v4.1.16，确保 macOS 与 Linux 用户通过 brew install 始终获取最新稳定版本。
      • 参数清洗: 在代理请求层增加了对图像生成模型的特殊过滤，确保不再为非思维链模型注入不兼容的生成参数。

  • v4.1.15 (2026-02-11):

…view the full README on GitHub.