dsh-usage：为 DeepSeek Harness 增加 Token 用量、费用估算和 52 周热力图

[kestiany]

大家好，我做了一个 DeepSeek Harness Web 插件：dsh-usage。

它用于记录和展示模型调用的 Token 用量，并在配置了价格时估算模型费用。目前 0.1.0 已发布到 npm。

主要功能

• 在每次对话结束位置固定展示：
  Total · Input · Cache · Output · Cost
• 在 Settings → Usage 中提供完整的用量页面
• 展示总 Token、输入、缓存命中、输出、调用次数及预估费用
• 提供类似 GitHub Contributions 的 52 周用量热力图
• 支持按模型、会话和单轮对话查看用量
• 支持 DeepSeek Harness 中的其他模型和 Provider
• 基于 Harness 持久化会话日志计算，无需增加独立的统计数据库

只要 Provider 返回标准 usage 数据，就可以记录 Token。费用计算需要为对应的 Provider 和模型配置价格；缺少 usage 或价格时，Usage 页面费用显示 --；对话底部仍展示 Token，但会省略 Cost，避免把不完整费用当作总费用。

安装

dsh plugin --profile web add dsh-usage
dsh --profile web --dump-config
dsh --profile web

如果是在 DeepSeek Harness 源码目录运行：

pnpm dsh plugin --profile web add dsh-usage
pnpm dsh --profile web --dump-config
pnpm dsh --profile web

npm：

https://www.npmjs.com/package/dsh-usage

当前状态

这是一个早期社区插件，并非 DeepSeek 官方插件。目前主要针对 Harness Web 使用，已经在本地实际会话中验证。

其中 Cost 是根据 Provider 报告的 Token 和插件配置价格计算的估算值，不代表供应商最终账单。

源码仓库正在整理，稍后会补充公开地址。

欢迎大家反馈：

• 还希望默认支持哪些模型或 Provider 的价格？
• 每轮对话底部的展示是否足够清晰？
• Usage 页面还需要哪些统计维度？
• 是否遇到 Token 能记录、但费用无法计算的模型？

[Electricitysheep]

Token 用量 + 费用估算 + 52 周热力图——这正是社区缺的"成本透明化"工具，和第 735 帖（每轮 token 显示）的需求是同一件事的完整版。

我们在白皮书第 14 章（缓存与成本工程）里讲了成本模型的原理（缓存命中 97% × 折扣），这个插件可以成为"实测工具"的配套推荐：https://github.com/Electricitysheep/dsh-handbook/blob/main/docs/14-cost.md

如果愿意，可以把 dsh-usage 收录进手册第 14 章的工具推荐 + 生态章节（社区资产清单）。

[kestiany]

感谢认可，非常愿意收录。
dsh-usage 正好实现了 #735 提到的单轮 Token 展示，并进一步区分了 Input、Cache 和 Output，同时提供费用估算、会话统计和 52 周热力图。
目前 0.1.0 已发布到 npm，源码仓库还在整理中，可以暂时引用 npm 包和本帖；仓库公开后我再补充地址。
如果手册需要安装示例、截图、字段口径或费用计算边界，我也可以配合提供。感谢你们整理这份手册！

[kestiny18]

更新：dsh-usage 源码仓库现已公开，并发布了 v0.1.1。

GitHub：
https://github.com/kestiny18/dsh-plugins/tree/main/dsh-usage

npm：
https://www.npmjs.com/package/dsh-usage

v0.1.1 补充了更完整的安装、升级与排错文档，并通过 Node.js 22.18 和 24 的 CI 验证。npm 发布已使用 GitHub Actions Trusted Publishing 和 provenance。

[kestiny18]

补充说明：源码仓库已经公开，项目后续由我的主 GitHub 账号 @kestiny18 维护：

https://github.com/kestiny18/dsh-plugins/tree/main/dsh-usage