Proposal: adopt dsh-plugin-doctor as official dsh plugin check and dsh doctor

[zoahdev]

Proposal: adopt dsh-plugin-doctor as official dsh plugin check and dsh doctor

对应 #1629（dsh plugin check）与 #1719（dsh doctor）两个社区请求：实现已存在并经过验证，本提案给出可直接采纳的规格。

为什么现在采纳

1. 插件数量正在爆炸（topic 2,958 仓库），但可验证安装的插件是稀缺品——官方预检是生态质量的地基；
2. 社区已有两个实现（dsh-plugin-doctor、moonquake2004/dsh-doctor）和完整教训（Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697/[Bug] Tool returns "Cannot read properties of undefined (reading 'prepare')" on web_search/fetch #1763/Bug: Plugin registrations on the host plane are invisible to agents (dsh 0.1.0-rc.6) #1782 的"能加载≠能用"）；
3. 实现无运行时依赖、输出稳定 JSON、已通过真实注册表可见性验证——收编成本极低。

建议命令

dsh plugin check <dir>        # 结构预检：manifest/patch/entry/files（纯确定性检查）
dsh plugin check --full <dir> # + build + pack + 全新 profile 安装 + 合成配置断言
dsh doctor                    # 环境诊断：node/pnpm/dsh PATH、端口；可加 --profile <name> 做宿主遮蔽检测

规格（与社区实现对齐）

• 退出码：0 = 全部通过；1 = 有 FAIL；2 = 命令本身不可用
• JSON 输出：{ "ok": bool, "checks": [{ "name": string, "status": "PASS|WARN|FAIL", "detail": string }] }
• WARN 语义：仅"可用但可优化"（如 dsh 不在 PATH）；Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697 宿主遮蔽这类"装了必炸"必须是 FAIL
• 边界：预检只验证确定性事实，不执行第三方插件代码；失败时保留已安装依赖、不写 profile（对齐 建议：在 profile 激活前增加第三方插件兼容性预检 #1774 的非目标清单）

实现证据

• dsh-plugin-doctor v1.5.0：https://github.com/zoahdev/dsh-plugin-doctor
  • preflight 全链路 + --profile（宿主遮蔽，被 moonquake2004 独立验证）+ --env --port
  • 12 单测 + 打包冒烟 + 真实注册表可见性测试，CI 全绿
• 与 moonquake2004/dsh-doctor（19 项离线检查）、dsh-diagnose（症状诊断）三方互补，JSON schema 已统一

采纳路径建议

1. 先收编 dsh plugin check（结构预检，无争议、无执行风险）；
2. dsh doctor 作为第二期（环境诊断）；
3. 社区实现保持同步，官方命令以兼容 JSON schema 为目标，避免生态分裂。

如果官方愿意，我可以直接把 checks 抽成纯函数库并提交（PR 通道开放后）。

[zoahdev]

Follow-up on the adoption track: two more upstream-ready specs are now published at https://github.com/zoahdev/dsh-docs/tree/main/docs/specs ? (1) Community Plugin Registry Contract v2 (shared registry.json schema so any marketplace/CLI/agent tool can consume the same catalog; reference implementation ships with a validator), and (2) first-class dsh plugin check + dsh doctor commands (stable exit codes + JSON output; both reference implementations are CI-green). Also live: dsh-subscribe v2 with a 536-plugin registry, in-harness market tools, and a zero-dep CLI ? Show and tell at #1828.

[boyin111-1]

Support this direction. Maintainer of https://github.com/boyin111-1/dsh-doctor here (17 offline checks, zero deps, single file, runs before dsh boots - listed alongside dsh-plugin-doctor in the proposal).

Three alignment points worth echoing from our side:

1. The JSON schema + exit-code contract (0/1/2, PASS|WARN|FAIL) is the right call - we already use the same convention, so a future merge is mechanical.
2. 'Loads but is unusable' checks (the Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697/[Bug] Tool returns "Cannot read properties of undefined (reading 'prepare')" on web_search/fetch #1763 host-shadowing family) must be FAIL, not WARN - a WARN there lets broken installs sail through. Our check 4/12 treats them as errors for exactly that reason.
3. The offline-before-boot property matters: the broken state lives in local files (package.json, node_modules, session logs, PATH) long before boot, which is what makes these checks able to run exactly when dsh can't.

Also happy to align check names/schema with dsh-plugin-doctor and moonquake2004/dsh-doctor so the three tools converge instead of forking.

[zoahdev]

The adoption track now has a formal RFC for maintainer feedback: #1846 ? Community plugin registry contract v2 + first-class dsh plugin check / dsh doctor. Also live: a release-compatibility report generator (zoahdev/dsh-ecosystem, workflow_dispatch) so every official release gets a per-plugin CI/verification signal within minutes. Current report for 0.1.0-rc.6: https://github.com/zoahdev/dsh-ecosystem/blob/main/docs/release-compat/0.1.0-rc.6.md