dsh-usage-heatmap
模型用量统计面板：累计 Token/峰值/最长会话/连续天数指标卡 + GitHub 风格 Token 热力图（日/周/累计切换）+ 活动洞察，数据来自本地 DSH 用量聚合
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zeng6125-rgb/dsh-usage-heatmap#125d62c898b292159bd7a09aac55a791206be9c5Usage Heatmap 以 dsh-usage-heatmap 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
模型用量统计面板 — 装在 DSH 设置页里的 Token 用量看板：九宫指标卡 + GitHub 风格热力图 + 活动洞察，数据全部在本地聚合。
An all-local token usage dashboard for the DeepSeek Harness settings page.
session_projcache）与已扫入的归档分桶中保留；面板把「已删归档」与「孤儿投影」分开标注。will-change: scroll-position），滚动走合成器线程。从 npm 安装：
dsh plugin add dsh-usage-heatmap
从 GitHub 安装（仓库已提交 lib/，无需构建）：
dsh plugin add github:zeng6125-rgb/dsh-usage-heatmap
或使用 Release 里的预构建 tarball：
dsh plugin add https://github.com/zeng6125-rgb/dsh-usage-heatmap/releases/latest/download/dsh-usage-heatmap.tgz
装好后在 设置 → 模型用量统计 查看。首次扫描需要几秒（取决于会话日志总量），之后走缓存与快照，秒开。
全部为本地文件，插件不发起任何网络请求：
| 来源 | 路径 | 用途 |
|---|---|---|
| 会话日志 | ~/.dsh/sessions/<cwd>/<sessionId>/session.v4.jsonl.zstd | 逐日分桶（仅追加多帧 zstd，增量续解） |
| 会话投影缓存 | ~/.dsh/storages/session_projcache/sessions/*.json | 会话级累计 token、会话元信息、孤儿/回填口径对账 |
| 聚合缓存 | ~/.dsh/storages/usage-heatmap/cache.json | 增量扫描结果、归档与续扫边界 |
| 快照 | ~/.dsh/storages/usage-heatmap/last-state.json | 重启后首帧秒开 |
逐日分桶依赖会话日志中的事件时间戳；缺失时回退到
createdAt/ 文件 mtime 摊分。 增量续解使用前缀头尾各 512KB 与长度的采样 sha256 守卫；采样不符或续扫边界失效时回退全量折叠。正确性依赖 DSH 日志仅追加的契约：长前缀中部改写不在采样检测范围内，不承诺识别任意文件篡改。
DSH_CHECKOUT=<dsh source checkout> bash scripts/build.sh # src/ → lib/
npm run typecheck # tsc --noEmit
npm test # 性能与数据获取回归测试
scripts/build.sh 需要一份 DSH 源码检出（DSH_CHECKOUT，或 ~/dsh-harness / ~/dsh / ~/.dsh/dsh-harness 之一）来链接 @deepseek-ai/* 与 cordis；终端用户安装时用的是仓库里已提交的 lib/，不需要这一步。
BSD-3-Clause