linguo2625469/workbuddy2api-panel · 上手攻略

仓库：linguo2625469/workbuddy2api-panel
链接：https://github.com/linguo2625469/workbuddy2api-panel
分类：AI 网关 / 账号聚合
作者：Tom
更新：2026-09-15

是什么

workbuddy2api-panel 是 Sliverkiss/workbuddy2api（腾讯 CodeBuddy 反向代理网关）的增强分支，在上游基础上新增了 Web 管理面板、浏览器内 OAuth 添加账号、在线配置热编辑、完整的积分任务体系（17/18 任务一键完成）等能力，同时同步了上游全部功能更新。

本质上，它是一个自托管的 OpenAI 兼容反向代理网关：将腾讯 CodeBuddy（copilot.tencent.com）账号包装为统一的 /v1/chat/completions 接口，客户端无需任何改造即可接入。

解决什么问题

腾讯 CodeBuddy 官方不提供 OpenAI 形态的开放 API，且账号有积分限额、冷却机制。想用多个 CodeBuddy 账号做高可用或大并发调用，原生方案无法实现。

本项目解决的是：

多账号管理与自动容灾：多账号池 → 单号故障自动换号 → 熔断/冷却防止雪崩
会话粘性：同一 conversation_id 尽量绑定同一账号，避免多轮上下文跳号
积分任务自动化：官方「成长计划」18 个任务中 17 个可一键完成，零人工干预
运维可视化：Web 面板替代命令行，看得见账号池状态、积分、冷却倒计时

快速安装

⚠️ 需要腾讯 CodeBuddy 真实授权账号，仅限本人、本机/私有环境测试。

# 1. 克隆仓库
git clone https://github.com/linguo2625469/workbuddy2api-panel.git
cd workbuddy2api-panel

# 2. 一键生成推荐配置（含随机 API 密钥）
# 目录下无 config.json 时，首次启动自动生成

# 3. Docker 部署（推荐）
docker run -d \
  --name workbuddy-panel \
  -p 7863:7863 \
  -v $(pwd)/config.json:/app/config.json \
  -v $(pwd)/auths:/app/auths \
  workbuddy2api-panel

# 4. 添加账号（OAuth 浏览器登录）
# 方式 A：面板「添加账号」按钮（浏览器内完成，免命令行）
# 方式 B：./login.sh（命令行设备授权流程）

首次运行后访问 http://localhost:7863 打开 Web 面板。

核心用法

基本调用（OpenAI 兼容）

curl http://localhost:7863/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3.5-sonnet",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

任何 OpenAI SDK / 前端零改造接入，只需将 baseURL 指向本网关。

会话粘性

# 带上 conversation_id，同一会话尽量绑定同一账号
curl ... -d '{
  "model": "claude-3.5-sonnet",
  "messages": [...],
  "extra_body": {
    "conversation_id": "your-session-uuid"
  }
}'

一键完成成长任务

面板「任务中心」→ 选择账号 → 点「一键完成」。支持： - 解锁领养、画布创建、对话活跃、模板使用、专家召唤等 17 个任务 - 行为事件幂等上报，已达标任务自动跳过 - 执行后自动轮询任务进度，达标即调用领奖接口

查看账号池状态

# Web 面板明暗主题，账号健康色条 / 积分量条 / 冷却倒计时
# 或 API
curl http://localhost:7863/status

模型能力查询

# 查询可用模型及档位
curl http://localhost:7863/v1/models

流式调用

curl http://localhost:7863/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -d '{"model": "claude-3.5-sonnet", "messages": [...], "stream": true}'

配置热生效（面板编辑）

面板「配置编辑」→ 修改 config.json → 保存立即生效（非装配期字段）。写入采用深合并 + 原子替换，保留未知键。

典型适用场景

场景	说明
多账号高可用	单号被限流/封禁自动切换，99.9% 可用率目标
大并发应用	账号池 + 在途租约限流，不超额占用单账号
AI 应用开发	不想申请官方 API，用 CodeBuddy 账号做生产级 LLM 调用
积分自动化	定时签到、旅行、活跃上报、保活，零人工干预
研究/测试	隔离环境批量实验，多模型多账号对照

坑与注意

⚠️ 合规红线：本项目是非官方网关，使用 CodeBuddy 账号作为上游。仅限本人授权账号、本机/私有环境测试。腾讯官方随时可能更改接口或封号，生产级使用需自行评估风险。

⚠️ ** Expert_Philanthropy 任务无法自动化**：该任务需真实捐款（服务端领奖时校验捐赠回执），面板只展示操作指引，无法绕过。

⚠️ JSON_SCHEMA 模式限制：若开启 response_format.json_schema，上游严格模式要求 Zod schema 必须 strict-safe（无 .optional() 键），否则网关本地 prepareRequest 阶段即失败。

⚠️ 模型级限流：6004 错误（该模型使用量超限）只冷却触发该模型的账号/模型组合，换其他模型请求不受影响。

⚠️ 学生认证任务：开学季活动中的学生认证需微信真实认证，不做自动化。

⚠️ 账号凭证安全：auths 目录权限 0600，泄露等于账号密码泄露。

⚠️ DeepSeek 思维链兼容：已内置 thinking.type=enabled 注入，但部分 flash 变体拒绝 tool_choice，建议用 MD_JSON 模式替代。

⚠️ baseURL 填写规范：兼容 OpenAI 格式网关时，baseURL 填到 /v1 根即可（不要填完整 chat/completions 路径，SDK 会自己追加）。

与同类对比

特性	本项目（panel 分支）	上游 workbuddy2api
Web 管理面板	✅ 内嵌 SPA，明暗主题	❌ 纯命令行
OAuth 浏览器添加账号	✅ 面板一键完成	❌ 需跑 login.sh
在线配置热编辑	✅ 面板直接改，热生效	❌ 改文件+重启
积分任务一键完成	✅ 17/18 任务覆盖	❌ 无
开学季活动支持	✅ 独立状态卡+5任务	❌ 无
粘性会话内容回退	✅ d-前缀哈希派生键	❌ 依赖客户端传 conversation_id
余额后台刷新	✅ schedule.balance_refresh_minutes	❌ 手动
账号池三因子加权	✅ 积分+闲置+成功率	✅ 同
熔断/冷却体系	✅ 6024/402/429 分级	✅ 同
定时任务（签到/旅行/活跃/保活）	✅ 四类独立开关	✅ 同

与腾讯云 API 网关、腾讯云 AI 代码助手等非同类，本项目专治腾讯系 AI 产品的账号层封装。

一句话推荐结论

腾讯 CodeBuddy 多账号党必备网关：Panel 分支在原版账号池调度之上叠加了完整的 Web 可视化运维 + 17 个成长任务一键自动化，是目前同类方案里上手最友好、功能最完整的解法——代价是需要一定技术基础部署，且始终顶着腾讯官方政策风险，适合个人/私有环境内自用。