前言¶
在 DeepSeek Harness（DSH）里接 WorkBuddy 做模型推理时，常见做法是单账号插件：一次请求绑定一个登录态。若你在 WorkBuddy 桌面端换过多个账号，或想按积分到期、轮询、会话粘性等方式自动换号，就要自己管凭据路径和额度排序。
dsh-connect-workbuddy-models 由维护者 DragonHorizon-xtihc 发布，分类为模型推理。它把本机所有曾登录过的 WorkBuddy 账号聚合成 DSH 里的一个模型池：自动发现账号、读积分与到期、临期提醒、签到与可选自动签到，并在模型选择器与输入框下方展示倍率、促销徽标和剩余总积分。与单账号插件 dsh-connect-workbuddy 的 provider id 刻意不重叠，两者可同时安装。
这是什么¶
插件包名 dsh-connect-workbuddy-models，当前资料中的版本为 0.1.1，许可证 MIT。装上后模型选择器会出现两个分组：WorkBuddy Models（国内版） 与 WorkBuddy Models（国际版）（provider id 分别为 workbuddy-models / workbuddy-models-global）。
目录页：https://www.skillhub.cn/plugins/DragonHorizon-xtihc/dsh-connect-workbuddy-models
源码与说明：https://github.com/DragonHorizon-xtihc/dsh-connect-workbuddy-models
账号自动发现¶
插件不挑号、不手动导入，只读扫描 WorkBuddy 桌面端留下的登录文件，并兼容 DSH vault 与环境变量指定路径。
| 平台 | 路径 |
|---|---|
| Windows | %LOCALAPPDATA% 与 %APPDATA% 下的 CodeBuddyExtension\Data\Public\auth\（两处都探） |
| macOS | ~/Library/Application Support/CodeBuddyExtension/Data/Public/auth/ |
| Linux | $XDG_CONFIG_HOME/CodeBuddyExtension/Data/Public/auth/（回落 ~/.config） |
活文件 workbuddy-desktop.info；带时间戳的 *.info 为历史快照，每个可解析为一个账号候选。第二个来源是 DSH vault（$DSH_HOME，回落 ~/.dsh）。环境变量 WORKBUDDY_AUTH_FILE 可指定单个文件或目录。
多账号即在 WorkBuddy 客户端里多次登录，再在 DSH 设置页点「重新检测账号」或重启 DSH。读不了的文件会列出原因（encrypted / unreadable / malformed），而不是静默少号。
积分、到期与签到¶
- 积分读数使用上游
CycleCapacityRemainPrecise家族，而非 pool 家族的CapacityRemain。 - 支持剩余总积分、各积分包余额与到期；周期包显示下次刷新时刻。
- 临期提醒默认 3 天内将过期的额度单独标出，可在设置中配置 1–90 天（
expiryWarnDays）。 - 设置页可按账号手动「签到」；可选自动签到（北京时间自然日幂等，默认整点
[9]）。 - 可选顺带领取补偿 / 赠礼积分（
automation.claimBenefits/claimBenefits）。
账户使用方式¶
设置页「账户使用方式」（distribution）会真正影响换号行为，默认 expiry（一次性积分包最先到期的账号优先服务）：
| 方式 | 行为概要 |
|---|---|
expiry |
按最近到期时间升序，无到期信息排最后 |
priority |
固定同一号直到限流或积分耗尽 |
round-robin |
连续请求依次轮询各号 |
balanced |
按权重抽取，避免单号被抽干 |
sticky |
单会话钉一个号，新会话换下一个 |
accounts.cn / accounts.global 为空时，由上述策略决定当前账号；也可在输入框下方或 HTTP 接口显式切换。
模型列表、倍率与界面读数¶
- 模型列表来自上游实时目录；设置页可「刷新模型」，并显示各模型积分倍率。国内版 fallback 目录无倍率字段时，未知显示为「—」，不当成 0。
- 「需要显示的模型」：
enabledModelIds/enabledModelIdsGlobal空数组表示全部显示。 - 模型选择器行展示本次生效的促销徽标与倍率，数据来自已在读的
/v3/config（modelPromotions/modelTiers），渲染时按墙钟或绝对窗口现算。 - 对话输入框下方（
showCreditsInComposer，默认开）显示当前区域账号名、该账号或整池剩余总积分，并可切换账号；仅当选中模型属于本插件 provider 时出现。
安装与启用¶
插件以 npm 包装进 DSH profile，资料推荐在目标 profile 的 package.json 中操作（例如 ~/.dsh/profiles/<profile>/package.json）。
1、在 dependencies 加入：
"dsh-connect-workbuddy-models": "^0.1.1"
2、在同一文件的 dsh.profile.bundles 数组里加入包名：
"dsh.profile.bundles": ["...", "dsh-connect-workbuddy-models"]
3、执行 pnpm install（或 npm install）。
4、重启 DSH（Web GUI 默认 3080 端口）。设置页左侧会出现「workbuddy模型」。
从 GitHub 安装时，依赖写法为：
"dsh-connect-workbuddy-models": "github:DragonHorizon-xtihc/dsh-connect-workbuddy-models"
仓库已提交 lib/ 构建产物，安装期无需本地构建。
典型用法与 HTTP 接口¶
安装并重启后，可用本地 HTTP 汇总状态或触发重新扫描：
# 汇总状态：账号 / 积分 / 到期 / 签到 / 模型 / 配置
curl http://127.0.0.1:3080/plugins/dsh-connect-workbuddy-models/status
# 重新扫描本机登录账号
curl -X POST http://127.0.0.1:3080/plugins/dsh-connect-workbuddy-models/accounts/refresh
其余路由均挂在 /plugins/dsh-connect-workbuddy-models/ 下，包括单账号积分（GET /account/credits）、手动签到（POST /checkin）、刷新模型目录（POST /models/refresh）、切换账号（POST /accounts/select）、自动签到配置（GET/POST /automation）等。设置命名空间为 wbmodels，字段含 enabled、distribution、accountsEnabled、orderAccountIds、automation.enabled 等，详见仓库 README 配置表。
适用场景与注意¶
适合在本机已用 WorkBuddy 桌面端登录过多个账号、希望在 DSH 里统一选模型并自动或策略化换号、同时关心积分到期与签到的开发者。
兼容性（资料原文）：Node.js ^22.19.0 或 >=24.0.0；DSH 0.2.0-rc.1 线及对应 peer 包；Windows / macOS / Linux 均可做账号发现，Windows 另有桌面端静态加密凭据解封支持。所有 @deepseek-ai/* 依赖为 peer，应使用 DSH 安装内的一份，避免重复装配。
DSH 社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系。插件在本机以当前 DSH 进程权限运行，会只读访问上述 auth 路径与 vault；安装前请自行查阅源码与 MIT 许可证，确认路径与自动化行为符合你的环境策略。
结尾¶
dsh-connect-workbuddy-models 把多账号 WorkBuddy 收成国内/国际两个模型池 provider，在发现、额度、签到与换号策略上做成可配置的一体化接入。进一步说明与开发细节见 GitHub README：https://github.com/DragonHorizon-xtihc/dsh-connect-workbuddy-models；目录入口：https://www.skillhub.cn/plugins/DragonHorizon-xtihc/dsh-connect-workbuddy-models。
