dsh-token-stats

大量调用 DeepSeek API 时，终端几乎无法回答今天花了多少 token、哪个模型最贵、账户余额还剩多少。dsh-token-stats 直接解析 DSH 会话日志（session.jsonl.zstd）中记录的 provider 真实用量数据，所有数字来自 inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens、reasoningTokens 原始字段，不估算、不抓包。

打开 Web GUI 即可看到六张统计卡片（累计 Token、今日用量、单会话峰值、最长聊天时长、当前连续天数、历史最长连续天数），下方是 GitHub 风格的 12 个月活动热力图，支持每日 / 每周 / 累计三种视图，悬停查看当日调用详情，点击任意日期可下钻到会话级明细并一键导出 CSV。按模型和按工作区的消耗排名让预算去向一目了然；输入、输出、缓存读取、缓存写入、推理五项构成以完整千分位数字展示。会话标题栏常驻实时 Token 角标与余额胶囊，余额低于可配置阈值时自动变红预警，防止余额耗尽导致调用静默失败。

适合以 DSH 为主要前端、每天数百乃至数千次调用 DeepSeek 的开发者和小团队。所有数据存储在本地 $DSH_HOME/token-stats/ 目录，API Key 仅在宿主进程内解析、绝不下发到浏览器。