前言¶
DeepSeek Harness(DSH)支持通過插件擴展功能。在模型推理過程中,針對特定提供者配置重試次數是常見的調試或容災手段。這款插件通過在 Web 界面添加一行配置項,將原本分散或需要修改配置文件的重試預算管理能力統一到了設置頁面。
插件定位¶
這是一個 DeepSeek Harness Web 插件,用於配置活躍提供者的模型請求重試預算。項目託管在 GitHub,開源協議爲 MIT,由用戶 502399493zjw-lgtm 維護。它通過 Settings → General 界面讓用戶能夠直觀地調整這一數值。
核心功能¶
插件主要實現以下邏輯:
1. 界面集成:在設置頁面的通用設置中增加一個數字輸入行,顯示其適用的提供者範圍。
2. 數值控制:支持輸入有限的非負整數(包括 0),直接控制重試上限。
3. 自動發現:通過讀取 llm.providers 發現當前活躍且可配置的提供者。
4. 策略處理:
* 針對“普通/默認”策略,寫入 retryPolicy.maxRetries。
* 針對“always”策略,保持無限重試。
* 保留現有的退避和可重試代碼字段,不干擾 DSH 自身的重試執行與退避行爲。
5. 安全寫入:使用帶版本控制的 settings.mutate 調用來修改配置,避免併發衝突。
安裝與啓用¶
使用官方提供的安裝命令添加插件:
dsh plugin --profile web add @zhongjingwei/dsh-model-retry@0.1.0-rc.9
安裝完成後,必須重啓 Web 界面才能使配置生效。
典型用法¶
- 在 Web 界面進入
Settings → General。 - 找到新增的“重試次數”配置行,將數值從默認值(如 2)修改爲 5。
- 插件會通過 API 將
retryPolicy.maxRetries更新爲 5。 - 在後續的模型請求中,如果失敗,DSH 會依次執行 1/5 到 5/5 的重試,直到第 6 次請求成功或達到設定的上限。
適用場景與注意¶
- 版本依賴:插件僅兼容 DSH
0.1.0-rc.8。該版本將重試配置移入了提供者配置中,插件通過已發佈的設置 API 來完成寫入。 - 運行環境:需要 Node.js 版本
^22.19.0 || >=24.0.0。 - 架構性質:這是一個外部 Cordis 插件,不修改 DSH 核心代碼。
總結¶
該插件爲 DSH 提供了一個輕量級的重試預算配置入口,適合需要在 Web 界面快速調整模型容錯策略的場景。插件源碼與詳情可查閱其 GitHub 倉庫。