供应商用量统计 kirigayakazima/dsh-usage-vendor-stats

dsh-usage-vendor-stats

English · 中文

DeepSeek Harness 用量统计插件：按服务商（订阅 / 官方 API）× KPI 聚合 API 用量，带 GitHub 风格日历热力图和每日 / 每月看板。

与 dsh-usage-stats 不同（那个按工作区聚合）：本插件以服务商（provider）为主维度，从 assistant/message 事件自动识别 message.source.provider 和 message.source.model，并把 KPI 拆成 token / 缓存命中 / 输出 / 推理。

功能

- 服务商维度：自动发现用过的每个服务商（如 huoshan、hebox、deepseek-official、tokenrhythm、opencode），可手动标注订阅 / 官方 API 和别名（持久化到 $DSH_HOME/storages 下的 KV 单元）。
- KPI 卡片：总 token（输入 / 缓存命中 / 输出 / 推理明细）、缓存命中率、模型调用数、轮次、会话数、服务商数，配多色 token 构成比例条。
- 53 周热力图：GitHub 绿风格，按每日模型调用数着色；点服务商标签可筛选；悬停查看各服务商与各 token 明细。
- 趋势折线图：Token / Calls 双轴趋势，默认按天，「今天」按小时聚合。
- 服务商模型下钻：点服务商行展开其各模型消耗。
- 每日明细：逐日 token / 缓存 / 输出 / 推理 / 命中率 / 轮次（近 30 天）。
- 每月汇总：全部历史按月聚合。
- 服务商 KPI 表：按总 token 排序，含命中率、模型数、类型徽标；点行下钻到模型。
- 时间预设：今天 / 7d / 14d / 30d / 90d / 全部。
- 费用估算：给每个服务商设每百万 token 单价，查看预估费用列。
- CSV 导出：把每日 / 每月 / 服务商表导出为 CSV。
- 健康 / 性能卡片：平均 TTFT（首 token 时间）、生成速度（t/s）、峰值上下文大小、请求错误率、模型 / 工具总耗时，从 DSH 的 sessionStats 投影聚合。
- 区间切换、动画、明暗主题适配。

截图

Dashboard

Heatmap & tables

数据来源

- 所有数据来自 DSH 持久化会话日志：assistant/message 事件带 usage（token 记账）和 message.source.{provider,model}（服务商 / 模型来源）。
- token 记账（与 DSH 一致）：inputTokens = 未缓存输入，cacheReadTokens = 缓存输入，outputTokens = 输出，reasoningTokens = 推理，cacheWriteTokens = 缓存写入。
- 缓存命中率 = 命中 /（命中 + 未缓存输入）× 100%。
- 激活时自动回填历史；数据在插件卸载 / 重启后仍保留。

安装

这是标准 DSH 社区插件包（声明 dsh.bundle 清单 + Web 客户端部分）。

从 GitHub 安装（推荐）

dsh plugin --profile web add "github:kirigayakazima/dsh-usage-vendor-stats"

安装后刷新页面即可，不用手动配置，也不用重启。

手动注册（本地开发）

1. 把这个目录放到任意位置，在 $DSH_HOME/profiles/node_modules/ 下建一个符号链接指向它（Windows 用 junction）： New-Item -ItemType Junction -Path "$env:DSH_HOME\profiles\node_modules\dsh-usage-vendor-stats" -Target "<absolute path to this dir>"

2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 里加一行：
- insert:
- id: usage-vendor-stats
name: dsh-usage-vendor-stats

用户补丁层支持热重载：保存后刷新页面即可。

用法

1. 打开 Settings（侧边栏底部），找到 API Usage Stats 页面；也可以点侧边栏底部的 📊 Usage Stats 入口，打开全屏面板。
2. 热力图颜色 = 当日调用次数；点厂商标签或表格行可以筛选 / 下钻。
3. 在 Vendor Management 里设置每个厂商的别名和类型（订阅 / 官方 API），还可以选填每百万 token 单价，用于估算成本。

架构

- 宿主端（lib/index.js）：扫描持久化会话日志并聚合用量（assistant/message.usage + message.source），监听 session/event 做实时折叠；通过 webServer 服务提供数据路由：
- GET /api/usage-vendor-stats —— 统计快照（厂商 / 模型 / 日 / 月 / 小时 / 总计）
- POST /api/usage-vendor-stats/vendor —— 设置厂商别名、类型和单价
- 客户端（lib/client.js）：window.__ModuleLoader__ 工厂格式的浏览器 bundle，注册 API Usage Stats 设置页（settings.section 插槽）、侧边栏底部入口（sidebar.footer.action）和全屏面板（shell.overlay）。

开发

- 改 lib/index.js / lib/client.js 后刷新页面生效（客户端 bundle 随页面加载）；宿主端改动需要重启 DSH。
- 插件没有第三方运行时依赖：宿主端只用 Cordis 服务，客户端只用 React（由模块表提供）。

