dsh-composition-doctor

安装或升级 DSH 插件后，主机有时连 Web 界面都打不开，日志又只剩一行含糊报错。Composition Doctor 面向这种「启动即失败」的场景：在默认只读、可离线的前提下，用有边界的元数据与可选错误日志，把能解释的失败指到下一步该看的 bundle、patch 或 profile 层，而不是猜路径或自动改配置。

核心是 CLI 诊断与组合分析。diagnose 与 check 在不启动 DSH、不导入插件代码的前提下检查 profile；scan 可发现重复 Cordis 行、hook 顺序风险、UI 槽位冲突、bundle 覆盖与 peer 不匹配等；snapshot、diff 与 preflight 帮助对比变更、在隔离临时环境中演练升级。生成报告后，why 与 impact 可沿观测到的事实解释单行来源或某个 bundle 的关联诊断。可选的 Web Composition Explorer 仅在已有可用 Web profile 时用于查看与导出报告，不提供安装、卸载或修复动作。

它解释的是 README 列出的有限模式（如重复 loader、bundle 不可用、缺失或无效的 patch、peer 版本不符、配置替换等），并明确边界：未知与 no-match 不代表 profile 健康，静态元数据也不能等同运行时真相。适合维护复杂 profile 的开发者、排查升级回归的维护者，以及愿意在手动检查时附带简短使用反馈、帮助完善案例覆盖的用户。