前言¶

DeepSeek Harness（DSH）的扩展方式以插件为主，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

智能体开发者在使用 DSH 时，通常会遇到几个实际问题：本月消耗量到了什么量级、估算花费是多少、8-17 DeepSeek 调价前后差异如何、缓存节省了多少、哪个模型或会话消耗更多。

dsh-whale-meter 是一个社区插件，用于把这些信息集中在一个用量与费用面板里。

这是什么¶

dsh-whale-meter 的定位是 DSH 用量与费用面板，由 Shiye-10Pages 维护，许可证为 MIT。

它支持本地计算与零上报，所有数据都在本机。除配置 API key 后的余额查询外，不发出任何网络请求。

核心功能¶

用量与花费估算¶

• 本月消耗量段位（五档）与估算分位
• 今日、昨日、本月、累计花费估算
• 每日预算线提醒

价格与调价对比¶

• 8-17 DeepSeek 涨价前后对比
• 高峰/空闲两档峰谷计价
• 跨调价日按价格生效区间分别计价
• 缓存命中率与节省金额展示

多模型与账单¶

• DeepSeek、Anthropic、OpenAI、Google、智谱 GLM、月之暗面 Kimi 共 46 个模型计价
• 国内厂商分档计价
• 分模型、分会话账单
• 安装前历史会话回填
• 近 14 天趋势
• 配置 API key 后查询账户余额
• 一键生成账单分享卡片

安装与启用¶

1、运行安装命令。命令中的 <你的profile> 为占位符，需要按实际 profile 填写。

dsh plugin --profile <你的profile> add dsh-whale-meter

2、安装完成后重启 dsh web。会话页顶部会出现花费徽章。

如果从源码安装：

dsh plugin --profile <你的profile> add github:Shiye-10Pages/dsh-whale-meter

从源码首次安装时，需要在 profile 的 pnpm-workspace.yaml 里授权构建，建议锁定 commit。

配置¶

零配置即可用。

需要调整时，可在 profile 的 cordis.patch.yml 中覆盖 whale-meter 的相关配置项：

• currency
• budgetDaily
• apiKey
• usdToCny
• backfill
• pricingUpdate
• prices

其中 apiKey 用于余额查询；缺省读 DEEPSEEK_API_KEY 环境变量。

价格默认使用内置表；远程表可选，拉取失败会回退内置表。未知模型不会编造价格，会标记为「未定价」。

典型用法¶

查看汇总¶

在 TUI 场景中，可以直接请求以下接口：

curl http://127.0.0.1:3080/whale-meter/api/summary

更新价格数据¶

更新价格时，先修改 src/pricing.data.ts，然后运行：

npm run gen:pricing

完成后再提交 PR。

适用场景与注意¶

dsh-whale-meter 适合需要查看 DSH 用量、估算花费、对比调价影响，以及按模型或会话拆分账单的开发者。

使用前注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。
• dsh 处于 developer preview，接口变动时插件会跟进适配。
• 余额查询需要配置 API key；除该查询外，不发出任何网络请求。

链接¶

• 目录页：https://www.skillhub.cn/plugins/Shiye-10Pages/dsh-whale-meter
• GitHub：https://github.com/Shiye-10Pages/dsh-whale-meter