dsh-workbuddy
在 DeepSeek Harness（DSH）里使用 WorkBuddy 的模型。
装好之后，WorkBuddy 的模型会直接出现在 DSH 的模型选择器里，和内置模型一样用；另有一个设置页
管理两个账号、查看实时倍率与繁忙程度、挑选用哪些模型。
| Provider 路由 | 部署 |
|---|---|
@huai_xin/dsh-workbuddy/cn |
https://www.workbuddy.cn |
@huai_xin/dsh-workbuddy/intl |
https://www.workbuddy.ai |
> 非官方项目。 与腾讯 / WorkBuddy 官方无任何关联，不使用其商标授权，也不分发其代码。
> 它只是一个第三方客户端插件，按公开可观测的接口工作。请自行确认使用方式符合你所在地区的
> 法律与 WorkBuddy 的服务条款。仓库里不含任何真实账号数据——示例与截图一律是假数据。
> 强烈建议配合 dsh-model-picker 一起使用。
> 这是同一个作者的另一个插件，它读取本插件发布的客户端状态服务，在模型选择器里直接显示
> 每个部署的实时积分、模型的探测结论、繁忙状态与实时倍率——不用打开设置页就能挑模型、看状态。
> 两个插件都装上即可联动，无需任何配置。
安装
# 从 npm 安装到某个 profile
dsh plugin --profile add @huai_xin/dsh-workbuddy
也可以在 Web UI 的插件管理里安装（效果相同）。
装完重启 DSH，然后 /workbuddy login cn 或 /workbuddy login intl 授权。
用法
登录
/workbuddy login cn # 大陆版：打开授权页，浏览器里点一下就行
/workbuddy login intl # 海外版
/workbuddy login all # 两个都登录
/workbuddy status # 账号、到期时间、模型数
/workbuddy logout cn # 退出：删凭据，并把它的模型从选择器里移除
/workbuddy refresh cn # 手动续期
/workbuddy models cn # 这个账号当前能用哪些模型
/workbuddy check cn # 检测哪些模型真的可用（详见下文）
登录完去设置页把想用的模型开关打开，它们就会出现在模型选择器里（默认全部停用）。
两个部署各自独立登录，互不影响。
与 dsh-model-picker 联动
本插件会向客户端发布一个状态服务（@huai_xin/dsh-workbuddy/state），我的
dsh-model-picker 插件读取它，
在模型选择器里做两件事：
- 显示积分：每个部署的实时余额直接出现在选择器里，不用打开设置页；
- 优化显示：模型的探测结论（可用 / 限流 / 无权限…）、繁忙状态与实时倍率跟着模型一起
展示，启用了哪些就显示哪些。
两个插件都装上即可联动，不需要任何配置。状态由本插件自动加载与刷新（每 5 分钟一次，
打开设置页的动作也会触发），选择器那边只管读。
设置页
设置 → WorkBuddy，两张卡片。
账户：表格是转置的，两个部署并排对比。
● 大陆版 [今日已签到] |
● 海外版 | |
|---|---|---|
| 账号 | 示例账号 | 900000001 |
| 到期 | 2027/01/16 09:00:00 | 2027/04/21 12:00:00 |
| 积分 | 1280.00 ⟳ | 360.00 ⟳ |
| 操作 | [更换账号] [退出登录] |
[更换账号] [退出登录] |
- 部署名旁的圆点是登录状态（绿=已登录 / 黄=等待授权 / 红=已过期 / 灰=未登录）。
- 积分旁的 ⟳ 只刷新这一行。
- 右上角一个「续期」，两个部署一起续，未登录的跳过。
- 签到按钮（只有大陆版有）跟在部署名右边。
- 未登录的部署整列只显示一个「登录」按钮。
模型：顶部标签切换查看哪个部署（只切换查看，不影响登录）。
- 按能不能用分两组：
可用模型/不可用模型，后者默认折叠。 - 每行：圆点是判定颜色（绿=可用 / 黄=排队或无权限 / 红=不可用 / 灰=未检测），右侧依次是
可用性 · 促销 · 繁忙程度 · 实时倍率，最后是该模型的启停开关。 - 模型默认全部停用，你手动打开哪些，选择器里就有哪些；这份选择在退出登录后也保留。
- 点一行展开详情：描述、上下文、最大输出、模态、思考档位、倍率、繁忙程度、促销。
- 工具栏：搜索、「全部启用 / 全部停用」、「⟳ 刷新列表」、「检测可用性」。全部启用作用于
可用分组，全部停用作用于两个分组。 - 开关立即生效，选择器马上跟着变。
积分与签到
- 启动约 15 秒后自动签到一次，之后每天本地 0 点再签到一次。
- 签到是幂等的，重启不会重复发积分。
- 海外版没有签到接口，只显示积分。
关于"哪些模型真的能用"
目录里列了不等于能用。这个插件会真的发一个请求去验证，而不是看目录字段猜。
- 大陆版：探测不产生任何消耗，可以随便点。
- 海外版：每个模型探测一次约 1 token，所以自动检测每天最多一次，「检测可用性」按钮可以手动随时点。
判定的三种结论（只有前两种会进「不可用模型」组）：
| 标签 | 含义 |
|---|---|
| 不可用 | 模型 id 在网关上不存在（已下架，目录里的僵尸条目） |
| 无权限 | 账号档位不够，或请求被网关拦截 |
| 未知 | 其它拿不到结论的报错（5xx、凭据问题等），悬停可看原始报文 |
没被证伪的不当成不能用，所以「未知」仍留在可用分组里。判定有效期 12 小时。
真实对话里如果某个模型回「不存在」或「无权限」，插件会直接记下来，不用等下次检测。
数据存在哪
全在 $DSH_HOME/dsh-workbuddy/ 一个目录里，删掉它就等于把插件恢复出厂：
| 文件 | 内容 |
|---|---|
credentials.json |
两个部署的令牌（0600 权限） |
catalog-<部署>.json |
模型目录缓存 |
availability-<部署>.json |
可用性判定 |
enabled-<部署>.json |
你启用过哪些模型（退出登录不删） |
official-<部署>.json |
从账号名单导入的列表 |
凭据不写进宿主的 .credentials.yaml，避免和别的插件混在一个文件里。
常见问题
装完没反应 / 面板报 404？
改了插件代码需要重启 DSH，重新启用插件不算。装新版本同理。
选择器里看不到某个模型？
它默认是停用的：去设置页把它的开关打开。如果退出过登录，模型会全部隐藏，重新登录后你
启用过的那些会原样回来。
某个模型显示「不可用」但我想试？
可以直接把开关打开——手动决定永远优先于检测结果。
倍率显示「未知」？
目录里没给这个模型的实时倍率。插件不会用旧值兜底、也不会猜。
为什么没有"关闭思考"的开关？
上游只声明了"可否关闭思考"这个字段，却从没给出能兑现它的请求参数（实测过），所以只能调档位。
许可
MIT，见 LICENSE。再次说明：本项目为第三方非官方插件，与腾讯 / WorkBuddy 无关联。
开发、排障、二次开发请看 AGENTS.md；上游接口与实测记录在
docs/workbuddy-protocol.md。
