dsh-usage-stats

用 DSH 聊得多了，你往往只记得「今天好像又烧了不少 Token」，却很难一眼看清：累计用了多少、哪天最猛、最近是哪些模型在扛用量。官方 trajectory 里能对账，但缺少一块像 ZCode 那样摆在设置里的总览面板。dsh-usage-stats 就是为这个缺口做的：在设置页挂上「使用统计」分区，把会话活跃度与模型用量用图表讲清楚，而且数据只来自本机。

插件会同时走两条路记账：一边监听宿主会话事件，按与官方一致的 tokenUsage 折叠语义落增量；一边从 ~/.dsh/sessions 回填历史，fork 会话会剪掉继承前缀，避免和父会话重复计数。面板上有五格终身摘要（累计 Token、单日峰值、最长聊天时长、当前与最长连续天数）、最近 52 周的 Token 活动热力图、可按今日/近 7 日/近 30 日切换的趋势折线，以及模型用量环形图。数字口径与官方「用量」tab 可对账，摘要悬停还能看到精确值与说明。

所有统计落在 ~/.dsh/usage-stats/，API 仅经本机 loopback 只读访问，无遥测、不上传。首次装载会后台回填历史，大库可能要几分钟；稳态下界面以轻量轮询更新，回填分片执行，尽量不拖慢日常使用。多窗口时单写者锁保证只一处采集，其余窗口仍可只读查看。

适合已在使用 DSH（web、headless 或 desktop）并希望本地掌握用量节奏的用户：想复盘模型占比、盯连续活跃天、或偶尔和官方 trajectory 逐项核对的人，都可以把它当作设置里的常驻仪表盘。与 dsh-keepsake 等记忆类插件互不依赖，可单独安装。