XDTrees/dsh-workbuddy-xdpool

DSH WorkBuddy XD Pool

将 WorkBuddy 桌面 App 里登录过的所有账号自动并入一个 DeepSeek Harness 模型池：无需任何手动配置，你在 WorkBuddy 桌面登录的每个账号都会成为一个池成员；某个账号被限流（429）时，请求会自动切换到下一个可用账号，实现多账号自动容错轮换。

与单账号连接插件（如 dsh-workbuddy-connect）的区别：XD Pool 把多账号当成常态——它不挑账号、不做手动导入，而是把本机 WorkBuddy 桌面 App 的所有历史登录快照全部纳入一个共享池，用一个 workbuddy-xdpool provider 分组对外暴露，模型请求在池内自动 failover。

插件配置卡片（设置 → 插件 → DSH WorkBuddy XD Pool）

WorkBuddy 池设置卡片：国内版 / 国际版切换栏、池健康状态、账号面板、积分包与合计、每账号每日签到、模型管理（启用勾选 / 图片输入 / 上下文窗口）

模型选择器（国内版 / 国际版 两个独立供应商分组；倍率直接拼进 model.name：DSH 0.1.2 composer 只读 name）

模型选择器：国内版与国际版各占一个分组，每个模型名后显示积分倍率与促销标签

国内版 / 国际版 双供应商（各自独立账号、积分与模型，可同时使用）

切换国内版与国际版：未登录的一侧给出该区域的登录步骤

功能

- 零配置开箱即用：安装并启用后，WorkBuddy 桌面 App 里每个已登录账号都会在第一次被请求时自动发现、进入池中轮换。无需在插件里手动录入账号。

- 自动容错轮换：池维护每个账号的 429 冷却状态。当某个账号触发限流进入冷却，后续请求会跳过它、落到下一个健康账号；冷却结束自动恢复。所有账号同时冷却时请求才暂停。

- 账号健康一目了然：插件设置卡片显示池健康状态（N 账号 / X 冷却、当前会轮到哪个账号）、每个账号的令牌有效期与冷却倒计时。

- 剩余积分实时可见：卡片按账号展示积分包（套餐名 · 剩余 / 总量）与合计剩余（大字绿色高亮），跟随上游实时刷新。

- 模型目录直接标注：卡片列出当前在池内可用的模型，并标注积分倍率（如 GLM-5.2 · x0.79）、免费 / 限时免费 / 夜间折扣标签、图片输入能力与上下文窗口，倍率与标签跟随上游 credits / tags 实时更新。

- 每日签到：卡片在每个账号的积分区下方提供签到按钮，并显示连签天数、每日积分与里程碑额外奖励；一键领取该账号当日签到奖励。多账号可逐个领取，无需先切换账号。领取前会重新查询状态，今日已领取的账号不会被重复领取。CLI 亦提供 checkin 命令。

- 国内版 / 国际版自动适配：按账号凭据里的登录域名自动选择上游域名——国际版登录（workbuddy.ai）走 www.workbuddy.ai；国内版（默认）走 copilot.tencent.com 与 www.codebuddy.cn。同一池内可混用两种区域的账号，各自请求各自区域的上游。

- 三种人工动作：卡片与 CLI 都提供「重新检测账号」（重新扫描桌面登录快照，把新登录的账号并入池）、「清除所有冷却」（立即解除全部 429 冷却）与「每日签到」三个操作。

安装

前置：已安装并登录 WorkBuddy 桌面 App（插件复用 App 的登录状态；多账号 = 在桌面 App 里逐个登录/切换账号即可，每次登录都会被自动吸收进池）。已针对 DSH Desktop host 0.1.2 兼容。

与 host 兼容 0.1.1-rc.2 / 0.1.2 系：设置节安装会按 host 能力自动选择 settings.installSection（0.1.2-rc.1+）或自由函数（更早）。

方式一：从 npm 安装（推荐）

dsh 不在 PATH 时，用 node ~/.dsh/profiles/node_modules/@deepseek-ai/dsh/lib/bin.js 代替 dsh
dsh plugin --profile desktop add dsh-workbuddy-xdpool

推荐 npm 安装：pnpm / npm 需要拉取的依赖只有插件自身（约 1 个包，数秒完成）。
从 GitHub 源码安装会连带安装开发依赖（构建器、测试框架等数百个包），明显更慢。

