前言¶
在使用 DeepSeek Harness (DSH) 进行模型开发和调试时，成本控制是重要的一环。开发者需要清晰地了解会话或单轮对话的预估费用。dsh-cost-meter 插件提供了这方面的能力。
这是什么¶
这是一个由 guojinpeng 维护的 DSH 插件。它显示会话和完成轮次的成本估算，支持 models.dev、OpenRouter 和 DeepInfra 的价格同步与自定义模型单价。
核心功能¶
插件的核心在于将复杂的 token 消耗转换为清晰的费用信息。
- 费用显示：显示会话和完成轮次的成本估算。会话面板按峰值价格、非峰值价格和固定价格分组，列出每个模型的组总和；轮次面板列出每个模型对应组的四个价格详情。
- 数据过滤：隐藏成本为零的行，不显示峰值或非峰值 token 计数。
- 分组统计：按提供商分组使用的模型，列表来自 DSH 会话历史。
- 货币支持：支持每个模型的 USD 或 CNY，更改货币时会转换所有四个费率，并显示单独的 USD 和 CNY 总计。
- 价格来源：可选择 models.dev、openrouter.ai 或 api.deepinfra.com 作为价格来源。支持每个全
provider/model名称的单独价格。 - 价格同步与缓存：从所选来源的本地缓存初始化新模型价格。仅在您选择 Sync prices 时下载模型价格。缓存文件单独存放于
data/models.dev.json、data/openrouter.ai.json和data/api.deepinfra.com.json。 - 价格匹配规则：按模型 ID 匹配源价格。保留不明确的匹配项的现有价格，当来源无法提供支持的费率时也保留现有价格。
- 高级设置与规则：支持不同的峰值规则（DeepSeek、Alibaba Cloud、Zhipu GLM）。使用假日日历（缓存于
data/holidays/）。
安装与启用¶
使用前请确保 DSH 版本为 0.2.0-rc.2 或更高。
1、在终端运行以下命令安装插件：
dsh plugin --profile web add -w @guojinpeng/dsh-cost-meter
2、重启 DSH。
3、打开 Plugins 面板，选择 @guojinpeng/dsh-cost-meter 以更改价格或同步价格。
典型用法¶
安装并重启 DSH 后，在会话或轮次面板中即可看到成本估算。点击价格详情上的信息按钮可以查看具体的计算公式。在插件设置中，您可以选择 Sync prices 来更新模型价格，或手动配置每个模型的 USD/CNY 单价及汇率。
适用场景与注意¶
该插件适合需要精细化管理 API 调用成本的开发者和研究员。插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。配置存储在 ~/.dsh/guojinpeng/dsh-cost-meter/config.json。
短结尾¶
dsh-cost-meter 帮助 DSH 用户直观地监控会话与轮次成本。查看 GitHub 或 SkillHub 目录 获取更多信息。
