DSH Token 使用热力日历

中文 | English

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

界面预览

中文界面

English UI

功能

• 展示累计 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 中覆盖完整插件配置：

- id: token-usage-heatmap
  name: dsh-plugin-token-usage-heatmap
  config:
    maxConcurrentSessionReads: 4

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

更新

在克隆目录中执行：

git pull --ff-only
pnpm install
pnpm test
pnpm build

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

卸载

dsh plugin --profile web remove dsh-plugin-token-usage-heatmap