将 arena.ai 的 300+ 模型通过 OpenAI 兼容 API 代理出来。
graph LR
Client["OpenAI 客户端<br/>(SDK / curl / 任意工具)"]
Server["Python 代理服务器<br/>localhost:9090"]
Ext["Chrome 扩展<br/>(arena.ai 页面内)"]
Arena["arena.ai API"]
Client -- "OpenAI 格式请求<br/>POST /v1/chat/completions" --> Server
Ext -- "定时推送 token / cookies / models<br/>POST /v1/extension/push" --> Server
Server -- "arena.ai 格式请求<br/>携带真实 token + cookies" --> Arena
Arena -- "SSE 流式响应<br/>(a0: / ag: / ad: 前缀)" --> Server
Server -- "OpenAI SSE 格式<br/>data: {choices: [...]}" --> Client
Chrome 扩展由三层脚本组成，通过消息桥接实现跨 world 通信：
sequenceDiagram
participant I as injector.js<br/>(MAIN World)
participant C as content.js<br/>(ISOLATED World)
participant B as background.js<br/>(Service Worker)
participant S as Python Server
Note over I: 页面加载完成
I->>I: 提取 models (Next.js 数据)
I->>I: 提取 cookies (document.cookie)
I->>C: window.postMessage({type: INIT})
C->>B: chrome.runtime.sendMessage({type: PAGE_INIT})
B->>B: 合并 cookies + 存储 models
B->>S: POST /v1/extension/push
Note over B: 每 80s 请求新 token
B->>C: sendMessage({type: NEED_TOKEN})
C->>I: window.postMessage({type: GET_TOKEN})
I->>I: grecaptcha.enterprise.execute(SITEKEY)
I->>C: window.postMessage({type: TOKEN_OK, token})
C->>B: sendMessage({type: NEW_TOKEN, token})
B->>S: POST /v1/extension/push
当客户端发起 /v1/chat/completions 请求时：
flowchart TD
A["客户端请求<br/>POST /v1/chat/completions"] --> B{扩展是否连接?}
B -- "否 (last_push > 120s)" --> B1["返回 503"]
B -- 是 --> C{模型是否存在?}
C -- 否 --> C1["模糊匹配模型名"]
C1 -- 仍未找到 --> C2["返回 404 + 可用模型列表"]
C1 -- 找到 --> D
C -- 是 --> D["构建 arena.ai 请求体"]
D --> E["生成 UUIDv7 (eval_id)"]
E --> F["拼接多轮对话历史"]
F --> G["从 token 池弹出 reCAPTCHA V3 token"]
G --> H["组装 headers<br/>(cookies + auth + UA)"]
H --> I["POST arena.ai/nextjs-api/stream/create-evaluation"]
I --> J{stream 参数?}
J -- true --> K["逐行解析 SSE → 转换为 OpenAI chunk 格式"]
J -- false --> L["累积全部内容 → 返回完整 OpenAI 响应"]
| 技术点 | 说明 |
|---|---|
| reCAPTCHA V3 绕过 | 扩展在真实浏览器环境中调用 grecaptcha.enterprise.execute()，获得高评分 token（有效期 ~2 分钟） |
| 双 World 注入 | injector.js 运行在 MAIN world 可访问页面全局变量（grecaptcha、Next.js 数据）；content.js 运行在 ISOLATED world 可访问 Chrome API |
| Cookie 分片处理 | arena.ai 的 auth cookie 可能被分片存储为 arena-auth-prod-v1.0 + arena-auth-prod-v1.1，服务器自动拼接 |
| Token 池管理 | 维护最多 10 个 V3 token 的滚动池，每 80 秒自动补充，过期 token (>120s) 自动清理 |
| SSE 协议转换 | arena.ai 使用自定义前缀（a0: 文本、ag: 推理、ad: 完成、a2: 心跳/图片、a3: 错误），服务器转换为标准 OpenAI SSE 格式 |
| 模型自动发现 | 从 Next.js 的 __NEXT_DATA__ 或 __next_f 中提取 initialModels，自动分类 text / image / vision 模型 |
- Python 3.8+
- Chrome 或 Firefox 浏览器
- 一个 arena.ai 账号（免费注册）
pip install -r requirements.txt
python server.py服务器默认监听 http://localhost:9090，启动后会等待扩展连接。
- 打开 Chrome，地址栏输入
chrome://extensions/ - 开启右上角的 开发者模式
- 点击 加载已解压的扩展程序
- 选择项目中的
extension/目录
- 打开 Firefox，地址栏输入
about:debugging#/runtime/this-firefox - 点击 临时载入附加组件
- 选择项目中的
extension-firefox/manifest.json文件
- 点击扩展图标，点击 Open Arena.ai 按钮（或手动打开
https://arena.ai/?mode=direct） - 等待页面完全加载（约 3-5 秒）
- 再次点击扩展图标，确认以下状态均为绿色：
- Server → Connected
- Arena Tab → Active
- Auth Cookie → Yes
- Models → 数量 > 0
# 查看所有可用模型
curl http://localhost:9090/v1/models
# 非流式聊天
curl http://localhost:9090/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "GPT-4o",
"messages": [{"role": "user", "content": "Hello!"}]
}'
# 流式聊天
curl http://localhost:9090/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "Claude 3.5 Sonnet",
"messages": [{"role": "user", "content": "Hello!"}],
"stream": true
}'from openai import OpenAI
client = OpenAI(
base_url="http://localhost:9090/v1",
api_key="not-needed", # 无需 API Key
)
# 流式输出
response = client.chat.completions.create(
model="GPT-4o",
messages=[{"role": "user", "content": "Hello!"}],
stream=True,
)
for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")本服务兼容以下客户端和API网关：
- OpenAI SDK - 标准 OpenAI 格式
- Claude Code - Anthropic Claude 客户端
- Gemini API - Google Gemini 客户端
- Codex - OpenAI Codex 客户端
- OpenCode - 开源代码助手
- NewAPI - OpenAI API 网关
- OneAPI - 统一 API 网关
服务器会自动检测客户端类型（通过 User-Agent）并适配相应的响应格式。
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/models |
GET | 列出所有可用模型（OpenAI 格式） |
/v1/chat/completions |
POST | 聊天补全，支持 stream: true/false |
/v1/extension/push |
POST | 扩展推送 token/cookies/models（内部使用） |
/v1/extension/status |
GET | 查看扩展连接状态和 token 池信息 |
/health |
GET | 健康检查 |
| 环境变量 | 默认值 | 说明 |
|---|---|---|
PORT |
9090 |
服务器监听端口 |
DEBUG |
- | 设置任意值开启调试日志 |
点击扩展图标，在弹窗中可修改 Server URL（默认 http://127.0.0.1:9090）。
| 特性 | Chrome 扩展 | Firefox 扩展 |
|---|---|---|
| Manifest 版本 | V3 (Service Worker) | V2 (Background Script) |
| API 命名空间 | chrome.* |
browser.* (兼容 chrome.*) |
| 目录 | extension/ |
extension-firefox/ |
arena2api/
├── server.py # FastAPI 代理服务器（OpenAI 格式转换 + arena.ai 调用）
├── requirements.txt # Python 依赖（fastapi, uvicorn, httpx）
├── extension/ # Chrome 扩展 (Manifest V3)
│ ├── manifest.json # 扩展清单（权限、脚本注入配置）
│ ├── background.js # Service Worker — token 池管理、cookie 刷新、定时推送
│ ├── content.js # Content Script (ISOLATED) — injector ↔ background 消息桥
│ ├── injector.js # Page Script (MAIN) — reCAPTCHA 调用、模型提取、cookie 读取
│ ├── popup.html/js # 扩展弹窗 UI（状态监控、手动操作）
│ └── icons/ # 扩展图标
├── extension-firefox/ # Firefox 扩展 (Manifest V2)
│ ├── manifest.json # Firefox 扩展清单
│ ├── background.js # Background Script — 兼容 Firefox API
│ ├── content.js # Content Script — 兼容 Firefox API
│ ├── injector.js # Page Script（与 Chrome 版本相同）
│ ├── popup.html/js # 扩展弹窗 UI
│ └── icons/ # 扩展图标
└── README.md
确认 Python 服务器已启动且端口正确。扩展每 30 秒自动推送一次，也可点击 Push 按钮手动触发。
确保 arena.ai 页面已完全加载。模型列表从页面的 Next.js 数据中提取，如果页面未加载完成则无法获取。尝试刷新 arena.ai 页面。
扩展超过 120 秒未推送数据，服务器判定连接断开。检查 arena.ai 标签页是否仍然打开，或重新打开页面。
reCAPTCHA token 有效期约 2 分钟，扩展每 80 秒自动补充。如果短时间内大量请求耗尽 token 池，稍等片刻即可恢复。
- 需要保持 arena.ai 标签页打开 — 扩展依赖页面环境获取 reCAPTCHA token
- Token 有效期约 2 分钟 — 扩展自动刷新，高频请求时可能需要等待补充
- 免费使用 — arena.ai 本身免费，本工具仅做协议格式转换
- 模型名称 — 使用 arena.ai 原始名称（如
GPT-4o、Claude 3.5 Sonnet），通过/v1/models查看完整列表 - 仅限本地使用 — 服务器默认监听
0.0.0.0，生产环境请注意网络安全