前言¶
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 插件故障对开发工作的干扰。更多详情可参考项目主页。
