前言¶

在 DeepSeek Harness（DSH）里跑长会话时，底部原生统计条通常只给出 token 用量和上下文占用百分比，费用、账户余额和峰谷计价需要另开页面或自己估算。下面介绍社区插件 dsh-usage-balance-v2（维护者 3493750852），它把本会话消耗、本会话用时和剩余余额嵌进官方用量条，并在侧边栏按工作区汇总累计，分类为客户端插件。

这是什么¶

dsh-usage-balance-v2 是 DSH Web 底部用量条旁的余额/消耗读数插件。默认插在原生统计条的 token 用量与上下文百分比之间，沿用原生字号、颜色和分隔符，不额外增加行高。读数示例形态如下（图标为内联 SVG）：

… 4.8M tok · 缓存命中 98%   [¥] ¥0.77  [⏱] 4m50s  [◉] ¥230.88 峰 ⌄   13%

三个内联读数分别对应：本会话消耗、本会话总用时、剩余余额。插件不依赖 @deepseek-ai/* npm 包，不会触发 DSH 的版本兼容性拦截。源码与说明见 GitHub，社区目录页：skillhub.cn/plugins/3493750852/dsh-usage-balance-v2。DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

底部内联读数与详情卡¶

点击读数区域可展开详情卡，主要能力包括：

1. 本会话消耗：读取 DSH 官方 tokenUsage 投影的整段会话 token（缓存命中 / 未命中 / 输出），按当前峰/谷单价计费；详情卡会列出乘法公式（例如 缓存 4.7M × ¥0.04/M + 未命中 73k × ¥2/M + 输出 54k × ¥8/M）。统计口径与原生 tok 一致，不是只统计插件启用后的轮次。
2. 本会话用时：读取官方 sessionStats 投影的 LLM + 工具 时间，并显示步数。
3. 剩余余额：优先用环境变量 DEEPSEEK_API_KEY 调用 DeepSeek /user/balance；无 API key 时回退到 DSH 账号登录态的余额服务（充值钱包 + 赠金钱包）。展开后可看构成；失败时显示具体原因。
4. 当前时段：按北京时间判断峰/谷，展示高峰规则与下次切换倒计时。
5. 最近一轮：上一轮消耗、时长、token、模型与峰谷状态。

插件不会在每轮结束时弹窗；明细集中在详情卡中。

侧边栏工作区累计¶

每个工作区标题行右侧显示该工作区下所有会话的累计消耗（一行小字）。数据由主包内置宿主路由提供：读取 $DSH_HOME/.dsh-usage-balance-v2.json，再按 DSH 的 workspaceRegistry 归属会话；浏览器会把当前会话的官方 tokenUsage / sessionStats POST 给路由，按会话取 max(账本, 官方值)，避免单会话消耗超过工作区累计。

峰谷计价¶

高峰：周一至周五（不含法定节假日）09:00–12:00、14:00–18:00。谷时：其余时段，含周末、调休上班的周末、法定节假日全天。高峰价 = 谷时价 × 2。

价目（人民币 / 百万 tokens，[谷时, 高峰]）：

价目与节假日定义在仓库 lib/pricing.mjs 的 PRICING、PEAK_HOURS、HOLIDAY_VALLEY；2027 年及以后需在国务院公布安排后补 HOLIDAY_VALLEY。

统计口径（本会话）¶

外部读数与详情卡主值使用的费用公式为：

费用 = 缓存命中 tokens / 1e6 × 命中价
     + (未缓存输入 + 缓存写入) / 1e6 × 未命中价
     + 输出 tokens / 1e6 × 输出价

token 取官方 tokenUsage 整段会话累计；价格按当前峰/谷时段。reasoningTokens 已含在 outputTokens 中。最近一轮按每一步 assistant/message 的真实 usage 与该步到达时的峰谷价累计，跨 12:00 / 18:00 的轮次会拆价。

本地账本文件 $DSH_HOME/.dsh-usage-balance-v2.json 只记录插件启用之后的轮次；totals 累计，today 按北京时间每日清零。删除该文件可重置统计（余额不受影响）。

安装与启用¶

推荐用 npm 安装（一个包同时包含底部读数与侧边栏工作区累计）：

dsh plugin --profile web add dsh-usage-balance-v2

桌面 profile 将 web 换成 desktop。

若使用手动链接或源码部署，还需在对应 profile 的 cordis.patch.yml 末尾追加：

- insert:
    - id: dsh-usage-balance-v2
      name: dsh-usage-balance-v2

DSH profile 默认 patchReload: live，保存后宿主热加载；刷新页面即可。仍不显示时可重启 DSH。

典型用法与验证¶

安装并刷新后，在底部用量条 token 与上下文百分比之间应出现三个读数；点击可展开详情。侧边栏工作区标题右侧可见该工作区累计。

在浏览器控制台可检查宿主路由是否就绪：

fetch('/dsh-usage-balance-v2/state.json').then((r) => r.json()).then(console.log)
fetch('/dsh-workspace-usage-v2/state.json').then((r) => r.json()).then(console.log)

前者应返回形如 { ok: true, totals, balance, pricing, lastTurn, ... }，后者为 { ok: true, workspaces: [...] }。

适用场景与注意¶

适合需要在 DSH 界面内实时对照 token、人民币消耗、会话时长和账户余额的开发者；需要按工作区看累计开销、或关心峰谷计价的长期使用者也会用到侧边栏与详情卡中的时段说明。

安装前建议自行阅读 仓库源码 与 MIT 许可证。插件以当前 DSH 进程权限运行，使用 DEEPSEEK_API_KEY 查询余额时需注意密钥暴露范围；无 key 时依赖 DSH 登录态，行为以官方余额服务为准。价目与节假日表需随官方调价与国务院安排维护，过期年份的 HOLIDAY_VALLEY 可能影响峰谷判断。

结尾¶

dsh-usage-balance-v2 把会话费用、用时和余额收进原生用量条，并用详情卡和工作区累计补全计价明细，适合在 DSH 里长期对话、需要控成本的场景。目录页：https://www.skillhub.cn/plugins/3493750852/dsh-usage-balance-v2；仓库：https://github.com/3493750852/dsh-usage-balance-v2。