前言¶
DeepSeek Harness（DSH）是用于构建智能体的开发平台。在开发调试过程中，实时掌握 API 调用成本有助于控制预算并优化提示词。官方账单通常存在延迟，且无法在开发阶段提供细粒度的成本反馈。下面介绍 dsh-api-cost 插件，它通过本地会话日志实时计算并显示成本。
这是什么¶
dsh-api-cost 是 DeepSeek Harness 的一个客户端插件，由开发者 CCCq-C 维护，采用 MIT 许可证。它通过本地会话投影计算 API 用量成本，无需修改宿主仓库即可独立运行。
核心功能¶
该插件主要提供以下能力：
- 实时成本显示：在浏览器输入栏上方显示一个“成本芯片”，实时更新当前的 API 消耗。
- 会话投影：基于会话日志的
apiCost投影，计算并展示每条样本的成本。 - 可配置费率：支持按美元/百万 tokens（USD/M tokens）配置费率表，并支持针对特定模型覆盖默认费率。
- 双语 UI：界面支持中文/英文切换，跟随宿主语言设置。
- 独立插件：作为独立的插件包，通过
cordis.patch.yml注入，不侵入宿主代码。
安装与启用¶
使用官方 CLI 安装：
dsh plugin --profile web add dsh-api-cost
安装完成后，重启 dsh web 服务，加载器会自动应用插件包内的配置。之后在任意会话中发送消息，输入栏上方就会出现成本芯片。
典型用法¶
启用插件后，发送消息即可在输入栏上方看到类似 API cost $0.0023 1.2K + 3.4K tok 的实时显示，其中包含总成本、输入 Token 和输出 Token 的数量。
如果需要调整费率或货币，需编辑配置文件 $DSH_HOME/profiles/web/cordis.patch.yml，在 api-cost 行中添加 config 字段。配置结构通常包含货币类型、默认费率以及针对特定模型的覆盖配置。
适用场景与注意¶
该插件适合需要在开发阶段即时监控成本的 DSH 用户。
在使用时需要注意以下几点：
- 估算值差异：成本是基于本地会话日志的估算值，可能与 DeepSeek 官方账单存在差异。这可能源于官方侧的缓存策略、价格变动或模型重命名。
- 模型切换计费：如果在会话中切换模型，后续的使用样本将按切换后的模型费率计费。
- 子代理独立显示：子代理拥有独立的会话 ID，其成本不会聚合显示在父会话的成本芯片中。
结尾¶
dsh-api-cost 为 DSH 开发者提供了一个轻量级的成本监控手段。通过本地计算和灵活的配置，能够有效辅助开发过程中的成本控制。更多详情可参考插件目录或 GitHub 仓库。
