SaiSenBox/dsh-boot-guard
40Last commit Aug 15, 2026
dsh-boot-guard DSH plugin
Boot Guard is a DSH plugin designed to rescue the Web UI when plugin loading fails, leaving the page with 'Failed to load plugins'. It automatically detects suspicious plugins, allows temporary skipping, and restores the workspace. It works by injecting a small rescue script into the failure page, independent of the normal client plugin loading chain.
How to install the dsh-boot-guard DSH plugin
dsh plugin --profile web add github:SaiSenBox/dsh-boot-guardCopying does not run this command. Review the repository and version before installing the dsh-boot-guard DSH plugin.
dsh-boot-guard DSH plugin data source
dsh-boot-guard DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-boot-guard DSH plugin can do
- Detects suspected faulty plugins from loading errors and auto-selects them
- Temporarily skip one or more plugins and refresh the page immediately
- Restore individual or all boot-guard-skipped plugins with double confirmation
- Clearly distinguishes between Boot Guard temporary skip and configuration disabled
- Copies a short diagnostic snippet for issue reporting
- Offers a read-only self-check mode with dark/light/narrow screen adaptation
Where the dsh-boot-guard DSH plugin fits
- Recover from a plugin crash that blocks the entire Web UI
- Test plugin compatibility by selectively skipping plugins
- Debug plugin loading issues without restarting the DSH process
- Quickly identify and isolate problematic plugins in a development environment
- Restore previously skipped plugins after fixing the issue
Who the dsh-boot-guard DSH plugin is for
- DSH Web UI users who develop or manage plugins
- DSH administrators who need to recover from plugin failures without CLI access
dsh-boot-guard DSH plugin limitations
- Currently verified only on DSH 0.1.0-rc.6, Node.js 24.5.0, and Windows
- Cannot skip itself; only skips other plugins by writing to cordis.patch.yml
- Remote mutation requires explicit environment variable and is not recommended without additional auth
- DSH is still in developer preview; plugin interfaces may change
dsh-boot-guard DSH plugin: from the repository README
Quoted from the SaiSenBox/dsh-boot-guard README, the upstream source of the dsh-boot-guard DSH plugin. Copyright remains with the original authors.
简体中文 · [English](README.en.md) [](https://github.com/SaiSenBox/dsh-boot-guard/actions/workflows/check.yml) [](LICENSE) > 插件把插件管理页面一起弄崩了，接下来怎么办？ `dsh-boot-guard` 是给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI 准备的一道小保险。正常情况下它安安静静地待着；只有插件加载失败、页面只剩下 `Failed to load plugins` 时，它才会出现，帮你找出可疑插件、临时跳过，然后把工作区救回来。  _上图是只读自检模式，只展示界面和诊断结果，不会真的改配置。_ ## 为什么写它 起因其实有点尴尬：我在给 DSH 调一个界面插件，刷新之后，整个 Web UI 直接起不来了。 问题插件本来应该去插件管理页里关掉，可插件管理页也属于 Web UI。结果就像把车钥匙锁在车里——明明知道是哪儿出了问题，却没有入口修它。 Boot Guard 就是为这个死循环写的。它不依赖正常的客户端插件加载链，而是由 host 直接把一段很小的救援脚本放进失败页面。其他插件没能加载时，它仍然有机会工作。 ## 它能做什么 - 从加载错误里找出疑似故障插件，并自动选中 - 默认只看用户插件，也可以搜索名称或 loader 条目 ID - 临时跳过一个或一批插件，刷新后立即重新尝试启动 - 单独恢复某个插件，或二次确认后恢复全部救援跳过项 - 明确区分“Boot Guard 临时跳过”和“配置原本就禁用” - 复制一份简短诊断，方便贴到 Issue 里一起排查 - 界面提供中文和英文，并跟随 DSH 设置里的语言选项 - 提供暗色、亮色和窄屏适配的只读自检页 它不会删除插件，也不会碰插件的数据。所谓“跳过”，只是向当前 DSH profile 的 `cordis.patch.yml` 写入一个带 Boot Guard 标记的 `disabled: true` 数组项；写入前会识别空文件、`[]` 和已有数组，恢复时也只会删除自己写入的块。 ## 安装 需要先安装并运行 [DeepSeek
Read the full READMERepository license: MIT
dsh-boot-guard DSH plugin questions
How do I install DSH Boot Guard?
You can install it via the DSH CLI: `dsh plugin --profile web add github:SaiSenBox/dsh-boot-guard`. After installation, restart `dsh web`. Alternatively, if published to npm, use `dsh plugin --profile web add dsh-boot-guard`. For local development on Windows, clone the repo and run `install.ps1`.
Can Boot Guard delete my plugins or data?
No, Boot Guard never deletes plugins or their data. The 'skip' action writes a `disabled: true` entry with a special marker to `cordis.patch.yml`. Restore only removes the entries it added. It does not touch user configuration or plugin files.
What should I do if Boot Guard doesn't appear when plugins fail?
Make sure Boot Guard is installed and active. It should automatically appear below the 'Failed to load plugins' message. If it doesn't, check that the plugin is enabled in your profile. You can also test the self-check page at `http://127.0.0.1:3080/boot-guard/health` to verify it's accessible.
Can I use Boot Guard from a remote machine?
By default, Boot Guard only accepts requests from localhost. To allow remote mutation, set the environment variable `DSH_BOOT_GUARD_ALLOW_REMOTE_MUTATION=1` before starting DSH. This is not recommended without additional authentication because it opens a write endpoint without extra protection.
How do I recover a plugin that I accidentally skipped?
Open Boot Guard's recovery interface after a page refresh. Navigate to the 'Rescued Skipped' section, find the skipped plugin, and click 'Restore' for that plugin. You can also restore all skipped plugins with a double-confirmation button. The restore only removes the Boot Guard skip marker, not the plugin itself.