README

WorkBuddy2API-Hub — 国际版、国内版多账号网关中枢

 [!IMPORTANT]
 官方群聊：https://t.me/wb2apihub

 凭证安全：本项目是本地部署网关，运行时需要在本地读取用户自行导入的账号凭证，才能调用官方接口；凭证保存在用户自己的 accounts/ 目录。项目不会把凭证上传到本项目的第三方服务器，也没有隐藏的凭证收集或上传逻辑。请立即关闭公网暴露，联系官方吊销全部 OAuth / 设备授权，确认旧 token 返回 401 后再重新授权。

 [!WARNING]
 WorkBuddy 上游正在收紧对非官方客户端的识别与拦截。

 - 封禁：2026-10-23 下午起，非官方客户端的识别与拦截明显收紧。
 - 维护者：近期工作压力增大，无法保证及时更新与响应。
 - 可用性：上游可能随时进一步收紧，导致本项目不可用。
 - 账号风险：使用非官方客户端造成的风控、限流或封禁，由使用者自行承担。

 Upstream enforcement tightened detection and blocking of unofficial clients from the afternoon of 2026-10-23. The maintainer is under increased workload and cannot guarantee timely updates or replies. The upstream may tighten further at any time; rate limits, account restrictions or bans caused by using an unofficial client are the user's responsibility.

本项目仅用于协议学习、研究与个人自用。请优先使用官方客户端，不要使用主账号，不要共享账号，也不要用于商业转售。

This project is for protocol research and personal use only. Prefer the official client, do not use your primary account, and do not resell or share access.


  
  
  
  
  
  


 核心特性

- 标准 API 兼容：将 WorkBuddy（国际版/国内版）与 CodeArts 封装为标准 OpenAI 格式（Chat Completions / Responses），无缝支持 Codex、Claude Code、NextChat 等各类客户端。
- 开箱即用与多端部署：便携版免装环境（Windows 自带精简运行时），支持 Docker、NAS（群晖/飞牛）一键部署及 OpenWrt 路由器固件。
- 多账号池与出口隔离：支持浏览器 OAuth 快速导入、每账号独立出口代理槽绑定、设备指纹隔离、自动故障转移与配额轮转。
- 自动化福利与签到：内置国内版全套成长任务、加油站签到与猫猫旅行，支持国际版每日活跃会话与 CodeArts 自动签到。
- 可视化管理看板：提供 Web 仪表盘，支持实时请求日志、Token/积分透视、多 API Key 权限分发（模型/账号白名单）与额度护栏。
- 一键工作台启动：start-workbuddy-all.bat 先用 --probe-only 检查端口上的实例是否健康，未运行才拉起网关并打开 WorkBuddy 工作台，避免重复启动或误连陌生服务。

 社区 Rust 版本

YTjungle666/workbuddy2api-hub 是社区独立维护的 Rust 重写分支。网关后端与启动器均使用 Rust 实现，提供单文件静态二进制，不依赖 Python 运行时；功能以上游 v2.0.1 为对齐基线。它不是本仓库的官方发布物，问题反馈与版本更新请前往对应仓库。

 ⚡ Vibe Coding 产物：本项目为 100% Vibe Coding 协同产物——人类开发者提出架构与业务意图，AI 助手端到端完成逆向分析、链路调度、WAF 指纹脱敏与界面编写。

 📌 提交代码贡献前：请先查看并严格遵循贡献手册 CONTRIBUTING.md——提交格式、测试门禁与端到端冒烟要求都在那里（AI / 智能体请特别注意其中的硬性规则节）。

---

 💖 赞助商

 想出现在这里？联系 [email protected]




  

Agent Router 是免费公益大模型 API 平台，支持 Claude-opus-5.5、GPT-6 Astra、GPT-6.1 Sol、deepseek-v4-flash 等主流模型，国内直连。注册送 ＄175（每日签到得 ＄25，被邀得 ＄50），支持 GitHub / LinuxDo 登录。




---

 一、快速启动

 1. 本机运行

- Windows：双击 start-wb-proxy.bat（静默后台运行 + 独立日志窗口）；如需前台控制台窗口，双击 start-wb-proxy-visible.bat。
- macOS / Linux：双击 start-wb-proxy.command 或在终端执行 ./start-wb-proxy.sh [端口]（默认 8788，需要 Python 3.9+）。
- 局域网共享模式：运行 start-wb-proxy-lan.bat（Windows）或 ./start-wb-proxy-lan.sh（macOS/Linux），首次启动将自动生成高强度 API Key 并在控制台打印。
- 启动后访问：
  - Web 看板：http://127.0.0.1:8788/（默认访问密码 admin，首次登录请在设置中修改）
  - API 地址：http://127.0.0.1:8788/v1

 2. Docker 部署

预编译多架构镜像发布在 GHCR，无需本地构建：

方式一：一键脚本（推荐）

bash
 官方源（直连 GitHub 环境）：
curl -fsSL https://raw.githubusercontent.com/ardeyouxipianyi/workbuddy2api-hub/main/quick-deploy.sh | bash

 国内网络 / NAS 加速：
curl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/ardeyouxipianyi/workbuddy2api-hub/main/quick-deploy.sh | sudo bash


 公网部署或配合反向代理：在管道前指定 WB_DEPLOY_MODE=public bash，并搭配 Nginx / Caddy / Cloudflare Tunnel 配置 TLS。

方式二：单文件 Docker Compose

yaml
ser

Top issues

Latest release

- 可选 Go/uTLS 传输桥：新增本地 Go/uTLS CONNECT 桥接器，启用后使用 Node/OpenSSL 兼容的 ClientHello（18 个 Cipher、10 个 Extension、无 ALPN），Python 继续负责 HTTP 构造、keep-alive 复用与 SSE 读取。默认仍为 Python/OpenSSL，仅 WB_TLS_FINGERPRINT=node 时启用；支持自动发现便携包内的 Windows / macOS / Linux amd64、arm64 桥接器，OpenWrt 额外支持 armv7。桥接器只监听回环地址，使用启动时随机认证密钥，继续验证上游证书，并在 WB_CA_BUNDLE 或不受支持的代理路径下拒绝静默降级。
- 设备 Token 支持：账号新增独立 deviceToken；设置页可配置文件路径 device_token_file，面板只显示脱敏来源、长度和加载状态，token 本体不返回浏览器，并支持热重载。优先级为账号 token  settings.json 字面值  文件；导入/导出仅在显式包含 secrets 时保留设备 token。
- 桌面 chat 兼容头：新增默认关闭的桌面 chat 兼容模式，按需发送 SDK 兼容请求头、X-Agent-Runtime、baggage 与会话字段；环境变量 WB_