前言¶
DeepSeek Harness (DSH) 採用插件化架構，Web 管理界面依賴若干可選插件。若這些插件包缺失或啓動時拋出錯誤，整個 Web 管理界面通常會崩潰，導致無法進行配置與管理。dsh-recovery 旨在解決這一問題，它能在插件異常時保持 Web 界面可用，並提供診斷與修復入口。
插件介紹¶
這是一個由 Tangtang232 維護的插件，定位爲 Web 端急救工具。它通過隔離啓動失敗的插件，確保 DSH Web 管理平面在插件異常時仍能保持運行，並在設置頁面提供修復操作。
核心功能¶
該插件具備以下能力：
- 保底運行：當可選插件包缺失時，保持 Web 管理界面運行。
- 錯誤隔離：在激活過程中，將拋出錯誤的可選插件隔離，避免拖垮整個系統。
- 診斷報告：報告插件 ID、模塊名稱、失敗類別以及是否支持自動修復。
- 依賴重裝：從 Web 頁面重新安裝記錄的 npm、GitHub 或本地依賴。
- 配置恢復：恢復最後已知的正常 Web 配置文件。
- 全面檢查：檢查設置、插件清單、代理預設、模型提供商以及本地主機/來源信任。
- 安全修復：修復前備份配置文件，驗證失敗時自動回滾。
安裝與啓用¶
在兼容的 DSH 構建版本上，使用以下命令安裝插件：
dsh plugin --profile web add github:Tangtang232/dsh-recovery#v0.1.0
安裝完成後，重啓 dsh web，然後打開 Settings → Recovery → Check and repair。
修復流程¶
修復流程完全在 Web 界面中完成，具體步驟如下：
- 讀取啓動時隔離的失敗項。
- 備份
package.json、鎖文件、工作區文件和配置文件補丁。 - 僅從配置文件清單中已記錄的來源恢復包。
- 重試插件激活或恢復最後健康的配置文件。
- 重新檢查管理 API。
- 當恢復或驗證失敗時回滾修改的文件。
注意事項¶
- 不調用模型 API：Recovery 不會調用模型 API 進行推理。
- 網絡依賴：包恢復可能需要網絡，僅當記錄來源爲遠程時。
- 版本兼容性：當前官方 DSH 版本不包含預插件啓動隔離或
recovery.scan/recovery.repair管理方法。在此版本上安裝此包無法恢復失敗的 Web 啓動。插件僅兼容基於 DSH0.1.1-rc.2的開發構建。 - 安全策略：永遠不會猜測未知的包來源，仍然失敗的插件將保持隔離。
總結¶
該插件通過結構化的修復流程，降低了 DSH 插件故障對開發工作的干擾。更多詳情可參考項目主頁。
