前言¶

在 DeepSeek Harness（DSH）里跑多会话、多模型时，token 消耗分散在各次 llm/stream 调用里，事后很难回答「这个月花了多少钱」「哪几个会话最费」。官方控制台有余额，但和本机 Harness 会话的对应关系并不直观。

下面介绍社区插件 dsh-usage-billing（维护者 940842546）：监听本机所有会话的模型调用，按 DeepSeek 官方定价分段计费，并在主界面与设置页提供图表化用量面板。当前版本 0.6.0，MIT 许可证，GitHub 约 9 stars。

这是什么¶

dsh-usage-billing 是针对 DeepSeek Harness 的免构建双面插件（Host 半体 lib/index.js + Client 半体 lib/client.js）。它自动统计本机所有会话的 DeepSeek 模型调用，按北京时间归入「调价前旧价 / 调价后高峰 / 调价后空闲」三段计费，数据持久化到写策略根目录下的 .dsh-usage-billing.json（v0.5.4 前为 .dsh-usage-stats.json，升级后自动迁移）。

计费口径以 README 为准：2026-08-17 00:00（北京时间）前按旧价；之后按峰谷定价——高峰为工作日 9:00–12:00、14:00–18:00（2026-08-23 起生效，此前周末同样计高峰），空闲价为高峰价的一半。

核心功能¶

统计与计费¶

• 全自动统计：监听 llm/stream，记录每次调用的输入/输出/缓存命中/未命中 tokens。
• 历史回填：首次启动扫描本机会话日志，重建历史用量与消费，并附会话标题。
• 分段计费：按北京时间自动归入三段价格；模型按名称子串归类（含 flash 按 flash 档，含 pro 按 pro 档，其余归入「未定价/免费」）。
• 定价可配置：价格表、高峰时段、调价边界日期、美元汇率均可编辑（改动只对后续调用生效），支持一键恢复默认。

界面与交互¶

• 主界面：侧边栏底部「Token 用量」卡片（当前模型 + 本会话 tokens/费用）→ 点击弹出「Token 用量与费用统计」弹窗（¥/USD 切换、总览、按模型/按会话表格、预算进度、官方余额、分段占比、用量热力图）；输入框下方常驻当前会话用量一行。
• 设置页 → 用量统计：统计卡片、预算进度、分段占比、日/周/月/年/累计热力图、按会话 Top 8（可点击打开对应会话）、按模型、最近调用、回填/清空/导出、计费与预算设置。
• 中英双语：界面文案跟随应用语言设置切换。

预算、余额与导出¶

• 预算告警：跨 80%/100% 阈值时桌面 toast 提醒（每日每档一次），进度条临近变橙、超支变红；设置页展示最近告警记录。
• 官方余额拉取：检测已配置的 DeepSeek API Key，拉取账户余额（总余额 / 充值 / 赠金），每 10 分钟刷新；未配置 Key 时静默跳过。
• 余额续航预估：按近 7 天日均花费估算可用天数与预计耗尽日期。
• 数据导出：一键导出 CSV（按日 / 按会话）或 JSON，文件名含日期范围。

动态工具与稳健性¶

• 动态工具 usage_billing：模型可直接查询统计，支持 today / month / all 等范围（例如「现在用了多少钱？」「今天呢？」）。
• 写入保护：统计文件带 temp 副本，主文件损坏时自动恢复；双实例心跳检测告警。

安装与启用¶

推荐通过 npm 一键安装（预构建包）：

dsh plugin --profile web add dsh-usage-billing

npm 包地址：https://www.npmjs.com/package/dsh-usage-billing

应用启动时通过本包的 dsh.bundle.patch（cordis.patch.yml）自动挂载，无需其他配置。安装后若面板未显示，需重启应用并刷新页面（客户端 bundle 由 clientModules 服务发现）。

本地路径形式同样支持：

dsh plugin --profile web add <本仓库路径>

也可将仓库根目录 cordis.patch.yml 内容加入用户级补丁 %USERPROFILE%\.dsh\cordis.patch.yml：

- insert:
    - id: usage-billing
      name: 'dsh-usage-billing'

注意：不要直接修改官方 bundle（如 @deepseek-ai/dsh-web-app/cordis.patch.yml），也不要把插件放进 npm-cache\_npx 缓存。

典型用法¶

查看主界面用量¶

安装并重启后，主界面侧边栏底部会出现「Token 用量」卡片，点击可打开统计弹窗，在右上角切换 ¥/USD。输入框下方会常驻显示当前会话的 tokens 与费用。

设置页明细与导出¶

进入 设置 → 用量统计，可查看近 30 天日趋势、热力图、按会话/按模型排行，并执行回填、清空或导出 CSV/JSON。

让模型查询花费¶

插件注册了动态工具 usage_billing，可在对话中直接问用量相关问题，例如查询今天或本月累计费用（范围参数支持 today、month、all）。

计费参考¶

价格单位为元 / 百万 tokens（摘自 README，完整表见仓库）：

官方定价参考：DeepSeek API 定价

适用场景与注意¶

适合谁：需要在本机 DSH 上持续跟踪 token 消耗与费用、做预算管控或对账的开发者。

使用注意：

• 插件以当前 DSH 进程权限运行，安装前应检查 源码 与 MIT 许可证。
• 统计文件位于写策略根目录（通常为用户主目录），多实例同时运行会互相覆盖写入，请保持单实例。
• 老版本若出现统计翻倍，v0.2.0 起已通过 schemaVersion 迁移标记在重启时自动单次重建修正。

DSH 生态遵循「一切皆插件」思路；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• 社区目录页：https://www.skillhub.cn/plugins/940842546/dsh-usage-billing
• GitHub 仓库：https://github.com/940842546/dsh-usage-billing

若你已在 Harness 上长期跑多会话任务，这个插件能把分散的 token 调用收成可读的账单与图表，并在接近预算时主动提醒。