zerro-223/dsh-token-usage

README 摘要

dsh-token-usage — DSH Token 用量统计插件 在 DeepSeek Harness Web UI 的侧边栏底部（设置按钮旁）增加「Token 用量」入口， 打开一个统计面板，按 API（provider） 、 模型 和 日期 分类展示模型调用的 Token 消耗，并配有流畅的入场/更新动画（数字滚动、柱状图生长、环形图描边、 逐项 stagger），自动适配深色/浅色主题（复用 DSH 的 --dsw- 设计令牌）。 界面预览 趋势图：输入 / 输出 / 缓存命中 / 成本曲线 每日用量热力图：近一年按天展示 Token 用量 模型汇总与最近请求：按模型统计，支持导出 模型价格配置：自动同步价格，支持手动覆盖 工作原理 - Node 端 （ lib/index.js ）：监听 llm/stream waterfall 事件，捕获每次 模型调用的 usage chunk（输入 / 输出 / 缓存读 / 缓存写 / 推理 tokens）， 逐条追加持久化到 /.dsh/storages/token-stats/usage.jsonl ，并通过 /token-stats/api/overview?days=5h hour 7 month 30 custom&start=...&end=...&provider=xxx&model=xxx 提供聚合结果（时间序列 series 、统计 totals 、缓存命中率 cacheHitRate 、筛选下拉选项 filterOptions ）；另提供轻量 /token-stats/api/heatmap?days=364 接口供热力图使用。 - 浏览器端 （ lib/client.js ）：注册 sidebar.footer.action 槽位 （id token-usage ），点击后打开统计面板： - 6 张统计卡：总 Tokens、请求数、输入、输出（含推理提示）、总命中率、估算成本（USD） （DeepSeek 等多数 provider 不报告 cache 读写明细，故不单列缓存卡片） - 成本估算：按模型单价（$ / 100万 tokens，输入 / 输出 / 缓存读 / 缓存写）× 实际用量计算； 价格自动同步自 modelradar.cn（启动时拉取 + 每日刷新， 缓存于 prices-auto.json ）。注意单位：modelradar 数据集按模型原生币种计价 （294 个模型里 183 个为 CNY），插件统一取数据集的 PriceUsdPer1M 换算字段 存成 USD，CNY 来源的模型在面板中标注「自动·源CNY」；「$」按钮可查看自动匹配结果、 按名称搜索模型、手动覆盖或强制刷新；手动价格优先于自动价格，未定价模型会在成本卡上提示 - 大趋势图：按「输入(深蓝) / 输…

分类