@luolingp/request-doctor 0.13.2 → 0.13.4

package/docs/01-/350/275/257/344/273/266/351/234/200/346/261/202/350/247/204/346/240/274/350/257/264/346/230/216.md

@@ -2,7 +2,7 @@
 
 **产品名称**：request-doctor（请求急救员）
 **产品标识**：request-doctor
-**版本**：0.13.2
+**版本**：0.13.4
 
 ---
 

package/docs/02-/350/275/257/344/273/266/350/256/276/350/256/241/350/257/264/346/230/216.md

@@ -1,7 +1,7 @@
 # 软件设计说明
 
 **产品名称**：request-doctor（请求急救员）
-**版本**：0.13.2
+**版本**：0.13.4
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.2
 
 ---

package/docs/03-/350/275/257/344/273/266/346/265/213/350/257/225/346/212/245/345/221/212.md

@@ -1,7 +1,7 @@
 # 软件测试报告
 
 **产品名称**：request-doctor（请求急救员）
-**版本**：0.13.2
+**版本**：0.13.4
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.6；GB/T 8566-2007 验证与确认过程
 
 ---
@@ -62,9 +62,11 @@
 | `test/client-half.test.mjs` | 9 | 客户端半：模块身份、注入声明、apply 注册、组件能渲染 |
 | `test/diagnostics.test.mjs` | 3 | 快照可选写入：不配置不写盘、突发合并、坏路径不致命 |
 | `test/restart-notice.test.mjs` | 3 |
+| `test/allow-version.test.mjs` | 5 | 放行：版本必填、缺管理器拒绝、成功只调一次、失败如实报 |
+| `test/panel-blocked.test.mjs` | 7 | 冲突判定：审计兼容却被拒装、清单形状解析、给 allow 动作 |
 | `test/panel-briefs.test.mjs` | 6 | 界面摘要：按名索引、只送可见行、缺数据不抛、不污染诊断 |
 | `test/verdict-report.test.mjs` | 29 | why 与 list：判定、理由、环境摘要、自动扫描、分组、缺口、按形态给建议 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
-| **合计** | **199** | **全部通过** |
+| **合计** | **211** | **全部通过** |
 
 执行结果：
 
@@ -217,4 +219,4 @@
 
 ### 7.2 分文件执行结果
 
-32 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 199。
+34 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 211。

package/docs/04-/345/256/211/350/243/205/351/203/250/347/275/262/350/257/264/346/230/216.md

@@ -1,7 +1,7 @@
 # 软件安装部署说明
 
 **产品名称**：request-doctor（请求急救员）
-**版本**：0.13.2
+**版本**：0.13.4
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.7
 
 ---

package/docs/05-/347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -1,7 +1,7 @@
 # 软件用户手册
 
 **产品名称**：request-doctor（请求急救员）
-**版本**：0.13.2
+**版本**：0.13.4
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.5
 
 ---

package/docs/06-/350/275/257/344/273/266/350/264/250/351/207/217/345/272/246/351/207/217/346/212/245/345/221/212.md

@@ -1,7 +1,7 @@
 # 软件质量度量报告
 
 **产品名称**：request-doctor（请求急救员）
-**版本**：0.13.2
+**版本**：0.13.4
 **度量标准**：GB/T 45717-2025《信息技术 软件测量 软件质量测量 自动化的源代码质量测度》
 **度量工具**：`tools/quality-measure.mjs`（本仓库自带，可复现）
 

package/docs/quality-report.json

