插件加载失败排查

最后更新 2026-11-09

先说结论：绝大多数“装了没反应”属于下面四类之一，回执里通常已经写了原因。

1. 模块找不到

回执里出现 ERR_MODULE_NOT_FOUND，说明插件声明的入口不存在，或者它的依赖没装上。常见于仓库里没有提交构建产物、需要先 pnpm build 的包。改从正式发布版本安装。

2. 版本不兼容

错误码 incompatible-version，会点名是 engines.dsh 还是某个 peer 依赖。要么装兼容版本，要么在确认风险后授予精确版本豁免。

3. 构建脚本待批准

回执里有 pendingBuilds 就是这个。批准后重试；不需要构建的包不要批准。

4. 平台不支持

unsupported-platform 表示这个组合包声明了支持的平台，当前系统不在其中。插件页会显示原因。

还是不行

看宿主日志与 ~/.dsh/profiles/<profile>/.plugin-manager/logs/ 下的 pnpm 日志；错误通常在那里比界面更完整。