方式二：从 GitHub 源码安装

dsh plugin --profile desktop add github:XDTrees/dsh-workbuddy-xdpool

方式三：手动注册 bundle

1) 安装包（npm 或 GitHub 任选其一）
dsh plugin --profile desktop add dsh-workbuddy-xdpool

2) 注册 bundle：编辑 ~/.dsh/profiles/desktop/package.json，
在 "dsh" → "profile" → "bundles" 数组末尾追加 "dsh-workbuddy-xdpool"

3) 重启 DSH Desktop

本地构建（开发者）：

pnpm install
pnpm build        # 产出 lib/index.js + lib/index.d.ts + lib/bin.js + lib/client.js
pnpm test         # 26 项测试（自动容错轮换、按(账号,模型)冷却、签到守卫）
pnpm typecheck    # 宿主侧
pnpm typecheck:client   # 客户端

构建产物已随仓库提交（lib/ 不再 gitignore）。因此从 GitHub 安装时不需要任何安装期脚本，不会触发 pnpm 的「构建脚本被拦截，请放行」提示。改动 src/ 后请重新 pnpm build 并把 lib/ 一并提交，否则用户拿到的是旧产物。

注意：pnpm install 需用 pnpm 11（npx pnpm@11），必要时加 --config.confirmModulesPurge=false --config.minimumReleaseAge=0（pnpm 11 默认的 minimumReleaseAge 供应链年龄策略会拦截刚发布的 rc 包）。

装好后：模型选择器里会出现 WorkBuddy XD Pool 分组；设置 → 插件 → DSH WorkBuddy XD Pool 卡片可查看池健康、各账号令牌/积分/签到/冷却，以及「重新检测账号」「清除所有冷却」按钮与每个账号的签到按钮。

插件在 Web / TUI profile 下同样可用（--profile web / --profile dsh-tui）。

命令行

统一用 dsh plugin --profile desktop exec dsh-workbuddy-xdpool  调用：

dsh plugin --profile desktop exec dsh-workbuddy-xdpool status    # 池账号数/冷却 + shim 状态（--credits 查积分、--json 机器可读、--rates 看倍率）
dsh plugin --profile desktop exec dsh-workbuddy-xdpool accounts  # 已发现账号（--json）
dsh plugin --profile desktop exec dsh-workbuddy-xdpool doctor    # 诊断发现/冷却/上游连通性
dsh plugin --profile desktop exec dsh-workbuddy-xdpool reset     # 立即清除所有 429 冷却
dsh plugin --profile desktop exec dsh-workbuddy-xdpool checkin   # 查询每个账号今日签到状态（--json 机器可读）
dsh plugin --profile desktop exec dsh-workbuddy-xdpool checkin all
领取所有账号今日签到奖励；也可传账号标签只领一个
dsh plugin --profile desktop exec dsh-workbuddy-xdpool login     # 引导如何在桌面再加一个账号入池

池里怎么多账号？

池走自动发现：WorkBuddy 桌面 App 每次登录都会在本机留下一个带令牌的历史快照，XD Pool 扫描这些快照，把每个账号都吸收入池。因此多账号 = 在 WorkBuddy 桌面 App 里逐个登录 / 切换账号即可，之后点卡片「重新检测账号」或重启 DSH，新账号自动成为池成员。

若你想对桌面 App 之外的某个登录做显式快照（例如临时固定某个账号再验证），也可手动导入：

在 WorkBuddy 桌面 App 登录账号后（key 自己起名）：
dsh plugin --profile desktop exec dsh-workbuddy-xdpool import myKey
查看/删除已导入快照：
dsh plugin --profile desktop exec dsh-workbuddy-xdpool accounts
dsh plugin --profile desktop exec dsh-workbuddy-xdpool remove myKey

导入快照以 key 的 MD5 前 8 位命名落在 ~/.dsh/.workbuddy-xdpool/（key 本身记在文件里），中文、带 /、带空格的 key 都安全；长期使用靠 refresh token 自动续期，失效则回到桌面重新登录后 import  --force 覆盖。

配置

池的有效配置经插件设置节（settings.workbuddy-xdpool）读取，模型设置页可改，改动即时生效：

