dsh-token-usage

面向 DeepSeek Harness 的持久化 Token 用量记录插件：按模型、会话与日期统计，并在设置页提供紧凑的可视化仪表盘。

真实 DSH 设置页截图。截图仅展示聚合 Token 统计与模型路由，不包含会话标题、提示词或回复正文。

🗺️ 功能概览

✨ 亮点

能力	说明
完整 Token bucket	分别记录未缓存输入、输出、缓存读取与缓存写入；reasoningTokens 已包含在输出中，不重复计算。
多维统计	以 provider / model、会话与 UTC 日期聚合普通对话、每次重试和上下文压缩用量。
52 周热力图	GitHub commit graph 风格的 Token 活跃度图；颜色越深代表当天总用量越高，悬停可查看精确数值。
紧凑布局	使用 K / M / B 展示大数字，悬停显示完整数值；热力图自适应设置页宽度，默认无需横向拖动。
历史预热	启动后顺序回放可读取的历史会话并写入 projection cache，不阻塞插件启动。
隐私优先	仅保留统计 bucket、日期和模型路由，不复制提示词、回复内容或其他会话正文。

🚀 安装

dsh plugin --profile web add github:LeemanCheung/dsh-token-usage

安装后重启当前 dsh web 进程并刷新 http://127.0.0.1:3080，再打开 设置 → Token 用量。

本地源码开发安装

在本目录的上一级运行：

dsh plugin --profile web add ./dsh-token-usage

📊 仪表盘内容