前言¶
用 DeepSeek Harness（DSH）跑智能体时，单次对话的 Token 会分散在多轮、多步、重试和流式输出里。宿主会持久化用量事件，但默认界面并不提供按天汇总、按模型拆分和成本估算。若你习惯在 CC Switch 一类工具里看统计，会希望在 DSH 内也有同类视图，且数据口径与官方 tokenUsage 一致。
下面介绍社区插件 dsh-plugin-usage（维护者 bennett-dsh）：在客户端注入「用量统计」仪表盘，从已有会话日志折叠聚合，不另写一套记账逻辑。
这是什么¶
dsh-plugin-usage 是 DeepSeek Harness 的 Token 用量统计插件，分类为客户端插件。它解决三件事：按时间范围看 Token 与调用次数、按模型筛选与明细、在可配置价目表下估算参考成本；并提供年度热力图与深/浅色主题适配。灵感来自 CC Switch 的统计能力。
- 目录页：https://www.skillhub.cn/plugins/bennett-dsh/dsh-plugin-usage
- 源码与说明：https://github.com/bennett-dsh/dsh-plugin-usage
- npm 包名：
dsh-plugin-usage（当前发布版本见仓库package.json，如0.3.0） - 许可证：MIT
核心功能¶
以下能力均来自插件 README，安装后可在设置页的「用量统计」仪表盘使用。
时间与聚合¶
- 预设：今日、近 7 天、近 30 天、全部
- 自定义时间范围，跨度不限；支持按小时、按天聚合
模型与 KPI¶
- 模型筛选；按模型明细（请求数、输入/输出、缓存、成本、占比）
- KPI 网格中的「模型占比」卡：按总 Token 显示前 4 个模型与「其它」
成本与币种¶
- 参考成本可在 ¥ / $ 之间切换（固定汇率 1 USD = 7 CNY，由宿主侧折算）
- 可配置每百万 Token 价格表；内置 DeepSeek 常见模型默认价
- 价目表以美元 / 百万 Token 为基准；显示 ¥ 时按 7:1 折算，价目表本身不改写
展示¶
- 年度热力图
- 深/浅色自适应，仅使用 DSH 主题变量，无第三方图表库
数据来源与计费口径¶
插件不自行记日志，而是折叠 DSH 会话日志里已持久化的用量事件：
- 活跃会话通过
snapshotEvents()；历史会话通过sessionPersistence.open/read，并按revision跳过未变日志 - 计费对齐官方
tokenUsage投影：同一(turn, step)替换；llm/retry-started之后的重试累加；assistant/attempt的 stream 用量也计入 - fork 会话按
inheritedEventCount跳过父会话前缀，避免重复计费 - 费用 = Σ(各 Token 分桶 × 对应单价) / 1e6
- 价格优先匹配
provider/model，其次裸model；未配置的模型标为「未定价」，成本记为 0
安装与启用¶
插件已发布到 npm，包名为 dsh-plugin-usage。安装命令以 README 为准，不要自行拼接 github:owner/repo 形式。
DSH Desktop
- 打开 设置 → 插件 → 添加插件
- 输入
dsh-plugin-usage并确认
Web / CLI profile
在对应 profile 下添加插件后需重启生效：
dsh plugin --profile <name> add dsh-plugin-usage
升级时：桌面端在插件页点更新；CLI 使用 update 子命令（与 add 同一 profile 约定）。
注意：desktop profile 由 Electron 应用独占，不能用 dsh plugin --profile desktop 操作。
配置¶
在 设置 → 插件 → dsh-plugin-usage 可修改：
currency：默认显示币种prices：每百万 Token 价格
配置写入 profile patch，重启后保留。仪表盘上参考成本卡的 ¥ / $ 切换只影响当前界面（同浏览器会记住选择）。
兼容性与运行环境¶
package.json 中声明：
- DSH：
>=0.2.0-rc.2 <0.3.0（engines.dsh） - Node：
>=22
更早的宿主仍保留 Session.events / readFrom 回退路径。
适用场景与注意¶
适合谁
- 需要按天或自定义区间复盘 Token 与调用次数的 DSH 用户
- 多模型混用时，需要筛选、明细和模型占比
- 希望在同一界面做参考成本估算，并愿意维护或沿用内置价目表
使用前请知悉
- 插件以当前 DSH 进程的权限运行，安装前建议阅读源码与 MIT 许可证，确认符合你的安全与合规要求。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录与 GitHub 页面为准（README 侧仓库约 3 stars、1 fork）。
结尾¶
dsh-plugin-usage 把 DSH 已有会话用量折叠成可筛选的仪表盘：时间范围、模型明细、可配置定价与热力图，口径跟官方 tokenUsage 对齐。若你正在 DSH 里长期跑智能体，用它做用量与参考成本复盘，比手工翻日志更直接。
