copilot-api-plus 1.0.56 → 1.0.57

package/README.md

@@ -1,843 +1,866 @@
-# Copilot API Plus
-
-[![npm version](https://img.shields.io/npm/v/copilot-api-plus.svg)](https://www.npmjs.com/package/copilot-api-plus)
-[![license](https://img.shields.io/npm/l/copilot-api-plus.svg)](https://github.com/imbuxiangnan-cyber/copilot-api-plus/blob/main/LICENSE)
-
-[English](README.en.md) | 简体中文
-
-> A proxy that converts GitHub Copilot, OpenCode Zen, and Google Antigravity into OpenAI & Anthropic compatible APIs. Works with Claude Code, opencode, and more.
-
-将 GitHub Copilot、OpenCode Zen、Google Antigravity 等 AI 服务转换为 **OpenAI** 和 **Anthropic** 兼容 API，支持与 [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview)、[opencode](https://github.com/sst/opencode) 等工具无缝集成。
-
----
-
-## 📋 目录
-
-- [功能特点](#-功能特点)
-- [快速开始](#-快速开始)
-- [详细使用指南](#-详细使用指南)
-  - [GitHub Copilot 模式](#1-github-copilot-模式默认)
-  - [OpenCode Zen 模式](#2-opencode-zen-模式)
-  - [Google Antigravity 模式](#3-google-antigravity-模式)
-- [代理配置](#-代理配置)
-- [Claude Code 集成](#-claude-code-集成)
-- [opencode 集成](#-opencode-集成)
-- [API 端点](#-api-端点)
-- [API Key 认证](#-api-key-认证)
-- [技术细节](#-技术细节)
-- [命令行参考](#️-命令行参考)
-- [Docker 部署](#-docker-部署)
-- [常见问题](#-常见问题)
-
----
-
-## ✨ 功能特点
-
-| 功能 | 说明 |
-|------|------|
-| 🔌 **多后端支持** | GitHub Copilot、OpenCode Zen、Google Antigravity 三种后端可选 |
-| 🤖 **双协议兼容** | 同时支持 OpenAI Chat Completions API 和 Anthropic Messages API |
-| 💻 **Claude Code 集成** | 一键生成 Claude Code 启动命令 (`--claude-code`) |
-| 📊 **使用量监控** | Web 仪表盘实时查看 API 使用情况 |
-| 🔄 **自动认证** | Token 过期自动刷新，无需手动干预 |
-| ⚡ **速率限制** | 内置请求频率控制，避免触发限制 |
-| 🌐 **代理支持** | 支持 HTTP/HTTPS 代理，配置持久化 |
-| 🐳 **Docker 支持** | 提供完整的 Docker 部署方案 |
-| 🔑 **API Key 认证** | 可选的 API Key 鉴权，保护公开部署的服务 |
-| ✂️ **上下文透传** | 全量透传上下文至上游 API，由客户端（如 Claude Code）自行管理压缩 |
-| 🔍 **智能模型匹配** | 自动处理模型名格式差异（日期后缀、dash/dot 版本号等） |
-| 🔁 **Antigravity 端点容错** | 双端点自动切换，按模型族追踪速率限制，指数退避重试 |
-
----
-
-## 🚀 快速开始
-
-### 安装
-
-```bash
-# 全局安装
-npm install -g copilot-api-plus
-
-# 或使用 npx 直接运行（推荐）
-npx copilot-api-plus@latest start
-```
-
-### 基本用法
-
-```bash
-# 启动服务器（默认使用 GitHub Copilot）
-npx copilot-api-plus@latest start
-
-# 使用 OpenCode Zen
-npx copilot-api-plus@latest start --zen
-
-# 使用 Google Antigravity
-npx copilot-api-plus@latest start --antigravity
-
-# 与 Claude Code 配合
-npx copilot-api-plus@latest start --claude-code
-```
-
-服务器启动后，默认监听 `http://localhost:4141`。
-
----
-
-## 📖 详细使用指南
-
-### 1. GitHub Copilot 模式（默认）
-
-使用你的 GitHub Copilot 订阅访问 AI 模型。
-
-#### 前置要求
-- GitHub 账户
-- 有效的 Copilot 订阅（Individual / Business / Enterprise）
-
-#### 启动步骤
-
-```bash
-npx copilot-api-plus@latest start
-```
-
-**首次运行**会引导你完成 GitHub OAuth 认证：
-
-1. 终端显示设备码，例如：`XXXX-XXXX`
-2. 打开浏览器访问：https://github.com/login/device
-3. 输入设备码，点击授权
-4. 返回终端，等待认证完成
-
-认证成功后，Token 会保存到本地，下次启动无需重新认证。
-
-#### 企业/商业账户
-
-```bash
-# Business 计划
-npx copilot-api-plus@latest start --account-type business
-
-# Enterprise 计划  
-npx copilot-api-plus@latest start --account-type enterprise
-```
-
-#### 可用模型
-
-| 模型 | ID | 上下文长度 |
-|------|-----|-----------|
-| Claude Sonnet 4 | `claude-sonnet-4` | 200K |
-| Claude Sonnet 4.5 | `claude-sonnet-4.5` | 200K |
-| GPT-4.1 | `gpt-4.1` | 1M |
-| o4-mini | `o4-mini` | 200K |
-| Gemini 2.5 Pro | `gemini-2.5-pro` | 1M |
-
----
-
-### 2. OpenCode Zen 模式
-
-使用 [OpenCode Zen](https://opencode.ai/zen) 的多模型 API 服务，支持 GPT-5、Claude、Gemini 等顶级编程模型。
-
-#### 前置要求
-1. 访问 https://opencode.ai/zen
-2. 注册账号并创建 API Key
-
-#### 启动步骤
-
-**方式一：交互式设置**
-```bash
-npx copilot-api-plus@latest start --zen
-```
-首次运行会提示输入 API Key，保存后下次自动使用。
-
-**方式二：直接指定 API Key**
-```bash
-npx copilot-api-plus@latest start --zen --zen-api-key YOUR_API_KEY
-```
-
-#### 可用模型
-
-| 模型 | ID | 说明 |
-|------|-----|------|
-| GPT-5.2 | `gpt-5.2` | OpenAI 最新模型 |
-| GPT-5.1 Codex Max | `gpt-5.1-codex-max` | 代码优化版 |
-| GPT-5.1 Codex | `gpt-5.1-codex` | 代码专用 |
-| GPT-5 Codex | `gpt-5-codex` | OpenAI Responses API |
-| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude (200K) |
-| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude (200K) |
-| Claude Sonnet 4 | `claude-sonnet-4` | Anthropic Claude |
-| Gemini 3 Pro | `gemini-3-pro` | Google Gemini |
-| Qwen3 Coder | `qwen3-coder` | Alibaba Qwen |
-| Kimi K2 | `kimi-k2` | Moonshot |
-| Grok Code Fast 1 | `grok-code-fast-1` | xAI |
-
-更多模型请访问 [opencode.ai/zen](https://opencode.ai/zen)
-
-#### API 端点
-
-Zen 模式支持以下 API 端点：
-
-| 端点 | 说明 |
-|------|------|
-| `/v1/chat/completions` | OpenAI 兼容 Chat API |
-| `/v1/messages` | Anthropic 兼容 Messages API |
-| `/v1/responses` | OpenAI Responses API (GPT-5 系列) |
-| `/v1/models` | 获取可用模型列表 |
-
-专用端点（无需 `--zen` 标志也可访问）：
-- `/zen/v1/chat/completions`
-- `/zen/v1/messages`
-- `/zen/v1/responses`
-- `/zen/v1/models`
-
-#### 管理 API Key
-
-```bash
-# 查看/更换 API Key（清除后重新启动会提示输入）
-npx copilot-api-plus@latest logout --zen
-```
-
----
-
-### 3. Google Antigravity 模式
-
-使用 Google Antigravity API 服务，支持 Gemini 和 Claude 模型。
-
-#### 前置要求
-- Google 账户
-
-#### 认证方式
-
-**方式一：API Key（推荐 - 最简单）**
-
-1. 访问 https://aistudio.google.com/apikey 获取 API Key
-2. 使用环境变量启动：
-
-```bash
-# Linux/macOS
-GEMINI_API_KEY=your_api_key npx copilot-api-plus@latest start --antigravity
-
-# Windows PowerShell
-$env:GEMINI_API_KEY = "your_api_key"
-npx copilot-api-plus@latest start --antigravity
-
-# Windows CMD
-set GEMINI_API_KEY=your_api_key
-npx copilot-api-plus@latest start --antigravity
-```
-
-**方式二：OAuth 网页登录（推荐）**
-
-```bash
-npx copilot-api-plus@latest start --antigravity
-```
-
-首次运行会提示选择登录方式：
-- **Web（推荐）**：自动打开浏览器完成 Google 登录，授权后自动捕获回调
-- **Manual**：手动复制回调 URL 到终端
-
-**方式三：自定义 OAuth 凭证**
-
-如果遇到 `invalid_client` 错误，可以创建自己的 OAuth 应用：
-
-1. 访问 https://console.cloud.google.com/apis/credentials
-2. 创建 OAuth 2.0 客户端 ID（选择"桌面应用"类型）
-3. 添加重定向 URI：`http://localhost:8046/callback`
-4. 使用环境变量或命令行参数：
-
-```bash
-# 环境变量方式
-ANTIGRAVITY_CLIENT_ID=your_client_id ANTIGRAVITY_CLIENT_SECRET=your_secret \
-  npx copilot-api-plus@latest start --antigravity
-
-# 命令行参数方式
-npx copilot-api-plus@latest start --antigravity \
-  --antigravity-client-id your_client_id \
-  --antigravity-client-secret your_secret
-```
-
-#### 可用模型
-
-| 模型 | ID | 说明 |
-|------|-----|------|
-| Gemini 2.5 Pro | `gemini-2.5-pro-exp-03-25` | Google Gemini |
-| Gemini 2.5 Pro Preview | `gemini-2.5-pro-preview-05-06` | Google Gemini |
-| Gemini 2.0 Flash | `gemini-2.0-flash-exp` | 快速响应 |
-| Gemini 2.0 Flash Thinking | `gemini-2.0-flash-thinking-exp` | 支持思考链 |
-| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude |
-| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude |
-
-#### 特性
-- ✅ 自动 Token 刷新
-- ✅ 多账户支持，自动轮换
-- ✅ 配额用尽自动切换账户
-- ✅ 支持 Thinking 模型（思考链输出）
-
-#### 多账户管理
-
-可以添加多个 Google 账户，系统会在配额用尽时自动切换：
-
-```bash
-# 添加新账户
-npx copilot-api-plus@latest antigravity add
-
-# 列出所有账户
-npx copilot-api-plus@latest antigravity list
-
-# 按索引删除账户
-npx copilot-api-plus@latest antigravity remove 0
-
-# 清除所有账户
-npx copilot-api-plus@latest antigravity clear
-# 或使用 logout 命令
-npx copilot-api-plus@latest logout --antigravity
-```
-
----
-
-## 🌐 代理配置
-
-如果你需要通过代理访问网络，有两种配置方式：
-
-### 方式一：持久化配置（推荐）
-
-配置一次，永久生效，下次启动自动使用。
-
-```bash
-# 交互式配置
-npx copilot-api-plus@latest proxy --set
-
-# 或直接设置
-npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890
-
-# 同时设置 HTTP 和 HTTPS 代理
-npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890 --https-proxy http://127.0.0.1:7890
-```
-
-#### 代理管理命令
-
-```bash
-# 查看当前代理配置
-npx copilot-api-plus@latest proxy
-
-# 启用代理
-npx copilot-api-plus@latest proxy --enable
-
-# 禁用代理（保留设置）
-npx copilot-api-plus@latest proxy --disable
-
-# 清除代理配置
-npx copilot-api-plus@latest proxy --clear
-```
-
-#### 示例：配置 Clash 代理
-
-```bash
-# Clash 默认端口 7890
-npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890
-
-# 验证配置
-npx copilot-api-plus@latest proxy
-# 输出：
-# Current proxy configuration:
-#   Status: ✅ Enabled
-#   HTTP_PROXY: http://127.0.0.1:7890
-#   HTTPS_PROXY: http://127.0.0.1:7890
-```
-
-### 方式二：环境变量（临时）
-
-仅当次启动生效：
-
-```bash
-# Linux/macOS
-export HTTP_PROXY=http://127.0.0.1:7890
-export HTTPS_PROXY=http://127.0.0.1:7890
-npx copilot-api-plus@latest start --proxy-env
-
-# Windows PowerShell
-$env:HTTP_PROXY = "http://127.0.0.1:7890"
-$env:HTTPS_PROXY = "http://127.0.0.1:7890"
-npx copilot-api-plus@latest start --proxy-env
-
-# Windows CMD
-set HTTP_PROXY=http://127.0.0.1:7890
-set HTTPS_PROXY=http://127.0.0.1:7890
-npx copilot-api-plus@latest start --proxy-env
-```
-
-### 代理配置优先级
-
-1. `--proxy-env` 参数（从环境变量读取）
-2. 持久化配置（`proxy --set` 设置的）
-3. 无代理
-
----
-
-## 💻 Claude Code 集成
-
-[Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) 是 Anthropic 的 AI 编程助手。
-
-### 自动配置（推荐）
-
-```bash
-# 使用 GitHub Copilot 作为后端
-npx copilot-api-plus@latest start --claude-code
-
-# 使用 OpenCode Zen 作为后端
-npx copilot-api-plus@latest start --zen --claude-code
-
-# 使用 Google Antigravity 作为后端
-npx copilot-api-plus@latest start --antigravity --claude-code
-```
-
-运行后：
-1. 选择主模型（用于代码生成）
-2. 选择快速模型（用于后台任务）
-3. 启动命令会自动复制到剪贴板
-4. **打开新终端**，粘贴并运行命令启动 Claude Code
-
-### 手动配置
-
-在项目根目录创建 `.claude/settings.json`：
-
-```json
-{
-  "env": {
-    "ANTHROPIC_BASE_URL": "http://localhost:4141",
-    "ANTHROPIC_AUTH_TOKEN": "dummy",
-    "ANTHROPIC_MODEL": "claude-sonnet-4",
-    "ANTHROPIC_SMALL_FAST_MODEL": "gpt-4.1",
-    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
-  }
-}
-```
-
-然后启动 copilot-api-plus 服务器后，在该项目目录运行 `claude` 命令。
-
----
-
-## 🔧 opencode 集成
-
-[opencode](https://github.com/sst/opencode) 是一个现代 AI 编程助手。
-
-### 配置步骤
-
-1. 在项目根目录创建 `opencode.json`：
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "provider": {
-    "copilot-api-plus": {
-      "api": "openai-compatible",
-      "name": "Copilot API Plus",
-      "options": {
-        "baseURL": "http://127.0.0.1:4141/v1"
-      },
-      "models": {
-        "claude-sonnet-4": {
-          "name": "Claude Sonnet 4",
-          "id": "claude-sonnet-4",
-          "max_tokens": 64000,
-          "profile": "coder",
-          "limit": { "context": 200000 }
-        },
-        "gpt-4.1": {
-          "name": "GPT-4.1",
-          "id": "gpt-4.1",
-          "max_tokens": 32768,
-          "profile": "coder",
-          "limit": { "context": 1047576 }
-        }
-      }
-    }
-  }
-}
-```
-
-2. 启动 copilot-api-plus：
-```bash
-npx copilot-api-plus@latest start
-```
-
-3. 在同一目录运行 opencode：
-```bash
-npx opencode@latest
-```
-
-4. 选择 `copilot-api-plus` 作为 provider
-
-### 快捷方式：使用环境变量
-
-```bash
-# 设置环境变量
-export OPENAI_BASE_URL=http://127.0.0.1:4141/v1
-export OPENAI_API_KEY=dummy
-
-# 运行 opencode
-npx opencode@latest
-```
-
----
-
-## 📡 API 端点
-
-服务器启动后，默认监听 `http://localhost:4141`。
-
-### OpenAI 兼容端点
-
-| 端点 | 方法 | 说明 |
-|------|------|------|
-| `/v1/chat/completions` | POST | 聊天补全（支持流式） |
-| `/v1/models` | GET | 模型列表 |
-| `/v1/embeddings` | POST | 文本嵌入（仅 Copilot） |
-
-### Anthropic 兼容端点
-
-| 端点 | 方法 | 说明 |
-|------|------|------|
-| `/v1/messages` | POST | 消息 API（支持流式） |
-| `/v1/messages/count_tokens` | POST | Token 计数 |
-
-### 专用端点
-
-各后端都有独立的专用路由，即使切换默认后端也能访问：
-
-| 路由前缀 | 说明 |
-|----------|------|
-| `/copilot/v1/*` | GitHub Copilot 专用 |
-| `/zen/v1/*` | OpenCode Zen 专用 |
-| `/antigravity/v1/*` | Google Antigravity 专用 |
-
-### 监控端点
-
-| 端点 | 方法 | 说明 |
-|------|------|------|
-| `/usage` | GET | 使用量统计（仅 Copilot） |
-| `/token` | GET | 当前 Token 信息 |
-
-### 调用示例
-
-```bash
-# OpenAI 格式
-curl http://localhost:4141/v1/chat/completions \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "claude-sonnet-4",
-    "messages": [{"role": "user", "content": "Hello!"}]
-  }'
-
-# Anthropic 格式
-curl http://localhost:4141/v1/messages \
-  -H "Content-Type: application/json" \
-  -H "x-api-key: dummy" \
-  -d '{
-    "model": "claude-sonnet-4",
-    "max_tokens": 1024,
-    "messages": [{"role": "user", "content": "Hello!"}]
-  }'
-```
-
----
-
-## ⚙️ 命令行参考
-
-### 命令列表
-
-| 命令 | 说明 |
-|------|------|
-| `start` | 启动 API 服务器 |
-| `auth` | 仅执行 GitHub 认证流程 |
-| `logout` | 清除已保存的凭证 |
-| `proxy` | 配置代理设置 |
-| `antigravity` | 管理 Google Antigravity 账户 |
-| `check-usage` | 查看 Copilot 使用量 |
-| `debug` | 显示调试信息 |
-
-### start 命令参数
-
-| 参数 | 别名 | 默认值 | 说明 |
-|------|------|--------|------|
-| `--port` | `-p` | 4141 | 监听端口 |
-| `--verbose` | `-v` | false | 详细日志 |
-| `--account-type` | `-a` | individual | 账户类型 (individual/business/enterprise) |
-| `--claude-code` | `-c` | false | 生成 Claude Code 启动命令 |
-| `--zen` | `-z` | false | 启用 OpenCode Zen 模式 |
-| `--zen-api-key` | - | - | Zen API Key |
-| `--antigravity` | - | false | 启用 Google Antigravity 模式 |
-| `--antigravity-client-id` | - | - | Antigravity OAuth Client ID |
-| `--antigravity-client-secret` | - | - | Antigravity OAuth Client Secret |
-| `--rate-limit` | `-r` | - | 请求间隔（秒） |
-| `--wait` | `-w` | false | 达到限制时等待而非报错 |
-| `--manual` | - | false | 手动审批每个请求 |
-| `--github-token` | `-g` | - | 直接提供 GitHub Token |
-| `--show-token` | - | false | 显示 Token 信息 |
-| `--proxy-env` | - | false | 从环境变量读取代理 |
-| `--api-key` | - | - | API Key 鉴权（可多次指定） |
-
-### proxy 命令参数
-
-| 参数 | 说明 |
-|------|------|
-| `--set` | 交互式配置代理 |
-| `--enable` | 启用已保存的代理 |
-| `--disable` | 禁用代理（保留设置） |
-| `--clear` | 清除代理配置 |
-| `--show` | 显示当前配置 |
-| `--http-proxy` | HTTP 代理 URL |
-| `--https-proxy` | HTTPS 代理 URL |
-| `--no-proxy` | 不走代理的主机列表 |
-
-### logout 命令参数
-
-| 参数 | 别名 | 说明 |
-|------|------|------|
-| `--github` | `-g` | 仅清除 GitHub Copilot 凭证 |
-| `--zen` | `-z` | 仅清除 Zen 凭证 |
-| `--antigravity` | - | 仅清除 Antigravity 凭证 |
-| `--all` | `-a` | 清除所有凭证 |
-
-> **提示**：不带参数运行 `logout` 会显示交互式菜单供选择。
-
-### antigravity 命令
-
-管理 Google Antigravity 账户的子命令：
-
-| 子命令 | 说明 |
-|--------|------|
-| `add` | 添加新的 Antigravity 账户（OAuth 登录） |
-| `list` | 列出所有已配置的账户及其状态 |
-| `remove <index>` | 按索引删除指定账户 |
-| `clear` | 清除所有 Antigravity 账户（需确认） |
-
-```bash
-# 示例
-npx copilot-api-plus@latest antigravity add      # 添加账户
-npx copilot-api-plus@latest antigravity list     # 列出账户
-npx copilot-api-plus@latest antigravity remove 0 # 删除索引为 0 的账户
-npx copilot-api-plus@latest antigravity clear    # 清除所有账户
-```
-
----
-
-## 🔑 API Key 认证
-
-如果你将服务暴露到公网，可以启用 API Key 认证来保护接口：
-
-```bash
-# 单个 Key
-npx copilot-api-plus@latest start --api-key my-secret-key
-
-# 多个 Key
-npx copilot-api-plus@latest start --api-key key1 --api-key key2
-```
-
-启用后，所有请求需要携带 API Key：
-
-```bash
-# OpenAI 格式 - 通过 Authorization header
-curl http://localhost:4141/v1/chat/completions \
-  -H "Authorization: Bearer my-secret-key" \
-  -H "Content-Type: application/json" \
-  -d '{"model": "claude-sonnet-4", "messages": [{"role": "user", "content": "Hello"}]}'
-
-# Anthropic 格式 - 通过 x-api-key header
-curl http://localhost:4141/v1/messages \
-  -H "x-api-key: my-secret-key" \
-  -H "Content-Type: application/json" \
-  -d '{"model": "claude-sonnet-4", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
-```
-
-在 Claude Code 中使用时，将 `ANTHROPIC_AUTH_TOKEN` 设为你的 API Key 即可。
-
----
-
-## 🔧 技术细节
-
-### 上下文管理
-
-代理层不做上下文截断，全量透传消息至上游 API。上下文压缩由客户端负责：
-
-- **Claude Code**：通过 `/count_tokens` 端点获取当前 token 数，接近上限时自动触发 `/compact` 压缩
-- **其他客户端**：如果上游 API 返回 400（token 超限），客户端自行处理重试
-
-### 智能模型名匹配
-
-Anthropic 格式的模型名（如 `claude-opus-4-6`）和 Copilot 的模型列表 ID 可能存在格式差异。代理使用多策略精确匹配：
-
-| 策略 | 示例 |
-|------|------|
-| 精确匹配 | `claude-opus-4-6` → `claude-opus-4-6` |
-| 去日期后缀 | `claude-opus-4-6-20251101` → `claude-opus-4-6` |
-| Dash → Dot | `claude-opus-4-5` → `claude-opus-4.5` |
-| Dot → Dash | `claude-opus-4.5` → `claude-opus-4-5` |
-
-对于 Anthropic 端点（`/v1/messages`），还会先通过 `translateModelName` 做格式转换（包括旧格式 `claude-3-5-sonnet` → `claude-sonnet-4.5` 的映射），再通过上述策略匹配。
-
-### Antigravity 端点容错
-
-Google Antigravity 模式内置了可靠性保障：
-
-- **双端点自动切换**：daily sandbox 和 production 两个端点，一个失败自动切换到另一个
-- **按模型族速率追踪**：分别追踪 Gemini 和 Claude 模型族的速率限制状态
-- **指数退避重试**：429/503 等限流错误自动退避重试，短间隔走同端点，长间隔切换端点
-
-### 请求日志
-
-每次 API 请求会输出一行日志，包含模型名、状态码和耗时：
-
-```log
-[claude-opus-4-6] 13:13:39 <-- POST /v1/messages?beta=true
-[claude-opus-4-6] 13:13:59 --> POST /v1/messages?beta=true 200 20.1s
-```
-
-### 网络重试
-
-对上游 API 的请求内置了瞬时网络错误重试（TLS 断开、连接重置等）：
-
-- 最多重试 2 次（共 3 次尝试）
-- 退避间隔：1s、2s
-- 仅重试网络层错误，HTTP 错误码（如 400/500）不重试
-
----
-
-## 🐳 Docker 部署
-
-### 快速启动
-
-```bash
-# 使用预构建镜像
-docker run -p 4141:4141 \
-  -v ./copilot-data:/root/.local/share/copilot-api-plus \
-  ghcr.io/imbuxiangnan-cyber/copilot-api-plus
-```
-
-### 自行构建
-
-```bash
-# 构建镜像
-docker build -t copilot-api-plus .
-
-# 运行容器
-docker run -p 4141:4141 \
-  -v ./copilot-data:/root/.local/share/copilot-api-plus \
-  copilot-api-plus
-```
-
-### Docker Compose
-
-```yaml
-version: "3.8"
-services:
-  copilot-api-plus:
-    build: .
-    ports:
-      - "4141:4141"
-    volumes:
-      - ./copilot-data:/root/.local/share/copilot-api-plus
-    environment:
-      - GH_TOKEN=your_github_token  # 可选
-    restart: unless-stopped
-```
-
-### 使用代理
-
-```bash
-docker run -p 4141:4141 \
-  -e HTTP_PROXY=http://host.docker.internal:7890 \
-  -e HTTPS_PROXY=http://host.docker.internal:7890 \
-  -v ./copilot-data:/root/.local/share/copilot-api-plus \
-  copilot-api-plus start --proxy-env
-```
-
----
-
-## ❓ 常见问题
-
-### 数据存储位置
-
-所有数据存储在 `~/.local/share/copilot-api-plus/` 目录下：
-
-| 文件 | 说明 |
-|------|------|
-| `github_token` | GitHub Token |
-| `zen-auth.json` | Zen API Key |
-| `antigravity-accounts.json` | Antigravity 账户 |
-| `config.json` | 代理等配置 |
-
-### 切换账户
-
-```bash
-# 交互式选择要清除的凭证
-npx copilot-api-plus@latest logout
-
-# 仅清除 GitHub Copilot 凭证
-npx copilot-api-plus@latest logout --github
-# 或简写
-npx copilot-api-plus@latest logout -g
-
-# 清除 Zen 凭证
-npx copilot-api-plus@latest logout --zen
-
-# 清除 Antigravity 凭证
-npx copilot-api-plus@latest logout --antigravity
-
-# 清除所有凭证
-npx copilot-api-plus@latest logout --all
-```
-
-### 查看使用量
-
-```bash
-# 命令行查看（仅 Copilot）
-npx copilot-api-plus@latest check-usage
-```
-
-启动服务器后，也可以访问 Web 仪表盘：
-```
-https://imbuxiangnan-cyber.github.io/copilot-api-plus?endpoint=http://localhost:4141/usage
-```
-
-### 调试问题
-
-```bash
-# 显示调试信息
-npx copilot-api-plus@latest debug
-
-# JSON 格式输出
-npx copilot-api-plus@latest debug --json
-
-# 启用详细日志
-npx copilot-api-plus@latest start --verbose
-```
-
-### 速率限制
-
-避免触发 GitHub 的滥用检测：
-
-```bash
-# 设置请求间隔 30 秒
-npx copilot-api-plus@latest start --rate-limit 30
-
-# 达到限制时等待而非报错
-npx copilot-api-plus@latest start --rate-limit 30 --wait
-
-# 手动审批每个请求
-npx copilot-api-plus@latest start --manual
-```
-
----
-
-## ⚠️ 免责声明
-
-> [!WARNING]
-> 这是 GitHub Copilot API 的逆向工程代理。**不受 GitHub 官方支持**，可能随时失效。使用风险自负。
-
-> [!WARNING]
-> **GitHub 安全提示**：过度的自动化或脚本化使用 Copilot 可能触发 GitHub 的滥用检测系统，导致 Copilot 访问被暂停。请负责任地使用。
->
-> 相关政策：
-> - [GitHub 可接受使用政策](https://docs.github.com/site-policy/acceptable-use-policies/github-acceptable-use-policies)
-> - [GitHub Copilot 条款](https://docs.github.com/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)
-
----
-
-## 📄 许可证
-
-MIT License
+# Copilot API Plus
+
+[![npm version](https://img.shields.io/npm/v/copilot-api-plus.svg)](https://www.npmjs.com/package/copilot-api-plus)
+[![license](https://img.shields.io/npm/l/copilot-api-plus.svg)](https://github.com/imbuxiangnan-cyber/copilot-api-plus/blob/main/LICENSE)
+
+[English](README.en.md) | 简体中文
+
+> A proxy that converts GitHub Copilot, OpenCode Zen, and Google Antigravity into OpenAI & Anthropic compatible APIs. Works with Claude Code, opencode, and more.
+
+将 GitHub Copilot、OpenCode Zen、Google Antigravity 等 AI 服务转换为 **OpenAI** 和 **Anthropic** 兼容 API，支持与 [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview)、[opencode](https://github.com/sst/opencode) 等工具无缝集成。
+
+---
+
+## 📋 目录
+
+- [功能特点](#-功能特点)
+- [快速开始](#-快速开始)
+- [详细使用指南](#-详细使用指南)
+  - [GitHub Copilot 模式](#1-github-copilot-模式默认)
+  - [OpenCode Zen 模式](#2-opencode-zen-模式)
+  - [Google Antigravity 模式](#3-google-antigravity-模式)
+- [代理配置](#-代理配置)
+- [Claude Code 集成](#-claude-code-集成)
+- [opencode 集成](#-opencode-集成)
+- [API 端点](#-api-端点)
+- [API Key 认证](#-api-key-认证)
+- [技术细节](#-技术细节)
+- [命令行参考](#️-命令行参考)
+- [Docker 部署](#-docker-部署)
+- [常见问题](#-常见问题)
+
+---
+
+## ✨ 功能特点
+
+| 功能 | 说明 |
+|------|------|
+| 🔌 **多后端支持** | GitHub Copilot、OpenCode Zen、Google Antigravity 三种后端可选 |
+| 🤖 **双协议兼容** | 同时支持 OpenAI Chat Completions API 和 Anthropic Messages API |
+| 💻 **Claude Code 集成** | 一键生成 Claude Code 启动命令 (`--claude-code`) |
+| 📊 **使用量监控** | Web 仪表盘实时查看 API 使用情况 |
+| 🔄 **自动认证** | Token 过期自动刷新，无需手动干预 |
+| ⚡ **速率限制** | 内置请求频率控制，避免触发限制 |
+| 🌐 **代理支持** | 支持 HTTP/HTTPS 代理，配置持久化 |
+| 🐳 **Docker 支持** | 提供完整的 Docker 部署方案 |
+| 🔑 **API Key 认证** | 可选的 API Key 鉴权，保护公开部署的服务 |
+| ✂️ **上下文透传** | 全量透传上下文至上游 API，由客户端（如 Claude Code）自行管理压缩 |
+| 🔍 **智能模型匹配** | 自动处理模型名格式差异（日期后缀、dash/dot 版本号等） |
+| 🔁 **Antigravity 端点容错** | 熔断器状态机、加权账号调度、后台任务自动降级、双端点自动切换 |
+
+---
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 全局安装
+npm install -g copilot-api-plus
+
+# 或使用 npx 直接运行（推荐）
+npx copilot-api-plus@latest start
+```
+
+### 基本用法
+
+```bash
+# 启动服务器（默认使用 GitHub Copilot）
+npx copilot-api-plus@latest start
+
+# 使用 OpenCode Zen
+npx copilot-api-plus@latest start --zen
+
+# 使用 Google Antigravity
+npx copilot-api-plus@latest start --antigravity
+
+# 与 Claude Code 配合
+npx copilot-api-plus@latest start --claude-code
+```
+
+服务器启动后，默认监听 `http://localhost:4141`。
+
+---
+
+## 📖 详细使用指南
+
+### 1. GitHub Copilot 模式（默认）
+
+使用你的 GitHub Copilot 订阅访问 AI 模型。
+
+#### 前置要求
+- GitHub 账户
+- 有效的 Copilot 订阅（Individual / Business / Enterprise）
+
+#### 启动步骤
+
+```bash
+npx copilot-api-plus@latest start
+```
+
+**首次运行**会引导你完成 GitHub OAuth 认证：
+
+1. 终端显示设备码，例如：`XXXX-XXXX`
+2. 打开浏览器访问：https://github.com/login/device
+3. 输入设备码，点击授权
+4. 返回终端，等待认证完成
+
+认证成功后，Token 会保存到本地，下次启动无需重新认证。
+
+#### 企业/商业账户
+
+```bash
+# Business 计划
+npx copilot-api-plus@latest start --account-type business
+
+# Enterprise 计划  
+npx copilot-api-plus@latest start --account-type enterprise
+```
+
+#### 可用模型
+
+| 模型 | ID | 上下文长度 |
+|------|-----|-----------|
+| Claude Sonnet 4 | `claude-sonnet-4` | 200K |
+| Claude Sonnet 4.5 | `claude-sonnet-4.5` | 200K |
+| GPT-4.1 | `gpt-4.1` | 1M |
+| o4-mini | `o4-mini` | 200K |
+| Gemini 2.5 Pro | `gemini-2.5-pro` | 1M |
+
+---
+
+### 2. OpenCode Zen 模式
+
+使用 [OpenCode Zen](https://opencode.ai/zen) 的多模型 API 服务，支持 GPT-5、Claude、Gemini 等顶级编程模型。
+
+#### 前置要求
+1. 访问 https://opencode.ai/zen
+2. 注册账号并创建 API Key
+
+#### 启动步骤
+
+**方式一：交互式设置**
+```bash
+npx copilot-api-plus@latest start --zen
+```
+首次运行会提示输入 API Key，保存后下次自动使用。
+
+**方式二：直接指定 API Key**
+```bash
+npx copilot-api-plus@latest start --zen --zen-api-key YOUR_API_KEY
+```
+
+#### 可用模型
+
+| 模型 | ID | 说明 |
+|------|-----|------|
+| GPT-5.2 | `gpt-5.2` | OpenAI 最新模型 |
+| GPT-5.1 Codex Max | `gpt-5.1-codex-max` | 代码优化版 |
+| GPT-5.1 Codex | `gpt-5.1-codex` | 代码专用 |
+| GPT-5 Codex | `gpt-5-codex` | OpenAI Responses API |
+| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude (200K) |
+| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude (200K) |
+| Claude Sonnet 4 | `claude-sonnet-4` | Anthropic Claude |
+| Gemini 3 Pro | `gemini-3-pro` | Google Gemini |
+| Qwen3 Coder | `qwen3-coder` | Alibaba Qwen |
+| Kimi K2 | `kimi-k2` | Moonshot |
+| Grok Code Fast 1 | `grok-code-fast-1` | xAI |
+
+更多模型请访问 [opencode.ai/zen](https://opencode.ai/zen)
+
+#### API 端点
+
+Zen 模式支持以下 API 端点：
+
+| 端点 | 说明 |
+|------|------|
+| `/v1/chat/completions` | OpenAI 兼容 Chat API |
+| `/v1/messages` | Anthropic 兼容 Messages API |
+| `/v1/responses` | OpenAI Responses API (GPT-5 系列) |
+| `/v1/models` | 获取可用模型列表 |
+
+专用端点（无需 `--zen` 标志也可访问）：
+- `/zen/v1/chat/completions`
+- `/zen/v1/messages`
+- `/zen/v1/responses`
+- `/zen/v1/models`
+
+#### 管理 API Key
+
+```bash
+# 查看/更换 API Key（清除后重新启动会提示输入）
+npx copilot-api-plus@latest logout --zen
+```
+
+---
+
+### 3. Google Antigravity 模式
+
+使用 Google Antigravity API 服务，支持 Gemini 和 Claude 模型。
+
+#### 前置要求
+- Google 账户
+
+#### 认证方式
+
+**方式一：API Key（推荐 - 最简单）**
+
+1. 访问 https://aistudio.google.com/apikey 获取 API Key
+2. 使用环境变量启动：
+
+```bash
+# Linux/macOS
+GEMINI_API_KEY=your_api_key npx copilot-api-plus@latest start --antigravity
+
+# Windows PowerShell
+$env:GEMINI_API_KEY = "your_api_key"
+npx copilot-api-plus@latest start --antigravity
+
+# Windows CMD
+set GEMINI_API_KEY=your_api_key
+npx copilot-api-plus@latest start --antigravity
+```
+
+**方式二：OAuth 网页登录（推荐）**
+
+```bash
+npx copilot-api-plus@latest start --antigravity
+```
+
+首次运行会提示选择登录方式：
+- **Web（推荐）**：自动打开浏览器完成 Google 登录，授权后自动捕获回调
+- **Manual**：手动复制回调 URL 到终端
+
+**方式三：自定义 OAuth 凭证**
+
+如果遇到 `invalid_client` 错误，可以创建自己的 OAuth 应用：
+
+1. 访问 https://console.cloud.google.com/apis/credentials
+2. 创建 OAuth 2.0 客户端 ID（选择"桌面应用"类型）
+3. 添加重定向 URI：`http://localhost:8046/callback`
+4. 使用环境变量或命令行参数：
+
+```bash
+# 环境变量方式
+ANTIGRAVITY_CLIENT_ID=your_client_id ANTIGRAVITY_CLIENT_SECRET=your_secret \
+  npx copilot-api-plus@latest start --antigravity
+
+# 命令行参数方式
+npx copilot-api-plus@latest start --antigravity \
+  --antigravity-client-id your_client_id \
+  --antigravity-client-secret your_secret
+```
+
+#### 可用模型
+
+| 模型 | ID | 说明 |
+|------|-----|------|
+| Gemini 2.5 Pro | `gemini-2.5-pro-exp-03-25` | Google Gemini |
+| Gemini 2.5 Pro Preview | `gemini-2.5-pro-preview-05-06` | Google Gemini |
+| Gemini 2.0 Flash | `gemini-2.0-flash-exp` | 快速响应 |
+| Gemini 2.0 Flash Thinking | `gemini-2.0-flash-thinking-exp` | 支持思考链 |
+| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude |
+| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude |
+
+#### 特性
+- ✅ 自动 Token 刷新
+- ✅ 多账户支持，加权智能调度（配额健康度 60% + Token 新鲜度 20% + 可靠性 20%）
+- ✅ 配额用尽自动切换账户
+- ✅ 熔断器状态机（CLOSED → OPEN → HALF_OPEN → CLOSED）
+- ✅ 后台/Agent 请求多信号检测，可选模型降级节省配额
+- ✅ 支持 Thinking 模型（思考链输出）
+
+#### 多账户管理
+
+可以添加多个 Google 账户，系统会在配额用尽时自动切换：
+
+```bash
+# 添加新账户
+npx copilot-api-plus@latest antigravity add
+
+# 列出所有账户
+npx copilot-api-plus@latest antigravity list
+
+# 按索引删除账户
+npx copilot-api-plus@latest antigravity remove 0
+
+# 清除所有账户
+npx copilot-api-plus@latest antigravity clear
+# 或使用 logout 命令
+npx copilot-api-plus@latest logout --antigravity
+```
+
+---
+
+## 🌐 代理配置
+
+如果你需要通过代理访问网络，有两种配置方式：
+
+### 方式一：持久化配置（推荐）
+
+配置一次，永久生效，下次启动自动使用。
+
+```bash
+# 交互式配置
+npx copilot-api-plus@latest proxy --set
+
+# 或直接设置
+npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890
+
+# 同时设置 HTTP 和 HTTPS 代理
+npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890 --https-proxy http://127.0.0.1:7890
+```
+
+#### 代理管理命令
+
+```bash
+# 查看当前代理配置
+npx copilot-api-plus@latest proxy
+
+# 启用代理
+npx copilot-api-plus@latest proxy --enable
+
+# 禁用代理（保留设置）
+npx copilot-api-plus@latest proxy --disable
+
+# 清除代理配置
+npx copilot-api-plus@latest proxy --clear
+```
+
+#### 示例：配置 Clash 代理
+
+```bash
+# Clash 默认端口 7890
+npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890
+
+# 验证配置
+npx copilot-api-plus@latest proxy
+# 输出：
+# Current proxy configuration:
+#   Status: ✅ Enabled
+#   HTTP_PROXY: http://127.0.0.1:7890
+#   HTTPS_PROXY: http://127.0.0.1:7890
+```
+
+### 方式二：环境变量（临时）
+
+仅当次启动生效：
+
+```bash
+# Linux/macOS
+export HTTP_PROXY=http://127.0.0.1:7890
+export HTTPS_PROXY=http://127.0.0.1:7890
+npx copilot-api-plus@latest start --proxy-env
+
+# Windows PowerShell
+$env:HTTP_PROXY = "http://127.0.0.1:7890"
+$env:HTTPS_PROXY = "http://127.0.0.1:7890"
+npx copilot-api-plus@latest start --proxy-env
+
+# Windows CMD
+set HTTP_PROXY=http://127.0.0.1:7890
+set HTTPS_PROXY=http://127.0.0.1:7890
+npx copilot-api-plus@latest start --proxy-env
+```
+
+### 代理配置优先级
+
+1. `--proxy-env` 参数（从环境变量读取）
+2. 持久化配置（`proxy --set` 设置的）
+3. 无代理
+
+---
+
+## 💻 Claude Code 集成
+
+[Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) 是 Anthropic 的 AI 编程助手。
+
+### 自动配置（推荐）
+
+```bash
+# 使用 GitHub Copilot 作为后端
+npx copilot-api-plus@latest start --claude-code
+
+# 使用 OpenCode Zen 作为后端
+npx copilot-api-plus@latest start --zen --claude-code
+
+# 使用 Google Antigravity 作为后端
+npx copilot-api-plus@latest start --antigravity --claude-code
+```
+
+运行后：
+1. 选择主模型（用于代码生成）
+2. 选择快速模型（用于后台任务）
+3. 启动命令会自动复制到剪贴板
+4. **打开新终端**，粘贴并运行命令启动 Claude Code
+
+### 手动配置
+
+在项目根目录创建 `.claude/settings.json`：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://localhost:4141",
+    "ANTHROPIC_AUTH_TOKEN": "dummy",
+    "ANTHROPIC_MODEL": "claude-sonnet-4",
+    "ANTHROPIC_SMALL_FAST_MODEL": "gpt-4.1",
+    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
+  }
+}
+```
+
+然后启动 copilot-api-plus 服务器后，在该项目目录运行 `claude` 命令。
+
+---
+
+## 🔧 opencode 集成
+
+[opencode](https://github.com/sst/opencode) 是一个现代 AI 编程助手。
+
+### 配置步骤
+
+1. 在项目根目录创建 `opencode.json`：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "copilot-api-plus": {
+      "api": "openai-compatible",
+      "name": "Copilot API Plus",
+      "options": {
+        "baseURL": "http://127.0.0.1:4141/v1"
+      },
+      "models": {
+        "claude-sonnet-4": {
+          "name": "Claude Sonnet 4",
+          "id": "claude-sonnet-4",
+          "max_tokens": 64000,
+          "profile": "coder",
+          "limit": { "context": 200000 }
+        },
+        "gpt-4.1": {
+          "name": "GPT-4.1",
+          "id": "gpt-4.1",
+          "max_tokens": 32768,
+          "profile": "coder",
+          "limit": { "context": 1047576 }
+        }
+      }
+    }
+  }
+}
+```
+
+2. 启动 copilot-api-plus：
+```bash
+npx copilot-api-plus@latest start
+```
+
+3. 在同一目录运行 opencode：
+```bash
+npx opencode@latest
+```
+
+4. 选择 `copilot-api-plus` 作为 provider
+
+### 快捷方式：使用环境变量
+
+```bash
+# 设置环境变量
+export OPENAI_BASE_URL=http://127.0.0.1:4141/v1
+export OPENAI_API_KEY=dummy
+
+# 运行 opencode
+npx opencode@latest
+```
+
+---
+
+## 📡 API 端点
+
+服务器启动后，默认监听 `http://localhost:4141`。
+
+### OpenAI 兼容端点
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/v1/chat/completions` | POST | 聊天补全（支持流式） |
+| `/v1/models` | GET | 模型列表 |
+| `/v1/embeddings` | POST | 文本嵌入（仅 Copilot） |
+
+### Anthropic 兼容端点
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/v1/messages` | POST | 消息 API（支持流式） |
+| `/v1/messages/count_tokens` | POST | Token 计数 |
+
+### 专用端点
+
+各后端都有独立的专用路由，即使切换默认后端也能访问：
+
+| 路由前缀 | 说明 |
+|----------|------|
+| `/copilot/v1/*` | GitHub Copilot 专用 |
+| `/zen/v1/*` | OpenCode Zen 专用 |
+| `/antigravity/v1/*` | Google Antigravity 专用 |
+
+### 监控端点
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/usage` | GET | 使用量统计（仅 Copilot） |
+| `/token` | GET | 当前 Token 信息 |
+
+### 调用示例
+
+```bash
+# OpenAI 格式
+curl http://localhost:4141/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4",
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+
+# Anthropic 格式
+curl http://localhost:4141/v1/messages \
+  -H "Content-Type: application/json" \
+  -H "x-api-key: dummy" \
+  -d '{
+    "model": "claude-sonnet-4",
+    "max_tokens": 1024,
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+```
+
+---
+
+## ⚙️ 命令行参考
+
+### 命令列表
+
+| 命令 | 说明 |
+|------|------|
+| `start` | 启动 API 服务器 |
+| `auth` | 仅执行 GitHub 认证流程 |
+| `logout` | 清除已保存的凭证 |
+| `proxy` | 配置代理设置 |
+| `antigravity` | 管理 Google Antigravity 账户 |
+| `check-usage` | 查看 Copilot 使用量 |
+| `debug` | 显示调试信息 |
+
+### start 命令参数
+
+| 参数 | 别名 | 默认值 | 说明 |
+|------|------|--------|------|
+| `--port` | `-p` | 4141 | 监听端口 |
+| `--verbose` | `-v` | false | 详细日志 |
+| `--account-type` | `-a` | individual | 账户类型 (individual/business/enterprise) |
+| `--claude-code` | `-c` | false | 生成 Claude Code 启动命令 |
+| `--zen` | `-z` | false | 启用 OpenCode Zen 模式 |
+| `--zen-api-key` | - | - | Zen API Key |
+| `--antigravity` | - | false | 启用 Google Antigravity 模式 |
+| `--antigravity-client-id` | - | - | Antigravity OAuth Client ID |
+| `--antigravity-client-secret` | - | - | Antigravity OAuth Client Secret |
+| `--rate-limit` | `-r` | - | 请求间隔（秒） |
+| `--wait` | `-w` | false | 达到限制时等待而非报错 |
+| `--manual` | - | false | 手动审批每个请求 |
+| `--github-token` | `-g` | - | 直接提供 GitHub Token |
+| `--show-token` | - | false | 显示 Token 信息 |
+| `--proxy-env` | - | false | 从环境变量读取代理 |
+| `--api-key` | - | - | API Key 鉴权（可多次指定） |
+
+### proxy 命令参数
+
+| 参数 | 说明 |
+|------|------|
+| `--set` | 交互式配置代理 |
+| `--enable` | 启用已保存的代理 |
+| `--disable` | 禁用代理（保留设置） |
+| `--clear` | 清除代理配置 |
+| `--show` | 显示当前配置 |
+| `--http-proxy` | HTTP 代理 URL |
+| `--https-proxy` | HTTPS 代理 URL |
+| `--no-proxy` | 不走代理的主机列表 |
+
+### logout 命令参数
+
+| 参数 | 别名 | 说明 |
+|------|------|------|
+| `--github` | `-g` | 仅清除 GitHub Copilot 凭证 |
+| `--zen` | `-z` | 仅清除 Zen 凭证 |
+| `--antigravity` | - | 仅清除 Antigravity 凭证 |
+| `--all` | `-a` | 清除所有凭证 |
+
+> **提示**：不带参数运行 `logout` 会显示交互式菜单供选择。
+
+### antigravity 命令
+
+管理 Google Antigravity 账户的子命令：
+
+| 子命令 | 说明 |
+|--------|------|
+| `add` | 添加新的 Antigravity 账户（OAuth 登录） |
+| `list` | 列出所有已配置的账户及其状态 |
+| `remove <index>` | 按索引删除指定账户 |
+| `clear` | 清除所有 Antigravity 账户（需确认） |
+
+```bash
+# 示例
+npx copilot-api-plus@latest antigravity add      # 添加账户
+npx copilot-api-plus@latest antigravity list     # 列出账户
+npx copilot-api-plus@latest antigravity remove 0 # 删除索引为 0 的账户
+npx copilot-api-plus@latest antigravity clear    # 清除所有账户
+```
+
+---
+
+## 🔑 API Key 认证
+
+如果你将服务暴露到公网，可以启用 API Key 认证来保护接口：
+
+```bash
+# 单个 Key
+npx copilot-api-plus@latest start --api-key my-secret-key
+
+# 多个 Key
+npx copilot-api-plus@latest start --api-key key1 --api-key key2
+```
+
+启用后，所有请求需要携带 API Key：
+
+```bash
+# OpenAI 格式 - 通过 Authorization header
+curl http://localhost:4141/v1/chat/completions \
+  -H "Authorization: Bearer my-secret-key" \
+  -H "Content-Type: application/json" \
+  -d '{"model": "claude-sonnet-4", "messages": [{"role": "user", "content": "Hello"}]}'
+
+# Anthropic 格式 - 通过 x-api-key header
+curl http://localhost:4141/v1/messages \
+  -H "x-api-key: my-secret-key" \
+  -H "Content-Type: application/json" \
+  -d '{"model": "claude-sonnet-4", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
+```
+
+在 Claude Code 中使用时，将 `ANTHROPIC_AUTH_TOKEN` 设为你的 API Key 即可。
+
+---
+
+## 🔧 技术细节
+
+### 上下文管理
+
+代理层不做上下文截断，全量透传消息至上游 API。上下文压缩由客户端负责：
+
+- **Claude Code**：通过 `/count_tokens` 端点获取当前 token 数，接近上限时自动触发 `/compact` 压缩
+- **其他客户端**：如果上游 API 返回 400（token 超限），客户端自行处理重试
+
+### 智能模型名匹配
+
+Anthropic 格式的模型名（如 `claude-opus-4-6`）和 Copilot 的模型列表 ID 可能存在格式差异。代理使用多策略精确匹配：
+
+| 策略 | 示例 |
+|------|------|
+| 精确匹配 | `claude-opus-4-6` → `claude-opus-4-6` |
+| 去日期后缀 | `claude-opus-4-6-20251101` → `claude-opus-4-6` |
+| Dash → Dot | `claude-opus-4-5` → `claude-opus-4.5` |
+| Dot → Dash | `claude-opus-4.5` → `claude-opus-4-5` |
+
+对于 Anthropic 端点（`/v1/messages`），还会先通过 `translateModelName` 做格式转换（包括旧格式 `claude-3-5-sonnet` → `claude-sonnet-4.5` 的映射），再通过上述策略匹配。
+
+### Antigravity 端点容错
+
+Google Antigravity 模式内置了多层可靠性保障：
+
+- **熔断器状态机**：按模型族（claude/gemini/other）独立管理，3 次失败后熔断（OPEN），30 秒后半开（HALF_OPEN）试探，连续 2 次成功则恢复（CLOSED）
+- **加权账号调度**：替代简单轮换，综合评分 `score = 配额健康度×0.6 + Token新鲜度×0.2 + 可靠性×0.2`，优先选用最健康的账号
+- **后台任务检测与降级**：多信号加权检测（tool_calls +0.5、tool 角色 +0.4、助手密度 +0.2、长对话 +0.1），得分 ≥ 0.6 判定为 Agent 请求，可自动降级高价模型（如 claude-sonnet-4-5 → gemini-2.5-flash）。通过 `ANTIGRAVITY_BACKGROUND_DOWNGRADE=1` 环境变量启用，默认关闭
+- **双端点自动切换**：daily sandbox 和 production 两个端点，一个失败自动切换到另一个
+- **指数退避重试**：429/503 等限流错误自动退避重试，短间隔走同端点，长间隔切换端点
+
+#### 后台降级环境变量
+
+| 变量 | 默认 | 说明 |
+|------|------|------|
+| `ANTIGRAVITY_BACKGROUND_DOWNGRADE` | `0` (关闭) | 设为 `1` 启用 Agent/后台请求自动模型降级 |
+
+降级映射：
+
+| 原始模型 | 降级后 |
+|----------|--------|
+| `claude-sonnet-4-5` | `gemini-2.5-flash` |
+| `claude-sonnet-4-5-thinking` | `gemini-2.5-flash-thinking` |
+| `claude-opus-4-5-thinking` | `claude-sonnet-4-5-thinking` |
+| `gemini-2.5-pro` | `gemini-2.5-flash` |
+| `gemini-3-pro-high` | `gemini-3-flash` |
+| `gemini-3-pro-low` | `gemini-3-flash` |
+
+客户端也可通过请求头 `X-Request-Type: background` 显式标记后台请求，无需检测直接生效。
+
+### 请求日志
+
+每次 API 请求会输出一行日志，包含模型名、状态码和耗时：
+
+```log
+[claude-opus-4-6] 13:13:39 <-- POST /v1/messages?beta=true
+[claude-opus-4-6] 13:13:59 --> POST /v1/messages?beta=true 200 20.1s
+```
+
+### 网络重试
+
+对上游 API 的请求内置了瞬时网络错误重试（TLS 断开、连接重置等）：
+
+- 最多重试 2 次（共 3 次尝试）
+- 退避间隔：1s、2s
+- 仅重试网络层错误，HTTP 错误码（如 400/500）不重试
+
+---
+
+## 🐳 Docker 部署
+
+### 快速启动
+
+```bash
+# 使用预构建镜像
+docker run -p 4141:4141 \
+  -v ./copilot-data:/root/.local/share/copilot-api-plus \
+  ghcr.io/imbuxiangnan-cyber/copilot-api-plus
+```
+
+### 自行构建
+
+```bash
+# 构建镜像
+docker build -t copilot-api-plus .
+
+# 运行容器
+docker run -p 4141:4141 \
+  -v ./copilot-data:/root/.local/share/copilot-api-plus \
+  copilot-api-plus
+```
+
+### Docker Compose
+
+```yaml
+version: "3.8"
+services:
+  copilot-api-plus:
+    build: .
+    ports:
+      - "4141:4141"
+    volumes:
+      - ./copilot-data:/root/.local/share/copilot-api-plus
+    environment:
+      - GH_TOKEN=your_github_token  # 可选
+    restart: unless-stopped
+```
+
+### 使用代理
+
+```bash
+docker run -p 4141:4141 \
+  -e HTTP_PROXY=http://host.docker.internal:7890 \
+  -e HTTPS_PROXY=http://host.docker.internal:7890 \
+  -v ./copilot-data:/root/.local/share/copilot-api-plus \
+  copilot-api-plus start --proxy-env
+```
+
+---
+
+## ❓ 常见问题
+
+### 数据存储位置
+
+所有数据存储在 `~/.local/share/copilot-api-plus/` 目录下：
+
+| 文件 | 说明 |
+|------|------|
+| `github_token` | GitHub Token |
+| `zen-auth.json` | Zen API Key |
+| `antigravity-accounts.json` | Antigravity 账户 |
+| `config.json` | 代理等配置 |
+
+### 切换账户
+
+```bash
+# 交互式选择要清除的凭证
+npx copilot-api-plus@latest logout
+
+# 仅清除 GitHub Copilot 凭证
+npx copilot-api-plus@latest logout --github
+# 或简写
+npx copilot-api-plus@latest logout -g
+
+# 清除 Zen 凭证
+npx copilot-api-plus@latest logout --zen
+
+# 清除 Antigravity 凭证
+npx copilot-api-plus@latest logout --antigravity
+
+# 清除所有凭证
+npx copilot-api-plus@latest logout --all
+```
+
+### 查看使用量
+
+```bash
+# 命令行查看（仅 Copilot）
+npx copilot-api-plus@latest check-usage
+```
+
+启动服务器后，也可以访问 Web 仪表盘：
+```
+https://imbuxiangnan-cyber.github.io/copilot-api-plus?endpoint=http://localhost:4141/usage
+```
+
+### 调试问题
+
+```bash
+# 显示调试信息
+npx copilot-api-plus@latest debug
+
+# JSON 格式输出
+npx copilot-api-plus@latest debug --json
+
+# 启用详细日志
+npx copilot-api-plus@latest start --verbose
+```
+
+### 速率限制
+
+避免触发 GitHub 的滥用检测：
+
+```bash
+# 设置请求间隔 30 秒
+npx copilot-api-plus@latest start --rate-limit 30
+
+# 达到限制时等待而非报错
+npx copilot-api-plus@latest start --rate-limit 30 --wait
+
+# 手动审批每个请求
+npx copilot-api-plus@latest start --manual
+```
+
+---
+
+## ⚠️ 免责声明
+
+> [!WARNING]
+> 这是 GitHub Copilot API 的逆向工程代理。**不受 GitHub 官方支持**，可能随时失效。使用风险自负。
+
+> [!WARNING]
+> **GitHub 安全提示**：过度的自动化或脚本化使用 Copilot 可能触发 GitHub 的滥用检测系统，导致 Copilot 访问被暂停。请负责任地使用。
+>
+> 相关政策：
+> - [GitHub 可接受使用政策](https://docs.github.com/site-policy/acceptable-use-policies/github-acceptable-use-policies)
+> - [GitHub Copilot 条款](https://docs.github.com/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)
+
+---
+
+## 📄 许可证
+
+MIT License