SaiSenBox/dsh-boot-guard

README 摘要

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 设置里的语言选项 - 提供暗色、亮色和窄屏适配的只读自检页 它不会删除插件，也不会碰插件的数据。所谓“跳过”，只是向当前 DSH profile 的 cordis.patch.yml 写入一个带 Boot Guard 标记的 disabled: true 数组项；写入前会识别空文件、 [] 和已有数组，恢复时也只会删除自己写入的块。 安装 需要先安装并运行 DeepSeek Harness。 从 GitHub 安装 安装完成后重启 dsh web 。 从 npm 安装 如果这个包已经发布到 npm，可以直接用： 本地开发安装（Windows） 本地安装器会把依赖放在 DSH profile 同盘目录，避开 Windows 上跨盘 file: 依赖可能产生的坏 junction。 怎么用 1. 当页面出现 Failed to load plugins ，恢复中心会自动挂在错误信息下方。 2. 先看“疑似故障”是否找对了；没找对就搜索并勾选其他插件。 3. 点击“跳过所选并刷新”。页面会重新加载，不需要重启整个 DSH 进程。 4. 修好插件后，在“救援已跳过”里逐个恢复，或者使用“恢复已跳过”。 恢复全部需要点两次，主要是防手滑。单次最多处理 64 个条目，通常远远够用；真的遇到大面积故障时，可以分批操作。 先做一次自检 不必真的弄…

分类