DSH Plugins
返回列表
🧩

dsh-crash-guard

admin-security 更新于 2026.11.04

在终端中运行以下命令:

dsh plugin install zxzc114514/dsh-crash-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 终端执行 dsh plugin install zxzc114514/dsh-crash-guard,或按 Profile 方式从 https://github.com/zxzc114514/dsh-crash-guard 引入该插件。

插件介绍

在 DeepSeek Harness 里装了很多第三方插件后,一次语法损坏的 bundle 或未成功激活的前端条目,往往会让 Electron 窗口直接白屏、弹出整窗崩溃——排查成本高,体验也极差。DSH Crash Guard(防崩卫士)借鉴 Minecraft 社区 Not Enough Crashes 的容错思路,把「坏插件」从启动链路里摘出去,让主界面照常起来,而不是跟着一起崩。

插件在 Node 宿主与浏览器两端各设一道防线:服务端启动时对前端 bundle 做基于文件指纹的语法与 Lazy-CJS 契约预检,损坏产物会从 ClientModuleRegistry 剥离并重建干净的启动图;Web 端则在官方 IZ() 严格审计前介入,用 loader.remove() 摘掉未激活条目并清理残留样式,避免「N entries did not activate」触发白屏弹窗。发现故障时会启用指纹绑定的静默隔离,记录写在独立的 .dsh-market/crash-guard-quarantine.json,不改动 package.json、state.json 与 cordis.patch.yml;代码指纹不变则下次静默跳过,本地改代码或市场更新后自动解除隔离并重试。

需要彻底停用时,顶栏救援面板提供「永久禁用」,会同步写入正式配置。面板跟随 DSH 语义色彩、明暗主题自适应,以紧凑胶囊嵌在标题栏右侧,展开后可查看故障分类、blockedBy 上游依赖与详细堆栈。

适合经常试装社区插件、自建 bundle 或维护复杂 Profile 的用户,以及希望在 DSH >=0.2.0-rc.2 环境下降低启动白屏风险、又不想依赖外部 watchdog 进程的人。

使用场景

  • 第三方插件 bundle 语法损坏导致 DSH 启动白屏或整窗崩溃
  • 前端条目未激活触发 IZ 审计报错与 Electron 崩溃弹窗
  • 试装大量社区插件后需要自动隔离故障项并保留可用界面

适合人员

  • 经常安装或更新 DSH 社区插件的桌面用户
  • 维护复杂 Profile 与自定义 bundle 的配置者
  • 在 0.2.0-rc.2 及以上版本希望降低启动风险的进阶用户