dsh-token-usage：DeepSeek Harness Token 用量仪表盘

DeepSeek Harness (DSH) 提供了插件扩展机制，开发者在使用模型进行对话或任务执行时，通常需要追踪 token 消耗量与调用频率。dsh-token-usage 插件通过聚合 session 日志，在设置页提供了一个可视化的用量统计界面，解决手动查日志统计繁琐的问题。

核心功能¶

该插件在设置页提供以下统计视图：

• 指标卡：展示总体使用量的概览数据。
• 活跃热力图：可视化展示调用活跃时段。
• 按天趋势：包含 Top 5 模型的堆叠柱状图与缓存命中率折线图。
• 模型占比环图：展示各模型的使用比例分布。
• 设置页用量统计 UI：将上述视图挂载至 DSH 的设置菜单中。

安装与启用¶

命令行安装：

dsh plugin --profile <profile> add https://github.com/felixzhang-glitch/dsh-token-usage

本地开发安装：
使用本地仓库的绝对路径安装（例如 /Users/name/dsh-token-usage）。本地目录安装为活链接，修改代码后重启 DSH 即可生效。

界面操作：
1. 打开 DSH 侧边栏「插件」→「添加插件」。
2. 输入 GitHub 仓库地址或本地绝对路径。
3. 安装完成后重启 DSH。

典型用法¶

1. 数据来源确认：确保模型请求返回的数据中包含 usage 字段，否则统计结果将为空。
2. 启用与刷新：在插件页确认该包已启用，然后进行浏览器硬刷新（或重启 DSH）。
3. 日志排障：若页面一直显示加载中或条目为空，检查诊断日志 ~/.dsh/profiles/<profile>/.plugin-manager/logs。

注意事项¶

• NPM 包区分：本插件不发布 npm。npm 上的同名包（如 Tastelessor/dsh-usage-stats）为第三方带计价包，对话框输入裸包名安装的并非本插件。
• 版本要求：建议在 DSH 0.1.7-rc.2（桌面版）或 0.1.6-alpha.2（web）环境下使用。
• 生效方式：装完必须重启 DSH 才能生效（桌面版 profile 无 live 重载）。