DeepSeek Harness (DSH) Desktop 在處理模型請求失敗時,內置了一套自動重試機制(默認重試 2 次)。但在某些特定場景下,你可能希望調整這個上限,或者完全禁用自動重試。dsh-model-retry-settings 插件解決了這個問題,它允許你通過 DSH Desktop 的設置界面直接配置自動模型請求的最大重試次數,無需修改核心代碼。
插件概覽¶
- 名稱:dsh-model-retry-settings
- 核心價值:通過 DSH Desktop 設置直接配置自動模型請求的重試次數。
- 維護者:y2zyyr
- 分類:模型推理
- 許可證:MIT
- 安裝方式:npm 包安裝,純插件實現。
核心功能¶
該插件主要提供以下能力:
- 原生設置集成:在 DSH Desktop 的「設置 → 通用」中新增一個配置項,用於調整重試次數。
- 全局重試限制:配置的數值對所有使用 DSH 標準重試策略的模型提供商生效。
- 支持取值:0、1、2、3、5、10。
- 默認行爲:默認值爲 2,與 DSH 內置默認值一致(安裝插件後不配置,行爲不變)。
- 持久化與實時:配置隨應用重啓保留,修改後無需重啓應用,下一個失敗請求即可應用新配置。
- 保持原有邏輯:不改變 DSH 內部的可重試錯誤分類(如
EMPTY_RESPONSE,RATE_LIMIT等)、指數退避、抖動及請求取消機制。
安裝與啓用¶
使用 DSH CLI 安裝該插件到指定的 web 配置文件中:
dsh plugin --profile web add @y2zyyr/dsh-model-retry-settings
安裝完成後,插件會自動加載。由於默認值爲 2,安裝後若不進行修改,DSH 的行爲與內置默認完全一致。
典型用法¶
- 打開 DSH Desktop。
- 進入 設置 → 通用。
- 找到 最大模型請求重試次數 配置項。
- 選擇需要的數值。
數值語義:
* 0:僅發起初始請求,不進行自動重試。
* 2:在初始請求失敗後,最多自動重試 2 次(總共最多 3 次請求)。
注意事項與限制¶
- 重試語義:配置的數值是「初始請求之後」的重試次數,不計入初始請求。
- 錯誤分類:該插件僅改變最大重試次數,不改變 DSH 對錯誤的分類。例如,認證錯誤和憑證錯誤永遠不會被轉換爲重試。
- 接口依賴:插件依賴 DSH 內部/RC 接口(如
agent/request-error重試策略和設置 seam)。如果 DSH 進行了重大版本更新,這些接口可能發生變化,插件可能失效。 - 安全性:當前 DSH 版本未通過通用設置 API 暴露任意插件設置命名空間。該插件使用受限的本地主機路由,僅暴露重試限制值,並限制在本地/受信任的 DSH 瀏覽器上下文中訪問。
總結¶
dsh-model-retry-settings 爲 DSH 用戶提供了在不觸及核心代碼的情況下,精細化控制模型請求重試策略的能力。對於需要嚴格控制重試上限或強制快速失敗的場景,該插件是一個實用的工具。