@dsh-external/dsh-usage-stats

DeepSeek Harness (DSH) 用量统计插件：聚合所有会话的 token 使用量（输入 / 输出 / 缓存读 / 缓存写），按模型与按天明细，并在设置页展示，可配置单价估算费用。

功能

• 聚合总览：全部会话的 token 总量、请求数、会话数。
• 按模型明细：每个 provider/model 的请求数与各项 token。
• 按天明细：每日用量列表 + 简易趋势图。
• 单价与费用估算：内置常见 provider 单价，可在设置页按模型覆盖，支持 USD/RMB 显示。
• 加载优化：后台预热 + 会话变化防抖重扫 + 增量按会话缓存 + stale-while-revalidate，打开设置页不阻塞。

数据流

遍历 ctx.sessionPersistence 的会话快照（listSnapshots / list），inspect/readFrom 读取事件，折叠 assistant/message 与 assistant/chunk(usage) 的 token 字段，按当前生效的 provider/model（request/header）归属。

API

• GET /dsh-usage-stats/api — 总览（?refresh=1 强制重扫）。
• POST /dsh-usage-stats/api/prices — 保存单价/汇率。

返回结构含 total、byModel（每模型含 byDay）、byDay、sessionCount、generatedAt、prices、refreshing。

依赖

• 宿主须提供服务：webServer、sessionPersistence、sessionProjectionCache。
• 运行时 peer：cordis（>=4.0.0-rc <5）。

安装与注入

方式一：直接注入目录（dsh-super-injector 环境）

dev_inject_plugin <本仓库目录>

方式二：打包后安装

cd <本仓库目录>
bash scripts/build.sh        # 校验 lib 并产出 tgz
# 用产物 tgz 在目标环境安装/注入

License

BSD-3-Clause