dsh-shanhai-stats
山海系列 DeepSeek Harness 用量统计插件：总量徽章、每日走势柱状图、GitHub 风格热力图、按模型/提供商分组明细
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cn-zhangpeng/dsh-shanhai-stats#14c141092c52fc4fce8dc9011e26735b8ab18ee4
Shanhai Stats 以 dsh-shanhai-stats 发布，当前版本为 1.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 用量统计插件（山海紫穹系列）。
在 DSH 的设置 → 用量统计 中提供四个板块：
assistant/message 事件（usage + message.source.provider/model），插件自身不计算 token，只做聚合与展示inputTokens = 未命中缓存的输入，cacheReadTokens = 缓存命中输入，cacheWriteTokens = 缓存写入；outputTokens 已含 reasoningTokens（展示时不再重复累加）totals / perWorkspace / perModel 永不清零；按天明细保留 53 周滑动窗口，窗口外只进总数seq 断点续扫 + gap 检测补读）dsh plugin --profile web add github:cn-zhangpeng/dsh-shanhai-stats
锁定版本安装（更安全，推荐生产环境）：
dsh plugin --profile web add github:cn-zhangpeng/dsh-shanhai-stats#v1.1.0
更新 / 卸载：
dsh plugin --profile web update dsh-shanhai-stats
dsh plugin --profile web remove dsh-shanhai-stats
将本目录软链接（junction）到你的 DSH 插件目录；
用 cordis.patch.yml 以覆盖层方式启动 Web UI：
pnpm dsh web --patch ./cordis.patch.yml
打开 DSH web 界面，在 设置 → 用量统计 查看；页面默认展示「当天」数据，也可切换 1 / 7 / 30 天或自定义范围。
参考官方文档：第一个插件 首次启用会扫描本地历史会话（进度见页面提示），扫描完成后数字不再频繁变化。
Host 半（Cordis 插件，lib/index.js）
sessionQuery / workspaceRegistry 注入
→ baseline 扫描历史会话（按 cwd 归属工作区）
→ 实时 session/event 增量折叠
→ 内存聚合：totals / perWorkspace / perModel / byDay(53周)
→ /api/shanhai-stats HTTP 接口
Client 半（浏览器 bundle，lib/client.js）
React.createElement 渲染（timer 注入，2s/15s 轮询）
→ 徽章 / 柱状图 / 热力图 / 模型分组表
按 provider × model 新增 perModel 聚合维度，聚焦纯用量统计。
| 维度 | 说明 |
|---|---|
| 总花费 Token | input + output + cacheRead + cacheWrite + reasoning（展示口径，缓存命中与计费价不同） |
| 缓存命中率 | cacheRead / (input + cacheRead) × 100% |
| 回合数 | turn/end 事件计数（含子代理会话） |
| 按天窗口 | 最近 53 周；更早历史只进全量 totals/按工作区/按模型，不进热力图与按天柱状图 |
dsh-shanhai-stats/
package.json # 插件元信息与打包配置
cordis.patch.yml # 插件注册补丁
lib/index.js # Host 半：聚合 + HTTP 接口
lib/client.js # Client 半：CC Switch 风格 UI
test/ # host 端到端 + client smoke 测试
node --check lib/index.js
node --check lib/client.js
node test/host-test.mjs # 模拟 DSH 环境端到端验证聚合
node test/client-smoke.mjs # 验证浏览器模块工厂可加载
MIT