反重力账户管理

安装指南 (Installation)

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

跨平台一键安装脚本

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

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.2.1/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.1，预览模式 curl -fsSL ... | bash -s -- --dry-run

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

```bash

2. 安装应用

brew install --cask antigravity-tools

> **提示**: 如果遇到权限问题，建议添加 `--no-quarantine` 参数。

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

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

**方式 2：通过 Homebrew** (如果您已安装 [Linuxbrew](https://sh.brew.sh/))

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

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

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

```bash

忘记密钥？执行 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

若已安装 opencode-antigravity-auth 插件，验证 google provider 仍可独立工作

opencode run "test" --model google/antigravity-claude-sonnet-4-5-thinking --variant max ```

💡 使用案例 (Usage Examples)

方式 1: 直接运行 (推荐)

- 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

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

🔌 快速接入示例

如何在 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 (推荐) ```python import openai

client = openai.OpenAI( api_key="sk-antigravity", base_url="http://127.0.0.1:8045/v1" )

使用 imageSize 参数(最高优先级)

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

选项 B: 手动下载

前往 GitHub Releases 下载对应系统的包： macOS: .dmg (支持 Apple Silicon & Intel) Windows: .msi 或 便携版 .zip * Linux: .deb 或 AppImage

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) 时，后端会毫秒级触发 自动重试与静默轮换，确保业务不中断。

- API_KEY: 必填。用于所有协议的 AI 请求鉴定。

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

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 接口 + 模型后缀

模型后缀说明： - 宽高比: -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 分辨率

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

• 系列化映射: 您可以将复杂的原始模型 ID 归类到“规格家族”（如将所有 GPT-4 请求统一路由到 gemini-3-pro-high）。
• 专家级重定向: 支持自定义正则表达式级模型映射，精准控制每一个请求的落地模型。
• 智能分级路由 (Tiered Routing): [新] 系统根据账号类型（Ultra/Pro/Free）和配额重置频率自动优先级排序，优先消耗高速重置账号，确保高频调用下的服务稳定性。
• 后台任务静默降级: [新] 自动识别 Claude CLI 等工具生成的后台请求（如标题生成），智能重定向至 Flash 模型，保护高级模型配额不被浪费。

🛠️ 常见问题排查 (Troubleshooting)

#### macOS 提示“应用已损坏，无法打开”？ 由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示。您可以按照以下步骤快速修复：

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

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

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