@@ -1,20 +1,20 @@
 {
   "standard": "GB/T 45717-2025 信息技术 软件测量 软件质量测量 自动化的源代码质量测度",
-  "generatedAt": "2026-10-29T16:11:20.101Z",
+  "generatedAt": "2026-10-29T16:21:27.245Z",
   "scope": {
-    "files": 32,
-    "totalLines": 5251,
-    "sourceLines": 3806,
-    "commentLines": 963
+    "files": 35,
+    "totalLines": 5313,
+    "sourceLines": 3841,
+    "commentLines": 982
   },
   "measures": {
-    "commentDensity": 25.3,
-    "duplicationPercent": 4.88,
-    "functionCount": 400,
+    "commentDensity": 25.57,
+    "duplicationPercent": 4.97,
+    "functionCount": 406,
     "maxComplexity": 10,
     "maxFunctionLines": 59,
     "maxFileLines": 500,
-    "averageComplexity": 3.88
+    "averageComplexity": 3.87
   },
   "limits": {
     "maxComplexity": 10,

package/index.js

@@ -19,6 +19,8 @@
 // 这个文件是装配处：只管生命周期和监听器，具体判断都在 lib/ 里。
 import { explainVerdict, listAudited } from './lib/verdict-report.js';
 import { panelBriefs } from './lib/panel-briefs.js';
+import { readRefused, refusedRowsOf } from './lib/refused-list.js';
+import { allowVersion } from './lib/allow-version.js';
 import { parseRetryConfig } from './lib/classify.js';
 import { collectPackageFacts, entryPathOf } from './lib/compat-repair.js';
 import { unmetPeers } from './lib/compat.js';
@@ -219,18 +221,6 @@ function registerDoctorCommand(ctx, deps) {
   });
 }
 
