← 返回列表
✓ 可直接安装
看清你的 DSH profile 为什么最终是现在这个样子。
自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=20）；该结论来自程序自动检查，未经人工实机验证。 · 最近上游提交 2026/9/24 · 已提供中文文档
只读的 DSH 和 Cordis 组合诊断、快照、差异以及升级预检。
综合分
30.7
GitHub 分
30.7
用户评分
—
★ Stars
1
周下载量
—
兼容 / 相关生态插件（非 dsh 原生，请按其对应运行时安装）
git clone https://github.com/lemonxiny55/dsh-composition-doctor.git信任档位：已验证本站已于 2 天前真实安装成功
- 是什么
- 生态插件（可安装，未声明 dsh 能力）
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 1 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/25（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查✓ 自动检查通过
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-composition-doctor @ 0.2.2
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 01:59:21
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-composition-doctor（中文） npm version CI Listed on dsh-plugin.org 看清你的 DSH profile 为什么最终是现在这个样子。 DSH profile 是由多层 composition 组合出来的。dsh-doctor 展示哪些 source 和 layer 带来了当前 row、现有证据能证明什么，以及哪些仍然未知。 只读 · 默认离线 · 不自动修复或安装 面向 DeepSeek Harness（dsh）的组合与升级预检工具。它读取明确指定的 profile，用可追溯证据解释可观察到的 Cordis/plugin composition；不会编辑真实 profile，也不会静默扩大权限。 快速开始 npm install -g dsh-composition-doctor npx @deepseek-ai/dsh plugin --profile web add dsh-composition-doctor dsh-doctor --version 然后直接问一个 composition 问题： dsh-doctor why row tool-bash --profile C:\path\to\profile dsh-doctor impact bundle @example/dsh-bundle --profile C:\path\to\profile why 解释一个可观察 row 的来源链；impact bundle 列出有直接 source 关联证据的 rows 和 diagnostics。 flowchart LR B["Bundle直接关联"] --> S["Source"] S -->|"introduced / patched-by"| R["Row"] L["Layer"] -->|"contains"| R R -->|"diagnosed-by"| D["Diagnostic"] 只有报告中存在支持 facts 时才展示这些关系；没有 ownership 证据的部分仍标为 unknown。 命令能力 · 证据边界 · 安全与隐私 · 兼容范围 · 开发 模型可解释什么 | 命令 | 作用 | |---|---| | dsh-doctor scan | 检测重复 Cordis row、hook 顺序风险、UI slot/route 所有权冲突、bundle 覆盖、peer/platform 不匹配和 profile 漂移。 | | dsh-doctor snapshot | 生成脱敏、可比较的 profile 快照及 lockfile 哈希。 | | dsh-doctor diff | 汇总新增、删除或升级的插件，以及 rows、hooks、UI 声明、peer 和平台变化。 | | dsh-doctor preflight | 在独立临时 profile 中演练目标 DSH 升级。 | | dsh-doctor why row | 基于明确指定的 profile 中可观察的来源和 layer 信息解释一个 row。 | | dsh-doctor impact bundle | 列出有直接来源关联证据的 bundle rows 和 diagnostics。 | why 和 impact 都需要 --profile 。报告新增可选、版本化且脱敏的 compositionFacts，由这两个命令和 Web Composition Explorer 共用。Web Settings 仍然只读：它读取最新本地报告，展示诊断图和 composition 图，并导出 JSON/Markdown；不提供修复、安装或卸载操作。 Composition facts 描述公开 --dump-config 返回的结构；无法取得时仅描述静态声明。introduced 和 patched-by 表示 DSH 输出中记录的来源链，不证明逐字段 owner。若未观察到前层 config key，移除的键和字段 owner 必须是 unknown。route/slot ownership、runtime hook ownership、任意依赖和可能的 dependents 会标记为未观察/未建模。 报告与证据边界 scan --output 只写入显式指定的目录。要让只读 Settings 页面看到同一份报告，必须显式选择 --publish，它会复制到默认插件目录 .dsh-composition-doctor/reports；也可以使用 --report-dir 发布到配置的插件报告目录。请使用 --format both，使 Web route 能读取 report.json，同时保留 Markdown 导出。报告目录不能是 profile、.env 所在位置，或任何含密钥、token 或其他敏感信息的目录。 报告中的 evidenceMode 标明证据来源：static 仅表示 allow-list 中的 manifest、patch、package metadata 等静态证据；composed 表示公开 dsh --profile --dump-config 返回了 composition 结果；runtime-observed 只允许真正启动隔离 runtime 并观察到注册/行为的后端使用；mixed 预留给同时提供多类来源的适配器。dump-config 即使成功，也不代表 runtime 已验证；存在 !!js 等运行时依赖时尤其如此。找不到兼容的公开 DSH CLI 时会回退到 static，并明确报告 warning。旧的 evidence schema 2 之前报告仍可按 legacy resolved 读取，但新报告不会再输出该标签。 preflight --candidate package@version 只会把通过校验的精确引用记录到隔离临时 package.json。目标 artifact 默认按本地优先顺序查找：--dsh-bin、本地 package directory、本地 tarball、已安装 dsh、--package-manager-cache、Doctor 自己的 cache；只有显式 --online 才允许访问 registry。在线解析会把精确 tarball 写入 Doctor 自己的 cache，记录来源、版本、integrity 和 hash，并且不会安装或执行 lifecycle script。--allow-build 不等于允许执行第三方 runtime code。 scan --fail-on never|info|warning|error 控制 scan 的退出码。默认是 never：warning 和 error 会写入报告，但不改变退出码；info 遇到任意诊断时退出 1，warning 遇到 warning 或 error 时退出 1，error 只在 error 时退出 1。参数错误退出 2，执行失败退出 1。 更改 profile 后重启 Web UI（npx @deepseek-ai/dsh web），再重新扫描。 每条诊断均为 info、warning 或 error，并附带 evidence、explanation 和最小 remediation。runtimeSmoke.status=not-run 不等于 runtime PASS；artifact-unavailable 不等于 incompatible；warning 也不等于已确认失败。 更多命令 dsh-doctor scan --profile C:\path\to\profile --format both --output .\reports\profile --publish dsh-doctor scan --profile C:\path\to\profile --format both --output .\reports\archive --report-dir C:\safe\doctor-reports dsh-doctor snapshot --profile C:\path\to\profile --output .\reports\before.json dsh-doctor diff --before .\reports\before.json --after .\reports\after.json --format both dsh-doctor preflight --profile C:\path\to\profile --target-dsh 0.1.5-rc.2 安全与隐私 默认操作只读，或仅在操作系统临时目录中隔离运行。插件不会修改 profile、安装或删除插件、迁移配置、扩大权限，默认也不会执行网络 I/O。它不会读取 .env、profile 密钥、会话正文或工作区源文件内容，也不会收集或持久化任意环境变量值；启动公开 CLI 时只传递平台所需的最小进程路由变量。 支持范围与限制 real-release harness 已使用真实公开 CLI 验证 @deepseek-ai/dsh@0.1.5-rc.1 和 @deepseek-ai/dsh@0.1.5-rc.2。0.1.6-alpha.1 仍只是 expected-compatible/experimental；0.1.0-rc.6 仅作历史兼容背景，不是当前 verified target。artifact 不可用时会明确报告 unavailable，绝不记为 PASS。已验证开发环境为 Windows + Node.js 24；CI 覆盖 Ubuntu + Node.js 20。只有公开 metadata 能提供 hook/UI ownership 时才会确认，否则标为 unverified；临时目录不是安全 sandbox。 开发 pnpm test pnpm typecheck pnpm build 仅在 checkout 开发时，构建完成后使用 node dist/cli/main.js 运行 CLI。 参阅 README.md、docs/compatibility.md 和 docs/examples/scan-report.md。MIT 许可。