QuanWenG/token_usage_heatmap

DSH Token 使用热力日历

dsh-plugin-token-usage-heatmap 是一个适用于 DeepSeek Harness Web 的树外 bundle。它在“设置 → 个人统计”中增加 GitHub/Codex 风格的 Token 使用热力日历，不修改 DSH 源码。

界面预览

中文界面

中文个人统计页面

English UI

English personal statistics page with weekly tooltip

功能

- 展示累计 Token、单日峰值、最长聊天时长、当前连续天数和最长连续天数。
- 提供最近 53 周的每日、每周和累计三种视图。
- Token 使用量越高，格子颜色或周柱高度越明显。
- 鼠标悬浮和键盘聚焦均可查看精确 Token 数及输入、输出、缓存读取、缓存写入明细。
- 支持中英文、亮色/暗色主题、横向滚动和响应式布局。
- 从已有会话日志实时派生统计，安装前的历史记录也会自动纳入。

统计口径

- 数据来自 DSH 的持久会话日志和当前活会话；主会话、子代理及工作流会话均会统计。
- 使用 DSH token-meter 的折叠语义：统计 assistant/chunk usage，最终 assistant/message usage 会替换同一步骤的早期样本，避免重复累计。
- 每日总量为未缓存输入、输出、缓存读取、缓存写入之和，日期按照浏览器所在的 IANA 时区归属。
- 最长聊天时长是单个会话从首个事件到最后事件的最大时间跨度。
- 今天没有使用量时不会立即中断当前连续天数；如果今天产生使用量，则今天会计入连续天数。
- 删除会话后，该会话的 Token 贡献会在下次读取时消失。插件不会创建或复制会话事件。

兼容性

| 项目 | 支持范围 |
| --- | --- |
| DeepSeek Harness | >=0.1.0-rc.5

Git 依赖会通过本项目的 prepare 脚本生成 lib/。pnpm 10 及以上默认禁止依赖在安装期间执行构建脚本；首次安装若被拒绝，请按照 DSH/pnpm 输出，把它显示的确切包键加入该 profile 的 pnpm-workspace.yaml：
yaml
allowBuilds:
dsh-plugin-token-usage-heatmap: true

确认源码可信后再授予构建权限，然后重新运行安装命令。

配置

冷会话读取并发数默认为 4，可在 profile 的 cordis.patch.yml 中覆盖完整插件配置：
yaml
- id: token-usage-heatmap
name: dsh-plugin-token-usage-heatmap
config:
maxConcurrentSessionReads: 4

允许范围为 1–32。DSH 的后置 patch 会替换整份 config，而不是深度合并，因此覆盖时需要保留所有仍然需要的配置键。

更新

在克隆目录中执行：
sh
git pull --ff-only
pnpm install
pnpm test
pnpm build

随后重启 DSH Web，使 Host 和浏览器 bundle 重新加载。

卸载
sh
dsh plugin --profile web remove dsh-plugin-token-usage-heatmap

从 DSH 源码运行时，将命令开头改为 pnpm dsh。卸载只移除 bundle 层和 profile 依赖，不需要清理额外的统计数据库。

开发与检查
sh
pnpm test
pnpm typecheck
pnpm build
pnpm pack:check

构建输出包括 Host 的 lib/index.js、浏览器 window.__ModuleLoader__ 工厂格式的 lib/client.js、内嵌 CSS Modules 以及 lib/types 声明。

GitHub Actions 在 Node.js 22 和 24 上执行安装、测试、类型检查、构建与打包检查。

许可证

本项目采用 MIT License。