dsh-connect-workbuddy-models

把本机所有登录过的 WorkBuddy 账号聚合成 DeepSeek Harness 里的一个模型池：自动发现账号、 签到、积分与到期、临期提醒、自动签到、模型倍率与促销徽标，并在输入框下方直接切换账号、查看剩余总积分。

装上之后模型选择器里出现两个分组：WorkBuddy Models（国内版） 与 WorkBuddy Models（国际版） （provider id workbuddy-models / workbuddy-models-global）。

和 dsh-connect-workbuddy 的关系：那个插件一次用一个账号；本插件把多账号当默认情况—— 本机所有历史登录快照全部收进一个池，对外一个 provider 分组，池内自动换号。两者的 provider id 刻意不重叠（它占 workbuddy / workbuddy-global），因此可以同时安装，互不抢占。

---

功能

一、账号自动发现

不挑号、不手动导入。插件扫描 WorkBuddy 桌面端留下的登录文件，同时兼容多个来源：

平台	路径
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， 新号就自动进池。凭据只读，插件从不索要密码。

读不了的文件会被列出来并说明原因（encrypted / unreadable / malformed），而不是悄悄少几个账号： Windows 构建会加密令牌字段，这种情况让用户「重新登录」是错的——他本来就登着。

二、积分、到期与临期提醒

能力	说明
积分读数	剩余总积分、每个积分包的余额与到期
到期时间	一次性包的到期时刻；周期包显示下次刷新时刻
临期提醒	阈值内会过期的额度单独标出（默认 3 天，可配 1–90 天）
手动签到	设置页按账号点「签到」，走上游签到端点
自动签到	按北京时间自然日幂等执行，重复调用不会重复领取
权益领取	可选顺带领取补偿 / 赠礼积分（claimBenefits）

余额读的是上游 CycleCapacityRemainPrecise 家族，不是 CapacityRemain——后者是 pool 家族， 整月额度已经花完时仍会报满额。

三、账户使用方式

设置页的「账户使用方式」下拉，五种，真正影响换号行为：

方式	行为	适合
expiry（默认）	一次性积分包最先到期的账号先服务，无到期信息的排最后	怕积分过期作废
priority	一直打同一个号，直到被限流或积分耗尽才换下一个	单号额度大，想尽快用完一个
round-robin	连续请求依次轮过每个号，花费均摊	多个号额度差不多
balanced	按权重抽取，冷清时也不会把第一个号抽干	想长期均匀消耗
sticky	一个会话钉一个号，新会话换下一个	想保住上游 prompt 缓存

默认是 expiry 而不是 priority：priority 的第一个排序键是 atRisk，而 atRisk 由 expiryWarnDays（默认 3 天）现算——10 天后才到期的积分不算 atRisk，排序会退回「谁分多谁先」， 变成「积分多的号被优先抽干」。expiry 直接按最近到期时间升序，全时段都成立。 expiryWarnDays 只决定提醒窗口，不再决定排序。

排序键（rankAccounts）依次是：可服务 → 有额度正在流失 → 用户手动序 → 最先到期 → 流失额度大 → 积分多 → 凭据更晚到期 → 账号 id（保证全序）。

四、模型列表、倍率与促销徽标

• 模型列表来自上游实时目录，设置页可点「刷新模型」重拉，并显示每个模型的积分倍率。
• undefined ≠ 0：国内版的 fallback 目录整份没有倍率字段。把未知当 0 会把收费模型显示成免费， 所以未知一律显示为「—」。
• 「需要显示的模型」默认全部显示；空选择 = 全选（不是全不选）。
• 模型选择器那一行会画上本次生效的促销徽标与倍率。徽标数据就躺在本插件已经在读的 /v3/config 里（modelPromotions / modelTiers），不额外发请求；且是按时钟现算的—— 命名时区的墙钟窗口（如 Asia/Shanghai 23:00–7:50）与绝对窗口（validFrom / validUntil） 都在渲染那一刻判定，不会出现「22:59 读到的夜间折扣到次日 08:00 还自称夜间」。
• 该槽位是宿主的 kind: 'single' 座位（一个单元格只有一个占用者），本插件用 -0.25 优先级插入， 避开宿主自带（0）、dsh-connect-qoder（-1）与 dsh-connect-workbuddy（-0.5）； 遇到不属于自己的 provider 返回纯模型名，不把邻居的显示弄没。

