前言¶
DSH（DeepSeek Harness）能精确计量令牌，但不会自动告知成本。现有的 harness 中没有价格表、没有 /cost 命令，也没有余额上限。dsh-plugin-price-aware 填补了这个空白。它让模型在每一轮都能读取自己的单价、账户余额和当前会话账单，并在执行昂贵步骤前提供 A/B/C 三档报价。
核心功能¶
该插件主要提供以下能力：
- 实时账单读取：模型可实时读取单价、账户余额及当前会话的运行账单。
- 成本估算：在执行任务前，提供 A/B/C 三档（最小/标准/详尽）的成本估算，每档包含令牌预估和金额。
- 预算闸门：当接近预算上限时，插件会主动询问用户，防止超支。
- 差异化定价支持：支持 DeepSeek 的高峰/非高峰定价及缓存命中价格。
- 命令行交互：提供
/money、/budget、/estimate等命令供用户查询和设置。 - 数学核心模块：提供纯数学核心模块，可供外部 harness、仪表盘或 CI 流水线中的预算检查使用。
安装与启用¶
使用以下命令安装插件：
dsh plugin add github:121212165/dsh-plugin-price-aware
安装完成后，必须重启 dsh 进程才能生效。插件的配置文件位于 cordis.patch.yml，所有字段均在该文件中 documented。
典型用法¶
安装并重启后，可按以下方式使用：
-
查看价格与余额
使用/money命令查看当前模型单价、账户余额、本会话已花费金额及剩余预算。 -
获取任务报价
使用/estimate <kind> [turns] [residentK]获取任务报价。这会返回 A/B/C 三档的成本预估。 -
管理预算策略
使用/budget [5]读取并修改预算策略。修改策略时，插件会打印配置编辑内容，而不是静默修改上限。 -
外部代码使用
在代码中导入dsh-plugin-price-aware/pricing模块，可复用其中的成本计算逻辑。
注意事项¶
- 重启依赖：安装后需重启 dsh 才能加载插件。
- 报价上限：报价仅是上限。若模型未停止说话，则无法保证最终成本不超过预估值。
- 依赖项：依赖
@deepseek-ai/cordis。 - 许可证：采用 MIT 许可证。
此插件通过实时账单和预算控制，解决了 DSH 在成本感知上的缺失问题。更多细节与源码，可前往 GitHub 仓库 查看。
