前言¶

DSH 的插件机制，适合把成本查看、额度显示和导出这类界面能力拆成独立包。对于长期使用多个模型、多个 provider 或中转站的开发者来说，手动记录 token 和余额容易出现口径不一致。

dsh-ui-usage-billing 是 kenz1117 维护的一个 DeepSeek Harness 插件。它通过 npm 包 @kenz1117/dsh-ui-usage-billing 安装，许可证为 MIT。插件在侧边栏提供成本指标入口，并提供全屏仪表盘，从持久化会话日志聚合真实用量，再按多厂商目录估算费用。

下面介绍它的功能、安装方式和需要留意的边界。

这是什么¶

一句话定位：面向 DSH 的用量计费仪表盘。资料说明它属于纯 UI surface，不注册工具、不注入系统提示、不向会话日志写入模型可见事件。

当前 package.json 标注版本为 1.0.15，许可证为 MIT。engines 要求为：

node ^22.19.0 || >=24.0.0

核心功能¶

侧边栏与仪表盘¶

启动宿主后，侧边栏设置上方出现计费入口。打开后是全屏仪表盘，分区包括：

• 概览
• 趋势
• 明细
• 统计
• 费率
• 设置

服务端从持久化会话日志实时聚合真实用量；数据到达前显示空快照。

费用估算与自定义单价¶

插件按实时多厂商官方价估算费用，并支持峰谷计价：

• 工作日高峰时段 ×2
• 周末全天按低谷价计费

自定义单价用于未收录或变价模型，可填写：

• 未命中
• 缓存命中
• 输出

可选 USD 与低谷价。

未计价模型费用按 0 计，并在 Hero 下提示 N 个模型未收录计价。

订阅、余额与对账¶

资料列出的订阅与余额能力包括：

• 订阅套餐额度识别与显示，包括 Kimi / Z.ai / OpenCode Go / MiniMax / OpenRouter / 小米 / 火山等
• 多厂商余额查询：DeepSeek / Kimi / 阶跃星辰 / 硅基流动 / xAI / 智谱 GLM / 腾讯云 TokenHub
• 中转站余额与滚动额度识别，按 provider baseURL 归一化 origin 归组
• 声明端点 declaredEndpoints
• 余额差对账 reconcilePath

用量明细与导出¶

资料列出的明细与导出能力包括：

• 成本突增归因：最近 40 轮每轮费用柱状图，超 2 倍红标
• 会话明细
• 月 / 年日历热力图
• 性能指标：TTFT 均值 / P50 / P90、tokens/s、总延迟均值
• Token 统计：输入（缓存未命中）/ 输入（缓存命中）/ 输出，含 reasoning 思考
• 按日 / 按会话 / 按站点 CSV 导出
• 全量 JSON 导出

CSV 导出对以 = / + / - / @ 开头的单元格前置单引号，并转义逗号 / 引号 / 换行 / 回车。

国际化与离线能力¶

资料列出的基础能力包括：

• 多语种：中文 / English
• 双币种：¥ / ≈$ 切换
• 离线自包含：无图表库、无外部 CDN、纯设计令牌

安全与隐私¶

资料列出的安全边界包括：

• 全部 HTTP 端点强制回环访问
• 写操作额外校验 Origin 回环与 Content-Type application/json
• 隐私底线：纯 UI surface，不注册工具、不注入系统提示、不向会话日志写入模型可见事件

安装与启用¶

先检查宿主版本和依赖，再安装 npm 包，最后启动宿主。

资料说明兼容底线为 DSH 0.1.2-alpha.1；旧宿主 0.1.0-rc.8 到 0.1.1-rc.2 建议停留在 v1.0.11。资料中的 peerDependencies 列表被截断，安装前建议以宿主和包的当前依赖为准。

1、安装 npm 包：

npm install @kenz1117/dsh-ui-usage-billing

2、在宿主 cordis.patch.yml 中加入：

- insert:
    - id: ui-usage-billing
      name: '@kenz1117/dsh-ui-usage-billing'

3、启动宿主后，侧边栏设置上方出现计费入口。

4、sessionPersistence 可用时自动聚合真实用量。

典型用法¶

先启动宿主，再从侧边栏进入仪表盘。下面几个示例来自资料：

• 未收录或变价模型：使用自定义单价，可填未命中、缓存命中、输出，并可选 USD 与低谷价。
• 腾讯云 TokenHub：凭据值填 <SecretId>:<SecretKey>。
• MiniMax 国内开发者环境：使用 minimax-token-plan-cn，自动对接 https://api.minimaxi.com。
• 导出：按日 / 按会话 / 按站点导出 CSV，也可导出全量 JSON。

适用场景与注意¶

适合在以下情况使用：

• 使用 DSH，并且需要把多 provider、多会话的用量与费用放在同一界面查看。
• 需要同时查看订阅额度、多厂商余额、中转站额度、声明端点与余额差对账。
• 需要导出 CSV / JSON，做后续核对或归档。

使用前注意：

• 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证；当前许可证为 MIT。
• 真实用量聚合依赖 sessionPersistence；资料说明 sessionPersistence 可用时自动聚合真实用量。
• 费用是估算口径：按实时多厂商官方价估算；未计价模型按 0 计，并在 Hero 下提示未收录计价模型数量。
• 资料中的 peerDependencies 列表被截断，不能据此确认完整依赖。
• 全部 HTTP 端点强制回环访问，写操作额外校验 Origin 回环与 Content-Type application/json。

小结¶

dsh-ui-usage-billing 提供的是一个 DSH 客户端侧的成本查看层：侧边栏入口、全屏仪表盘、真实用量聚合、多厂商价格估算、订阅余额与导出。它的边界也清楚：不注册工具，不注入系统提示，不写入模型可见事件。

GitHub：https://github.com/kenz1117/dsh-ui-usage-billing

资料中给出的目录页：https://www.skillhub.cn/plugins/kenz1117/dsh-ui-usage-billing