dsh-boot-guard
当损坏的插件阻止 Web UI 启动时，为 DeepSeek Harness 提供不依赖加载器的救援控制台。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-boot-guard@1.1.2
Boot Guard 以 dsh-boot-guard 发布，当前版本为 1.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 · English
插件把插件管理页面一起弄崩了，接下来怎么办？
dsh-boot-guard 是给 DeepSeek Harness Web UI 准备的一道小保险。正常情况下它安安静静地待着；只有插件加载失败、页面只剩下 Failed to load plugins 时，它才会出现，帮你找出可疑插件、临时跳过，然后把工作区救回来。
上图是只读自检模式，只展示界面和诊断结果，不会真的改配置。
起因其实有点尴尬：我在给 DSH 调一个界面插件，刷新之后，整个 Web UI 直接起不来了。
问题插件本来应该去插件管理页里关掉，可插件管理页也属于 Web UI。结果就像把车钥匙锁在车里——明明知道是哪儿出了问题，却没有入口修它。
Boot Guard 就是为这个死循环写的。它不依赖正常的客户端插件加载链，而是由 host 直接把一段很小的救援脚本放进失败页面。其他插件没能加载时，它仍然有机会工作。
它不会删除插件，也不会碰插件的数据。所谓“跳过”，只是向当前 DSH profile 的 cordis.patch.yml 写入一个带 Boot Guard 标记的 disabled: true 数组项；写入前会识别空文件、[] 和已有数组，恢复时也只会删除自己写入的块。
需要先安装并运行 DeepSeek Harness。
dsh plugin --profile web add github:SaiSenBox/dsh-boot-guard
安装完成后重启 dsh web。
如果这个包已经发布到 npm，可以直接用：
dsh plugin --profile web add dsh-boot-guard
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。
Failed to load plugins，恢复中心会自动挂在错误信息下方。恢复全部需要点两次，主要是防手滑。单次最多处理 64 个条目，通常远远够用；真的遇到大面积故障时，可以分批操作。
不必真的弄坏插件来测试它。启动 DSH Web 后打开：
http://127.0.0.1:3080/boot-guard/previewhttp://127.0.0.1:3080/boot-guard/preview?theme=lighthttp://127.0.0.1:3080/boot-guard/health自检页是只读的。搜索、筛选和勾选都能试，最终操作不会写入配置。
这个插件会修改本地配置，所以边界写得比较死：
POST + JSON 请求，并且默认只允许本机回环连接dsh.profile 的 profile 时自动进入只读模式，不会猜测当前目录[] 会安全归一化，其他结构直接拒绝如果确实需要从非回环地址直接执行恢复操作，可以在启动 DSH 前显式设置 DSH_BOOT_GUARD_ALLOW_REMOTE_MUTATION=1。这会放宽 Boot Guard 的本机限制；没有额外认证保护时不建议开启。
当前版本在 DSH 0.1.0-rc.6、Node.js 24.5.0 和 Windows 上完成验证。项目遵循 DSH 官方 Node.js 要求：^22.19.0 || >=24.0.0。
DSH 目前仍是 developer preview，插件接口可能继续变化。如果新版本把救援入口弄坏了，欢迎带上 DSH 版本和“复制诊断”的内容提 Issue。
npm run check
npm test
npm run pack:check
这个项目故意不引入客户端运行时依赖。救援工具最重要的能力，是在其他东西都没有正常起来时，自己还能起来。
MIT © 2026 SaiSenBox