前言¶
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 倉庫 查看。
