kongjianguan/dsh-tokstat

README 摘要

dsh-tokstat 读取 DeepSeek Harness (dsh) 会话日志的实时使用量与性能 TUI 统计面板 —— Tokens / TTFT / TPS / 成本一屏看全 Overview dsh-tokstat 直接读取 dsh 的会话日志（ /.dsh/sessions/ /session.jsonl.zstd ， zstd 帧级增量解析），把散落在多个会话文件里的每一次 LLM 请求还原成可分析的 指标： 输入/输出/缓存 Tokens、TTFT（首 token 时延）、TPS、耗时、重试与失败、 估算成本 。 项目提供两种形态： - dsh 设置面板插件 ：在 dsh Web 设置页增加「统计」section，实时展示概览 / 模型 / 会话 / 请求，2s 轮询； - Python TUI ：独立终端仪表盘（7 个视图， o t m p s r e 切换）。 适合谁： - 想了解自己每天在 dsh 上花了多少 token / 钱的用户； - 想评估模型与供应商性能（TTFT、TPS 分布）的用户； - 想排查重试、失败步骤的 agent 重度用户。 7 个视图（ o t m p s r e 切换）： Tab 内容 总览 请求数 / 总 Tokens / 平均 TTFT(TPS)（含 p50·p95）/ 成功率 / 缓存命中率 / 成本 / 耗时 Hero 卡 + Tokens 构成条 + 4 条实时火花线 + Top 模型/会话 趋势 按小时/天（ h / d ）的柱状图：请求数、Tokens（输入+缓存 vs 输出）、平均 TTFT（绿≤5s/黄≤120s/红 120s）、平均 TPS 模型 / 供应商 各模型/供应商的用量、缓存命中率、TTFT 中位+p95、TPS、重试、成本，点击表头排序 会话 每个会话的用量/性能/成本/用户消息/最后活动；点击行可查看单会话详情 请求 逐条请求日志（1200 条上限）， f 过滤，点击表头排序 错误 重试原因分布（TRANSPORT/SERVER/TIMEOUT…）、逐条重试事件、失败步骤 指标设计参考了 cc-switch 的用量统计、new-api 与 sub-api 的数据看板，指标口径与 dsh 官方 sessionStats 投影一致（见 指标定义）。 Compatibility - 数据格式基于 dsh 0.1.0-rc.6 的会话日志结构验证（2026-08-15），并已与 服务器端 session projcache.json 投影交叉验证（llmMs/decodeTokens 精确相等， TTFT 误差 add 本插件，并重启 dsh Web /tokstat/stats 404 插件未加载或该 profile 未启用 webServer；检查 boot 日志 Develo…

分类