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 贡献会在下次读取时消失。插件不会创建或复制会话事件。

兼容性

已验证 DSH 0.1.0-rc.5 实际运行，以及 0.1.0-rc.6 的安装、测试、类型检查、构建与打包。

从 GitHub 克隆并安装

1. 克隆项目

git clone https://github.com/QuanWenG/token_usage_heatmap.git
cd token_usage_heatmap

2. 安装依赖并构建

pnpm install
pnpm test
pnpm typecheck
pnpm build

3. 安装到 DSH Web profile

如果使用已经安装到系统中的 dsh CLI，请在插件目录执行：

dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web

如果从 DSH 源码运行，请切换到 DSH 源码根目录，并把插件路径替换为刚才克隆目录的绝对路径：

pnpm dsh plugin --profile web add /absolute/path/to/token_usage_heatmap
pnpm dsh --profile web --dump-config
pnpm dsh --profile web

启动后打开 http://127.0.0.1:3080，进入“设置 → 个人统计”。--dump-config 输出中应包含 # == dsh-plugin-token-usage-heatmap 层和 token-usage-heatmap 插件行。

Windows PowerShell 也使用相同命令，只需将示例路径替换为实际的绝对路径。

直接从 GitHub 安装（可选）

DSH 也支持把 GitHub 仓库直接添加到 profile。建议锁定 release、tag 或 commit，避免后续提交静默改变实际安装的代码：

dsh plugin --profile web add github:QuanWenG/token_usage_heatmap#<tag-or-commit>

Git 依赖会通过本项目的 prepare 脚本生成 lib/。pnpm 10 及以上默认禁止依赖在安装期间执行构建脚本；首次安装若被拒绝，请按照 DSH/pnpm 输出，把它显示的确切包键加入该 profile 的 pnpm-workspace.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

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

开发与检查

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。