V-dev-388/dsh-usage-meter

README excerpt

dsh-usage-meter DSH（DeepSeek Harness）模型用量仪表盘插件。在设置页新增「用量」板块，按服务商/模型汇总全部会话的 token 用量，支持今日 / 近 7 天 / 近 30 天三档时间范围趋势图。 - 官方 bundle 格式： package.json 声明 dsh.bundle ，随 dsh plugin add 自动加入 profile 层栈 - 零外部依赖：Host 端只用官方 Cordis 服务（ sessions / fs / sessionQuery / webServer ）与官方内置包 @deepseek-ai/dsh-home-paths ，不 import 任何第三方包 - 历史回放走官方 ctx.sessionQuery （live-preferred 语料），持久层内部完成 zstd 解压与回放校验，不依赖外部命令 - 数据落盘 $DSH HOME/storages/usage-meter.json ，经 ctx.fs.writeText 原子写（tmp + rename） - 完全被动：只在本机监听会话事件，不联网、无遥测 功能 - 汇总卡：请求数 / 总 Token / 缓存命中率 / 输入 / 输出 / 缓存读取 - 时间范围：今日（24 根小时柱）/ 近 7 天 / 近 30 天（按天柱），本地时区切日 - 服务商表、模型表：请求数、输入、输出、缓存读取、总 Token - 60s 自动轮询 + 手动刷新 - 全部会话都计入（含子 agent 会话） 数据口径 - 只统计 assistant/message 且带 usage 的事件（失败请求无 message，不计） - 归属取 data.message.source.provider / model - 缓存命中率 = cacheRead ÷ (input + cacheRead) - 不做费用估算，不做逐请求日志表 安装（官方方式，dsh web profile） 插件已发布到 npm，并声明 dsh.bundle manifest： dsh plugin add 会将包追加进 profile 的 dsh.profile.bundles 层栈，其 cordis.patch.yml 自动插入插件行；client 部分经 dsh.client 声明被 dsh-client-modules 扫描进 DSH BOOT 。 安装后重启 dsh web （或刷新页面加载 client bundle），打开 设置 → 用量 即可查看。 HTTP 接口 接口 说明 GET /dsh-usage-meter/summary?range=today\ 7d\ 30d 汇总 + byProvider + byModel + series（今日按小时、其余按天…

Category