dsh-boot-guard

简体中文 · English

插件把插件管理页面一起弄崩了，接下来怎么办？

dsh-boot-guard 是给 DeepSeek Harness Web UI 准备的一道小保险。正常情况下它安安静静地待着；只有插件加载失败、页面只剩下 Failed to load plugins 时，它才会出现，帮你找出可疑插件、临时跳过，然后把工作区救回来。

上图是只读自检模式，只展示界面和诊断结果，不会真的改配置。

为什么写它

起因其实有点尴尬：我在给 DSH 调一个界面插件，刷新之后，整个 Web UI 直接起不来了。

问题插件本来应该去插件管理页里关掉，可插件管理页也属于 Web UI。结果就像把车钥匙锁在车里——明明知道是哪儿出了问题，却没有入口修它。

Boot Guard 就是为这个死循环写的。它不依赖正常的客户端插件加载链，而是由 host 直接把一段很小的救援脚本放进失败页面。其他插件没能加载时，它仍然有机会工作。

它能做什么

• 从加载错误里找出疑似故障插件，并自动选中
• 默认只看用户插件，也可以搜索名称或 loader 条目 ID
• 临时跳过一个或一批插件，刷新后立即重新尝试启动
• 单独恢复某个插件，或二次确认后恢复全部救援跳过项
• 明确区分“Boot Guard 临时跳过”和“配置原本就禁用”
• 复制一份简短诊断，方便贴到 Issue 里一起排查
• 提供暗色、亮色和窄屏适配的只读自检页

它不会删除插件，也不会碰插件的数据。所谓“跳过”，只是向当前 DSH profile 的 cordis.patch.yml 追加一个带 Boot Guard 标记的 disabled: true 配置块；恢复时也只会删除自己写入的块。

安装

需要先安装并运行 DeepSeek Harness。

从 GitHub 安装

dsh plugin --profile web add github:SaiSenBox/dsh-boot-guard

安装完成后重启 dsh web。

从 npm 安装

如果这个包已经发布到 npm，可以直接用：

dsh plugin --profile web add dsh-boot-guard

本地开发安装（Windows）

git clone https://github.com/SaiSenBox/dsh-boot-guard.git
cd dsh-boot-guard
powershell -ExecutionPolicy Bypass -File .\install.ps1

本地安装器会把依赖放在 DSH profile 同盘目录，避开 Windows 上跨盘 file: 依赖可能产生的坏 junction。

怎么用

1. 当页面出现 Failed to load plugins，恢复中心会自动挂在错误信息下方。