workbuddy2api

把 WorkBuddy / CodeBuddy 订阅账号，变成一个标准的 OpenAI / Anthropic / Responses 兼容 API。

直连腾讯 WorkBuddy 后端，原生支持 function calling、流式 SSE、思考强度（reasoning effort），内置多账号轮询池、限流冷却与故障转移、会话粘性、按区分发，并附带一个完整的中文 Web 管理面板。

Warning

仅供个人学习与技术研究，禁止任何商业用途。

本项目未获腾讯或任何权利方授权，与其无任何隶属或合作关系。使用它可能违反 WorkBuddy / CodeBuddy 的服务条款，并可能导致账号被封禁、订阅费用损失。

请仅使用你自己合法拥有的账号，风险自负。完整条款见免责声明。

特性

协议兼容

POST /v1/chat/completions —— OpenAI Chat Completions（含原生 tools / tool_calls）
POST /v1/messages —— Anthropic Messages（Claude Code 等客户端可直接用）
POST /v1/messages/count_tokens —— Anthropic token 计数
POST /v1/responses —— OpenAI Responses API
GET /v1/models —— 模型列表

多账号与稳定性

扫描 auth 目录下所有 *.info，自动组成轮询池
账号被上游 429 / 超额时自动进入冷却，到期自动恢复；冷却期间请求自动故障转移到其他账号
会话粘性：同一会话固定在同一账号上，命中上游 prompt cache，避免来回切号导致 token 爆炸
按区分发：国区（copilot.tencent.com）与国际区（*.codebuddy.ai）账号自动分流，受限模型只落在支持它的区上
access token 过期自动续期并回写 auth 文件

Web 管理面板（中文）

导入 / 删除 / 启停账号，查看每个账号的 token 到期与可用性
一键探测各模型可用性、查看用量与请求日志
设置 / 热更新 API Key（写入文件，无需重启）
每日自动签到

架构与端口

两个进程，由 supervisord（Docker）或 start.sh（本地）一起拉起。 对外只暴露一个端口：3008。

