前言¶
在 DeepSeek Harness（DSH）里切换模型、跑长对话时，WorkBuddy 侧剩余积分和「当前模型 × 当前时段」下的实际消耗倍率往往不在同一屏里。凭感觉估 token 容易和账单对不上；若为了看余额再去打开 WorkBuddy 或代理面板，又会打断编码节奏。社区插件 dsh-workbuddy-token（维护者 xsdao，目录分类 admin-security）把只读查询嵌进 DSH 输入框旁的胶囊 UI：按上游实时配置把剩余积分折成 token 估算，并遵守固定刷新间隔，不做签到、领取或任何写操作。
这是什么¶
dsh-workbuddy-token 是 DSH 插件：在输入框旁显示 WorkBuddy 剩余积分，并按「当前选中模型 × 当前时段」的折后倍率，给出 token 数量估算（只读）。数据来自 WorkBuddy 计费与配置接口，模型表、倍率、活动规则每次刷新全量重建，不做本地硬编码。
维护者 xsdao；源码与说明见 GitHub 仓库，社区目录页：skillhub.cn/plugins/xsdao/dsh-workbuddy-token。插件以 MIT 许可证发布；package.json 中版本为 0.1.3，声明兼容 DSH >=0.2.0-rc.1 <0.3.0-0。
核心功能¶
胶囊 UI 与交互¶
正常状态下，胶囊类似如下信息（具体数值随账号与模型变化）：
┌──────────────────────────────┐
│ glm-5.2 · x0.35 · 夜间 │
│ ≈ 11.7M tokens(估算) │
└──────────────────────────────┘
点击胶囊 = 手动刷新(立即拉积分 + 配置两个接口)
第二行常驻剩余积分；对 WorkBuddy 模型附带 token 估算。倍率会随模型与时段浮动的场景（例如 auto）可显示区间。点击胶囊会立即拉取积分并刷新配置，等价于手动触发一次完整刷新。
只读与直连¶
插件仅调用：
/v2/billing/meter/get-user-resource（积分）/v3/config（模型与活动配置）
不执行签到、领取、2api 等写操作。请求直连上游（www.codebuddy.cn / www.workbuddy.ai，按凭据中的 region/domain 路由），不经过 CPA 代理。
凭据发现与安全¶
凭据按顺序发现：CPA 目录下 ~/.cli-proxy-api/workbuddy-*.json（glob）；若无则尝试 WorkBuddy 桌面端登录文件。日志与 UI 不输出 token 明文。
请求纪律¶
- 积分：默认每 5 分钟请求一次（可配置，最小 60 秒）
- 模型/活动配置：默认每 2 小时一次（可配置，最小 600 秒）
- 失败时按 1→2→4→8 分钟指数退避
三态显示¶
- 正常：实时数据；WorkBuddy 模型附 token 估算；浮动倍率模型显示区间。
- 降级：上游失败时展示最后一次成功缓存，并标注「X 分钟前」。
- 异常：凭据失效（401/403）提示重新登录；当前模型已从目录消失时显示「已下架」，积分仍展示；选中非 WorkBuddy 模型时不猜测倍率，只显示剩余积分。
配置项¶
在 profile 的插件配置中可调整：
| 键 | 默认 | 说明 |
|---|---|---|
creditsIntervalSec |
300 | 积分刷新间隔（秒，最小 60） |
configIntervalSec |
7200 | 模型/活动配置刷新间隔（秒，最小 600） |
cpaDir |
~/.cli-proxy-api |
CPA 凭据目录 |
baseTokensPerCredit |
1000 | 基准费率：x1 倍率下 1 积分约换的 token 数（估算系数；官方未公布，可用 CPA 用量记录校准） |
安装与启用¶
DSH Desktop 的 profile 由 Electron 应用独占管理，官方文档说明 dsh plugin add 会被拒绝。本插件通过仓库自带的安装脚本走 DSH 插件管理器同款路径：修改 profile 的 package.json、注册 file: 依赖并写入 dsh.profile.bundles，再执行 pnpm install。
在插件仓库根目录执行：
node install.mjs # 默认 desktop profile;--profile <name> 可指定其他
脚本会备份 profile 的 package.json / pnpm-lock.yaml，完成依赖注册与安装后做自检（宿主/客户端模块加载、exports、凭据发现）。命令可重复运行（幂等）。回滚时用安装时生成的 .bak-<时间戳> 覆盖原文件，再在该 profile 下执行 pnpm install。
安装前请自行阅读源码与许可证；插件在 DSH 进程权限下运行，会读取本地 WorkBuddy/CPA 凭据并访问上游计费接口。
典型用法¶
- 完成上述
node install.mjs安装并重启或 reload DSH Desktop（按你本地 DSH 习惯操作）。 - 确保 CPA 目录或 WorkBuddy 桌面端登录状态有效，以便插件发现凭据。
- 在 DSH 输入框旁查看胶囊：切换模型或进入不同时段（如夜间倍率）时，观察倍率与 token 估算是否随
/v3/config更新。 - 需要立刻对齐余额时，点击胶囊手动刷新。
- 若估算与心理预期偏差较大，可在配置中调整
baseTokensPerCredit，并结合 CPA 用量记录做校准（README 说明该系数为估算，非官方公布值）。
开发者本地构建与自测（与终端使用无关，仅供改插件时使用）：
pnpm i && pnpm build # lib/index.js + lib/client.js
pnpm test # node test/verify.mjs,断言换算/窗口/解析逻辑
适用场景与注意¶
适合：已在 DSH Desktop 中使用 WorkBuddy 模型、希望在一屏内看到剩余积分与按当前模型/时段折算的 token 估算，且接受「只读、不代领权益」行为的开发者。
注意：
- 分类为 admin-security，涉及本地凭据读取与对外 HTTPS；安装前请审查 源码 与 MIT 许可证。
- token 估算依赖上游配置与
baseTokensPerCredit，属于辅助参考，不能替代官方账单。 - 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的独立插件。
结尾¶
dsh-workbuddy-token 把 WorkBuddy 积分与「当前模型 × 时段」倍率下的 token 估算收进 DSH 输入框旁，只读、直连、可配置刷新节奏，并区分正常、降级与凭据异常三种展示状态。需要安装说明与配置表时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/xsdao/dsh-workbuddy-token
- GitHub：https://github.com/xsdao/dsh-workbuddy-token
