dsh-token-metrics：DeepSeek Harness 的 Token 用量统计页

它是做什么的？

Token Metrics 是 DeepSeek Harness（DSH）的 Token 用量统计插件，把经过 DSH 的每一次模型调用记录下来，并在侧边栏生成一个用量统计页。它解决的是「钱花在哪、缓存有没有命中、哪个模型和项目最耗 token」这类看不见的问题，数据全部来自 DSH 自己的会话日志，不额外发请求、不上传任何内容。插件由 hugoyee75-cmyk 维护，采用 MIT 协议，用 JavaScript 编写，零运行时依赖、无构建步骤。

核心功能

• 八项总计指标：input、output、cacheRead、cacheWrite、reasoning、total、调用次数与缓存命中率，覆盖今日、近 7 天与全部三个时间维度。
• 多维明细拆分：按模型、供应商、项目、来源（主会话 / 子代理 / workflow）、账号、日期切换视图，项目按会话工作目录归组。
• 图表可视化：一张可切换四种视角的主趋势图（总量 / 命中率 / 输入构成 / 按模型）加一张模型占比环形图，配色跟随亮暗主题。
• 模型合并口径：占比图与趋势按模型名跨供应商合并，明细表仍按供应商拆分，避免同一模型被拆散。
• 启动回扫与持久化：首次打开自动扫描历史会话日志补算用量并显示进度，重启不丢、跨会话累计。
• 自更新：右上角版本号本身是按钮，点击即检查更新，状态灯区分最新 / 有新版本 / 未检查，支持安装与热重载。

怎么使用这个插件？

在 DSH 中启用后，侧边栏会出现「Token 用量统计」图标，点开即是统计页：顶部用时间范围与模型下拉筛选，中间看八项总计指标，下方是趋势图、占比环形图与明细表。首次打开会自动回扫历史日志补上以前的用量，界面会显示扫描进度。需要调整行为时，在 profile 的配置里覆盖同 id 的配置项，例如落盘防抖、快照缓存时长、保留天数、趋势曲线条数、是否展示会话明细、是否统计失败请求等；注意同 id 覆盖会整体替换配置，改几项就要把其余项一并写全。统计页顶部还提供按钮，可直接触发落盘、检查更新或从会话日志重算全部统计。

报错怎么排查？

界面语言不跟随 DSH 设置时，通常是读取语言字段或订阅方式不对：当前语言字段应为 active，且面板需要订阅语言变化，否则已打开的页面不会重渲染。统计数字与预期不符时，先确认统计口径——失败的请求尝试属于重试中间态，默认不计入，避免重复；压缩与会话标题生成则由流式事件补充捕获。若明细数据缺失，可触发一次从会话日志重算全部统计。