dsh-composition-doctor：为 DeepSeek Harness 提供只读组合诊断与升级预演

它是做什么的？

Composition Doctor 是 DeepSeek Harness（DSH）的只读组合诊断插件，用于解释 Cordis 与插件组合中可观测到的风险。它解决的是「升级或改配置前不知道会撞什么」的问题：重复的 Cordis 行、hook 顺序、UI 槽位与路由归属冲突、bundle 覆盖、peer 与平台不匹配、profile 漂移，都能在动手前被指出并附上具体证据。它只读取显式指定的 profile，从不修改真实 profile，也不会悄悄改动权限。

核心功能

• 组合扫描：检测重复 Cordis 行、hook 顺序风险、UI 槽位与路由归属冲突、bundle 覆盖、peer 与平台不匹配以及 profile 漂移。
• 快照与对比：生成经过脱敏、可比较的 profile 快照（含 lockfile 哈希），并汇总新增、移除、升级的插件、行、hook、UI 声明、peer 与平台差异。
• 升级预演：在隔离的临时 profile 中演练目标 DSH 升级，记录经过校验的精确版本引用，不安装、不执行第三方生命周期脚本。
• 证据分级：报告标注证据模式，区分仅基于清单与补丁元数据的静态结论、来自公开 dump-config 的组合结果，以及隔离运行时观测。
• 只读设置页：Web 设置页仅展示与导出，读取最新本地报告、呈现冲突图并导出 JSON 或 Markdown，不提供修复、安装或卸载动作。
• 退出码控制：可按诊断级别决定扫描退出码，默认不因警告或错误改变退出码，便于接入自动化流程。

怎么使用这个插件？

在 DSH 中启用后，用 dsh-doctor scan 指定一个 profile 做体检，报告只写入你指定的目录；若想让只读设置页看到同一份报告，需显式选择发布，并同时输出 JSON 与 Markdown 两种格式。升级前先用 dsh-doctor snapshot 存下当前状态，改完再用 dsh-doctor diff 对比前后差异，或用 dsh-doctor preflight 在隔离临时 profile 里预演目标版本。注意不要把 profile 目录、环境变量文件位置或任何含密钥与令牌的目录当作报告目录；若没有可用的公开 DSH CLI，扫描会退回静态模式并记录一条警告。

报错怎么排查？

扫描结果里出现静态回退警告，说明当前环境没有可用的公开 DSH CLI，此时结论只覆盖清单与补丁元数据，不代表最终运行时组合。若报告显示的是旧版证据标签，属于早期 schema 写入的历史报告，新报告不会再输出该标签。参数格式错误会返回退出码 2，运行层面的失败返回 1，可据此区分是命令写错还是执行环境问题。