前言¶
在 DeepSeek Harness（DSH）这类强调“一切皆插件”的 Web 运行环境里，多模型调用后常见的问题是：各模型消耗了多少 tokens、哪部分命中了缓存、费用大约多少、DeepSeek 账户还剩下多少余额。model-usage-plugin 是一个 DSH Web 插件，用于统计各模型 tokens 消耗并估算费用，同时显示 API 账户余额。它把 token 明细、费用估算和余额查看放到设置面板中，适合需要在 DSH 里核对模型调用成本的使用者。
这是什么¶
model-usage-plugin 是 DSH Web 插件，仓库地址为 https://github.com/AKS1st/model-usage-plugin，许可证为 MIT。它解决的核心问题是：按模型查看 tokens 消耗、估算费用，并在页面中展示 DeepSeek 账户余额。
核心功能¶
下面按能力拆开看。
按模型统计 tokens 与调用¶
- 按模型统计 tokens，区分缓存命中 / 未命中 / 写入。
- 统计调用次数与失败次数。
- 基于价格估算费用。
默认价格与自定义价格¶
- 内置主流模型默认价格：国产模型按人民币，海外模型按美元。
- 首次使用自动套用默认价格，之后可随时修改。
- 每个模型卡片可以点“配置价格”修改单价与计价货币，也可以点“重置”恢复默认价。
峰谷定价¶
每个模型可勾选“峰谷定价”，最多支持两个高峰时段（HH:MM，支持跨零点）。两个高峰时段共用同一组高峰价；高峰期 token 按高峰价计费，非高峰期按正常价计费。如果高峰价留空，则沿用正常价。
DeepSeek 默认价按官方最新峰谷计费更新：
deepseek-v4-flash/deepseek-v4-pro预置官方 2026-08-17 定价，包括空闲价与高峰价、两个高峰时段09:00–12:00/14:00–18:00，时段按服务器本地时间。deepseek-chat/deepseek-reasoner为官方最新价。- 已知 DeepSeek 模型若仍停留在旧默认价或峰谷时段为空，启动时会自动升级为官方默认配置；已配置有效高峰时段的用户自定义价格不受影响。
汇率与余额¶
- 费用统一按目标货币展示，默认人民币。
- 汇率成功获取后连同时间戳缓存到数据文件。
- 无缓存时启动自动刷新一次。
- 打开设置页时，如果缓存不超过一周，不自动刷新，需手动点击“更新汇率”；无缓存或超过一周则自动刷新一次。
- 查询 DeepSeek 账户余额，并在页面顶部大字展示总 Token 与账户余额。
展示控制¶
设置面板提供“模型消耗”页签。勾选“仅显示已调用模型”后，只展示实际使用过的模型，未使用过的模型会被隐藏。
安装与启用¶
该插件通过 dsh plugin（pnpm 转发）安装到 profile，并自动登记为 bundle 层。仓库说明标注为纯 JS，零构建，即装即用。
从 GitHub 仓库安装¶
执行下面命令安装，并重启 web 服务使 profile 生效：
dsh plugin --profile web add github:AKS1st/model-usage-plugin
dsh web # 重启 web 服务使 profile 生效
本地安装¶
先 clone 仓库，再指向仓库目录安装：
git clone https://github.com/AKS1st/model-usage-plugin.git
dsh plugin --profile web add /path/to/model-usage-plugin
dsh web
卸载¶
执行下面命令移除插件：
dsh plugin --profile web remove model-usage-plugin
典型用法¶
经过上面的步骤后，可按下面方式使用：
- 打开 设置 → 模型消耗。顶部会显示总 Token、账户余额、目标货币与汇率状态。
- 查看每个模型卡片中的 token 明细与费用。
- 点“配置价格”修改单价与计价货币、启用峰谷定价，并设置高峰时段与高峰价。
- 需要恢复默认价时，点“重置”。
- 勾选“仅显示已调用模型”，页面只显示实际使用过的模型。
数据、权限与注意¶
- 统计、价格与汇率缓存（含时间戳）保存在
$DSH_HOME/musage-stats.json。 - 页面填写的余额 API Key 仅保存在内存，不会写入磁盘；需要持久化时，请配置
DEEPSEEK_API_KEY环境变量或凭证。 - 插件以当前 dsh 进程权限运行。安装前建议检查源码与许可证；该仓库许可证为 MIT。
- DSH 插件生态强调“一切皆插件”，该插件以独立仓库形式提供，使用时按仓库说明和许可证判断。
结尾¶
model-usage-plugin 适合需要在 DSH Web 中查看模型 tokens 消耗、缓存明细、费用估算和 DeepSeek 账户余额的场景。它把常用成本信息集中到设置面板，方便按模型核对调用情况。仓库地址：https://github.com/AKS1st/model-usage-plugin。
