前言¶
在 DeepSeek Harness (DSH) 的使用中，配置模型提供方的重試策略（retryPolicy）通常需要直接編輯 settings.yaml 文件。這種方式缺乏可視化反饋，調整參數（如重試模式、次數、退避策略）時容易出錯。dsh-retry-policy-settings 插件旨在解決這一問題，提供一個可視化的編輯界面。
插件介紹¶
這是一個 DeepSeek Harness (DSH) 插件，由 guanosine-diphosphate 維護。它允許在 DSH Web UI 中直接編輯模型提供方的 retryPolicy 配置，包括模式、重試次數、可重試錯誤碼以及指數退避參數，並即時寫入配置文件。
核心功能¶
- 自動發現：自動讀取所有已註冊的模型提供方（如自定義 OpenAI 兼容 API、DeepSeek 官方等）。
- 全字段編輯：編輯提供方
retryPolicy的全部可選字段（mode,maxRetries,retryableCodes,backoff參數等）。即使文件中有默認值的字段也會顯示。 - 一鍵恢復：支持一鍵移除配置並恢復默認。
- 環境適配：中文/English 自動跟隨 DSH 全局語言切換，深色/淺色主題自適應。
安裝¶
通過 GitHub 安裝到你的 DSH profile：
dsh plugin --profile web add "github:guanosine-diphosphate/dsh-retry-policy-settings#main"
安裝後，將 dsh-retry-policy-settings 加入 profile 的 dsh.profile.bundles（<profile>/package.json），重啓 Web UI 即可使用。
使用方法¶
- 打開 DSH Web UI。
- 進入左下角的 設置。
- 點擊 模型重試策略（英文界面顯示 Model Retry Policy）。
- 選擇具體的提供方，調整模式與參數，點擊 保存。
配置寫入位置¶
插件修改後的配置會寫入到 settings.yaml，具體路徑取決於模型提供方所屬的適配器：
| 提供方類型 | settings.yaml 路徑 |
|---|---|
自定義 / pi-ai 提供方（如 scnet） |
llm-pi-ai.providers.<id>.retryPolicy |
DeepSeek 官方（deepseek-official） |
llm-deepseek.retryPolicy |
依賴與注意事項¶
- 依賴：依賴官方插件
@deepseek-ai/dsh-llm-retry（DSH 默認已啓用）。 - 模式限制：在
always模式下，maxRetries和retryableCodes字段會被禁用（由底層 Schema 限制）。
結語¶
該插件爲 DSH 用戶提供了管理模型重試策略的便捷入口，適合需要在 Web UI 中頻繁調整重試邏輯的開發者。
