修复 DSH 插件加载失败

DSH 插件加载失败时，应依次核对安装结果、profile 位置、模块格式、依赖和第一个运行时错误。

核对实际安装产物

确认 package 或本地路径位于目标 profile 预期的位置，并且安装版本符合上游说明。

保留首个 import 或运行时异常，并与插件入口对照。后面的通用加载失败通常只是汇总。

来源用于核对当前事实，不代表来源方认可本站结论。

DSH 插件加载失败到底是什么状态？

文件已经解析到位，但插件没能真正可用。加载还需要三件事：在你启动的那个 profile 里注册过、入口能被解析、依赖以插件期望的版本存在。

模块格式问题长什么样？

报错里出现 require is not defined、import 语句不能用在非模块里，或者 .js 文件里出现意外的 token。这类是 ESM 与 CommonJS 不匹配，属于打包问题，不是你的配置问题。

装错 profile 会导致 DSH 插件加载失败吗？

很常见。装在一个 profile 里的插件在另一个里就是完全不存在，harness 也不会提醒你。改别的之前，先确认当前生效的是哪个 profile。

重装一遍能修好吗？

不该作为第一步。重装会把现场证据抹掉，而且多数时候结果不变，先读第一条错误，判断问题出在注册、解析还是运行时。

重试之前要先记下什么？

准确的错误原文、当前 profile、工作目录，以及 Node 和包管理器版本。缺了这些，同一个故障第二次出现时你会当成全新问题重查一遍。