DeepSeek Harness (DSH) 采用插件化架构，允许开发者通过扩展来增强功能。dsh-shanhai-stats 是一个用于用量统计的插件，它从 DSH 会话日志中提取数据，提供总量汇总、每日走势、GitHub 风格热力图以及按模型/提供商分组的明细。
安装与启用¶
使用官方插件命令安装：
dsh plugin --profile web add github:cn-zhangpeng/dsh-shanhai-stats
安装后，在 DSH 的设置 → 用量统计 中查看。
核心功能¶
数据来源与口径¶
插件的数据来源于 DSH 会话日志的 assistant/message 事件，包含 usage 和 message.source.provider/model 字段。插件自身不计算 token，仅做聚合与展示。其数据口径与 DSH 一致：
* inputTokens：未命中缓存的输入。
* cacheReadTokens：缓存命中输入。
* cacheWriteTokens：缓存写入。
* outputTokens：已包含 reasoningTokens。
时间维度与历史回填¶
- 时间维度：提供全量
totals、按工作区 (perWorkspace)、按模型 (perModel) 三种聚合维度，且数据永不清零。 - 按天明细：保留 53 周滑动窗口。
- 历史回填：插件激活时会扫描本地全部工作区会话。此后通过实时事件增量折叠，利用
seq断点续扫和 gap 检测进行补读。 - 子代理：支持子代理会话，随事件自然计入。
视图展示¶
插件提供四个板块：
1. 总量汇总徽章：展示总花费 Token、缓存命中率、总使用次数、总请求次数、模型用量、连续使用天数。默认进入页面即为“当天”视图。
2. 每日走势折线图：按天展示输入 / 缓存命中 / 缓存写入 / 输出四段 Token 走势。支持切换 当天 / 1 / 7 / 30 天视图。
3. GitHub 风格热力图：展示近一年每日活动热度，悬停可查看明细。
4. 用量明细表：支持“按供应商”或“按模型”两个标签页切换，查看各供应商或各模型的 Token 用量、消息数、缓存命中情况。
使用说明¶
- 默认进入页面即为“当天”视图，可通过下拉菜单切换 1 / 7 / 30 天或自定义范围。
- 在用量明细表中，点击“按供应商”或“按模型”标签页进行切换。
注意事项¶
- 首次启用会扫描本地历史会话，扫描完成后数字不再频繁变化。
- 新增了按
provider × model的perModel聚合维度。 - 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
生态背景¶
该插件是社区目录中的一项资源，与 DeepSeek 或幻方无官方从属关系。
