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