dsh-token-heatmap

English | 中文

一个可拖动的浮动窗口，用 GitHub 贡献图的形式（Codex也长这样）显示你的 DeepSeek Harness token 用量： 最上面是今天的总量，下面是最近 30 天，悬停时上方会展开一整年的面板

DeepSeek自己写的Readme ↓

安装

github:cccchensy/dsh-token-heatmap

直接在任意会话里对 agent 说：安装插件 github:cccchensy/dsh-token-heatmap 如果你已经 clone 了仓库，就改成安装它的目录路径

装好后窗口会出现在对话区的左下角卸载在同一个 Plugins 页面里操作

• 插件按 profile 生效，重启后依然存在
• 更新插件后要重启 DSH —— 替换已安装的包需要重启才能加载新代码
• 数据不会离开你的机器它读取你自己的会话日志，并在进程内返回聚合结果： 没有网络请求，也没有遥测

使用

• 拖动可把它移到任意位置，位置会被记住
• 悬停会在上方展开年度面板：总量、活跃天数、日均、当前与最长连续天数、 最佳单日、颜色图例，以及每一天的输入 / 缓存 / 输出拆分
• 双击可把它折叠成只剩标题行
• 只要有会话在运行，窗口就会缓慢闪烁，最后一个会话结束后停止 窗口内部没有任何动画，所以数字不会闪

局限

• 今天的数字准确到最后一个已提交的 step，而不是最后一个生成的 token
• 口径对齐官网的用量页。已按 2026-10-01 核对：官网 529,217,300，本插件 527,911,277， 低 0.25%
• 这 0.25% 来自重试失败的请求：官方计入服务端已经处理过的 prompt，而 Harness 不把 失败尝试的用量写进日志。基于日志的统计拿不到这部分，任何实现都一样
• 同一份会话历史被复制进多个日志时（subagent 快照、fork）只算一次，按 「时间 + turn/step + 五个 token 桶」的指纹去重
• 压缩摘要（compaction summary）本身是一次计费调用，已计入
• 闪烁表示「有会话在运行」，而不是「此刻正在消耗 token」

开发

node verify.mjs          # token 规则 + 对真实会话日志做一次扫描
node verify-client.mjs   # 浏览器侧 bundle
node verify-host.mjs     # HTTP 路由，端到端

可调的开关 —— 窗口长度、是否统计 subagent、扫描并发度、新鲜度窗口 —— 都在 lib/config.js 里，Host 侧是不带任何依赖、无需构建的纯 ESM

MIT 许可