前言¶
在 DSH（DeepSeek Harness）中开发或调试智能体时，经常需要实时关注 DeepSeek 的计费与用量，尤其是峰谷时段的价格差异和当日的 token 消耗。手工查官方定价页面、在日志里统计用量，不仅繁琐，而且无法做到边写边看。dsh-usage-pulse 在输入框下方挂载一个悬浮组件，直接把峰谷时段、价格、今日花费和分时用量图表呈现出来，刷新无需重载页面。
是什么¶
dsh-usage-pulse 是一个 DSH Web UI 插件，由 hunyu-feng 维护。它把 DeepSeek 的官方定价（deepseek-flash 和 deepseek-v4-pro，峰谷两档）和当前会话的 token 用量、花费、缓存命中率、输出占比等拆解为面板，同时展示 24 小时用量柱状图和最近 7 天趋势，所有数据本地计算并持久化，不涉及对话内容。
核心功能¶
峰谷时段与价格状态¶
插件在输入框下方显示一个状态徽章，标注当前是“峰时”还是“谷时”，并附带倒计时到下一次价格切换。计算基于北京时间（Asia/Shanghai），并纳入中国法定节假日：周一至周五 09:00–12:00 与 14:00–18:00 为峰时，其余时间（周末、节假日）为谷时，谷时价格正好是峰时的一半。点击徽章可以展开“下一谷段开始时间”以及当前时段的起止时间，如果正处于峰时，徽章会显示“谷段 X:XX 起”。
今日用量与花费概览¶
组件每隔 5 秒刷新一次今日的 token 总量与花费（CNY），在面板上用中文和数字展示。点击徽章展开后，可以看到当前会话的请求数、token 数、成本，以及缓存命中/未命中、输出占比等细分数据，同时给出本次会话中发生在峰时与谷时的花费占比。
分时用量图表¶
24 小时柱状图直观展示每小时的用量，高峰时段用琥珀色标注。下方再附上最近 7 天的日用量趋势，方便快速识别消耗高峰。
官方计费口径与模型价格¶
插件内置了 DeepSeek 官方定价表（CNY per 1M tokens），覆盖 deepseek-flash 和 deepseek-v4-pro，峰谷两档。价格遵循官方页面 https://api-docs.deepseek.com/quick_start/pricing/ 的定义，峰时价格是谷时的 2 倍。插件通过 harness 的会话事件流读取 assistant/message → usage，其中 inputTokens 已排除缓存命中，成本计算公式为 cost = miss·missRate + hit·hitRate + output·outRate，缓存写入按缓存未命中计费，不包含搜索与获取请求的费用。
多语言支持¶
插件通过 harness 的 locale 服务支持中英文双语 UI，根据环境自动切换语言。
安装与启用¶
这是一个 DSH 插件包，package.json 声明了 dsh.bundle 清单，cordis.patch.yml 负责将插件注入到 harness 中。安装方式与其它插件一致：
dsh plugin add hunyu-feng/dsh-usage-pulse
安装完成后无需重启，组件会直接出现在输入框下方的 composer dock 中。
典型用法¶
- 安装插件后，在 DSH Web UI 的对话页面中，输入框下方会出现用量看板。
- 面板顶部的徽章显示当前时段与倒计时，点击可查看下一谷段开始时间。
- 面板显示今日 token 总数与花费，点击徽章展开当前会话的细分数据。
- 滚动查看 24 小时柱状图与最近 7 天趋势，判断高峰时段。
- 根据峰谷价格，在编写长对话或批量请求时，尽量在谷时段发起，以降低成本。
适用场景与注意¶
适合需要在 DSH 中频繁调用 DeepSeek API、关注成本与用量的开发者与调试者。插件以当前 dsh 进程的权限运行，所有数据存储在本地文件 ~/.dsh-usage-pulse/usage.json（可通过环境变量 DSH_USAGE_PULSE_DIR 覆盖路径），只保存聚合数据（每小时 token 与成本计数、会话总数），不涉及对话内容。
安装前建议查看源码与许可证（MIT），特别是 holidays.js 的法定节假日列表，若遇到节假日误判，可在假期公布后补充下一年度数据。
结尾¶
dsh-usage-pulse 把 DeepSeek 的峰谷定价、token 消耗与分时图表直接嵌入 DSH Web UI，让用量与成本在开发过程中可见可查。目录页与源码仓库见下：
