前言¶
DeepSeek Harness（DSH）把功能扩展交给插件。对使用 DSH Web 的开发者来说，Token 用量往往需要从会话日志里整理出来；如果要做累计回顾、单日峰值检查、连续天数观察，就需要一个集中展示入口。
QuanWenG/token_usage_heatmap 是面向 DSH Web 设置页的 Token 使用统计插件。它提供最近 53 周的每日、每周和累计视图，并支持鼠标悬浮与键盘聚焦查看明细。该插件不修改 DSH 源码。
这是什么¶
这个插件由 QuanWenG 维护，仓库为 QuanWenG/token_usage_heatmap。它面向 DSH 的 web profile，兼容 DeepSeek Harness >=0.1.0-rc.5 <0.2.0，许可证为 MIT。
安装后，它会在 DSH Web 的“设置 → 个人统计”中展示 Token 使用统计，包括累计 Token、单日峰值、最长聊天时长、当前连续天数、最长连续天数，以及 53 周热力图。
核心功能¶
下面介绍插件已列出的主要能力：
- 展示累计 Token、单日峰值、最长聊天时长、当前连续天数和最长连续天数。
- 提供最近 53 周的每日、每周和累计三种视图。
- Token 使用量越高，格子颜色或周柱高度越明显。
- 鼠标悬浮和键盘聚焦均可查看精确 Token 数，以及输入、输出、缓存读取、缓存写入明细。
- 支持中英文、亮色/暗色主题、横向滚动和响应式布局。
- 从已有会话日志实时派生统计，安装前的历史记录也会自动纳入。
- 不修改 DSH 源码。
安装与启用¶
克隆源码后安装¶
先克隆仓库并进入插件目录：
git clone https://github.com/QuanWenG/token_usage_heatmap.git
cd token_usage_heatmap
接下来安装依赖，并执行测试、类型检查和构建：
pnpm install
pnpm test
pnpm typecheck
pnpm build
然后在插件目录中执行安装、配置导出和启动命令：
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web
启动后打开：
http://127.0.0.1:3080
进入“设置 → 个人统计”查看插件页面。
直接从 GitHub 安装¶
也可以直接把 GitHub 仓库加入 web profile，并锁定 tag 或 commit：
dsh plugin --profile web add github:QuanWenG/token_usage_heatmap#<tag-or-commit>
命令中的 <tag-or-commit> 是占位符，实际安装时需要替换为具体 tag 或 commit。
pnpm 构建脚本注意¶
源码构建要求 Corepack，仓库固定使用 pnpm 11.7.0。直接从 GitHub 安装时，要求 pnpm 10 或更高版本。
pnpm 10 及以上默认禁止依赖在安装期间执行构建脚本。如果首次安装被拒绝，需要先确认源码可信，再把该 profile 的 pnpm-workspace.yaml 中加入 allowBuilds 配置：
allowBuilds:
dsh-plugin-token-usage-heatmap: true
确认源码可信后，重新运行安装命令。
典型用法¶
安装成功后，打开 DSH Web 的“设置 → 个人统计”，即可看到累计 Token、单日峰值、最长聊天时长、当前连续天数和最长连续天数。
热力图会展示最近 53 周的每日、每周和累计视图。Token 使用量越高，格子颜色或周柱高度越明显。
鼠标悬浮或键盘聚焦到某个统计单元时，可以看到精确 Token 数，以及输入、输出、缓存读取、缓存写入明细。统计从已有会话日志实时派生，安装前已经存在的历史记录也会纳入统计。
配置注意¶
如果需要同步调整插件配置，可在 profile 的 cordis.patch.yml 中覆盖 maxConcurrentSessionReads。允许范围是 1–32：
maxConcurrentSessionReads: 1
上面的 1 只是范围下限示例，实际值按需要选择。DSH 的后置 patch 会替换整份 config，而不是深度合并，因此覆盖插件配置时需要保留所有仍然需要的配置键。
连续天数与删除会话¶
今天没有使用量时，不会立即中断当前连续天数；如果今天产生使用量，则今天会计入连续天数。
删除会话后，该会话的 Token 贡献会在下次读取时消失。插件不会创建或复制会话事件。
适用场景与注意¶
适合使用 DSH web profile，并且希望在一个设置页内回顾 Token 用量、53 周使用趋势和连续天数的开发者。使用前应确认运行版本在兼容范围内：DeepSeek Harness >=0.1.0-rc.5 <0.2.0。
插件会以当前 dsh 进程权限运行，并读取会话日志来派生统计，因此安装前应检查源码、许可证和依赖。本插件许可证为 MIT。
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解为官方应用商店。
链接¶
- GitHub：
https://github.com/QuanWenG/token_usage_heatmap - 目录页线索：
https://www.skillhub.cn/plugins/QuanWenG/token_usage_heatmap