五、输入框下方读数与账号切换

对话输入框下方（conversation.input.left 槽位，order: 4）显示：

• 当前 provider 对应的账号名；
• 该账号 / 整个池的剩余总积分；
• 点开可切换当前使用账号（按区域）。

读数只在选中的模型属于本插件时才出现——归属判定读宿主 modelSelection 投影的 next ?? lastUsed。 开关在设置页（showCreditsInComposer），默认开。

---

安装

方式一：npm 安装（推荐）

在目标 profile 目录（如 ~/.dsh/profiles/<profile>/package.json）中：

1. 在 dependencies 加入：

   "dsh-connect-workbuddy-models": "^0.1.1"
   

2. 在同一文件的 dsh.profile.bundles 数组里加入包名（cordis.patch.yml 的 insert 就作用在这里）：

   "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/，安装期不需要跑构建脚本（pnpm 高版本默认拦截安装期脚本， 这也正是产物入库的原因）。

方式三：从源码运行（开发态）

git clone https://github.com/DragonHorizon-xtihc/dsh-connect-workbuddy-models.git
cd dsh-connect-workbuddy-models
pnpm install
pnpm build

然后在 profile 的 dependencies 里用 link: 指向本地目录：

"dsh-connect-workbuddy-models": "link:/absolute/path/to/dsh-connect-workbuddy-models"

验证

# 汇总状态：账号 / 积分 / 到期 / 签到 / 模型 / 配置
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

---

配置项

设置页「workbuddy模型」的字段（持久化在设置命名空间 wbmodels）：

字段	类型	默认	说明
enabled	boolean	true	是否启用本 provider
distribution	枚举	expiry	账户使用方式，见上表
enabledModelIds	string[]	[]	需要显示的模型（国内版）；空数组 = 全部显示
enabledModelIdsGlobal	string[]	[]	同上，国际版
accountsEnabled	string[]	[]	参与池的账号 id；空 = 全部发现的账号都参与
orderAccountIds	string[]	[]	手动排序的账号 id，[0] 排最前
showCreditsInComposer	boolean	true	输入框下方读数开关
expiryWarnDays	number	3	临期提醒阈值（天），范围 1–90
automation.enabled	boolean	false	自动签到总开关
automation.checkinHours	number[]	[9]	北京时间整点执行
automation.claimBenefits	boolean	false	是否顺带领取补偿 / 赠礼积分
accounts.cn / accounts.global	string	''	当前使用账号（按区域）；空 = 交给 distribution 决定

自动签到的时间常量：AUTOMATION_TIME_ZONE = 'Asia/Shanghai'、AUTOMATION_TICK_MS = 60_000、 AUTOMATION_ACCOUNT_DELAY_MS = 800、DEFAULT_CHECKIN_HOURS = [9]。

---

HTTP 路由

全部挂在 /plugins/dsh-connect-workbuddy-models/ 下：

路径	方法	参数	用途
/status	GET	region	汇总状态：账号 / 积分 / 到期 / 签到 / 模型 / 配置
/accounts/refresh	POST	—	重新扫描本机登录账号
/account/credits	GET	accountId	单账号积分明细
/checkin	POST	accountId（可省 = 全部）	手动签到
/benefit/claim	POST	accountId、kind	领取补偿 / 赠礼积分
/models/refresh	POST	—	拉取实时模型目录与倍率
/models/save	POST	—	保存需要显示的模型选择
/accounts/select	POST	accountId、region	切换当前使用账号
/automation	GET / POST	—	自动签到开关与时段

查询参数名常量集中在 src/status-paths.ts（WB_ACCOUNT_ID_PARAM / WB_KIND_PARAM / WB_REGION_PARAM），路由处理函数与浏览器请求方共用同一份，改名单点生效。

