只读的 DSH profile 医生：配置树七检（patch 丢字段、死 patch、工具重名、装了没挂载、停更、树 diff、组成解释）加八项生态检查——pnpm store 版本冲突（`dsh plugin add` 报 ERR_PNPM_UNEXPECTED_STORE 的根因）、patch insert 指向不存在的包、断裂的 junction、重复能力插件、孤儿 backup 目录、GitHub 源依赖、npm 发布权限提示、minimumReleaseAgeExclude 缺口。四个 agent 工具，每条 finding 都带修复文案。
你的 DSH 配置里有设置项在静默失效，你的 node_modules 里有链接在悄悄断裂，你的
.dsh目录里躺着没人引用的备份。这个插件把那些事一件件找出来，并告诉你怎么修。
两类检查合一：配置树七检（config-clobber / dead-patch / tool-collision / plugin-not-mounted / plugin-stale / entry diff / explain）+ 生态八检（pnpm store 冲突 / patch 名不可解析 / 链接断裂 / 重复能力 / 孤儿备份 / GitHub 源 / 发布权限 / release-age 豁免）。
dsh plugin --profile desktop add @bushizhanghan/dsh-profile-doctor
重启 DSH 后生效。只读：这个插件从不写你的 profile。
| 工具 | 作用 |
|---|---|
profile_doctor | 全量体检，返回文本报告 + 结构化 findings（含每条 fix） |
profile_doctor_explain | 解释这个 harness 到底由什么组成：按功能区分的条目数、哪些关着、哪些条件启用、第三方插件全列表 |
profile_doctor_release_age | pnpm 发布冷静期体检：谁被豁免了、谁还在冷却窗口内、该往 minimumReleaseAgeExclude 加什么行 |
profile_doctor_links | node_modules 链接专项：每个 junction/symlink 的目标是否还在、哪些 patch insert 行指向不存在的包、pnpm store 版本是否冲突 |
| 规则 | 级别 | 抓什么 |
|---|---|---|
config-clobber | ✗ error | patch 覆盖 config 时整体替换，没重述的兄弟字段静默消失 |
dead-patch | ✗ error | patch 指向的 entry id 不存在（带编辑距离 did-you-mean） |
tool-collision | ✗ error | 两个挂载插件注册同名工具——DSH 直接拒绝启动 |
entry-removed | ! warn | 出厂 profile 里的条目被你的 patch 删了 |
plugin-not-mounted | ! warn | 装了但既不在 bundles 也没被 patch insert，从不加载 |
plugin-stale | ! warn | 180 天没发新版（DSH 在 preview 期，breaking change 频繁） |
entry-toggled / entry-added | · info | 树 diff 可见化 |
| 规则 | 级别 | 抓什么 |
|---|---|---|
pnpm-store-conflict | ✗ error | node_modules 是 v10 store 链的，而 CLI 的 pnpm 是 v11 → dsh plugin add 报 ERR_PNPM_UNEXPECTED_STORE |
patch-name-unresolvable | ✗ error | patch insert 的 name 在 node_modules 里找不到（scoped 包放错层级：必须在 @scope/ 下） |
link-broken | ✗ error | junction/symlink 目标已消失（含 lstat 就失败的坏 junction） |
duplicate-capability | ! warn | 两个第三方插件提供同一能力（如两个 code-review） |
orphan-backup | ! warn | backup-* 目录没有任何东西引用，只占地方 |
github-source | ! warn | github: 依赖：需要联网、绕过 registry 完整性校验、force-push 会变 |
publish-scope | · info | granular token 发不了裸包名（E403）——提示走 scoped 名 |
| release-age | 工具 | 谁在 pnpm 冷却窗口内、minimumReleaseAgeExclude 缺哪行 |
! "backup-workmate-lib-20261023-1252" is a backup directory nothing references (329 KB, 6 files)
! "backup-workmate-lib-20261023-1245" is a backup directory nothing references (324 KB, 6 files)
! "backup-workmate-lib-20261023-1242" is a backup directory nothing references (322 KB, 6 files)
! "backup-plugin-upgrade-20261022" is a backup directory nothing references (96 KB, 7 files)
! "dsh-md-export" installs from github: instead of the npm registry
! "dsh-workbuddy" installs from github: instead of the npm registry
以及 profile_doctor_release_age 报出的 4 条豁免与冷却缺口。
!!js 表达式，严格加载器会拒绝、宽松的会求值。我们只要「有哪些键」，直接读结构更安全也更零依赖。fix 文案，但插件只读。改配置是人来决定的事（dsh-doctor 的 --fix 也刻意只留在 CLI，同理）。node --test test/ # 16 个单测：dump 解析、七检、生态八检
MIT
把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖，并在首次使用时初始化未配置的项目。需要 Node.js 22+；首次初始化需要网络连接和项目目录写入权限。
Matt Pocock 技能套件的 DSH 控制面板：右侧 details 列打开；含 wayfinder 决策地图、issue 行级 triage / 修复 / 讨论 / 执行按钮、9 项核心套件探测 + 20 个技能雷达、环境检查、跨会话 handoff 交接。
