前言¶
在 DeepSeek Harness（DSH）里接 WorkBuddy 模型，通常依赖社区插件 dsh-workbuddy-connect：它负责把 WorkBuddy 的模型接到 DSH 的模型选择器。单账号使用时，一旦触发频率限制或当日额度耗尽，对话只能等待或改用手动切换凭据，对需要长时间跑任务或并行多会话的开发者并不友好。
dsh-workbuddy-multi 是 dsh-workbuddy-connect 的伴侣插件：不修改上游插件的任何文件，在其之上维护国内版、国际版各自的账号池，并在限流、轮换、令牌续期与模型分组等方面提供统一设置页。下面介绍它的定位、能力与安装用法。
这是什么¶
- 名称：
dsh-workbuddy-multi（DSH WorkBuddy Multi-Account） - 维护者：richardhxwang
- 分类：客户端插件（DSH Web 端注入设置 UI）
- 仓库：github.com/richardhxwang/dsh-workbuddy-multi
- 当前版本（package.json）：0.7.0，许可证 MIT
- 依赖：
dsh-workbuddy-connect（peer 要求 ^0.7.8）；未安装或被停用时会尝试通过插件市场自动安装或启用
一句话：dsh-workbuddy-connect 负责接入模型，本插件负责多账号池与轮换策略。
核心功能¶
多账号轮换¶
国内版、国际版各自维护一个账号池。某个账号触发频率限制或额度耗尽时，会暂停到额度恢复的时刻，下一次请求使用下一个可用账号，不会再发给处于限流中的账号。
轮换方式可在设置页选择：
| 方式 | 行为 |
|---|---|
| 限流时切换（默认） | 持续使用当前账号；限流或额度耗尽时暂停该账号并切换 |
| 逐次轮换 | 每个请求依次使用下一个可用账号 |
| 手动指定 | 不自动切换，只使用手动设为「当前」的账号 |
只有 WorkBuddy 返回了额度恢复时间的限流才会暂停账号并切换。「模型繁忙」等不带恢复时间的临时限流不切换账号，由 DSH 自动重试。
添加账号与令牌续期¶
- 扫码添加：设置页生成 WorkBuddy 官方登录链接，微信扫码即可加入账号池。
- 从桌面 App 导入：读取 WorkBuddy 桌面 App 当前登录的账号。
- 导入授权文件：一次最多 10 个；DSH 未在本机运行时，可展开「按路径导入」填写路径。
定时刷新即将过期的令牌；需要重新登录的账号会单独标出。每个账号支持刷新令牌、停用/启用、重命名、删除；可用账号可「设为当前」。
模型分组与上游能力合并¶
| 分组方式 | 行为 |
|---|---|
| 按版本合并（默认） | 国内版、国际版各一个模型组，组内账号自动轮换 |
| 按账号分组 | 每个账号对应一个模型组，在模型选择器中直接选用 |
推理档位共享（默认开启）：同版本内任一账号在设置页检测过的推理等级对池内所有账号生效；检测仅在设置页进行，输入框不会出现「推理等级」按钮。对声明不校验参数的模型，按惯例提供 low / medium / high / max 四档。
上下文选档：对目录中声明多档窗口的模型，可在模型列表里逐个选择窗口大小，或一键全部设为默认/最低/最高；模型选择器里的条目名称不变。
积分合计：按版本汇总池内已启用账号的积分，可在输入框旁显示合计（可通过配置或设置页开关控制）。
设置页的开关（模型分组、推理档位共享、输入框积分、上下文选档）即时生效，并保存在 ~/.dsh/workbuddy-pool/settings.json，重启 DSH 后保持。上游插件的账号状态、积分、模型列表刷新、可见性、最大上下文、推理档位检测与版本更新检查，也收进本插件设置页。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证。
从插件市场安装（推荐）：打开 DSH「插件市场」，搜索 dsh-workbuddy-multi，点击安装。
命令行（dsh web profile）：
dsh plugin --profile web add https://github.com/richardhxwang/dsh-workbuddy-multi/releases/latest/download/dsh-workbuddy-multi.tgz
装好后刷新页面，在「插件」页打开 dsh-workbuddy-multi 进入设置页。
依赖 dsh-workbuddy-connect 会在安装后自动检查；无插件市场时，设置页会提示手动安装：
dsh plugin add dsh-workbuddy-connect
典型用法¶
添加账号¶
- 打开插件设置页，点击右上角「添加账号」。
- 选择国内版或国际版，在浏览器或手机中打开生成的登录链接，微信扫码。
- 登录成功后账号立即进入对应版本的账号池。
也可在版本标题右侧「⋯」菜单中从桌面 App 导入或导入授权文件。
选择轮换与分组¶
在设置页选定「限流时切换 / 逐次轮换 / 手动指定」以及「按版本合并 / 按账号分组」。改完后无需额外重启即可按新策略请求模型。
可选配置（cordis.patch.yml）¶
一般不需要改；设置页改过的开关以设置页为准。需在 profile 的 cordis.patch.yml 中调整时，可参考：
- id: llm-workbuddy-multi
config:
cooldownMs: 1800000 # 额度用尽但无法得知恢复时间时的暂停时长（毫秒）
keepalive: true # 令牌自动续期
keepaliveSweepMs: 900000 # 续期检查间隔
poolRoot: '' # 账号池目录，留空为 ~/.dsh/workbuddy-pool
reasoningCache: true # 推理档位跨账号共享
creditsChip: false # 输入框积分合计 chip
contextTiers: true # 按模型选择上下文窗口
creditsIntervalMs: 300000 # 后台统计积分间隔；0 = 不周期统计
适用场景与注意事项¶
适合：已在 DSH 中使用 dsh-workbuddy-connect，且需要多个 WorkBuddy 账号分担限流、或按账号在模型选择器中区分的用户。
务必注意：
- 不要在
dsh-workbuddy-connect的设置里填写authFile/authFileAI路径；优先级高于本插件，填写后自动轮换不会生效，设置页会提示。 - 国内版账号凭据由本机 WorkBuddy App 密钥加密，账号池拷贝到其他电脑无法使用；国内版只能在本机使用。
- 凭据仅保存在本机
~/.dsh/workbuddy-pool/（文件权限 0600）；设置页与接口不显示令牌。 - 从桌面 App 导入的国内版账号，令牌由上游在使用时刷新；若希望纳入本插件的自动续期，需用「添加账号」扫码登录一次。
DSH 社区插件目录（如 skillhub.cn 上的条目）由社区维护，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-workbuddy-multi 在不动上游 dsh-workbuddy-connect 的前提下，把多账号池、限流切换、扫码与导入、令牌续期以及模型分组集中到一块设置页。若你已经在 DSH Web 里用 WorkBuddy，可先在市场安装本插件，再按版本添加账号并选择轮换策略。
- 目录页：https://www.skillhub.cn/plugins/richardhxwang/dsh-workbuddy-multi
- GitHub：https://github.com/richardhxwang/dsh-workbuddy-multi