---

兼容性与依赖

项	要求
Node.js	^22.19.0 或 >=24.0.0
DSH	0.2.0-rc.1 线（peer：@deepseek-ai/dsh-llm、dsh-llm-pi-ai、dsh-host-webserver、dsh-settings、dsh-client-ui-* 等）
React	^18.2.0（由宿主 shell 提供，不随包分发）
操作系统	Windows / macOS / Linux（账号发现三平台均可；Windows 另有桌面端静态加密凭据的解封支持）

所有 @deepseek-ai/* 依赖都是 peer，装的是 DSH 安装里的那一份——自带副本会出现「两份 cordis / 两份 llm 服务」。

---

开发

pnpm typecheck   # tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit
pnpm test        # vitest run
pnpm build       # tsdown → lib/index.js + lib/index.d.ts + lib/client.js

目录

src/status-paths.ts   共享契约：路由、查询参数、投影类型、unwrapVolatile(Deep)、rankAccounts
src/version.ts        构建期注入的版本常量
src/upstream.ts       上游 HTTP 客户端：目录 / 积分 / 签到 / benefits / token 刷新
src/accounts.ts       账号发现（桌面端 auth 目录 + DSH vault 双源）、凭据解封、排序
src/at-rest.ts        桌面端静态加密凭据的解封（at-rest 密钥派生 + AES-256-GCM）
src/catalog.ts        模型目录（静态 fallback + 实时刷新 + 用户选择过滤）
src/adapter.ts        pi-ai 适配器（provider 注册 + 转发到 shim）
src/shim.ts           与 pi-ai 的桥接层
src/scheduler.ts      自动签到与积分任务（北京时间自然日幂等）
src/web-status.ts     web 路由处理函数
src/index.ts          宿主入口：settings、provider 注册、web 路由、scheduler 启停
src/client/           浏览器半区（设置页 + 输入框读数 + 模型标签）
tests/                单元与集成测试

src/status-paths.ts 只放常量与纯函数，不 import 任何 @deepseek-ai/* 包：它会被打进浏览器 bundle，一旦引入宿主侧依赖，客户端半区就在加载期失败。

两个必须记住的坑

1. 装配给设置的配置必须 unwrapVolatileDeep。schemastery 的 volatile 字段解析出来是活引用 { get(): T }，typeof === 'object' 所以不会被当成异常。直接交给 settings 服务时，服务会 structuredClone 整份对象做校验，活引用过不去 → 命名空间注册不上 → 设置页卡片静默消失 （无异常、无横幅）。浏览器侧 { ...reference } 展开成 { get: <function> }，会丢掉所有兄弟字段。
2. 客户端 bundle 必须把 react-dom 外部化。react-dom 由宿主 shell 的模块加载器 （staticModules）注册；打进 bundle 会内联它的 CJS 构建，开头是 if (process.env.NODE_ENV !== "production") …，浏览器里没有 process，于是在模块求值阶段抛 ReferenceError: process is not defined，整个客户端半区加载失败： web boot: 1 entry did not activate。详见 tsdown.config.ts 的注释。

---

设计取舍（已知限制）

• 纯月包账号（没有一次性积分包的到期信息）在 expiry 方式下会沉到有到期信息的账号之后。 这是刻意的——月包会刷新，不存在「快要流失」的额度。设置页会用排序原因把这一点解释出来。
• 上游的促销徽标只有应用通道（PRODUCT_UA）才看得见；用 CLI 通道的身份读同一份 /v3/config 回来的是严格子集，既没有 modelPromotions 也没有 modelTiers。
• 凭据来源只读：插件从不写回桌面端的 .info 登录文件，也不索要密码。上游 401 触发的 token 刷新 结果单独写在 $DSH_HOME/<plugin-id>/credential-refresh.json（文件 0600、目录 0700，里面是 bearer token，属于本机私有数据）；自动化账本 automation-ledger.json 同目录，只存「今天哪个时段 跑过」，不含任何凭据。

---

License

MIT。见 LICENSE。