# AIAPI

AI API 代理服务器，将 GitHub Copilot、OpenCode Zen、Google Antigravity、AWS Kiro、Factory AI Droids 等 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-模式)
  - [AWS Kiro 模式](#4-aws-kiro-模式)
  - [Factory AI Droids 模式](#5-factory-ai-droids-模式)
- [多平台轮换](#多平台轮换)
- [模型映射](#模型映射)
- [代理配置](#代理配置)
- [Claude Code 集成](#claude-code-集成)
- [opencode 集成](#opencode-集成)
- [API 端点](#api-端点)
- [命令行参考](#命令行参考)
- [Docker 部署](#docker-部署)
- [常见问题](#常见问题)

---

## 功能特点

| 功能             | 说明                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------ |
| 多后端支持       | GitHub Copilot、OpenCode Zen、Google Antigravity、AWS Kiro、Factory AI Droids 五种后端可选 |
| 双协议兼容       | 同时支持 OpenAI Chat Completions API 和 Anthropic Messages API                             |
| 多账号池管理     | 支持多账号配置，自动轮换和故障转移                                                         |
| Request ID 追踪  | 每个请求自动分配唯一 ID，便于日志追踪                                                      |
| Claude Code 集成 | 一键生成 Claude Code 启动命令 (`--claude-code`)                                            |
| 使用量监控       | Web 仪表盘实时查看 API 使用情况                                                            |
| 自动认证         | Token 过期自动刷新，无需手动干预                                                           |
| 速率限制         | 内置请求频率控制，避免触发限制                                                             |
| 代理支持         | 支持 HTTP/HTTPS 代理，配置持久化                                                           |
| Docker 支持      | 提供完整的 Docker 部署方案                                                                 |

---

## 快速开始

### 方式一：npm/npx（推荐）

```bash
# npx 直接运行（无需安装）
npx aiapi-server start
npx aiapi-server start --kiro
npx aiapi-server start --droids

# 或全局安装
npm install -g aiapi-server
aiapi start
aiapi start --kiro
```

### 方式二：源码运行

```bash
# 克隆项目
git clone https://github.com/imbuxiangnan-cyber/aiapi.git
cd aiapi

# 安装依赖
bun install

# 开发模式
bun run dev

# 生产环境
bun run start
```

服务器启动后，默认监听 `http://localhost:4141`。

---

## 详细使用指南

### 1. GitHub Copilot 模式（默认）

使用你的 GitHub Copilot 订阅访问 AI 模型。

#### 前置要求

- GitHub 账户
- 有效的 Copilot 订阅（Individual / Business / Enterprise）

#### 启动步骤

```bash
bun run start
```

**首次运行**会引导你完成 GitHub OAuth 认证：

1. 终端显示设备码，例如：`XXXX-XXXX`
2. 打开浏览器访问：https://github.com/login/device
3. 输入设备码，点击授权
4. 返回终端，等待认证完成

认证成功后，Token 会保存到本地，下次启动无需重新认证。

#### 企业/商业账户

```bash
# Business 计划
aiapi start --account-type business

# Enterprise 计划
aiapi 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

#### 可用模型

| 模型              | ID                  | 说明                    |
| ----------------- | ------------------- | ----------------------- |
| GPT-5.2           | `gpt-5.2`           | OpenAI 最新模型         |
| GPT-5.1 Codex Max | `gpt-5.1-codex-max` | 代码优化版              |
| Claude Opus 4.5   | `claude-opus-4-5`   | Anthropic Claude (200K) |
| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude (200K) |
| Gemini 3 Pro      | `gemini-3-pro`      | Google Gemini           |
| Qwen3 Coder       | `qwen3-coder`       | Alibaba Qwen            |
| Kimi K2           | `kimi-k2`           | Moonshot                |

更多模型请访问 [opencode.ai/zen](https://opencode.ai/zen)

---

### 3. Google Antigravity 模式

使用 Google Antigravity API 服务，支持 Gemini 和 Claude 模型。

#### 前置要求

- Google 账户

#### 认证方式

**方式一：API Key（推荐）**

1. 访问 https://aistudio.google.com/apikey 获取 API Key
2. 使用环境变量启动：

```bash
# Windows PowerShell
$env:GEMINI_API_KEY = "your_api_key"
bun run start

# Windows CMD
set GEMINI_API_KEY=your_api_key
bun run start
```

#### 可用模型

| 模型              | ID                         | 说明             |
| ----------------- | -------------------------- | ---------------- |
| Gemini 2.5 Pro    | `gemini-2.5-pro-exp-03-25` | Google Gemini    |
| Gemini 2.0 Flash  | `gemini-2.0-flash-exp`     | 快速响应         |
| Claude Opus 4.5   | `claude-opus-4-5`          | Anthropic Claude |
| Claude Sonnet 4.5 | `claude-sonnet-4-5`        | Anthropic Claude |

#### 特性

- 自动 Token 刷新
- 多账户支持，自动轮换
- 配额用尽自动切换账户
- 支持 Thinking 模型（思考链输出）

---

### 4. AWS Kiro 模式

使用 AWS Kiro (CodeWhisperer) 服务访问 AI 模型。

#### 前置要求

- AWS 账户
- CodeWhisperer 访问权限

#### 启动步骤

```bash
bun run start --kiro
# 或使用别名
bun run start -k
```

**首次运行**会引导你完成 AWS 认证：

1. 选择认证方式（Social 或 IdC）
2. 按提示完成 AWS Builder ID 或 IAM Identity Center 登录
3. 认证成功后，凭证会保存到本地

#### 可用模型

| 模型              | ID                           | 说明             |
| ----------------- | ---------------------------- | ---------------- |
| Claude Sonnet 4   | `claude-sonnet-4-20250514`   | Anthropic Claude |
| Claude 3.5 Sonnet | `claude-3-5-sonnet-20241022` | Anthropic Claude |
| Claude 3.5 Haiku  | `claude-3-5-haiku-20241022`  | 快速响应         |
| Amazon Nova Pro   | `amazon-nova-pro-v1:0`       | Amazon Nova      |
| Amazon Nova Lite  | `amazon-nova-lite-v1:0`      | 轻量版           |

---

### 5. Factory AI Droids 模式

使用 [Factory AI Droids](https://factory.ai/) 服务访问多种 AI 模型。

#### 前置要求

1. 访问 https://factory.ai/
2. 注册账号并创建 API Key（格式：`fk-xxx`）

#### 启动步骤

```bash
bun run start --droids
# 或使用别名
bun run start -d
```

**首次运行**会提示输入 Droids API Key。

#### 可用模型

| 模型              | ID                           | 说明              |
| ----------------- | ---------------------------- | ----------------- |
| Claude Sonnet 4   | `claude-sonnet-4-20250514`   | Anthropic Claude  |
| Claude 3.5 Sonnet | `claude-3-5-sonnet-20241022` | Anthropic Claude  |
| GPT-4o            | `gpt-4o`                     | OpenAI            |
| GPT-4o Mini       | `gpt-4o-mini`                | OpenAI 轻量版     |
| o1                | `o1`                         | OpenAI 推理模型   |
| o1-mini           | `o1-mini`                    | OpenAI 推理轻量版 |
| Gemini 2.0 Flash  | `gemini-2.0-flash`           | Google Gemini     |
| Gemini 1.5 Pro    | `gemini-1.5-pro`             | Google Gemini     |

---

## 多平台轮换

多平台轮换功能允许你同时使用多个平台，自动在它们之间轮换请求，实现负载均衡和故障转移。

### 开启轮换

轮换功能**默认关闭**，需要手动开启。通过代码调用：

```typescript
import { enableRotation, disableRotation } from "~/lib/auto-router";

// 开启轮转，指定参与的平台
enableRotation(["kiro", "antigravity", "droids"]);

// 关闭轮转
disableRotation();
```

### 工作原理

1. **平台内账号轮换**：在当前平台内部，轮换使用所有已配置的账号
2. **模型过滤**：只选择支持当前模型的平台
3. **跨平台故障转移**：当前平台所有账号都被限额或连续多次错误后，自动切换到下一个平台，继续账号轮换
4. **循环机制**：所有平台轮换完毕后，从头开始

```
平台1 (kiro): 账号A → 账号B → 账号C (轮换)
              ↓ 所有账号被限额/多次错误
平台2 (antigravity): 账号D → 账号E (轮换)
              ↓ 所有账号被限额/多次错误
平台3 (droids): 账号F (轮换)
              ↓ 所有平台用完
返回平台1 (kiro): 继续轮换...
```

### 故障处理

```typescript
import { markPlatformFailed, resetFailedPlatforms } from "~/lib/auto-router";

// 标记平台失败（后续请求会跳过该平台）
markPlatformFailed("kiro");

// 重置所有失败状态
resetFailedPlatforms();
```

### 注意事项和限制

> **重要**：多平台轮转存在以下问题，使用前请仔细阅读。

#### 1. 上下文不连续

**问题**：每次请求可能路由到不同平台，导致对话上下文丢失。

```
用户: 请帮我写一个函数  → 平台A
AI: 好的，这是函数...
用户: 请优化这个函数    → 平台B (不知道之前写了什么函数！)
```

**解决方案**：

- 对于需要上下文的对话，使用手动映射固定到单一平台
- 或者在每次请求中包含完整的对话历史

#### 2. 模型名称不一致

**问题**：同一个模型在不同平台可能有不同的名称。

| 平台        | 模型名称               |
| ----------- | ---------------------- |
| Copilot     | `claude-sonnet-4`      |
| Kiro        | `CLAUDE_SONNET_4_V1_0` |
| Antigravity | `claude-sonnet-4-5`    |

**解决方案**：使用[模型映射](#模型映射)功能统一模型名称。

#### 3. 响应格式差异

**问题**：不同平台返回的响应格式可能略有不同（如 token 计数、finish_reason 等）。

**影响**：某些依赖特定响应字段的客户端可能出现兼容性问题。

#### 4. 配额和限制不同

**问题**：各平台的配额、速率限制、最大 token 数等可能不同。

**建议**：

- 了解各平台的限制
- 设置合理的 `max_tokens` 值
- 监控各平台的使用量

#### 5. 适用场景

| 场景        | 是否适合轮转 | 原因               |
| ----------- | ------------ | ------------------ |
| 单次问答    | ✅ 适合      | 无上下文依赖       |
| 代码生成    | ✅ 适合      | 通常是独立任务     |
| 多轮对话    | ❌ 不适合    | 需要上下文连续     |
| Claude Code | ⚠️ 谨慎      | 部分功能依赖上下文 |

---

## 模型映射

模型映射功能统一处理不同平台之间的模型名称差异，支持自动映射和手动配置。

### 自动映射

系统内置以下自动映射功能：

#### 1. 模型别名

常用别名会自动转换为标准名称：

| 输入别名            | 标准名称            |
| ------------------- | ------------------- |
| `claude-4.5-opus`   | `claude-opus-4-5`   |
| `claude-4.5-sonnet` | `claude-sonnet-4-5` |
| `claude-3.5-sonnet` | `claude-3-5-sonnet` |
| `gpt4o`             | `gpt-4o`            |
| `gemini-pro`        | `gemini-1.5-pro`    |
| `gemini-flash`      | `gemini-2.0-flash`  |

#### 2. Kiro 平台自动转换

Kiro (CodeWhisperer) 使用特殊的内部格式，系统会自动转换：

```
claude-sonnet-4      → CLAUDE_SONNET_4_V1_0
claude-opus-4-5      → CLAUDE_OPUS_4_5_V1_0
claude-3-5-haiku     → CLAUDE_3_5_HAIKU_V1_0
```

#### 3. 智能平台推荐

当请求的模型在当前平台不可用时，系统会自动推荐合适的平台：

| 模型类型    | 推荐平台    |
| ----------- | ----------- |
| Claude 系列 | Kiro        |
| GPT 系列    | Copilot     |
| Gemini 系列 | Antigravity |
| Amazon Nova | Kiro        |

### 手动配置

#### 跨平台模型映射

为同一模型在不同平台设置不同的名称：

```typescript
import { setCrossPlatformMappings } from "~/lib/model-mapper";

setCrossPlatformMappings({
  "claude-sonnet-4": {
    copilot: "claude-sonnet-4",
    kiro: "claude-sonnet-4-20250514",
    antigravity: "claude-sonnet-4-5",
  },
});
```

#### 平台到平台映射

当从一个平台切换到另一个平台时，指定模型的对应关系：

```typescript
import { addPlatformMapping } from "~/lib/model-mapper";

// 当 Kiro 的 claude-sonnet-4-5 切换到 Antigravity 时，使用 thinking 版本
addPlatformMapping("kiro", "claude-sonnet-4-5", {
  antigravity: "claude-sonnet-4-5-thinking",
});
```

### API 函数

| 函数                                         | 说明                     |
| -------------------------------------------- | ------------------------ |
| `normalizeModelName(model)`                  | 将别名转换为标准名称     |
| `mapModelForPlatform(model, platform)`       | 获取模型在指定平台的名称 |
| `setCrossPlatformMappings(mappings)`         | 设置跨平台映射           |
| `addPlatformMapping(source, model, targets)` | 添加平台到平台映射       |

---

## 代理配置

如果你需要通过代理访问网络，有两种配置方式：

### 方式一：持久化配置（推荐）

配置一次，永久生效，下次启动自动使用。

```bash
# 交互式配置
aiapi proxy --set

# 或直接设置
aiapi proxy --http-proxy http://127.0.0.1:7890

# 同时设置 HTTP 和 HTTPS 代理
aiapi proxy --http-proxy http://127.0.0.1:7890 --https-proxy http://127.0.0.1:7890
```

#### 代理管理命令

```bash
# 查看当前代理配置
aiapi proxy

# 启用代理
aiapi proxy --enable

# 禁用代理（保留设置）
aiapi proxy --disable

# 清除代理配置
aiapi proxy --clear
```

#### 示例：配置 Clash 代理

```bash
# Clash 默认端口 7890
aiapi proxy --http-proxy http://127.0.0.1:7890

# 验证配置
aiapi proxy
# 输出：
# Current proxy configuration:
#   Status: ✅ Enabled
#   HTTP_PROXY: http://127.0.0.1:7890
#   HTTPS_PROXY: http://127.0.0.1:7890
```

### 方式二：环境变量（临时）

仅当次启动生效：

```bash
# Windows PowerShell
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
aiapi start --proxy-env

# Windows CMD
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
aiapi start --proxy-env

# Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
aiapi 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 作为后端
aiapi start --claude-code

# 使用 OpenCode Zen 作为后端
aiapi start --zen --claude-code

# 使用 Google Antigravity 作为后端
aiapi start --antigravity --claude-code

# 使用 AWS Kiro 作为后端
aiapi start --kiro --claude-code

# 使用 Factory AI Droids 作为后端
aiapi start --droids --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"
  }
}
```

然后启动 aiapi 服务器后，在该项目目录运行 `claude` 命令。

---

## opencode 集成

[opencode](https://github.com/sst/opencode) 是一个现代 AI 编程助手。

在项目根目录创建 `opencode.json`：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aiapi": {
      "api": "openai-compatible",
      "name": "AIAPI",
      "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 }
        }
      }
    }
  }
}
```

---

## 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 专用 |
| `/kiro/v1/*`        | AWS Kiro 专用           |
| `/droids/v1/*`      | Factory AI Droids 专用  |

### 监控端点

| 端点          | 方法 | 说明                     |
| ------------- | ---- | ------------------------ |
| `/usage`      | GET  | 使用量统计（仅 Copilot） |
| `/token`      | GET  | 当前 Token 信息          |
| `/token-pool` | 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           |
| `--kiro`                      | `-k` | false      | 启用 AWS Kiro 模式                        |
| `--droids`                    | `-d` | false      | 启用 Factory AI Droids 模式               |
| `--rate-limit`                | `-r` | -          | 请求间隔（秒）                            |
| `--wait`                      | `-w` | false      | 达到限制时等待而非报错                    |
| `--manual`                    | -    | false      | 手动审批每个请求                          |
| `--github-token`              | `-g` | -          | 直接提供 GitHub Token                     |
| `--show-token`                | -    | false      | 显示 Token 信息                           |
| `--proxy-env`                 | -    | false      | 从环境变量读取代理                        |

### 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 凭证    |
| `--kiro`        | `-k` | 仅清除 Kiro 凭证           |
| `--droids`      | `-d` | 仅清除 Droids 凭证         |
| `--all`         | `-a` | 清除所有凭证               |

> **提示**：不带参数运行 `logout` 会显示交互式菜单供选择。

### antigravity 子命令

管理 Google Antigravity 账户：

| 子命令           | 说明                                    |
| ---------------- | --------------------------------------- |
| `add`            | 添加新的 Antigravity 账户（OAuth 登录） |
| `list`           | 列出所有已配置的账户及其状态            |
| `remove <index>` | 按索引删除指定账户                      |
| `clear`          | 清除所有 Antigravity 账户（需确认）     |

```bash
# 示例
aiapi antigravity add      # 添加账户
aiapi antigravity list     # 列出账户
aiapi antigravity remove 0 # 删除索引为 0 的账户
aiapi antigravity clear    # 清除所有账户
```

---

## Docker 部署

### 构建镜像

```bash
docker build -t aiapi .
```

### 运行容器

```bash
docker run -p 4141:4141 \
  -v ./data:/root/.local/share/aiapi \
  aiapi
```

### Docker Compose

```yaml
version: "3.8"
services:
  aiapi:
    build: .
    ports:
      - "4141:4141"
    volumes:
      - ./data:/root/.local/share/aiapi
    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 ./data:/root/.local/share/aiapi \
  aiapi start --proxy-env
```

---

## 常见问题

### 数据存储位置

所有数据存储在 `~/.local/share/aiapi/` 目录下：

| 文件                        | 说明             |
| --------------------------- | ---------------- |
| `github_token`              | GitHub Token     |
| `zen-auth.json`             | Zen API Key      |
| `antigravity-accounts.json` | Antigravity 账户 |
| `kiro-auth.json`            | Kiro 认证信息    |
| `droids-auth.json`          | Droids API Key   |
| `config.json`               | 代理等配置       |

### 切换账户

```bash
# 交互式选择要清除的凭证
aiapi logout

# 仅清除 GitHub Copilot 凭证
aiapi logout --github
# 或简写
aiapi logout -g

# 清除 Zen 凭证
aiapi logout --zen

# 清除 Antigravity 凭证
aiapi logout --antigravity

# 清除 Kiro 凭证
aiapi logout --kiro

# 清除 Droids 凭证
aiapi logout --droids

# 清除所有凭证
aiapi logout --all
```

### 查看使用量

```bash
# 命令行查看（仅 Copilot）
aiapi check-usage
```

启动服务器后，也可以访问监控端点：

```bash
# 使用量统计
curl http://localhost:4141/usage

# Token 信息
curl http://localhost:4141/token

# Token 池状态
curl http://localhost:4141/token-pool
```

### 调试问题

```bash
# 显示调试信息
aiapi debug

# JSON 格式输出
aiapi debug --json

# 启用详细日志
aiapi start --verbose
```

### 速率限制

避免触发平台的滥用检测：

```bash
# 设置请求间隔 30 秒
aiapi start --rate-limit 30

# 达到限制时等待而非报错
aiapi start --rate-limit 30 --wait

# 手动审批每个请求
aiapi start --manual
```

### 企业/商业账户

GitHub Copilot Business 或 Enterprise 用户：

```bash
# Business 计划
aiapi start --account-type business

# Enterprise 计划
aiapi start --account-type enterprise
```

---

## 免责声明

> **警告**：这是多平台 API 的逆向工程代理。**不受官方支持**，可能随时失效。使用风险自负。

> **安全提示**：过度的自动化或脚本化使用可能触发平台的滥用检测系统，导致访问被暂停。请负责任地使用。

---

## 许可证

MIT License