DeepSeek Harness（DSH）采用「一切皆插件」的架构。在进行智能体开发或模型调用时，开发者往往需要实时监控 Token 消耗、费用计算以及钱包余额。如果不借助额外工具，这些信息往往散落在日志或控制台中，难以直观查看。下面介绍一款专为 DSH 打造的插件，用于解决上述痛点。
该插件名为 dsh-usage-meter-harness，由开发者 faith1688 维护。它是一个标准的 DSH Cordis 插件，能够为 DeepSeek Harness 提供实时的用量、费用与余额计量功能。
功能概览¶
插件提供以下核心能力：
- 实时监控：在聊天输入框旁直接显示 Token 数量、花费金额与真实余额。
- Token 细分：支持输入、缓存命中、缓存写入、输出四个维度的 Token 细分。
- 回合与速度：提供回合使用面板，展示单轮用量与单位价格（高峰/低谷）；支持实时 Token 速度监控。
- 缓存统计：提供会话的缓存命中率统计。
- 钱包与预算：展示真实 DeepSeek 钱包余额（其他提供商可使用本地记账估算），并支持预算与剩余额度追踪。
- 计费引擎：
- 提供 6 种计费模板（基础、缓存命中/未命中、峰谷、缓存写入+命中、输入+输出、批量半价）。
- 支持自定义价格行（最多 4 行）。
- 峰谷计费基于北京时间工作日及小时窗口，支持跨午夜计费。
- 支持按模型定价、共享钱包。
- 内置 137 个模型（19 个厂商）的价格表。
- 自动汇率转换（USD -> CNY）。
- 支持同步官方价格（需提供官方 API Key）。
- 设置与体验：
- 双语 UI（中文/英文）。
- 提供 20+ 内置主题。
- 生成时锁定价格，确保一致性。
- 所见即所得的弹出窗口。
安装与启用¶
安装前需确保已安装 DSH CLI。安装方式取决于你是否使用 pnpm。
前置条件（方法 1 和 2 需要 pnpm）¶
DSH CLI 本身运行在 pnpm 上，若使用方法 1 或 2，需先安装 pnpm：
npm install -g pnpm
# 或
corepack enable
安装方法¶
方法 1：通过 DSH CLI 使用 npm 仓库（需要 pnpm）
dsh plugin --profile web add --verbose @faith1688/dsh-usage-meter-harness@latest
方法 2：通过 DSH CLI 使用 GitHub 仓库（需要 pnpm）
dsh plugin --profile web add --verbose github:faith1688/dsh-usage-meter-harness#main
方法 3：一行命令安装（推荐，不依赖 pnpm）
此方法直接使用 npm，无需配置 pnpm 协调：
npx -y @faith1688/dsh-usage-meter-harness@latest
安装完成后，必须重启 dsh web 以应用更改：
dsh web
使用与更新¶
安装成功后，在聊天界面即可看到实时用量面板。若需更新插件：
- 全新安装或使用 npx 方法：直接再次运行上述安装命令即可。
- 使用 pnpm 更新：在配置目录下运行：
pnpm update @faith1688/dsh-usage-meter-harness
- 强制更新：如果 pnpm 报告版本未更新（由于新版本发布后的 24 小时冷却期），或绑定方式为
file:路径，请直接使用npx命令：
npx -y @faith1688/dsh-usage-meter-harness@latest
该命令具有幂等性，会自动升级配置。
注意事项：
* 安装程序不会修改 profile 根目录的 cordis.patch.yml，因此你手动添加的其他插件配置不会被覆盖。
* 如果在 pnpm 环境下更新遇到“已满足”提示，请使用 npx 命令强制拉取最新版本。
适用场景¶
该插件适用于所有使用 DeepSeek Harness 进行模型调用的开发者，特别是需要精细控制成本、监控缓存命中率以及需要多模型共享钱包的场景。
总结¶
dsh-usage-meter-harness 为 DSH 提供了一套完整的成本控制与用量监控方案。通过实时面板、峰谷计费及官方价格同步，开发者可以更直观地管理资源消耗。
