前言¶
在 DSH（DeepSeek Harness）開發中，當模型請求失敗且上游錯誤碼未被默認策略覆蓋時，往往會導致請求直接中斷。特別是當提供方將無法識別的上游錯誤歸類爲 PI_AI_ERROR 時，現有的重試機制可能無法發揮作用。此時需要一種獨立於內置策略的兜底機制來處理這類特定錯誤。
是什麼¶
lim12137/dsh-llm-extra-retry 是一個 DSH 插件，旨在爲模型請求失敗瀑布追加一條獨立恢復策略。它由 lim12137 維護，解決了當上遊返回 PI_AI_ERROR 錯誤碼時無法自動重試的問題。
核心功能¶
該插件提供以下能力：
* 針對 PI_AI_ERROR 錯誤，等待 20 秒後自動重試一次。
* 其他錯誤碼保留 @deepseek-ai/dsh-llm-retry 的默認策略（5 次有界指數退避）。
* 使用獨立的 policyKey 記賬，與內置策略互不干擾。
安裝與啓用¶
按照以下步驟將插件接入 DSH 環境：
1. 本目錄以 link: 依賴掛入 profiles/web/package.json；
2. 在配置中找到 dsh.profile.bundles，增加 "dsh-llm-extra-retry"；
3. 確保 node_modules/dsh-llm-extra-retry 爲指向本目錄的目錄聯接；
4. 重啓 DSH 使配置生效。
典型用法¶
插件默認行爲爲：檢測到 PI_AI_ERROR 時等待 20 秒重試一次。若需調整等待時長或重試次數，可修改插件根目錄下的 lib/index.js 文件，修改頂部的 DELAY_MS 或 MAX_RETRIES 常量。
適用場景與注意¶
此插件適用於需要對特定錯誤碼進行兜底重試的場景。使用前請檢查源碼與許可證（MIT）。注意：請求取消或插件卸載會立刻中止等待中的退避。
結尾¶
通過引入此插件，可以爲 DSH 的模型請求失敗增加一層針對 PI_AI_ERROR 的獨立恢復策略。更多詳情請參考 GitHub 倉庫。
