@abcdefu_cja/dsh-usage-stats

DSH Web 的 API 用量统计插件：精确统计 token、请求、完成轮次、活跃天数、缓存命中率、费用估算，并同时拉取 OpenCode 订阅配额与 DeepSeek 官方余额。以独立插件形态挂载（不属于 dsh-web-ui 家族），在设置页左侧导航提供专属「用量统计」Tab。

与启发式估算不同，本插件的 token 计数是精确的：直接来自每个请求的 provider usage 报告（inputTokens/outputTokens 与 cacheReadTokens/cacheWriteTokens），并采用 DSH 自身的 (turn, step) 替换语义，最终消息会替换其先前的用量块而不是重复累计。

功能

• 用量概览 Tab

  • 常驻 KPI 区：Token 总量（含费用）、请求数、完成轮次、活跃天数、平均缓存命中率、提供商动态卡（OpenCode 周配额 / DeepSeek 余额）
  • Token 四分色拆分条（输入 / 缓存读 / 缓存写 / 输出）
  • 堆叠柱状趋势图：按模型分段着色，Y 轴中文单位刻度（万/亿），悬停柱子显示当日明细 tooltip（总用量 / 费用 / 分模型 Top5+其他 / 缓存命中率）
  • 模型明细表（请求数 / token / 费用）

• 模型与缓存 Tab：模型占比 Donut 图 + 缓存效率诊断（命中率、节省 token、节省比例）

• 余额与配额 Tab：OpenCode 订阅配额三窗口进度条（滚动 / 每周 / 每月 + 重置倒计时）；DeepSeek 官方余额（金额 / 预计可用天数 / 充值链接跳转官方充值页 / 手动刷新）

• 会话用量面板：会话页按钮展开当前会话用量（累计 / 最近请求 / 进行中轮次实时消耗）

架构

• 宿主端：订阅 session/event（全局、所有会话），把每次请求折入 UsageStatsMeter（token / 请求 / 轮次 / 费用 / 最近请求元数据）。按日（本地时区 YYYY-MM-DD）与分模型桶聚合，落盘到 ~/.dsh/dsh-usage-stats.json（30s 防抖写盘 + flush/dispose 即时写，原子 tmp + rename，损坏文件转 .bak 重建）。只读路由 /api/dsh-usage-stats/* 带 loopback 围栏。余额客户端拉取全部已检测 provider 的快照（OpenCode 配额 + DeepSeek 金额），各自失败互不影响。