进程	作用	监听	是否对外
`panel.py`	Web 面板 + API 入口	3008	✅ 唯一对外端口
`converter.py`	API 后端（被面板反代）	127.0.0.1:3009	❌ 仅容器内网

                    ┌────────────────────────────────────────┐
   浏览器  ───────▶ │  panel.py                      :3008   │
   http://host:3008 │  ├─ /          管理面板                │
                    │  └─ /v1/*  ─┐  反代                   │
                    └─────────────┼──────────────────────────┘
                                  │ 127.0.0.1:3009
   客户端  ───────▶  （同一个地址）▼
   http://host:3008/v1        ┌──────────────────────────┐
                              │  converter.py   :3009    │ ──▶ copilot.tencent.com
                              │  多账号池 / 粘性 / 冷却   │
                              └──────────────────────────┘

面板和 API 用同一个地址、同一个端口：

用途	地址
管理面板	`http://<host>:3008`
API Base URL	`http://<host>:3008/v1`

3008 上没有任何写死的 IP 或端口，PANEL_PORT 可改。 API 进程只监听回环，不会单独暴露到宿主机。

Docker 部署

前置要求

项目	要求
Docker Engine	20.10+
Docker Compose	v2（用 `docker compose`，不是 `docker-compose`）
架构	amd64 / arm64 均可（基础镜像 `python:3.12-slim` 是多架构的）
磁盘	镜像约 250 MB，另加账号数据

一键部署

# 克隆仓库（把 <owner> 换成仓库所属账号）
git clone https://github.com/<owner>/workbuddy2api.git
cd workbuddy2api

cp .env.example .env
# 可选：按需修改端口 / 时区，不改也能直接跑

docker compose up -d --build

首次构建约 1–2 分钟（只装 4 个 Python 依赖，无需编译原生扩展）。

验证部署

# 1) 容器状态：应为 running / healthy
docker compose ps

# 2) 健康检查
curl -s http://127.0.0.1:3008/health

# 3) 浏览器打开管理面板
#    http://<你的主机IP>:3008

健康检查返回 {"status":"ok",...} 就说明两个进程都起来了。

容器内部结构

一个容器里跑两个进程（由 supervisord 管理）：

进程	监听	是否对外
`panel.py`	`0.0.0.0:3008`	✅ 唯一对外端口
`converter.py`	`127.0.0.1:3009`	❌ 仅容器内网

对外只需要 3008：面板页面和 /v1 API 都走它。 converter 不发布到宿主机，从外部无法直连。

数据持久化

账号与配置存在宿主机的 ./data/auth（挂载到容器 /data/auth）：

./data/auth/
├── *.info                  # 账号凭据（导入后生成）
├── .api_key                # API Key（面板里设置）
├── .request_log.jsonl      # 请求日志
├── .token_stats.jsonl      # Token 统计
├── models.json             # 模型列表
└── model_regions.json      # 模型分区

这个目录不要提交到 Git。仓库的 .gitignore 已默认忽略它。

常用命令

操作	命令
启动	`docker compose up -d`
重新构建并启动	`docker compose up -d --build`
查看状态	`docker compose ps`
实时日志	`docker compose logs -f`
最近 200 行日志	`docker compose logs --tail=200`
重启	`docker compose restart`
停止（保留数据）	`docker compose down`
停止并删除数据 ⚠️	`docker compose down -v`
进入容器排查	`docker compose exec workbuddy2api bash`

down -v 会删除数据卷，账号和 API Key 都会丢失，执行前请确认。

修改端口

编辑 .env：

PANEL_PORT=8080

然后重建：

docker compose up -d

访问地址相应变成 http://<主机>:8080。

更新到新版本

cd workbuddy2api
git pull
docker compose up -d --build

数据卷不受影响，账号和配置都会保留。

导入账号

两种方式：

方式一：面板导入（推荐）

打开 http://<主机>:3008 → 账号 → 导入，粘贴凭据 JSON。

方式二：直接放文件

cp 你的凭据.info ./data/auth/
docker compose restart

反向代理与 HTTPS

生产环境建议在前面加一层 Nginx 并启用 HTTPS：

server {
    listen 443 ssl;
    server_name api.example.com;

    ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3008;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;

        # ⚠️ SSE 流式必须关闭缓冲，否则回复会攒到最后一次性吐出
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 600s;
    }
}

启用后建议在 .env 里设置 PUBLIC_API_BASE=https://api.example.com，这样面板里展示给客户端的 Base URL 才是外部域名。

面板的管理接口没有鉴权，请务必配合 Basic Auth / VPN / IP 白名单，不要直接把 3008 裸奔在公网。

国内构建加速（可选）

如果拉取 PyPI 很慢，可以在 Dockerfile 里给 pip 换源：

RUN pip install --no-cache-dir -r requirements.txt \
    -i https://pypi.tuna.tsinghua.edu.cn/simple

Docker 镜像本身如果拉不动，给 daemon 配 registry-mirrors。

卸载

docker compose down -v          # 停止并删除数据卷
docker rmi workbuddy2api:latest # 删除镜像

排查

现象	原因 / 处理
`docker compose ps` 显示 `unhealthy`	看 `docker compose logs`；多为端口占用或依赖未装好
面板能开，`/v1` 返回 502	`converter` 进程没起来，检查日志里有无 Python 报错
宿主机连不上 3008	确认 `.env` 的 `PANEL_PORT` 与访问端口一致；确认防火墙放行
构建时 pip 超时	见上面「国内构建加速」
账号导入后不生效	确认文件在 `./data/auth/` 且以 `.info` 结尾，然后 `docker compose restart`

本地运行（不用 Docker）

需要 Python 3.10+。

pip install -r requirements.txt
bash start.sh

或者手动分两个终端：

# 终端 1 —— API 后端（只监听回环）
cd app
CODEBUDDY_AUTH_DIR=../data/auth API_PORT=3009 \
  python3 converter.py --host 127.0.0.1 --skip-check --desensitize \
  --api-key-file ../data/auth/.api_key

# 终端 2 —— 面板 + 对外入口
export CODEBUDDY_AUTH_DIR="$PWD/../data/auth"
export CONVERTER_BASE="http://127.0.0.1:3009"
export PANEL_PORT=3008
python3 panel.py

然后访问 http://localhost:3008。

在 Windows / macOS 上，如果不指定 CODEBUDDY_AUTH_DIR， converter 会自动去 WorkBuddy / CodeBuddy 桌面端的默认凭据目录找已登录的账号。

配置

所有配置都走环境变量（Docker 下写在 .env）。

端口

变量	默认	说明
`PANEL_PORT`	`3008`	唯一对外端口：面板 + `/v1` API
`API_PORT`	`3009`	内网 API 端口，仅容器内使用，不对宿主机发布
`CONVERTER_BASE`	`http://127.0.0.1:3009`	面板反代的目标地址
`PUBLIC_API_BASE`	空	面板展示给客户端的 API 地址。留空 = 同源（默认）。只有走独立域名时才设置
`TZ`	`Asia/Shanghai`	容器时区

账号与凭据

变量	默认	说明
`CODEBUDDY_AUTH_DIR`	`/data/auth`	凭据目录，存放 `*.info` 账号文件与 `.api_key`
`CODEBUDDY_MODELS_FILE`	`$AUTH_DIR/models.json`	模型列表文件（示例见 `config/models.example.json`）
`CODEBUDDY_MODEL_REGIONS_FILE`	`$AUTH_DIR/model_regions.json`	模型分区配置（示例见 `config/model_regions.example.json`）

稳定性调优

变量	默认	说明
`CODEBUDDY_RATE_COOLDOWN`	`30`	账号被限流后跳过多少秒
`CODEBUDDY_FAILOVER_COOLDOWN`	`60`	故障转移冷却秒数
`CODEBUDDY_SESSION_TTL`	`1800`	会话粘性 TTL（秒），30 分钟无活动解绑
`CODEBUDDY_SESSION_MAX`	`2000`	粘性会话表上限
`CODEBUDDY_RATE_RETRY`	`3`	限流后重试次数
`CODEBUDDY_REASONING_EFFORT`	空	全局思考强度：`low` / `medium` / `high` / `max`。留空则用请求里的值

鉴权

变量	说明
`CODEBUDDY2OPENAI_KEY`	客户端 Bearer Key。推荐改用面板写入 `$AUTH_DIR/.api_key`，可热更新无需重启
`CODEBUDDY2OPENAI_KEY_FILE`	Key 文件路径（默认 `$AUTH_DIR/.api_key`）。文件不存在或为空 = 不校验

优先级：--api-key > --api-key-file > 不校验。生产环境务必设置 Key，否则任何能访问到 3008 的人都能白嫖你的账号。

使用

1. 导入账号

打开面板 http://localhost:3008 → 账号 → 导入，粘贴 WorkBuddy / CodeBuddy 桌面端导出的凭据 JSON。

可以一次导入多条（JSON 数组），也可以批量指定代理。

凭据格式兼容导出的 [{access_token, refresh_token, uid, ...}]。

2. 设置 API Key

面板 → API 密钥 → 新建 Key。生成后只显示一次，请立刻保存。

Key 写入 $AUTH_DIR/.api_key，converter 热读取，无需重启。

3. 调用

面板的「总览 → 接口接入」页会直接给出可复制的 curl 命令和当前 Base URL。

OpenAI 格式

curl http://localhost:3008/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WB2API_KEY" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

Anthropic 格式（Claude Code 等）

curl http://localhost:3008/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $WB2API_KEY" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI 客户端 / SDK

from openai import OpenAI

client = OpenAI(base_url="http://localhost:3008/v1", api_key="<你的 key>")
print(client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "你好"}],
).choices[0].message.content)

查看可用模型

curl http://localhost:3008/v1/models -H "Authorization: Bearer $WB2API_KEY"

API 端点

API（经面板 3008 反代）

方法	路径	说明
GET	`/health`	健康检查 + 账号池状态
GET	`/v1/models`	模型列表
POST	`/v1/chat/completions`	OpenAI Chat Completions
POST	`/v1/messages`	Anthropic Messages
POST	`/v1/messages/count_tokens`	Anthropic token 计数
POST	`/v1/responses`	OpenAI Responses API

面板管理接口（3008）

方法	路径	说明
GET	`/`	管理面板页面
GET	`/api/status`	运行状态
GET	`/api/accounts`	账号列表
POST	`/api/accounts/import`	导入账号
POST	`/api/accounts/{file}/toggle`	启用 / 停用账号
DELETE	`/api/accounts/{file}`	删除账号
GET/POST	`/api/key`	读取 / 设置 API Key
GET	`/api/models`	模型列表
POST	`/api/models/probe`	探测模型可用性
GET	`/api/usage`	用量统计
GET	`/api/logs`	请求日志
GET	`/api/token-stats`	Token 统计

面板管理接口没有鉴权，请勿直接暴露到公网。要远程访问请套一层反向代理 + Basic Auth / VPN。

目录结构

workbuddy2api/
├── app/
│   ├── converter.py            # API 后端：多账号池、协议转换、转发
│   ├── panel.py                # Web 面板 + /v1 反向代理（对外入口）
│   ├── anthropic_adapter.py    # Anthropic Messages <-> Chat 转换
│   ├── responses_adapter.py    # OpenAI Responses <-> Chat 转换
│   ├── responses_projection.py # Responses 投影
│   ├── desensitize.py          # 内容脱敏（缓解上游审核误拦）
│   └── daily_checkin.py        # 每日自动签到
├── ui/
│   └── index.html              # 面板前端
├── tools/                      # 诊断 / 探测脚本（非运行必需）
├── config/                     # 示例配置
├── scripts/crontab.example     # 定时签到示例
├── Dockerfile
├── docker-compose.yml
├── supervisord.conf            # 同时拉起 API + 面板
├── start.sh                    # 本地（非 Docker）启动
├── requirements.txt
├── .env.example
├── SECURITY.md                 # 隐私说明 + 部署安全建议
└── LICENSE

常见问题

Q：为什么 API 也是 3008？

面板进程同时承担反向代理：/v1/* 会被转发到内网 3009 上的 API 后端。这样你只需要记住一个地址，也少暴露一个端口。API 后端本身只监听回环，外部访问不到。

Q：面板能打开，但 API 调用返回 401 / 没有账号？

先确认 auth 目录里已经导入了 *.info 账号。面板「账号」页应能看到账号并显示健康状态。再确认 converter 进程用的是同一个 CODEBUDDY_AUTH_DIR。

Q：返回「所有账号都在冷却中」怎么办？

说明当前所有账号都被上游限流了。等冷却结束（面板会显示解除时刻），或再导入一个账号。可以调大 CODEBUDDY_RATE_COOLDOWN 减少无效重试。

Q：某个模型报「无可用账号 / 503」？

该模型被 model_regions.json 限制在特定区（如 kimi-k3 只在国区），而你当前没有该区的可用账号。加一个对应区的账号，或调整 model_regions.json。

Q：Claude Code 连不上？

Claude Code 走 Anthropic 协议，把 Base URL 指向 http://<host>:3008，模型名用 /v1/models 里列出的名称。注意 Claude Code 会带很大的 system prompt，如果遇到上游审核拦截，保持 --desensitize 开启。

Q：想在前面再套一层 Nginx？

location / {
    proxy_pass http://127.0.0.1:3008;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    # SSE 流式必须关闭缓冲
    proxy_buffering off;
    proxy_read_timeout 600s;
}

这时可以设置 PUBLIC_API_BASE=https://你的域名，面板里展示的 Base URL 才会是外部域名。

Q：端口 3008 被占用了？

改 .env 里的 PANEL_PORT，docker compose up -d 即可。代码里没有写死的端口。

Q：容器起来了但状态是 unhealthy？

先看 docker compose logs --tail=100。常见原因是：宿主机 3008 已被占用、./data/auth 权限不对（容器内以非 root 写不进去）、或首次启动时依赖还没装完（等 30 秒再 docker compose ps）。

Q：能不能只跑一个进程、不要 supervisord？

可以，但没必要。面板和 API 是两个独立进程，supervisord 负责拉起并在崩溃时自动重启。如果你想拆成两个容器，让 API 容器暴露 3009、面板容器把 CONVERTER_BASE 指向 API 容器的地址即可，代码本身不依赖同容器部署。

免责声明

请在下载、安装或使用本项目之前，完整阅读本节。 继续使用即表示你已阅读、理解并同意以下全部条款。如果你不同意其中任何一条，请立即停止使用并删除本项目。

1. 项目性质

本项目是一个技术研究与学习性质的工具，用于演示协议转换、多账号调度与反向代理等通用工程实践。它通过逆向分析的方式与第三方服务（腾讯 WorkBuddy / CodeBuddy）的后端接口进行交互。本项目不是上述服务的官方客户端，与腾讯及其关联公司没有任何隶属、合作、赞助或背书关系。

2. 无授权声明

本项目未获得腾讯公司或任何相关权利方的授权、许可或认可。所有涉及的商标、服务名称、接口与后端服务，其知识产权均归各自权利人所有。本项目仅包含独立编写的源代码，不包含任何来自上述服务的专有代码、二进制文件或商业秘密。

3. 使用者的责任与义务

使用者必须自行确保其使用行为合法合规，包括但不限于：

遵守 CodeBuddy / 腾讯云的服务条款、用户协议及可接受使用政策；
遵守你所在国家或地区的法律法规；
仅使用你自己合法拥有或已获授权的账号，不得使用他人账号；
不得将本工具用于商业转售、账号出租、代充、薅羊毛、批量注册或任何形式的滥用；
不得利用本工具规避付费、攻击服务、干扰服务正常运行或从事其他不正当行为。

4. 风险自担

使用本项目可能违反第三方服务的服务条款，并可能导致：

账号被限流、封禁或永久停用；
已支付的订阅费用损失；
账号内数据丢失；
其他你未预见的后果。

上述全部风险由使用者自行承担。 项目作者与贡献者不对任何直接或间接损失负责。

5. 免责条款

本项目按**「现状」（AS IS）**提供，不附带任何形式的明示或默示担保，包括但不限于对适销性、特定用途适用性及不侵权的担保。在任何情况下，作者与贡献者均不对因使用或无法使用本项目而产生的任何索赔、损害或其他责任负责，无论其源于合同、侵权还是其他方式。

6. 停止使用

如果你收到权利人的通知，或意识到自己的使用行为可能构成侵权或违约，请立即停止使用并删除本项目。

隐私说明

本仓库不包含任何个人信息或真实凭据，包括但不限于：

账号、手机号、邮箱、用户名等个人标识；
access token / refresh token / API Key / 各类密钥；
内网 IP、主机名、NAS 路径等部署环境信息；
请求日志、签到记录、用量统计等运行数据。

所有敏感配置均通过环境变量注入，仓库内只提供 config/*.example.json 形式的占位示例。若你发现仓库中仍残留任何隐私信息，请提交 issue，我们会尽快移除。

License

MIT

Name		Name	Last commit message	Last commit date
app		app
config		config
scripts		scripts
tools		tools
ui		ui
.dockerignore		.dockerignore
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
docker-compose.yml		docker-compose.yml
requirements.txt		requirements.txt
start.sh		start.sh
supervisord.conf		supervisord.conf

Latest commit

History

Folders and files

Repository files navigation