@dsh-external/dsh-usage-stats
用量统计：聚合所有会话的 token 使用总量与模型分布，设置页显示
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dustinmoon78/dsh-usage-stats#3cf01654b8a813f8406c9bbd47928055d38b62d6Usage Stats 以 @dsh-external/dsh-usage-stats 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
DeepSeek Harness (DSH) 用量统计插件：聚合所有会话的 token 使用量（输入 / 输出 / 缓存读 / 缓存写），按模型与按天明细，并在设置页展示，可配置单价估算费用。
若已安装 dsh-market 插件市场：
dsh-usage-stats（或 @dsh-external/dsh-usage-stats）插件市场只收录其 registry 里列出的源；若搜索不到，请先用下面②/③/④安装，再考虑把它加入市场 registry。
本包已声明 dsh.bundle manifest，可用官方命令直接安装：
dsh plugin --profile web add @dsh-external/dsh-usage-stats
包未发布 npm 时会回退为 GitHub 源码安装，依赖网络可达 github.com。
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）归属。
| 方法 | 路径 | 说明 |
|---|---|---|
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。cordis（>=4.0.0-rc <5）。BSD-3-Clause