waygate-workbuddy

把 WorkBuddy 订阅，变成一个本地 base_url

快速开始 · 命令 · 客户端怎么填 · 工作原理 · 常见问题

用你的 WorkBuddy 账号登录一次（官方 OAuth 通道），在本机起一个 OpenAI / Anthropic 兼容的聊天端点， 供 Cursor / Claude Code / Cherry Studio 等客户端直连。只在本机读写与转发，不上传任何数据。

快速开始

要求：Node.js ≥ 20（不需要装 WorkBuddy 桌面端）。

# 全局安装（之后命令就是 wb）
npm i -g waygate-workbuddy

# 登录：打印授权链接（浏览器打开、用你的 WorkBuddy 账号完成登录）
wb login

# 启动
wb

wb login 会原地等你 2 分钟 —— 你在浏览器点完登录，终端自动继续，无需再来一次。 若超过 2 分钟，它会提示你用 wb login-poll 续取：

请在浏览器打开下面的链接完成登录（用你的 WorkBuddy 账号）：

  https://copilot.tencent.com/...?state=...

完成后本终端会**自动继续**（最多等 120 秒）。

  ⏳ 等待登录完成… 3s（最多再等 117s，按 Ctrl+C 可中断）

✓ 登录成功 → ~/.waygate/wb/credential.json

启动后终端会打印模型 ID 与代理地址，把它们填进你的客户端即可。

[!NOTE] 登录走 WorkBuddy 官方给插件/CLI 的 OAuth 设备授权通道 —— 不读本机客户端文件、不做任何解密。 登录态只保存在本机 ~/.waygate/wb/credential.json（权限 0600），不会上传。

命令

wb                       # 启动反代（同 wb serve），打印模型 ID 与代理地址
wb models                # 只列出模型 ID（不起服务）
wb login                 # 登录：打印授权链接并原地等 2 分钟（超时提示改用 login-poll）
wb login-poll            # 完成登录：浏览器授权后取 token（`login` 等待超时也用它）
wb checkin               # 签到代领 + 跑成长任务 + 连登兑换
wb status                # 只查签到状态（不领取）
wb doctor                # 自检：端口 / 登录态 / 模型清单 / 上游连通 / 令牌刷新

| 参数 | 说明 | | --- | --- | | --port <n> | 监听端口（默认 8786） | | --host <addr> | 监听地址（默认 127.0.0.1） | | --key <sk-…> | 指定入站密钥（默认自动生成并缓存） | | --json | 机器可读输出 | | --verbose | 打印每个请求的路由日志 |

客户端怎么填

Cursor / Cherry Studio / OpenAI SDK

• Base URL：http://127.0.0.1:8786/v1
• API Key：启动时打印的 sk-wb-…
• 模型：模型 ID（如 deepseek-v4.1-flash）

Claude Code

ANTHROPIC_BASE_URL=http://127.0.0.1:8786
ANTHROPIC_API_KEY=sk-wb-…

暴露的端点：POST /v1/chat/completions · POST /v1/messages · GET /v1/models · GET /healthz

支持流式（SSE）与非流式（stream: false 时自动聚合为单个 JSON）。

工作原理

flowchart LR
  C["客户端<br/>Cursor / Claude Code"] -->|"OpenAI / Anthropic<br/>:8786"| W["waygate-workbuddy"]
  W -->|"① 注入官方桌面端指纹"| U["WorkBuddy 网关<br/>copilot.tencent.com"]
  W -->|"② 满足上游硬约束<br/>（见下）"| U
  U -.->|"SSE（本就是 OpenAI 格式，直接透传）"| W
  W -.-> C
  L["官方 OAuth 设备授权<br/>（wb login 一次）"] -.-> W

上游本身就是 OpenAI 兼容 —— 所以没有协议翻译层，出站 SSE 直接透传。 本工具真正做的事是三件：

1. 注入官方桌面端指纹：X-Product（取 deploymentType，实测 SaaS）、X-IDE-*、 X-Agent-Intent: craft、X-Private-Data: true、X-CodeBuddy-Request: 1 等 —— 缺失时 用量不会归因到 WorkBuddy 使用端。
2. 满足上游的隐形硬约束（实测得到的 400 来源，违反即整条挂）：
   • stream: false → 400（上游只认流式）
   • max_tokens < 16 → 400
   • role 精确为小写 developer → 400
   • system 正文命中「长 n-gram 模板指纹」（Claude Code 血统的 git 环境模板行）→ 400 ⇒ 本工具对模板行做语义等价改写（可关：环境变量 WB_PROMPT_REWRITE=off）
3. 管理登录态：access 约 28 天，提前 2 天自动刷新；刷新会轮换 refresh token，已自动写回。

安全：入站密钥绝不出站（用 allowlist 而非 blocklist —— 失效模式是「少带一个头」而不是「密钥外泄」）； 出站凭证只存在本机 ~/.waygate/wb/（0600）。

常见问题

Q：登录走的是什么通道？ A：WorkBuddy 官方给插件/CLI 的 OAuth 设备授权。 不读本机客户端文件、不做任何解密 —— 与那些「读桌面端加密登录态」的工具性质不同。 （本仓库也不含任何解密代码：指纹与改写模块与凭证获取完全解耦。）

Q：登录态过期了怎么办？ A：access 约 28 天，本工具提前 2 天自动刷新并写回，通常无需人工干预。 若 refresh 也失效（如在其他设备登出），重跑 wb login（等 2 分钟；超时用 wb login-poll 续取）即可。wb doctor 会显示剩余时长。

Q：checkin 报「未完成」的任务？ A：那是任务的前置条件没满足（多为「体验 XX」型）。工具如实记 skipped，不伪造行为去凑。

Q：会让我的桌面端掉线吗？ A：实测不会 —— 刷新后旧 access token 仍有效（官方插件刷新链，多会话共存）。 与 MiniMax/Qoder 的「同账号互相踢」不同。

Q：WB_PROMPT_REWRITE 是什么？ A：system 提示改写档位（template（默认）/neutral/off）。 上游调整了模板指纹规则、而本工具的规则还没跟上时，可设 WB_PROMPT_REWRITE=off 关掉它排查； neutral 则把 system 整段换成中性提示（更激进）。

免责声明

本工具仅供个人在本机使用自己的订阅，不提供任何服务端能力、不代管他人凭证。 使用者需自行确认其行为符合 WorkBuddy 的服务条款。作者不对因使用本工具产生的任何后果负责。

相关项目

• waygate-qoder —— 同款工具，对应 Qoder CN（npm i -g waygate-qoder）
• waygate-mmcode —— 同款工具，对应 MiniMax Code（npm i -g waygate-mmcode）
• waygate-core —— 三个工具共用的骨架（npm i waygate-core）
• waygate-open —— 同一作者的完整多提供商反代（含控制台、用量统计）

License

MIT