概览
dsh-usage-stats
DSH 官方桌面版「使用统计」插件——设置页新增使用统计分区，照 ZCode 开源版界面：五格终身摘要条 + GitHub 式 Token 热力图（每日/每周/累计三档）+ 今日/近 7 日/近 30 日趋势折线 + 模型用量环形图。数据来自 host 侧 session 事件采集（照抄官方 tokenUsage 投影折叠语义），全本地 JSONL 落盘 ~/.dsh/usage-stats/，零上传零新依赖，支持历史会话回填（node:zlib 解 zstd）。纯只读 GET API 四条走内核 webServer 同源反代。
README / ZH
插件文档
目录摘要
DSH 官方桌面版「使用统计」插件——设置页新增使用统计分区，照 ZCode 开源版界面：五格终身摘要条 + GitHub 式 Token 热力图（每日/每周/累计三档）+ 今日/近 7 日/近 30 日趋势折线 + 模型用量环形图。数据来自 host 侧 session 事件采集（照抄官方 tokenUsage 投影折叠语义），全本地 JSONL 落盘 ~/.dsh/usage-stats/，零上传零新依赖，支持历史会话回填（node:zlib 解 zstd）。纯只读 GET API 四条走内核 webServer 同源反代。
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
已知限制如下： - live 折叠槽在内存，重启即弃：替换窗横跨进程重启时旧样本极罕见双计； - 回填路径 attempt 样本的模型归属依赖会话内 `request/header` 前置，缺失时记 unknown（参考环境中 0 条 unknown）； - 最长聊天时长按（会话, 日）分桶取极差，跨日会话按日截断，是近似口径； - 少数「有水位无 mtime」的历史会话（生产环境中少数会话如此）每次装载仍会解压（约 0.7~4 秒，可容忍）； - 多帧 zstd 帧边界靠魔数扫描，理论上极低概率误报（在大量帧样本上零误报；解压失败帧跳过并计数留痕）； - 热力图固定回看 52 自然周，更早的用量只计入摘要条等全期口径，不出现在格子里； - 热力图「每周/累计」档的悬停卡片取该周**末位日期**（周六）与周合计，是既有口径（照 ZCode）； - 趋势悬停卡片最多列 8 个模型行（超出注「另有 N 个模型未列出」）——单日模型数很多时卡片不再无限长。