dsh-token-heatmap

在 DeepSeek Harness 里长时间跑 agent 时，token 会分散在多段会话和多次 turn 里，单靠官网用量页很难在对话现场快速感知「今天用了多少、最近是否变忙」。dsh-token-heatmap 在对话区左下角提供一个可拖动的浮动窗口，用类似 GitHub 贡献图的方式把用量可视化：顶部是今日总量，下方是最近 30 天的色块日历，位置会记住，双击可收成一行标题。

数据完全留在本机。插件读取你自己的会话日志，在进程内聚合后展示，不发网络请求、不做遥测。悬停时会在上方展开年度面板，除了全年色图与图例，还能看到活跃天数、日均、当前与最长连续天数、最佳单日，以及每一天的输入、缓存、输出拆分。只要有会话在运行，窗口会缓慢闪烁提示「仍在进行」，会话全部结束后停止；窗口内部没有数字动画，阅读更稳。

统计口径尽量对齐官网用量页，并对同一份历史被复制进多个日志（例如 subagent 快照、fork）的情况按指纹去重，避免重复计数。需要说明的是：今日数字准确到最后一个已提交的 step，与「最后一个刚生成的 token」可能略有先后；基于日志的实现通常会比官方略低一点（例如未写入日志的失败重试），这是数据源差异而非单纯展示 bug。

适合经常开多会话、想在不离开对话的前提下盯用量节奏的用户，也适合希望本地自查、又不想把用量数据发到第三方的开发者。可调项（窗口长度、是否统计 subagent、扫描并发、新鲜度窗口等）在 lib/config.js，可按习惯微调。