Overview
@skkjkk/dsh-usage-dashboard
DSH usage statistics dashboard: token / cost / duration / session aggregation with trend, heatmap and calendar views (settings.section "数据看板").
README / EN
Package documentation
Registry summary
DSH usage statistics dashboard: token / cost / duration / session aggregation with trend, heatmap and calendar views (settings.section "数据看板").
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
- **仅统计普通会话**：子代理会话（`delegationDepth > 0` / `parentSession`）与旧布局裸 `<uuid>` 目录不计入，因此会话数少于 `~/.dsh/sessions` 的目录总数。 - **费用为估算值**：单价来自本地定价表，未匹配的模型不计费（显示 ¥0），看板费用通常低于上游实际账单；缓存「预计节省」同样按表内价目估算。 - **首次冷启动需要时间**：全库首次折叠在后台进行（启动后约 150ms 触发）。命中磁盘缓存时重启为秒级；缓存缺失或因定价 / 口径变更失效时，需重新折叠全部会话（大库为分钟级）。 - **无法读取的日志会被跳过**：格式迁移失败或文件损坏的日志不重试，个别历史会话可能不出现在看板中。 - **活跃时长按生成区间累计**，并行会话分别累加，因此可能超过 24 小时；它衡量的是模型生成占用，不是墙钟时间。 - **`totalMs` 为区间并集**：重叠的并行会话只计一次，窗口边缘按事件级精确裁剪，跨桶边界的情形为近似值。