统计 DSH 全部会话（含 subagent）的 Token 用量与成本。数据来自会话事件流，不额外埋点； live 会话、持久化会话、subagent 会话三路合并，持久化会话按 revision 增量缓存，事件到达即失效缓存。

顶部：真实消耗 Tokens 总量、总请求数、总成本；时间范围可切 今天（默认）/ 7 天 / 30 天 / 90 天 / 全部 / 自定义时间段；成本可切 $ 美元 / ¥ 人民币；主数据 15 秒轮询，另有手动「刷新」。
指标卡：新增输入、输出、缓存创建、缓存命中、推理、缓存命中率（带进度条）。
活跃度：近一年按天的热力图（按当日请求数着色），显示活跃天数与日期区间。
模型分布：模型 / 请求 / 输入 / 输出 / 缓存读 / 缓存写 / 总量 / 成本 / 占比。
使用趋势：双 Y 轴折线（左 Token、右成本），各指标独立画线，从每条线自身第一个非 0 点起笔。
请求查看：按会话聚合（会话 / 请求 / 输入 / 输出 / 缓存命中 / 总量 / 成本 / 最后活动），可按 全部来源 / 主会话 / 子会话 过滤、按标题 / ID / 路径搜索，点行展开到单次请求明细。
计价明细：折叠区，展开后可增改删价目、同步 models.dev、设置汇率。

内置表打底：components/token-usage/pricing-defaults.mjs 随插件分发（79 条，美元 / 每百万 Token），永远可用。
插件自有价目文件 ~/.dsh/token-usage/pricing.json（TOKEN_USAGE_PRICING 可改）覆盖内置表，条目分两种来源：
- source: 'user' — 面板里手工添加 / 修改的价目，同步永不覆盖；
- source: 'models-dev' — 从 models.dev 同步写入，下次同步整体替换。
删除墓碑 deletedModelIds — 删过的条目（含内置表里的）不会被同步复活。

文件缺失或损坏时只降级到内置表并在面板标注错误，不会把成本整体归零。

同步 models.dev：面板「⟳ 同步 models.dev」拉 https://models.dev/api.json（15 秒超时），过滤非文本模型，ID 归一化后只写入当前实际用过的模型；匹配不到就明确提示、不写任何价目。
汇率：默认 7.2，可在计价明细里改。数据一律美元存储与计算，换算只发生在显示层。
需要对齐网关与 models.dev 的命名差异时，在 components/token-usage/host.js 的 MODEL_ALIASES 里登记。

方法与路径	说明
`GET /api/token-usage`	全量统计；`range=today\|7d\|30d\|90d\|all\|custom`，自定义配 `start` / `end`，`force=true` 跳过缓存
`GET /api/token-usage/summary`	只要汇总数字
`GET /api/token-usage/pricing`	价目表与来源（`builtin` / `overrides` / `sync` / `exchangeRate` / `error`）
`POST /api/token-usage/pricing`	`{ action: 'upsert' \| 'delete' \| 'sync' \| 'rate' }`
`GET /api/token-usage/activity`	近一年逐日活跃度（请求数 + Token 数）

dsh-toolkit

同名包的其他仓库