dsh-token-heatmap-wyz

dsh-token-heatmap-wyz

DeepSeek Harness（dsh web）插件：Token 用量热力图 + 按模型的 token 用量明细。

• 热力图：近 26 周按天着色（GitHub 风格，深色/浅色主题自适应，窄屏横向滚动），格点为对数刻度。
• 总量：今日 / 本周 / 本月 / 累计 四个总量 chip，点击即把明细表锁定到对应时段（再点一次取消）。
• 明细：热力图下方是按 provider/model 归属的 token 用量表（输入 / 输出 / 缓存读 / 缓存写 / 合计 / 占比 + 占比条）。
• 点选热力图中的某一天或任一总量 chip，明细表切换到该范围；点「全部」恢复当前视图的窗口聚合。
• 数据完全来自本机：聚合所有会话的事件日志（assistant/message 的 data.usage 与 assistant/chunk 的 usage 样本），增量折叠 + 磁盘缓存，稳态开销 O(新增事件)。

使用

安装到 web profile（本地目录）：

dsh plugin --profile web add <本目录路径>
# 例如：
dsh plugin --profile web add C:\path\to\dsh-token-heatmap

或发布到 npm 后：

dsh plugin --profile web add dsh-token-heatmap-wyz

重启 dsh web 后，打开 设置 → Token 热力图 即可看到面板；API 端点：

GET http://127.0.0.1:<port>/api/dsh-token-heatmap-wyz/usage

返回 {ok, days:[{date, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, tokens, models:[...]}], models:[...], total:{...}, updatedAt}，仅允许回环地址访问（peer-socket fence）。

更新

重新运行安装命令会取到最新发布版本（npm 安装路径）：

dsh plugin --profile web add dsh-token-heatmap-wyz

卸载

dsh plugin --profile web remove dsh-token-heatmap-wyz

结构

文件	说明
lib/index.js	Host 入口：注册 /api/dsh-token-heatmap-wyz/usage 精确路由，增量聚合 live + persisted 会话
lib/usage.js	纯聚合逻辑（无依赖，可单测）：样本替换语义、per-day/per-model 分桶
client/client.js	Client 入口：设置页 section 注册 + 热力图/明细表 UI（纯 JS，无构建）
cordis.patch.yml	profile bundle 挂载声明

聚合语义参考 Ychris12138/dsh-usage-stats（MIT，同一事件模型的成熟实现）与官方 dsh-token-meter 的 tokenUsage 投影：同一 (turn, step) 的重复样本会替换而非累加早期样本。

实现约束（Dsh Plugin 生态约定）

• 纯 JS，无 JSX/TypeScript；React 一律 React.createElement。
• Services：Host 用 ctx.get()/inject: 声明（webServer、sessions、sessionPersistence）；Client 注入 slots、locale，通过 settings.section 插槽注册面板。
• 不写业务持久化到 plugin 目录；统计缓存在 ~/.dsh/storages/dsh-token-heatmap-wyz-cache.json（与 dsh-usage-stats 相同约定）。

开发

无构建步骤，测试仅依赖 Node（≥ 20），不需要 dsh 运行时：

npm test

• test/cache-prune.mjs：缓存裁剪端到端测试（自包含，使用临时 DSH_HOME）；
• test/render-smoke.cjs：渲染冒烟测试（以 fake React 驱动组件并检查元素树）；
• test/harness-client.cjs：客户端 bundle 装配 + 纯函数单测（需要本机已全局安装 dsh CLI，以解析其中的 react）。