前言¶
用 DeepSeek Harness（DSH）跑智能体时，API 按峰谷计价：工作日白天单价高，其余时段减半。会话一多，很难凭感觉判断「现在是不是峰时、今天烧了多少 tokens、钱主要花在缓存还是全价输入」。去外部账单页查又和本地开发节奏脱节。
dsh-usage-peak 是社区维护者 hhse 发布的客户端插件，只读本机 DSH 会话日志与鲸鱼记账本，在侧栏和设置页展示峰谷状态、今日花费与趋势，不联网、不上报。
这是什么¶
插件全名对应仓库 hhse/dsh-usage-peak，分类为客户端（Web UI）。当前 package 版本为 1.0.1，MIT 许可。
它解决的是：在 Harness 里就地看清用量与花费构成，并把 DeepSeek Flash / Pro 的峰谷价目表内嵌展示，方便对照日志理解账单。
核心功能¶
侧栏常驻胶囊¶
安装后，侧栏图标列表最上方会出现一行浓缩信息，例如：● 峰 ¥14.70 · 12.8M tok · 2:43 后转谷。点击可打开完整面板；侧栏折叠时收成小圆点。
设置页「用量仪表盘」¶
与侧栏同源数据，展开后包括：
- 峰谷状态：当前时段、距离下次切换的倒计时、当前时段单价（缓存命中 / 全价输入 / 输出）。
- 今日概况：花费、请求数、tokens、缓存命中率、峰时花费占比、余额（可与鲸鱼记账本交叉校验）。
- 今日 24 小时分布：按小时柱状图，峰时与谷时着色不同，当前小时高亮。
- 花费构成：缓存命中、全价输入、输出三段占比。
- 近 14 天趋势：按天堆叠柱状，便于对照峰时占比。
- 按模型：Flash / Pro 各自的请求数、tokens、花费。
- 价目表：当前时段对应行高亮。
数据快照默认缓存 15 秒；面板上的「刷新」会带 ?fresh=1 强制重算。
价格模型（插件内置）¶
单位：元 / 百万 tokens，[谷时, 峰时]。
| 模型 | 缓存命中 | 全价输入 | 输出 |
|---|---|---|---|
| DeepSeek Flash | 0.02 / 0.04 | 1 / 2 | 4 / 8 |
| DeepSeek Pro | 0.15 / 0.30 | 4.5 / 9 | 13.5 / 27 |
峰时：周一至周五 09:00–12:00、14:00–18:00（北京时间）；其余时间、周末与节假日为谷时（单价减半）。
数据从哪来¶
插件在本地读取：
~/.dsh/sessions/<项目 slug>/<会话 id>/session.v4.jsonl.zstd：从每条assistant/message的usage与模型字段统计，并按请求时刻判断峰谷。~/.dsh/.dshw-usage.json：鲸鱼记账本的余额与当日花费。
日志可能是多帧 zstd；Node 自带 zlib.zstdDecompressSync 只解第一帧，插件会按 magic 切帧、逐帧解压再拼接，无需系统安装 zstd 命令行。
安装与启用¶
DeepSeek Harness 采用「一切皆插件」的扩展方式；社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览仓库源码与许可证——插件以当前 DSH 进程权限读本地日志。
官方 README 给出的安装命令为：
dsh plugin add github:hhse/dsh-usage-peak
（README 注明 npm 同名包发布后也可按包名安装；以你使用的安装渠道文档为准。）
装好后：
- 侧栏最上方出现用量胶囊；
- 设置 → 用量仪表盘 打开完整面板。
兼容性与已知限制¶
- DSH：
package.json中声明与 0.2.1-rc.3 兼容（dsh.compatibility.dshReleases）。 - Node.js：>= 22.15（依赖
zlib.zstdDecompressSync）。 - 实现为纯 JS，无构建步骤；
client.js通过window.__ModuleLoader__注册，React 由宿主提供。
限制方面：
- 依赖 DSH 会话日志内部格式（
session.v4.jsonl.zstd与assistant/message.data.usage）。DSH 若改格式，插件需跟进；读不到数据时面板为空态而非报错。 - 历史范围限于本机会话日志；鲸鱼记账本从 2026-11-02 起才有记账数据。
典型用法¶
日常开发无需额外配置：开着 DSH 写代码时看侧栏即可判断是否在峰时、今日 tokens 与切价倒计时。需要复盘「钱花在哪儿」时，打开设置里的用量仪表盘，看 24 小时分布与花费构成，或对照 14 天趋势和按模型表格。
结尾¶
dsh-usage-peak 把峰谷计价和本地 session 用量绑在一起，适合长期在 DSH 里调 API、关心缓存命中率与峰时占比的开发者。详情与截图见 GitHub README；目录页：https://www.skillhub.cn/plugins/hhse/dsh-usage-peak，源码：https://github.com/hhse/dsh-usage-peak。
