dsh-usage-stats

dsh-usage-stats

在 DSH 设置里增加一个 使用统计 页面：扫描本机全部会话日志，汇总累计、峰值、连续天数、聊天时长、每日趋势和模型用量。

预览图使用虚构的演示数据，不含真实会话、账号或用量。

统计口径

• Token：输入 + 缓存读取 + 缓存写入 + 输出，与 DSH 自己的 tokenUsage 投影一致。
• 会话：包含子会话，跨工作区汇总；被 fork 的子会话会物理复制父会话日志，统计时用 inheritedEventCount 去掉父会话前缀，避免重复计费。
• 模型：取自每条 assistant/message 的 message.source.model；没有该字段的旧日志回退到最近的 request/header.config.model。
• 聊天时长：同一会话内相邻事件间隔不超过 1 小时才累计；长时间挂起不会把“聊了几天”算成一次聊天。
• 连续天数：按本地日期统计有 Token 用量的连续天数。

数据来自 sessionQuery 对持久化日志的重放；不会改写日志。首次打开会在后台扫描全部会话（几百个会话通常十几秒到半分钟，视日志量而定），随后缓存 5 分钟，页面上的“刷新”会强制重算。

页面内容

• 五张卡片：累计 Token、峰值 Token、最长聊天时长、当前连续天数、最长连续天数。
• Token 活动热力图：近 12 个月，支持每日 / 每周 / 累计三种聚合；悬停格子显示日期、Token 数和轮消息数。
• 每日 Token 趋势图：按模型分线（前 5 个模型 + 其他），可切换近 7 日 / 近 30 日 / 全部；悬停显示当天总量、各模型明细和十字线。
• 模型用量环图：当前时间范围内的模型占比与 Token 数。

安装

从 GitHub 安装：

dsh plugin --profile desktop add github:XEsx630/dsh-usage-stats

本地开发时，也可以在 插件 / Plugins 页面选择 Add plugin，填入本目录的绝对路径并启用 dsh-usage-stats。两种方式都依赖 profile 里声明的 bundle；HMR 会热加载，如果设置侧栏没有出现 使用统计，刷新页面（Ctrl+R）或重启 DSH。

卸载

在插件页面卸载，或从 profile 的 package.json 中删除 dsh-usage-stats 依赖与 bundle 条目，再删掉 node_modules/dsh-usage-stats。

结构

API

GET /dsh-usage/api/stats（同源、仅本机 Host）返回：

{
  "generatedAt": 1792416000000,
  "sessions": 76,
  "failed": 0,
  "longestChatMs": 63000000,
  "totals": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0, "total": 0 },
  "days": [{ "date": "2026-10-19", "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0, "turns": 0, "total": 0 }],
  "models": [{ "model": "deepseek-v4.1-flash", "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0, "total": 0 }],
  "modelDays": [{ "date": "2026-10-19", "models": [{ "model": "deepseek-v4.1-flash", "total": 0 }] }]
}

?refresh=1 跳过 5 分钟缓存。