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

dsh-usage-vendor-stats

English · 中文

English

DeepSeek Harness 使用统计插件：按供应商（订阅 / 官方 API）× KPI 聚合 API 使用量，带有 GitHub 风格的日历热力图以及每日 / 每月仪表盘。

与 dsh-usage-stats（按工作区聚合）不同：本插件以供应商（provider）作为主要维度，从 assistant/message 事件中自动检测 message.source.provider 和 message.source.model，并将 KPI 拆分为 tokens / 缓存命中 / 输出 / 推理。

功能特性

- 供应商维度：自动发现使用过的每个供应商（例如 huoshan、hebox、deepseek-official、tokenrhythm、opencode），并支持手动标注订阅 / 官方 API 以及别名（持久化到 $DSH_HOME/storages 下的 KV 单元）。
- KPI 卡片：总 tokens（输入 / 缓存命中 / 输出 / 推理明细）、缓存命中率、模型调用次数、轮次、会话数、供应商数量，并带有多彩的 token 组成比例条。
- 53 周热力图：GitHub 绿色风格，按每日模型调用次数显示强度；点击供应商标签进行筛选；悬停查看各供应商及各 token 明细。
- 趋势折线图：Token / Calls 双轴趋势，默认按天，“今天”按小时（小时级聚合）。
- 供应商模型下钻：点击供应商行可展开其各模型的消耗情况。
- 每日明细：按天显示 tokens / 缓存 / 输出 / 推理 / 命中率 / 轮次（最近 30 天）。
- 每月汇总：按月份聚合全部历史记录。
- 供应商 KPI 表格：按总 tokens 排序，包含命中率、模型数量、类型徽章；点击某行可下钻查看模型。
- 时间预设：今天 / 7 天 / 14 天 / 30 天 / 90 天 / 全部。
- 成本估算：为每个供应商设置每百万 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 ""

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

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

使用方法

1. 打开设置（侧边栏底部），找到 API 用量统计页面，或点击侧边栏底部的 📊 用量统计条目以打开全屏面板。
2. 热力图颜色 = 每日调用次数；点击厂商标签或表格行可筛选 / 下钻。
3. 在厂商管理中，设置每个厂商的别名和类型（订阅 / 官方 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__ 工厂格式的浏览器打包文件，注册 API 用量统计设置页面（settings.section 插槽）、侧边栏底部条目（sidebar.footer.action）和全屏面板（shell.overlay）。

开发

- 编辑 lib/index.js / lib/client.js 后刷新页面即可生效（客户端打包文件随页面加载）；宿主端更改需要重启 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