dsh-doctor

dsh 的 patch 层遵循整条替换语义：你只改了一个字段，其余未重新声明的字段就从启动树里消失了，退出码依然是 0。entry id 拼错一个字母只往 stderr 写一行日志，Web UI 里完全看不到。这类静默失效往往拖上几周才表现为行为漂移，届时很难回溯是哪个 patch 层丢的字段。

dsh-doctor 调用 dsh 自身的 --dump-config 与 --dump-default-config 拿到实际启动树和基准树，将两者做 diff 并逐条归因到用户 patch 层。七类检查覆盖字段被吞（config-clobber）、entry id 对不上（dead-patch）、工具名冲突（tool-collision）、插件未挂载、插件过期、条目被移除或新增等，每条附严重等级和 did-you-mean 提示。--explain 模式列出当前 profile 实际运行的全部条目及其条件表达式；--fix 仅在被标记的 config 块内补回丢失字段，先写 .bak，其余字节不动。作为 plugin 安装后还注册 config_doctor 工具，让 agent 在对话中直接回答"为什么我的设置没生效"。

适合正在用 dsh 管理 profile patch 层的开发者、需要在 CI 中做升级前配置校验的团队协作者，以及被静默失效折磨过、希望一条命令十秒内得到确定答案的任何人。零依赖、只读（--fix 除外）、无需注册，npx 即可运行。