dsh-usage-stats

DSH 本身不保留跨会话的用量视图，会话一删，历史 token 消耗就再也查不到。dsh-usage-stats 把每次模型调用的输入、输出、缓存命中、缓存写入逐条记进一个独立的本地 SQLite 账本，删会话、清日志都不影响已入账的数据，让用量记录真正持久化、可追溯。

核心能力在于「分桶」与「分口径」。数据按天 × 服务商 × 模型聚合，时间范围可切今日、本周、指定日期或全部；口径可分全部、仅主对话、仅 DSH 内部调用（压缩、摘要、标题生成）。三路数据来源——session/event 主对话、llm/stream 内部调用、启动时增量回溯——共用同一主键去重，不会双计。接口仅接受 loopback 来源，无出网请求、无配置项、无密钥，所有数据留在 $DSH_HOME 下的一两个文件里。

适合想按天或按模型核对 token 消耗、并且需要把主对话与 DSH 内部调用分开看的人。不适合需要算钱（只有 token 数，不乘单价）、跨机器汇总、或 TUI / headless 场景。