niyouqianma/workbuddy2api-hub
AI 工程把 WorkBuddy 与 CodeArts 账号封装成本地 OpenAI 兼容网关,支持聊天、生图与生视频接口。
项目介绍
WorkBuddy2API-Hub 是一个本地部署的网关,把 WorkBuddy(国际版/国内版)和华为云 CodeArts 账号包装成 OpenAI 风格的接口:/v1/chat/completions、/v1/responses、/v1/models,另有生图和异步生视频端点。适合已有这些账号、想用 Codex、Claude Code、NextChat 等 OpenAI 兼容客户端调用的人。
相比单纯的反向代理,它主要多了一层控制面:Web 看板支持浏览器 OAuth 导入账号、按账号绑定出口代理、多 API Key 按模型与账号白名单分发、用量与 Token 统计、故障转移和配额轮转,还内置签到与成长任务自动化。出站可选 Go/uTLS 桥,由 WB_TLS_FINGERPRINT 控制,默认 auto,桥不可用时回退 Python/OpenSSL。
快速使用
需要 Python 3.9+,或在 Docker 中运行。脚本方式必须在 wb_proxy.py 所在目录执行:
cd /path/to/workbuddy2api-hub
python3 -m wb_proxy --port 8788
README 说明用 -m 而非直接运行脚本可降低常驻内存,前提是当前目录为项目根目录。Windows 可双击 start-wb-proxy.bat 后台启动,macOS/Linux 用 ./start-wb-proxy.sh [端口]。
启动后打开 http://127.0.0.1:8788/(默认密码 admin,首次登录请在设置中修改),点击「添加账号 (OAuth)」完成授权,在设置里新建 API Key,再把客户端指向 http://127.0.0.1:8788/v1 并使用该 Key。可先请求 /v1/models 确认当前出口实际可用的模型 ID。
Docker 用户可直接拉取 GHCR 镜像或使用 README 中的 compose 配置,示例将 ./accounts 和 ./usage 持久化。
使用约束
- 项目依赖第三方服务的非官方客户端行为。README 说明上游自 2026-10-23 下午起明显收紧识别与拦截,账号可能被限流或封禁,维护者也不能保证及时更新。
- 凭证由网关在本地读取,保存在
accounts/目录。README 要求不要把网关暴露到公网,若曾暴露应立即吊销 OAuth / 设备授权;看板默认密码admin必须修改。 - Anthropic Messages 适配为实验性功能,默认关闭(
WB_ENABLE_ANTHROPIC_MESSAGES=0),长会话缓存命中情况与原生接口不同。 - CodeArts 的模型 ID 按上游目录精确匹配;聊天模型别名由
model_aliases_enabled控制,默认关闭。 - 许可证为 MIT。上游服务仍受其自身条款约束,README 声明仅供协议学习与个人使用。
HotRepo 点评
该项目出现在 HotRepo 2026-11-16 的 Python 新项目榜中,在一个一小时的统计窗口内新增 5 Star、3 Fork,观察时共 105 Star、44 Fork。窗口太短,谈不上持续性,也没有记录到全部语言日榜名次。技术上它确实是一套完整的控制面(看板、Key 权限、代理槽位、请求日志),但可用性绑在一个 README 自己承认正在封禁非官方客户端的第三方服务上。更适合把它看作带明确上游风险的工具项目,而不是稳定的 API 供应方案。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- linguo2625469/workbuddy2api-panel把腾讯 CodeBuddy 账号池封装成 OpenAI 兼容接口的自托管网关,附带 Web 面板和成长任务自动化。
- QuantumNous/new-api把多家模型服务收到一个自托管网关后面,对外提供 OpenAI、Claude 或 Gemini 兼容接口,适合需要共享额度与统一计费的团队。
- yang0/chatgpt2api-dsh在本机运行 ChatGPT 号池并暴露 OpenAI 兼容接口,供 DSH 插件、Cherry Studio 等客户端调用和生图。
- do-whilefor/zcode2api把 ZCode 免费账号接入成 OpenAI、Anthropic 兼容 API 的自托管网关,支持多账号调度与自动领卡。
- nwverse/persona用单一对话入口调度本机 Agent 的自托管中枢,覆盖多端客户端与扩展市场。