许可证

MIT

DeepSeek Harness 用量统计插件：按厂商（订阅 / 官方 API）× KPI 聚合 API 使用量，带 GitHub 风格日历热力图、趋势折线图与日 / 月 / 小时统计看板。

区别于 dsh-usage-stats（按工作区统计）：本插件以厂商（provider）为第一维度，自动识别 assistant/message 事件里的 message.source.provider 与 message.source.model，拆分 token / 缓存命中 / 输出 / 推理等 KPI。

功能

- 厂商维度：自动发现所有使用过的厂商（如 huoshan、hebox、deepseek-official、tokenrhythm、opencode），可手动标记为「订阅 / 官方API」，设置别名（持久化到 $DSH_HOME/storages 的 KV 单元）
- KPI 卡片：总花费 Token（输入 / 缓存命中 / 输出 / 推理分项）、缓存命中率、模型调用次数、回合数、会话数、厂商数量，附多色 Token 构成比例条
- 53 周热力图：GitHub 绿色风格，颜色深浅按当日模型调用次数；点击厂商筛选后仅统计该厂商；悬停查看按厂商明细与 Token 明细
- 趋势折线图：Token / 调用双轴趋势，默认按日；选「今天」时按小时展示（小时级聚合）
- 厂商模型钻取：点击厂商行展开该厂商的逐模型消耗
- 每日明细：近 30 天逐日 Token / 缓存 / 输出 / 推理 / 命中率 / 回合
- 每月汇总：全部历史按月聚合
- 厂商 KPI 表：按总 Token 排序，含命中率、模型数、类型标签；点击行钻取模型
- 时间预设：今天 / 7 天 / 14 天 / 30 天 / 90 天 / 全部
- 费用估算：为每个厂商设置每百万 token 单价，即可看到折算的预估费用列
- CSV 导出：每日 / 每月 / 厂商表格均可导出 CSV
- 健康度/性能卡片：平均首字延迟（TTFT）、生成速度（t/s）、峰值 Context、请求错误率、模型/工具总耗时，聚合自 DSH 的 sessionStats 投影
- 时间范围切换、动画、亮暗主题自适应

截图

用量看板

热力图与表格

数据说明

- 数据全部来自 DSH 持久化会话日志：assistant/message 事件携带 usage（Token 记账）与 message.source.{provider,model}（厂商/模型来源）
- Token 统计口径（与 DSH 一致）：inputTokens 为未命中输入，cacheReadTokens 为缓存命中输入，outputTokens 为输出，reasoningTokens 为推理，cacheWriteTokens 为缓存写入
- 缓存命中率 = 命中 /（命中 + 未命中输入）× 100%
- 插件激活时自动回填全部历史会话；插件卸载 / 重启后数据不丢

安装

本插件是标准的 DSH 社区插件包（声明 dsh.bundle manifest + web client 半）。

从 GitHub 直接安装（推荐）

dsh plugin --profile web add "github:kirigayakazima/dsh-usage-vendor-stats"

安装后刷新页面即可，无需手动改配置、无需重启。

手动注册（本地开发）

1. 把本目录放入任意位置，并在 $DSH_HOME/profiles/node_modules/ 下创建指向本目录的符号链接（Windows 用 junction）： New-Item -ItemType Junction -Path "$env:DSH_HOME\profiles\node_modules\dsh-usage-vendor-stats" -Target "<本目录绝对路径>"

2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 添加一行：
- insert:
- id: usage-vendor-stats
name: dsh-usage-vendor-stats

用户 patch 层会被热重载：保存后刷新页面即可。

使用

1. 打开 设置（侧边栏底部）找到「API 用量统计」页，或点击侧边栏底部的「📊 用量统计」入口打开全屏面板
2. 热力图颜色 = 当日调用次数；点击厂商 chip 或表格行可筛选 / 钻取
3. 在「厂商管理」里给每个厂商设置别名与类型（订阅 / 官方API），可选设置每百万 token 单价用于费用估算

架构

- Host 半（lib/index.js）：扫描持久化会话日志聚合用量（assistant/message.usage + message.source），监听 session/event 实时折叠；通过 webServer 服务注册数据路由：
- GET /api/usage-vendor-stats — 统计快照（厂商 / 模型 / 日 / 月 / 小时 / 汇总）
- POST /api/usage-vendor-stats/vendor — 设置厂商别名、类型与单价
- Client 半（lib/client.js）：window.__ModuleLoader__ 工厂格式的浏览器 bundle，注册设置面板「API 用量统计」页（settings.section 槽位）、侧边栏底部入口（sidebar.footer.action）与全屏面板（shell.overlay）。

开发

- 修改 lib/index.js / lib/client.js 后刷新页面即生效（client bundle 随页面加载）；host 半改动通过重启 DSH 生效
- 插件包无第三方运行时依赖：host 半只使用 Cordis 服务，client 半只使用 react（模块表提供）

License

MIT