DSH plugin 加载崩溃：duplicate loader entry id 与 Failed to load plugins 的原因与解决

DSH plugin 加载崩溃，duplicate loader entry id 是 bundle 依赖被重复提升（entry id 撞车），Failed to load plugins 是插件挂载失败致命屏。 前者从 profile bundle 配置里删重复项，后者逐个禁用定位元凶。按「清理重装 → 检查依赖冲突 → 逐个禁用 → 回滚稳定版」四步处理。

DSH plugin 两段报错原文：重复 loader 与挂载失败致命屏

duplicate loader entry id 是加载器在构建 bundle 栈时发现重复 entry、Failed to load plugins 是启动时插件挂载失败且无恢复操作。 两段报错（来源）：

1. duplicate loader entry id: <包名>——启动或安装时加载器拒绝：同一个已声明 bundle 的依赖被重复提升进 bundle 栈，entry id 撞车（源码）；
2. Failed to load plugins——启动过程走到挂载阶段失败，界面进入致命屏，没有任何恢复按钮；
3. 现象：前者常在装完新插件后出现，后者常在一批插件升级/重装后出现——两者都会让宿主启动异常。

DSH plugin 崩溃根因：依赖重复提升 + 挂载期异常

两条根因：一是依赖被重复提升导致 bundle 栈出现重复 entry，二是某个插件在挂载期抛异常、拖垮整个启动。 展开说：

1. 重复提升：dsh plugin add 把一个已声明 bundle 的依赖又提升进 bundle 栈，产生重复 entry id（来源）——常见于插件 A 与插件 B 共享同一个 bundle 依赖，两边都声明了层；
2. 挂载期异常：某个插件在启动挂载阶段抛错（缺依赖、版本不兼容、初始化失败），UI 不提供恢复操作（来源）；
3. 两者叠加场景：一批插件重装后依赖树变化，既可能撞出重复 entry，也可能让某个插件的挂载前提失效。

解决 DSH plugin 崩溃：清理重装 → 检查依赖冲突 → 逐个禁用 → 回滚稳定版

先清重复再定位元凶：清理重装、检查依赖树、逐个禁用、回滚稳定版，一步步缩小范围。 逐步执行：

1. 清理重装——先移除最近安装/更新的插件，再逐个加回：
   bash

   dsh plugin --profile web remove <最近装的插件>
   dsh plugin --profile web add <同一插件>
   

   重启宿主，能正常启动说明重复 entry 已消除；
2. 检查依赖冲突（针对 duplicate loader entry id）——打开 profile 目录下的 package.json（~/.dsh/profiles/<name>/package.json），看 dsh.profile.bundles 里有没有重复条目：有就把重复项删掉只留一份，保存后重新执行 pnpm install 同步依赖；
3. 逐个禁用定位（针对 Failed to load plugins）——把全部插件移出 profile 重启，能启动就是插件挂载问题；然后每次加回一个插件并重启，哪个加回去就崩，元凶就是它（来源）；
4. 回滚到稳定版——卸载崩溃版本，改装此前稳定运行的版本（dsh plugin --profile web add <包名>@<旧版本>），或等作者发修复版；
5. 验证——重启宿主，能正常进入界面、无致命屏、duplicate loader entry id 不再出现即修复。

DSH plugin 崩溃修复后怎么验证？bundle 栈干净、逐插件回归与稳定性观察

修完分三关验证：bundle 配置无重复、宿主启动无致命屏、逐插件加回不再崩——三关全过再投入正式使用。 按顺序执行：

1. 核对 bundle 栈无重复项——查看 profile 的 bundle 声明：

   bash

   cat ~/.dsh/profiles/web/package.json | grep -A6 '"bundles"'
   

   bundles 列表里每个包只出现一次即干净；出现重复项说明冲突还在，回上节第 2 步删重。

2. 重启宿主确认无致命屏：

   bash

   dsh web
   

   启动日志正常进入 Web 服务监听、不再出现 duplicate loader entry id 与 Failed to load plugins，界面能打开即第二关过。

3. 逐插件加回回归——每次加回一个插件并重启验证：

   bash

   dsh plugin --profile web add <插件名>
   

   加回后重启宿主不崩，再加下一个；哪个加回去就崩，元凶就是它（回上节第 3 步）。

4. 查当前已装清单（确认回归范围）：

   bash

   dsh plugin --profile web list
   

   列表与你的预期一致、无多余残留项，说明清理到位。

5. 稳定性观察收尾——连续使用一段时间（跑几个任务、重启一两次）不再崩溃，修复闭环；期间先备份过 profile 配置（上节注意事项第 4 条），出问题可快速回滚。

注意事项：DSH plugin 崩溃先查重复再禁用

1. duplicate loader entry id 先查 dsh.profile.bundles 的重复项，别急着全量重装。
2. Failed to load plugins 用「逐个加回」定位元凶，一次加一个、加一个重启一次。
3. 崩溃插件定位后先禁用，等作者修复版或到 DSH Plugin Hub 找替代——Hub 的插件页标注版本迭代，可追踪修复进度。
4. 重装前先备份 profile 配置（复制 ~/.dsh/profiles/<name>/），避免操作失误丢配置。
5. 其他安装报错可参考安装报错排查。

来源：dshbase 常见问题排错、DeepSeek Harness loader 源码、DeepSeek Harness 插件发布文档