@dsh-external/dsh-usage-stats
English | 中文
DeepSeek Harness (DSH) 用量统计插件：聚合所有会话的 token 使用量（输入 / 输出 / 缓存读 / 缓存写），按模型与按天明细，并在设置页展示，可配置单价估算费用。
功能
- 聚合总览：全部会话的 token 总量、请求数、会话数。
- 按模型明细：每个 provider/model 的请求数与各项 token。
- 按天明细：每日用量列表 + 简易趋势图。
- 单价与费用估算：内置常见 provider 单价，可在设置页按模型覆盖，支持 USD/RMB 显示。
- 加载优化：后台预热 + 会话变化防抖重扫 + 增量按会话缓存 + stale-while-revalidate，打开设置页不阻塞。
安装
① 插件市场一键安装
若已安装 dsh-market 插件市场：
- 打开 Settings → Plugin Market
- 搜索
dsh-usage-stats（或 @dsh-external/dsh-usage-stats）
- 点 安装，刷新页面即可在设置页看到「用量统计」
插件市场只收录其 registry 里列出的源；若搜索不到，请先用下面②/③/④安装，再考虑把它加入市场 registry。
② dsh plugin add（官方安装命令）
本包已声明 dsh.bundle manifest，可用官方命令直接安装：
dsh plugin --profile web add @dsh-external/dsh-usage-stats
包未发布 npm 时会回退为 GitHub 源码安装，依赖网络可达 github.com。
③ dsh-super-injector 直接注入
dev_inject_plugin <本仓库目录>
④ 克隆 + 打包安装
git clone https://github.com/dustinmoon78/dsh-usage-stats.git
cd dsh-usage-stats
bash scripts/build.sh # 校验 lib 并产出 tgz
# 在目标环境安装/注入产出的 tgz
数据流
遍历 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 | 保存单价/汇率 |
curl -s 'http://127.0.0.1:<port>/dsh-usage-stats/api'
返回结构含 total、byModel（每模型含 byDay）、byDay、sessionCount、generatedAt、prices、refreshing。
依赖
- 宿主须提供服务：
webServer、sessionPersistence、sessionProjectionCache。
- 运行时 peer：
cordis（>=4.0.0-rc <5）。
License
BSD-3-Clause