| 字段 | 说明 | 默认 |
| --- | --- | --- |
| authFile | 覆盖 WorkBuddy 桌面 auth 文件路径（跨平台探测异常时用，等价于 WORKBUDDY_AUTH_FILE） | 自动探测 |
| cooldownMs | 单账号 429 冷却时长（毫秒） | 60000 |

也可直接写在 ~/.dsh/settings.yaml：

workbuddy-xdpool:
cooldownMs: 120000

架构

- 宿主侧（src/，DSH 主进程内）：
- index.ts —— 注册 workbuddy-xdpool provider、workbuddy-xdpool 设置节（settings.installSection）、4 条同源路由（状态 / 重新检测 / 清除冷却 / 签到）、账号发现与模型目录播种。
- accounts.ts —— WorkBuddyAccountPool：读取本机 WorkBuddy 桌面 auth 快照、429 冷却、round-robin failover 与 token 刷新。
- catalog.ts / upstream.ts —— 上游模型目录（含每模型积分倍率、免费/图片能力标签）、积分查询与每日签到的上游客户端（按凭据域名自动切换国内 / 国际版域名）。
- web-status.ts / status-paths.ts —— 卡片消费的同源状态文档与路由；签到是本插件唯一的写操作，按「POST + 回环来源 + 显式 accountId + 领取前二次确认」四重守卫。
- bin.ts —— 上述 CLI。
- 客户端（src/client/，浏览器卡片，经 dsh.client 由宿主加载）：折叠卡片外壳沿用宿主内置卡的 dsm-plugin-card 样式语言（--dsw-alias- 主题变量），内容用 dsm-workbuddy-xdpool- 前缀，绝不污染宿主其它卡片；命名空间 settings.workbuddy-xdpool。
- 构建：tsdown 产出 lib/index.js（宿主入口）+ lib/index.d.ts（类型）+ lib/bin.js（CLI）+ lib/client.js（CJS，window.__ModuleLoader__.load 包裹的浏览器 bundle）。四个产物均随仓库提交，因此安装时不需要任何构建脚本。

已知限制

- 仅使用本机桌面 App 的账号：池不会、也无法替你发起 WorkBuddy 的登录/扫码（token 由 WorkBuddy 桌面 App 自己的腾讯 SSO 登录铸造并设备绑定）。加池账号 = 在 WorkBuddy 桌面 App 里登录/切换，XD Pool 自动吸收。
- 依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整；若某账号 refresh token 失效，回到桌面重新登录即可。
- 若 Windows 与 Linux 用户名不同且 Windows 环境变量未传入 WSL，请用 WORKBUDDY_AUTH_FILE 或配置节的 authFile 指定实际位置。

免责声明

- 本项目仅供个人学习和研究使用，仅驱动使用者自己的 WorkBuddy 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守 WorkBuddy 的服务条款；因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断），由使用者自行承担。
- 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
- 本项目与腾讯、WorkBuddy、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。

致谢

本项目的实现参考了以下已公开的项目，并按其许可证要求保留版权声明。参考方向为设计思路与既有结论，代码为独立实现；关键模块在源文件头部注释中也标注了所参考的项目与模式：

- corrinehu/dsh-workbuddy-connect（MIT）—— 设置节注册（settings.installSection）与 DSH 插件结构、客户端卡片加载机制、桌面端凭据刷新与 loopback shim 加固的核心参照；本项目沿用其「宿主通过 installSection 挂卡片」的打通路径。
- dingminhua/dsh-connect-workbuddy（MIT，Copyright (c) 2026 LaoDing）—— dsm-plugin-card 卡片样式语言与 --dsw-alias-* 主题变量的参照实现；每日签到（/v2/billing/meter/checkin-activity-status 与 /v2/billing/meter/daily-checkin）、积分包聚合口径（月度周期套餐 / 一次性礼包区分）与国内 / 国际版按 domain 选择上游域名的做法，参考了该项目已验证的接口形态。
- Sliverkiss/workbuddy2api（MIT）—— WorkBuddy 上游协议（copilot.tencent.com 的 wire behavior）与积分接口的参照实现。

以上项目的版权归各自作者所有。本项目采用参考设计思路 + 独立实现的方式，未整体复制任何参考项目的源码。若标注有遗漏或不当之处，欢迎提交 issue 指正。

许可证

MIT