dsh-shanhai-stats
DeepSeek Harness 用量统计插件（山海紫穹系列）。
在 DSH 的设置 → 用量统计 中提供四个板块：
使用统计示例
- 总量汇总徽章 — 总花费 Token、缓存命中率、总使用次数、模型用量、连续使用天数；默认进入页面即为「当天」视图
- 每日走势柱状图 — 按天展示输入 / 缓存命中 / 缓存写入 / 输出四段 Token 走势（可切 当天 / 1 / 7 / 30 天）
- GitHub 风格热力图 — 近一年每日活动热度，支持按工作区筛选、悬停查看明细
- 按模型 / 提供商分组明细表 — 每个提供商下各模型的 Token 用量、消息数、占比，支持折叠
特性
- 数据来自 DSH 会话日志的
assistant/message 事件（usage + message.source.provider/model），插件自身不计算 token，只做聚合与展示
- 口径与 DSH 一致：
inputTokens = 未命中缓存的输入，cacheReadTokens = 缓存命中输入，cacheWriteTokens = 缓存写入；outputTokens 已含 reasoningTokens（展示时不再重复累加）
- 时间维度：全量
totals / perWorkspace / perModel 永不清零；按天明细保留 53 周滑动窗口，窗口外只进总数
- 历史回填：插件激活时扫描全部工作区会话；此后通过实时事件增量折叠（
seq 断点续扫 + gap 检测补读）
- 支持子代理会话（随事件自然计入）
- 深浅色主题自适应（使用 DSW 设计变量）
安装
方式一：插件命令（推荐）
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 # 验证浏览器模块工厂可加载
License
MIT
