前言¶
在 DeepSeek Harness（DSH）里跑多轮会话时，每条助手消息往往自带 provider 上报的 usage（输入、cache hit、输出等 token）。这些数据散落在 $DSH_HOME/sessions 下的会话日志里，单靠翻日志很难按天、按模型汇总，也更难对照公开价目估成本。若你已经在用 DSH 的 web profile 做日常开发，却还没有统一的用量视图，下面介绍的 dsh-usage-report 把本地会话聚合成 Settings → Usage 页面，用来查看区间内的请求数、token 与估算费用。
这是什么¶
dsh-usage-report 是由社区维护者 yuyaxiong 发布的 DSH bundle 插件（GitHub：yuyaxiong/dsh-usage-report，当前 package 版本 0.1.0，许可证 MIT）。它不替代账单系统：成本为按内置或自定义单价 估算，数据来源是会话里已记录的 usage 字段。插件要求运行环境 dsh ^0.2.2-rc.1，并以 web 客户端注入设置相关 UI 模块。
核心功能¶
安装并启用后，插件会读取 $DSH_HOME/sessions 中的全部会话并聚合，在设置里增加 Usage 页，已核实能力包括：
- 按所选时间范围展示 cost / request / token 卡片；
- 单日按小时柱状图，更长区间按日图表；
- 分模型面板（请求与 token 图表）；
- 自定义日期范围选择器；
- 对筛选结果 CSV 导出；
- 对未出现在内置价目表中的模型，提供 手动填价 表单。
内置价目遵循 DeepSeek 公开定价，并区分峰谷（示例：deepseek-flash / deepseek-v4-pro 的 cache hit、cache miss、output 等每百万 token 单价）。Web 搜索调用按 DeepSeek 另计（资料写明：成功请求 $0.75 / 1000 次），在统计中单独计数。
安装与启用¶
面向 web profile 时，README 给出的安装方式为：
dsh plugin --profile web add dsh-usage-report
随后在 profile 的 package.json 里，将 dsh-usage-report 加入 dsh.profile.bundles（若从 plugin-market 索引安装，通常会一并完成注册）。插件以当前 DSH 进程权限读写本地会话与存储；安装前建议浏览仓库源码并确认 MIT 许可证是否符合你的合规要求。
典型用法¶
在界面中查看与导出¶
完成安装并重启或加载 bundle 后，打开 DSH 客户端 Settings → Usage。用日期选择器限定范围后，查看卡片与图表；需要离线分析时，对当前筛选区间执行 CSV 导出。某模型在日志里有 token 但未匹配到任何单价时，页面会提示你补价，补全后该模型的成本才会计入合计。
覆盖或扩展单价¶
默认可通过文件 $DSH_HOME/storages/usage/prices.json 覆盖汇率、档位与单模型价。下面结构与 README 一致，用于说明字段含义（usdCny、按 tier 的峰谷价、裸 models、以及 providers 下按网关区分的模型价）：
{
"usdCny": 7.1,
"tiers": { "flash": { "hitPeak": 0.006, "hitOff": 0.003, "missPeak": 0.3, "missOff": 0.15, "outPeak": 1.2, "outOff": 0.6 } },
"models": { "my-model": { "missPeak": 0.5, "outPeak": 2 } },
"providers": { "my-gateway": { "models": { "gw-model": { "missPeak": 0.5, "outPeak": 2 } } } }
}
解析顺序为：providers[provider].models[model] → providers[provider].default → models[model] → 内置 tier。无法解析到任何价格的模型记为 unpriced：token 仍会计数，但成本不计入，直至你在设置页或 prices.json 中补价。
适用场景与注意¶
适合已经在 DSH web 环境中长期跑会话、希望用本地日志做用量复盘和成本粗算的开发者。下列限制来自官方 README，使用时宜事先接受：
- 会话日志记录
provider与model，但不记录base_url与具体付费凭证，同一 adapter 的两条线路事后无法区分；若需分开统计，应为每条线路使用独立的 provider（自定义 adapter）。 - 成本仅包含模型 usage 与搜索请求；图像 token 以及未体现在
usage中的 provider 侧费用不计入。
生态上，DSH 强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的安装命令亦以仓库 README 为准，请勿自行拼接未在文档出现的 github:owner/repo 安装串。
结尾¶
dsh-usage-report 把分散的会话 usage 收成一块可筛选、可导出、可自定单价的 Usage 看板，便于在长周期开发里对照公开价目做估算。目录页：https://www.skillhub.cn/plugins/yuyaxiong/dsh-usage-report；源码与说明：https://github.com/yuyaxiong/dsh-usage-report。
