开源项目推荐：WorkBuddy Manager 与 CodeBuddy API Proxy——CodeBuddy 生态的运维层与协议层

管理员 2026年10月10日 149 次阅读 1529 字 约 6 分钟

最近在折腾腾讯 CodeBuddy 生态的工具链，发现了两个思路完全不同的开源项目：WorkBuddy Manager 做「运营层」——给账号池网关配一个公网级的 Web 控制台；CodeBuddy API Proxy 做「协议层」——让 Claude Code、Codex CLI 这类客户端原生直连 CodeBuddy。一个管得宽、一个钻得深，写篇对比介绍。

说明：两款均为复用自己账号登录态的非官方代理/管理工具，仅供学习研究与个人自用，与腾讯无关；请勿商用转售，风险自负。

一、WorkBuddy Manager：给账号池网关配一个公网级控制台

仓库：github.com/ithtelab/workbuddy-manager

先理清关系：Sliverkiss 的 workbuddy2api（Go）把 CodeBuddy 账号池包装成 OpenAI 兼容接口，能力完整但只有命令行。WorkBuddy Manager 是它的官方认可的社区前端面板——不改上游一行代码，专门补可视化运维，Next.js 15 + FastAPI 技术栈，在 LINUX DO 社区发布。

它把命令行时代的问题都搬进了面板

原本要做的现在在面板上
服务器跑 login.sh 扫码加号点「添加账号」扫码，自动签到并纳管
curl /status 看哪个号挂了仪表盘实时健康度、冷却、有效期
手动改 config.json 调签到/并发中文可视化设置，开关 + 数字框
所有下游共用一个全局 Key多密钥分发，各自独立配额与白名单
不知道谁用了多少每次调用的模型/Token/延迟/来源 IP 全量留痕

运营级的安全设计（这是它区别于其他面板的核心）

  • 多密钥分发：每把密钥独立设版本、有效期、IP 数上限、IP 白名单与模型白名单、额度——同一个网关可以给不同人/不同工具发不同权限的 Key
  • 入站防护：IP 白/黑名单（CIDR 语法），配合审计日志做公网运营
  • 全量审计：每笔调用记录密钥、IP、模型、状态码、首字延迟、扣费与缓存命中
  • 运维配套：一键更新（带签名校验，v1.0.80 还修了 GitHub API 限流导致更新中断的问题）、PostgreSQL 异地备份、上游代理环境变量透传修复
  • 模型中心：账号可用模型单列一页（上下文/最大输出/思考档位），支持模型别名映射——下游在用的名字映到实际模型，迁移无感
  • 五语种界面（中/繁/英/日/韩），账号分组、积分到期监控、签到/旅行/活跃/保活四类定时任务一应俱全
与上游的分工：账号轮询、并发与熔断仍由上游网关负责，面板不侵入、不改上游一行代码——「上游负责能力，面板负责呈现」，并补上密钥分发、IP 管控、用量统计这些运营环节。

日常使用就三步：纳管账号（微信/QQ 扫码授权，成功后自动每日签到）→ 分发密钥（按需配权限）→ 把下游工具指到 /v1。之后的签到、保活、用量统计全部自动。

二、CodeBuddy API Proxy（hawklithm/workbuddy2api）：轻量三协议代理

仓库：github.com/hawklithm/workbuddy2api

Python（FastAPI + httpx 异步）写的轻量代理，名字和 Sliverkiss 那个 workbuddy2api 相同但完全是另一个项目，定位也不同——不搞账号池调度，专注协议转换与请求质量。

核心能力

  • 三协议入口：OpenAI Chat Completions、Anthropic Messages API、OpenAI Responses——意味着 Claude Code（Anthropic 协议）、Codex CLI（Responses 协议）可以原生直连，不用中间再转一层
  • 智能脱敏（--desensitize）：对 system 消息里的敏感词插入零宽空格（U+200B），打断后端关键词匹配。这是它最实用的功能——Claude Code 的 system prompt 含大量 Anthropic 品牌词、Codex CLI 含安全术语，不脱敏几乎必被「内容违规」误拦
  • 消息压缩：智能压缩历史消息省 token，长上下文场景（Codex CLI）显著
  • 工具调用兼容：自动过滤不合规工具定义、DSML（DeepSeek 标记语言）解析、流式 60 秒总时长保护（防上游异常流无限跑）
  • 国内外双后端：--global 一键切国际版 CodeBuddy（copilot.tencent.com ↔ codebuddy.ai），会话与模型目录隔离
  • 多账号隔离：多登录态并存，方便工作/个人号切换
  • 客户端接入体验：Codex CLI 改一行 base_url、Claude Code 在 CC Switch 里加一个配置即用；健康检查与模型列表接口齐全；支持 1000+ 并发
脱敏什么时候需要开：对接 Claude Code / Codex CLI 这类 agentic 工具时强烈推荐（它们的 system prompt 含品牌词与安全术语，不脱敏几乎必被「内容违规」误拦）；纯代码生成、普通对话不开也没事。工具定义兼容也是自动的——非法工具定义直接过滤，DeepSeek 的 DSML 工具调用标记自动解析还原。

三、怎么选？

两个项目加上生态里另外两个常见方案（多平台聚合的 Agent2API、带成长任务自动化的 WorkBuddy2API Panel），按「管多少家 × 管多深」排一张表：

项目范围一句话定位
Agent2API15+ 平台统一入口，广度聚合，桌面端
CodeBuddy API Proxy仅 CodeBuddy三协议轻量代理，脱敏+压缩，Claude Code/Codex 原生直连
WorkBuddy2API Panel仅 CodeBuddy账号池深度运维 + 17/18 成长任务一键完成
WorkBuddy Manager仅 CodeBuddy（配 Sliverkiss 网关）公网级控制台：多密钥分发 + IP/模型白名单 + 调用审计
选型建议：只想自己用、一台机器 → CodeBuddy API Proxy（uv 一条命令，协议适配最顺滑）；要给别人用/公网运营、需要发 Key 管权限 → WorkBuddy Manager（密钥分发 + IP 白名单 + 审计是刚需）；养号 + 任务自动化 → WorkBuddy2API Panel；不止 CodeBuddy 一家 → Agent2API。Manager 和 Panel 都是面板但不冲突——各自配的上游网关不同。

我的实际用法：服务器上跑 WorkBuddy Manager 管账号池和发密钥，本机用 CodeBuddy API Proxy 直连写码——一个管「谁能用、用多少」，一个管「协议顺、误拦少」，正好互补。

返回首页