huantian1223/dsh-token-stats

README 摘要

dsh-token-stats English 中文 DeepSeek Harness（DSH）的 Token 用量统计插件。直接解析 DSH 会话日志（ session.jsonl.zstd ）中的真实 provider usage 数据，在 Web GUI 内提供完整的用量统计：累计/今日/峰值 Token、最长聊天时长、连续使用天数，以及 12 个月的活动热力图（每日/每周/累计），并按模型、工作区拆分明细。 功能 统计卡片（6 张，3×2 布局） 页面顶部以 3 列 × 2 行对称展示六项核心指标，窄屏自动降为 2 列： 卡片 含义 累计 Token 数 输入 + 输出 + 缓存读取 + 缓存写入 的全量累计 今日 Token 今天截至当前的用量，副标题含调用次数与 占累计比例 峰值 Token 数 单个会话的最高消耗，标注发生日期 最长聊天时长 单次连续会话的最长时长（会话按 30 分钟无活动切分） 当前连续天数 从今天（或昨天）往前连续有使用的天数 最长连续天数 历史最长连续使用记录 「活跃日」定义：当天有任何 token 消耗即算活跃。 Token 活动热力图 GitHub 风格的 7 行日历网格（周一至周日），滚动 12 个月窗口，两个维度可自由组合： - 三种视图 ： - 每日 ：每个格子 = 当天用量 - 每周 ：每个格子 = 所在周的合计（整列 7 格同色，一眼看出"这一周有活动"） - 累计 ：每个格子 = 截至当天的累计值（左暗右亮，形成递增渐变） - 时间范围 ：12个月 / 3个月 / 30天 切换，默认 3 个月（数据稀疏时日历不至于大片空白） - 悬停预览 ：气泡显示「8月13日 使用了 6391.7万个 Token（58 次调用）」，空格子显示「无使用」 - 点击下钻 ：在每日视图点击任意日期格子，弹出当日明细弹窗——列出当天各会话的 Token 与调用次数， 显示会话标题 （一眼认出是哪个会话），重复标题的多个会话 自动合并 并标注 ×N，超过 10 条自动 分页 ；弹窗打开时可点其他日期直接切换 - 导出 CSV ：一键导出当前范围的按日数据（日期 / Token / 调用次数），带 UTF-8 BOM，Excel 打开不乱码 消耗构成 输入 / 输出 / 缓存读取 / 缓存写入 / 推理 五项明细， 完整精确数字 （千分位），不做万/亿简写——查具体数值时一目了然。（缓存读取为 DeepSeek 前缀缓存命中，通常占比极高但计费远低于输入。） 按模型 / 工作区 各模型、各工作区的消耗排名，完整精确数字；可一眼看出消耗集中在哪个模型、哪个项目目录。 会话头部实时角标 对话界面标题栏右侧常驻两个胶囊： - 本会话 X ：当前会话已用 Token，10 秒轮询刷新；点击弹出本会话明细（总计/输入/输出/缓存/推理 + 按…

分类