前言¶
在 DeepSeek Harness (DSH) 的使用場景中,針對不同 LLM 提供商調整請求重試策略(如重試模式、最大重試次數)及超時參數(如連接超時、流式空閒超時)是常見需求。若需手動修改配置文件或通過代碼調整,流程較爲繁瑣。dsh-llm-retry-settings 插件提供了可視化的設置頁面,直接對接 DSH 的公共設置接口,用於管理這些參數。
插件簡介¶
這是一個客戶端插件,由 Yiklek 維護。它通過新增的設置頁面,允許用戶查看和編輯各個 LLM 提供商的請求重試策略和超時字段。
核心功能¶
該插件主要提供以下能力:
- 重試策略配置:支持設置重試模式(
mode:normal或always)以及最大重試次數(maxRetries)。 - 超時字段管理:支持配置超時毫秒數,包括通用請求超時(
timeoutMs)、WebSocket 連接超時(websocketConnectTimeoutMs)以及流式傳輸空閒超時(streamIdleTimeoutMs)。 - 即時生效:所有寫入操作通過
settings.mutate進行,修改後無需重啓 DSH 進程,下一次模型請求即可生效。 - 架構設計:純客戶端插件,宿主端邏輯爲空;GUI 通過迴環 API 網關與系統交互,交互方式與內置的模型設置頁面一致。
安裝與啓用¶
使用官方安裝命令即可完成加載,無需手動編輯配置文件:
npx @deepseek-ai/dsh plugin --profile web add github:Yiklek/dsh-llm-retry-settings
安裝完成後,插件會自動添加到 dsh.profile.bundles 並加載其補丁層。
典型用法¶
插件利用 llm-retry 執行器,但具體策略與超時配置位於各提供商的設置命名空間中(如 llm-pi-ai、llm-deepseek)。
超時字段會從各命名空間的設置架構中自動發現;對於已知的內置提供商,系統使用已知的回退映射表。
在 DSH 界面中找到對應 LLM 提供商的設置頁面,即可查看並修改上述參數。
適用場景與注意¶
- 適用場景:需要在 DSH 界面直接調整 LLM 連接重試與超時行爲的開發者。
- 注意事項:此插件爲標準 dsh bundle 插件,依賴
package.json中聲明的dsh.bundle.patch指向cordis.patch.yml。 - 風險提示:插件基於 MIT 許可證開源,安裝前建議檢查源碼以確保安全。
結語¶
該插件簡化了 LLM 連接參數的配置流程。更多細節與源碼可參考 GitHub 倉庫。