-// 一行清单里被拒的那个包；没有就返回 undefined。
-function refusedRowOf(row) {
-  const first = row?.error?.incompatible?.[0];
-  if (first === undefined) return undefined;
-  return { name: first.name, version: first.version, runtimeVersion: first.runtimeVersion };
-}
-
-// 从管理器给的清单里挑出被拒装的包：只有带 incompatible 的行才算。
-function refusedRowsOf(result) {
-  return (result?.value ?? []).map(refusedRowOf).filter((row) => row !== undefined);
-}
-
 // 汇总当前需要处理的插件：本插件扫描的审计结果，加上管理器的拒装记录，按名去重。
 async function collectPanelRows(deps, manager) {
   const runtimeVersion = deps.probe.runtimeFacts().runtimeVersion;
@@ -353,13 +343,13 @@ async function runDoctorCommand(invocation, deps) {
   if (sub === 'allow') return allowVersionCommand(rest.join(' '), deps);
     // why 回答「这个插件为什么被判为不可兼容」，答案就在最近一轮审计里。
     // list 列出所有审计过的插件，先看全貌再用 why 追问。
-    if (sub === 'list') return listAudited(deps);
+    if (sub === 'list') return listAudited({ ...deps, refusedRows: await readRefused(deps.probe?.get?.('pluginManager')) });
     if (sub === 'why') return explainVerdict(rest.join(' '), deps);
   return summarizeRepairs(deps);
 }
 
 
-// 把一个本地插件目录准备好，让它能被装上。
+
 async function prepareInstallCommand(spec, deps) {
   if (spec === '') return { kind: 'error', text: 'usage: /doctor install <目录路径或包名> — 两者都行' };
 
@@ -403,33 +393,12 @@ async function prepareInstallCommand(spec, deps) {
 // 而检查只认显式授权。所以给用户一个在点安装之前把这件事做掉的入口：
 // 先 /doctor allow，再在界面上装，装完扫描会自动把声明对齐、环境建好。
 async function allowVersionCommand(spec, deps) {
-  const trimmed = String(spec ?? '').trim();
-  if (trimmed === '') return { kind: 'error', text: '用法：/doctor allow <包名@版本>' };
-  if (trimmed.includes('@', 1) === false) {
-    return { kind: 'error', text: '要写清楚版本，例如 /doctor allow dsh-ssh-ops@0.4.0' };
-  }
-
-  // 授权必须有明确的运行时版本和管理器实例，缺一个都做不了。
-  const runtimeVersion = deps.probe.runtimeFacts().runtimeVersion ?? '';
-  const ready = runtimeVersion !== '' && deps.pluginManager !== undefined;
-  if (ready === false) return { kind: 'error', text: '拿不到当前 DSH 版本或管理器不可用，无法授权' };
-
-  try {
-    await deps.pluginManager.setVersionExemption(trimmed, runtimeVersion, true, true);
-  } catch (error) {
-    return { kind: 'error', text: `授权失败：${String(error)}` };
-  }
-  const note = `已放行 ${trimmed} 在 ${runtimeVersion} 上运行`;
-  deps.record('version-allowed', note);
-
-  return {
-    kind: 'success',
-    text: [
-      `已授权 ${trimmed} 运行在 ${runtimeVersion}`,
-      '现在可以在插件面板里正常安装它了。',
-      '装完之后，声明对齐和兼容环境会自动补上。',
-    ].join('\n'),
-  };
+  const facts = deps.probe.runtimeFacts();
+  return allowVersion(spec, {
+    runtimeVersion: facts.runtimeVersion,
+    manager: deps.pluginManager,
+    record: deps.record,
+  });
 }
 
 // 自己装一个注册表里的包。
@@ -494,4 +463,4 @@ async function summarizeRepairs(deps) {
     for (const item of waiting) lines.push(`- ${item.hint}`);
   }
   return { kind: 'success', text: lines.join('\n') };
-}
+}

package/lib/allow-version.js

@@ -0,0 +1,38 @@
+// 放行一个插件在某个运行时版本上运行。
+//
+// /doctor allow 与界面上的按钮都要做这件事，规则只有一份：
+// 必须写清版本，必须有当前运行时版本和管理器实例。
+
+// @param {string} spec - 形如 包名@版本。
+// @param {object} input - { runtimeVersion, manager, record }。
+// @returns {Promise<{kind: string, text: string}>} 命令结果。
+export async function allowVersion(spec, input) {
+  const trimmed = String(spec ?? '').trim();
+  if (trimmed === '') return { kind: 'error', text: '用法：/doctor allow <包名@版本>' };
+  if (trimmed.includes('@', 1) === false) return { kind: 'error', text: '要写清楚版本，例如 /doctor allow dsh-ssh-ops@0.4.0' };
+
+  const runtimeVersion = input.runtimeVersion ?? '';
+  if (runtimeVersion === '' || input.manager === undefined) return { kind: 'error', text: '拿不到当前 DSH 版本或管理器不可用，无法授权' };
+
+  try {
+    await input.manager.setVersionExemption(trimmed, runtimeVersion, true, true);
+  } catch (error) {
+    return { kind: 'error', text: `授权失败：${String(error)}` };
+  }
+  input.record?.('version-allowed', `已放行 ${trimmed} 在 ${runtimeVersion} 上运行`);
+
+  return {
+    kind: 'success',
+    text: [
+      `已授权 ${trimmed} 运行在 ${runtimeVersion}`,
+      '现在可以在插件面板里正常安装它了。',
+      '装完之后，声明对齐和兼容环境会自动补上。',
+    ].join('\n'),
+  };
+}
+// 没写版本时给一条能直接照抄的例子，省得去翻文档。
+export function allowHint(name) {
+  const base = String(name ?? '').trim();
+  if (base === '') return '用法：/doctor allow <包名@版本>';
+  return `要在插件页安装它，先执行：/doctor allow ${base}@<版本>`;
+}

package/lib/panel-blocked.js

@@ -0,0 +1,18 @@
+// 审计兼容但管理器拒装的插件。
+//
+// 两边结论冲突时，用户看到的是一句「不兼容」却查不到原因。
+// 这里把这种冲突找出来，交给调用方明说并给出授权动作。
+
+// @param {object[]} audited - 审计条目。
+// @param {object[]} refused - 管理器拒装记录，每项至少含 name。
+// @returns {string[]} 冲突的插件名。
+export function blockedButCompatible(audited, refused) {
+  const refusedNames = new Set((refused ?? []).map((row) => row.name));
+  const names = [];
+  for (const item of audited ?? []) {
+    if (item.verdict !== 'compatible') continue;
+    if (!refusedNames.has(item.name)) continue;
+    names.push(item.name);
+  }
+  return names;
+}

package/lib/refused-list.js

@@ -0,0 +1,26 @@
+// 读一次插件管理器的拒装记录。
+//
+// /doctor list 要报「审计说兼容、管理器仍拒装」的冲突，界面也要用它标来源。
+// 两处都需要这份清单，读法就放在这里，读不动时各自决定怎么兜。
+
+// 一行清单里被拒的那个包；没有就返回 undefined。
+export function refusedRowOf(row) {
+  const first = row?.error?.incompatible?.[0];
+  if (first === undefined) return undefined;
+  return { name: first.name, version: first.version, runtimeVersion: first.runtimeVersion };
+}
+
+// 从管理器给的清单里挑出被拒装的包：只有带 incompatible 的行才算。
+export function refusedRowsOf(result) {
+  return (result?.value ?? []).map(refusedRowOf).filter((row) => row !== undefined);
+}
+
+// 直接问管理器要一份。读不动就是空数组——调用方据此只报审计结论。
+export async function readRefused(manager) {
+  if (manager === undefined) return [];
+  try {
+    return refusedRowsOf(await manager.listBundles());
+  } catch {
+    return [];
+  }
+}

package/lib/verdict-report.js

@@ -1,159 +1,168 @@
-import { linesText } from './text-lines.js';
-
-// 已经在扫的时候，告诉用户等一下，而不是报「没有结果」。
-// 有插件需要处理时给出的动作提示。诊断必须配一句能照做的事。
-const NEXT_STEP = '修复会在下一轮扫描时自动尝试；想立刻重试：/doctor install <包名>';
-
-const BUSY_TEXT = '正在扫描，几秒后再执行 /doctor list 就能看到结果。';
-
-// 最近一轮审计的清单。没扫过就是空数组。
-function auditedOf(deps) {
-  return deps.diagnostics?.versionScan?.audited ?? [];
-}
-
-import { ensureAudited } from './scan-bridge.js';
-
-// 讲清某个插件为什么被拦下。
-//
-// 审计把判定、理由、缺的符号都记在诊断里，平时只在整轮扫描的输出里一闪而过。
-// 装不上的人真正想问的就是「为什么」，所以要能直接查。
-
-// @param {string} name - 插件包名。
-// @param {object} deps - 组合根传进来的依赖，只需要 diagnostics。
-// @returns {{kind: string, text: string}} 命令结果。
-export async function explainVerdict(name, deps) {
-  if (name === '') return { kind: 'error', text: 'usage: /doctor why <包名>' };
-  const found = find(name, deps);
-  if (found !== undefined) return { kind: 'success', text: linesText(reportLines(found)) };
-
-  // 和 list 一样：没有扫描结果就先扫一轮，正在扫就告诉用户等一下。
-  const state = await ensureAudited(deps.versionRepair);
-  if (state.busy === true) return { kind: 'success', text: BUSY_TEXT };
-  const again = find(name, deps);
-  if (again !== undefined) return { kind: 'success', text: linesText(reportLines(again)) };
-  return { kind: 'error', text: missingText(name, auditedOf(deps)) };
-}
-
-// 在最近一轮审计里按包名找一条。
-function find(name, deps) {
-  return auditedOf(deps).find((item) => item.name === name);
-}
-
-// 一条一条拼出结论：判定、理由、缺的符号、环境，最后给一句能照做的建议。
-function reportLines(hit) {
-  const lines = [`${hit.name}@${hit.version}：${hit.verdict}`];
-  for (const reason of hit.reasons ?? []) lines.push(`  ${reason}`);
-  if ((hit.missing ?? []).length > 0) lines.push(`  缺符号：${hit.missing.join(', ')}`);
-  if (hit.environment !== undefined) lines.push(`  环境：${hit.environment}`);
-  lines.push(advice(hit));
-  return lines;
-}
-
-// 没查到这个插件时说清楚现状，顺便列出已经审计过谁。
-function missingText(name, audited) {
-  if (audited.length === 0) return `没有 ${name} 的审计结论：还没有扫描结果，先执行 /doctor 或等下一轮扫描`;
-  return `没有 ${name} 的审计结论。已审计的插件：${audited.map((item) => item.name).join(', ')}`;
-}
-
-// 结论后面跟一句能直接照做的话。
-//
-// 环境形态决定下一步：旧版本已经装好的只差重启，没环境的等下一轮扫描，
-// 兼容的则要去走安装路径——三种情况给同一句话等于没说。
-function advice(hit) {
-  if (hit.verdict === 'compatible') return '  结论：可以装。装不上就是管理器那边的检查没过，用 /doctor install 走本插件的路径。';
-
-  const environment = hit.environment ?? '';
-  if (environment.includes('真实旧版本')) {
-    return '  结论：它要的旧版本已经装好，重启 DSH 后重新扫描即可生效。';
-  }
-  if (environment.includes('薄垫片') && (hit.missing ?? []).length === 0) {
-    return '  结论：环境已按现行实现转发，若仍装不上用 /doctor install <包名> 重试。';
-  }
-  return '  结论：下一轮扫描会尝试装入插件声明的旧版本；也可直接 /doctor install <包名> 重试。';
-}
-
-// /doctor list 的入口：没有扫描结果就先扫一轮。
-//
-// 刚启动时诊断里什么都没有，直接说「还没有结果」等于把活推回给用户。
-// 扫描本身是幂等的，顺手做掉更省事。
-export async function listAudited(deps) {
-  if (auditedOf(deps).length > 0) return formatList(deps);
-  const state = await ensureAudited(deps.versionRepair);
-  if (state.busy === true) return { kind: 'success', text: BUSY_TEXT };
-  return formatList(deps);
-}
-
-// 列出所有被审计过的插件：不先知道包名也能看现状。
-//
-// 按判定分组输出：需要处理的排在前面。混在一起时，扫一眼看不出问题在哪。
-export function formatList(deps) {
-  const audited = auditedOf(deps);
-  if (audited.length === 0) return { kind: 'success', text: '还没有扫描结果，先执行 /doctor 或等下一轮扫描' };
-
-  const broken = audited.filter((item) => item.verdict !== 'compatible');
-  const fine = audited.filter((item) => item.verdict === 'compatible');
-  const width = Math.max(...audited.map((item) => item.name.length));
-
-  const lines = [`已审计 ${audited.length} 个插件：`];
-  if (broken.length > 0) pushGroup(lines, `需要处理 ${broken.length} 个`, broken, width);
-  if (fine.length > 0) pushGroup(lines, `可以直接用 ${fine.length} 个`, fine, width);
-
-  // 几个插件被同一个符号卡住时，修一次能全解开，值得单独点出来。
-  if (broken.length > 0) {
-    const gap = gapSummary(broken);
-    if (gap !== undefined) lines.push('', `先修这个：${gap}`);
-    lines.push('', NEXT_STEP);
-  }
-  lines.push('', '用 /doctor why <包名> 看某个插件的完整理由。');
-  return { kind: 'success', text: linesText(lines) };
-}
-
-// 一个小标题加若干行。
-function pushGroup(lines, title, items, width) {
-  lines.push('', `${title}：`);
-  for (const item of items) lines.push(`  ${rowOf(item, width)}`);
-}
-
-// 一行：名字对齐，后面跟判定和环境提示。
-function rowOf(item, width) {
-  const name = item.name.padEnd(width);
-  const where = item.environment === undefined ? '' : `　${shortEnvironment(item.environment)}`;
-  return `${name}  ${item.verdict}${where}`;
-}
-
-// 哪些符号是多个插件共同缺的。
-//
-// 一个符号被两个以上插件需要、又都不在运行时里，这是最值得先处理的事：
-// 修一次能同时解开好几个插件，用户不必逐个 /doctor why 去拼出这件事。
-export function commonGaps(audited) {
-  const owners = new Map();
-  for (const item of audited ?? []) {
-    for (const symbol of item.missing ?? []) {
-      const list = owners.get(symbol) ?? [];
-      list.push(item.name);
-      owners.set(symbol, list);
-    }
-  }
-
-  const gaps = [];
-  for (const [symbol, names] of owners) {
-    if (names.length >= 2) gaps.push({ symbol, plugins: names });
-  }
-  return gaps.sort((a, b) => b.plugins.length - a.plugins.length);
-}
-
-// 把共同缺口说成一句话；没有时返回 undefined。
-export function gapSummary(audited) {
-  const gaps = commonGaps(audited);
-  if (gaps.length === 0) return undefined;
-  const first = gaps[0];
-  return `${first.plugins.length} 个插件都缺 ${first.symbol}（${first.plugins.join(', ')}）`;
-}
-// 列表里只用环境的摘要：把包名列表整段丢掉，超长再截。
-//
-// 「真实旧版本 3 个（需重启）：@deepseek…」把冒号和半截包名挤在一起，读起来别扭；
-// 包名列表留给 /doctor why 输出。
-export function shortEnvironment(text) {
-  const head = text.split('：')[0].split('；')[0];
-  return head.length > 30 ? `${head.slice(0, 30)}…` : head;
-}
+import { linesText } from './text-lines.js';
+
+// 已经在扫的时候，告诉用户等一下，而不是报「没有结果」。
+// 有插件需要处理时给出的动作提示。诊断必须配一句能照做的事。
+const NEXT_STEP = '修复会在下一轮扫描时自动尝试；想立刻重试：/doctor install <包名>';
+
+const BUSY_TEXT = '正在扫描，几秒后再执行 /doctor list 就能看到结果。';
+
+// 最近一轮审计的清单。没扫过就是空数组。
+function auditedOf(deps) {
+  return deps.diagnostics?.versionScan?.audited ?? [];
+}
+
+import { ensureAudited } from './scan-bridge.js';
+import { blockedButCompatible } from './panel-blocked.js';
+
+// 讲清某个插件为什么被拦下。
+//
+// 审计把判定、理由、缺的符号都记在诊断里，平时只在整轮扫描的输出里一闪而过。
+// 装不上的人真正想问的就是「为什么」，所以要能直接查。
+
+// @param {string} name - 插件包名。
+// @param {object} deps - 组合根传进来的依赖，只需要 diagnostics。
+// @returns {{kind: string, text: string}} 命令结果。
+export async function explainVerdict(name, deps) {
+  if (name === '') return { kind: 'error', text: 'usage: /doctor why <包名>' };
+  const found = find(name, deps);
+  if (found !== undefined) return { kind: 'success', text: linesText(reportLines(found)) };
+
+  // 和 list 一样：没有扫描结果就先扫一轮，正在扫就告诉用户等一下。
+  const state = await ensureAudited(deps.versionRepair);
+  if (state.busy === true) return { kind: 'success', text: BUSY_TEXT };
+  const again = find(name, deps);
+  if (again !== undefined) return { kind: 'success', text: linesText(reportLines(again)) };
+  return { kind: 'error', text: missingText(name, auditedOf(deps)) };
+}
+
+// 在最近一轮审计里按包名找一条。
+function find(name, deps) {
+  return auditedOf(deps).find((item) => item.name === name);
+}
+
+// 一条一条拼出结论：判定、理由、缺的符号、环境，最后给一句能照做的建议。
+function reportLines(hit) {
+  const lines = [`${hit.name}@${hit.version}：${hit.verdict}`];
+  for (const reason of hit.reasons ?? []) lines.push(`  ${reason}`);
+  if ((hit.missing ?? []).length > 0) lines.push(`  缺符号：${hit.missing.join(', ')}`);
+  if (hit.environment !== undefined) lines.push(`  环境：${hit.environment}`);
+  lines.push(advice(hit));
+  return lines;
+}
+
+// 没查到这个插件时说清楚现状，顺便列出已经审计过谁。
+function missingText(name, audited) {
+  if (audited.length === 0) return `没有 ${name} 的审计结论：还没有扫描结果，先执行 /doctor 或等下一轮扫描`;
+  return `没有 ${name} 的审计结论。已审计的插件：${audited.map((item) => item.name).join(', ')}`;
+}
+
+// 结论后面跟一句能直接照做的话。
+//
+// 环境形态决定下一步：旧版本已经装好的只差重启，没环境的等下一轮扫描，
+// 兼容的则要去走安装路径——三种情况给同一句话等于没说。
+function advice(hit) {
+  if (hit.verdict === 'compatible') return '  结论：可以装。装不上就是管理器那边的检查没过，用 /doctor install 走本插件的路径。';
+
+  const environment = hit.environment ?? '';
+  if (environment.includes('真实旧版本')) {
+    return '  结论：它要的旧版本已经装好，重启 DSH 后重新扫描即可生效。';
+  }
+  if (environment.includes('薄垫片') && (hit.missing ?? []).length === 0) {
+    return '  结论：环境已按现行实现转发，若仍装不上用 /doctor install <包名> 重试。';
+  }
+  return '  结论：下一轮扫描会尝试装入插件声明的旧版本；也可直接 /doctor install <包名> 重试。';
+}
+
+// /doctor list 的入口：没有扫描结果就先扫一轮。
+//
+// 刚启动时诊断里什么都没有，直接说「还没有结果」等于把活推回给用户。
+// 扫描本身是幂等的，顺手做掉更省事。
+export async function listAudited(deps) {
+  if (auditedOf(deps).length > 0) return formatList(deps);
+  const state = await ensureAudited(deps.versionRepair);
+  if (state.busy === true) return { kind: 'success', text: BUSY_TEXT };
+  return formatList(deps);
+}
+
+// 列出所有被审计过的插件：不先知道包名也能看现状。
+//
+// 按判定分组输出：需要处理的排在前面。混在一起时，扫一眼看不出问题在哪。
+export function formatList(deps) {
+  const audited = auditedOf(deps);
+  if (audited.length === 0) return { kind: 'success', text: '还没有扫描结果，先执行 /doctor 或等下一轮扫描' };
+
+  const broken = audited.filter((item) => item.verdict !== 'compatible');
+  const fine = audited.filter((item) => item.verdict === 'compatible');
+  const width = Math.max(...audited.map((item) => item.name.length));
+
+  const lines = [`已审计 ${audited.length} 个插件：`];
+  if (broken.length > 0) pushGroup(lines, `需要处理 ${broken.length} 个`, broken, width);
+  if (fine.length > 0) pushGroup(lines, `可以直接用 ${fine.length} 个`, fine, width);
+
+  // 几个插件被同一个符号卡住时，修一次能全解开，值得单独点出来。
+  if (broken.length > 0) {
+    const gap = gapSummary(broken);
+    if (gap !== undefined) lines.push('', `先修这个：${gap}`);
+    lines.push('', NEXT_STEP);
+  }
+
+  // 审计说兼容、管理器仍拒装：两边结论冲突，必须单独说，并给出授权动作。
+  const conflict = blockedButCompatible(audited, deps.refusedRows ?? []);
+  if (conflict.length > 0) {
+    lines.push('', `审计认为可用但被拒装 ${conflict.length} 个：${conflict.join(', ')}`);
+    lines.push('  这些插件本身没问题，是版本检查没过。用 /doctor allow <包名@版本> 授权后再装。');
+  }
+
+  lines.push('', '用 /doctor why <包名> 看某个插件的完整理由。');
+  return { kind: 'success', text: linesText(lines) };
+}
+
+// 一个小标题加若干行。
+function pushGroup(lines, title, items, width) {
+  lines.push('', `${title}：`);
+  for (const item of items) lines.push(`  ${rowOf(item, width)}`);
+}
+
+// 一行：名字对齐，后面跟判定和环境提示。
+function rowOf(item, width) {
+  const name = item.name.padEnd(width);
+  const where = item.environment === undefined ? '' : `　${shortEnvironment(item.environment)}`;
+  return `${name}  ${item.verdict}${where}`;
+}
+
+// 哪些符号是多个插件共同缺的。
+//
+// 一个符号被两个以上插件需要、又都不在运行时里，这是最值得先处理的事：
+// 修一次能同时解开好几个插件，用户不必逐个 /doctor why 去拼出这件事。
+export function commonGaps(audited) {
+  const owners = new Map();
+  for (const item of audited ?? []) {
+    for (const symbol of item.missing ?? []) {
+      const list = owners.get(symbol) ?? [];
+      list.push(item.name);
+      owners.set(symbol, list);
+    }
+  }
+
+  const gaps = [];
+  for (const [symbol, names] of owners) {
+    if (names.length >= 2) gaps.push({ symbol, plugins: names });
+  }
+  return gaps.sort((a, b) => b.plugins.length - a.plugins.length);
+}
+
+// 把共同缺口说成一句话；没有时返回 undefined。
+export function gapSummary(audited) {
+  const gaps = commonGaps(audited);
+  if (gaps.length === 0) return undefined;
+  const first = gaps[0];
+  return `${first.plugins.length} 个插件都缺 ${first.symbol}（${first.plugins.join(', ')}）`;
+}
+// 列表里只用环境的摘要：把包名列表整段丢掉，超长再截。
+//
+// 「真实旧版本 3 个（需重启）：@deepseek…」把冒号和半截包名挤在一起，读起来别扭；
+// 包名列表留给 /doctor why 输出。
+export function shortEnvironment(text) {
+  const head = text.split('：')[0].split('；')[0];
+  return head.length > 30 ? `${head.slice(0, 30)}…` : head;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luolingp/request-doctor",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "自动修复客户端引起的请求失败，并让版本不匹配的 DSH 插件能装上、能跑起来。",
   "keywords": [
     "dsh-plugin",