DeepSeek Harness（DSH）采用插件化架构，dsh-token-pulse 是其中一款本地 Token 监控工具。它通过读取本地会话日志，生成 GitHub 风格的日历热图，解决在没有云端仪表盘时追踪 Token 消耗的需求。
安装与启用¶
- 确保本地已安装 Node.js ≥ 23.8（插件依赖内置的
node:zlib进行 zstd 解码）。 - 确保已启动 DSH Web profile（
dsh web已运行）。 - 执行安装命令：
dsh plugin --profile web add dsh-token-pulse
- 安装完成后，重启 DSH Web 服务，进入设置页面即可找到 Token Pulse 栏目。
核心功能¶
- 视图切换：支持周、月、季度、年四种视图。
- 周视图：每天展开为 24 个小时柱状图，用于观察高峰时段。
- 月视图：日历格显示日期与当日用量。
- 季度/年视图：采用 GitHub 风格的日历格，季度视图放大以便观察，年度视图采用双行排布。
- 统计展示：
- 顶部展示今日、本周、本月及累计总量的统计数据。
- 支持按模型或供应商查看 Top 5 统计数据。
- 数据与刷新：
- 本地持久化：历史数据落盘保存，删除会话不会丢失记录。
- 自动刷新：支持 5 / 10 / 30 / 60 分钟的自动刷新，也可手动刷新。
- 语言与设置：支持中/英文界面切换。
使用与配置¶
- 数据源：插件仅读取本地会话日志。请确认
$DSH_HOME/sessions目录下存在包含usage字段的日志文件，否则可能显示为 0。 - 重置历史：如需清空所有历史统计数据，进入设置页右上角
...菜单，选择「重置历史」。
注意事项¶
- 时区：插件固定使用北京时区，周起始日为周一。
- 网络与计费：零网络请求，零计费接口调用，仅作为只读工具运行。
生态背景¶
DSH 理念是“一切皆插件”。本插件为社区维护项目（MIT 协议），维护者：Hou-DL。
