@luolingp/request-doctor 0.12.0 → 0.12.2

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.12.0
+**版本**：0.12.2
 
 ---
 

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.12.0
+**版本**：0.12.2
 **编制依据**：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.12.0
+**版本**：0.12.2
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.6；GB/T 8566-2007 验证与确认过程
 
 ---
@@ -62,8 +62,8 @@
 | `test/client-half.test.mjs` | 5 | 客户端半：模块身份、注入声明、apply 注册、组件能渲染 |
 | `test/diagnostics.test.mjs` | 3 | 快照可选写入：不配置不写盘、突发合并、坏路径不致命 |
 | `test/restart-notice.test.mjs` | 3 |
-| `test/verdict-report.test.mjs` | 5 | /doctor why：判定、理由、缺符号、环境、下一步 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
-| **合计** | **166** | **全部通过** |
+| `test/verdict-report.test.mjs` | 11 | why 与 list：判定、理由、缺符号、环境、空清单自动扫描 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
+| **合计** | **172** | **全部通过** |
 
 执行结果：
 
@@ -213,4 +213,4 @@
 
 ### 7.2 分文件执行结果
 
-31 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 166。
+31 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 172。

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.12.0
+**版本**：0.12.2
 **编制依据**：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.12.0
+**版本**：0.12.2
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.5
 
 ---
@@ -211,4 +211,19 @@ dsh-hyper-tools@0.1.0：incompatible
   结论：要修得先让它要的东西能被提供；缺符号时本插件会尝试装入插件声明的旧版本。
 ```
 
-判定为兼容但界面里装不上时，它也会告诉你该走 `/doctor install`。查不到这个插件时会列出已经审计过的插件名。
+判定为兼容但界面里装不上时，它也会告诉你该走 `/doctor install`。查不到这个插件时会列出已经审计过的插件名。
+
+想先看全貌：
+
+```
+/doctor list
+```
+
+```
+已审计 3 个插件：
+  dsh-hyper-tools  incompatible　真实旧版本 3 个（需重启）：@de…
+  ok-plugin        compatible
+  demo             incompatible
+```
+
+列表里只留环境提示的前半句，完整内容用 `/doctor why` 看。

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.12.0
+**版本**：0.12.2
 **度量标准**：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-29T13:23:48.300Z",
+  "generatedAt": "2026-10-29T15:17:19.719Z",
   "scope": {
-    "files": 29,
-    "totalLines": 5029,
-    "sourceLines": 3663,
-    "commentLines": 910
+    "files": 30,
+    "totalLines": 5084,
+    "sourceLines": 3698,
+    "commentLines": 923
   },
   "measures": {
-    "commentDensity": 24.84,
-    "duplicationPercent": 4.91,
-    "functionCount": 378,
+    "commentDensity": 24.96,
+    "duplicationPercent": 4.99,
+    "functionCount": 384,
     "maxComplexity": 10,
     "maxFunctionLines": 59,
     "maxFileLines": 500,
-    "averageComplexity": 3.89
+    "averageComplexity": 3.86
   },
   "limits": {
     "maxComplexity": 10,

package/index.js

@@ -17,7 +17,7 @@
 // 因此能显示出来，不用发明新的事件类型。
 //
 // 这个文件是装配处：只管生命周期和监听器，具体判断都在 lib/ 里。
-import { explainVerdict } from './lib/verdict-report.js';
+import { explainVerdict, listAudited } from './lib/verdict-report.js';
 import { parseRetryConfig } from './lib/classify.js';
 import { collectPackageFacts, entryPathOf } from './lib/compat-repair.js';
 import { unmetPeers } from './lib/compat.js';
@@ -210,7 +210,7 @@ function registerDoctorCommand(ctx, deps) {
         commandCtx.commands.register({
           name: 'doctor',
           description: 'Show request-doctor repair activity, repair version mismatches now, or prepare a plugin for installation',
-          input: { hint: 'install <path-or-package> | allow <package@version> | why <package>' },
+          input: { hint: 'install <path-or-package> | allow <package@version> | why <package> | list' },
           handler: async (invocation) => runDoctorCommand(invocation, deps),
         }),
       'request-doctor: /doctor command',
@@ -341,6 +341,8 @@ async function runDoctorCommand(invocation, deps) {
   // allow 只授权、不安装：给那些想继续在图形界面里点安装的人用。
   if (sub === 'allow') return allowVersionCommand(rest.join(' '), deps);
     // why 回答「这个插件为什么被判为不可兼容」，答案就在最近一轮审计里。
+    // list 列出所有审计过的插件，先看全貌再用 why 追问。
+    if (sub === 'list') return listAudited(deps);
     if (sub === 'why') return explainVerdict(rest.join(' '), deps);
   return summarizeRepairs(deps);
 }

package/lib/text-lines.js

@@ -0,0 +1,9 @@
+// 拼多行文本的小工具。
+//
+// 命令输出都是「一行一条」的形状，集中到这里，各处的写法就不会各拼各的。
+
+// 把若干行接成命令结果。空数组时给出兜底句。
+export function linesText(lines, empty) {
+  if (lines.length === 0) return empty;
+  return lines.join('\n');
+}

package/lib/verdict-report.js

@@ -1,3 +1,10 @@
+import { linesText } from './text-lines.js';
+
+// 最近一轮审计的清单。没扫过就是空数组。
+function auditedOf(deps) {
+  return deps.diagnostics?.versionScan?.audited ?? [];
+}
+
 // 讲清某个插件为什么被拦下。
 //
 // 审计把判定、理由、缺的符号都记在诊断里，平时只在整轮扫描的输出里一闪而过。
@@ -8,10 +15,10 @@
 // @returns {{kind: string, text: string}} 命令结果。
 export function explainVerdict(name, deps) {
   if (name === '') return { kind: 'error', text: 'usage: /doctor why <包名>' };
-  const audited = deps.diagnostics?.versionScan?.audited ?? [];
+  const audited = auditedOf(deps);
   const hit = audited.find((item) => item.name === name);
   if (hit === undefined) return { kind: 'error', text: missingText(name, audited) };
-  return { kind: 'success', text: reportLines(hit).join('\n') };
+  return { kind: 'success', text: linesText(reportLines(hit)) };
 }
 
 // 一条一条拼出结论：判定、理由、缺的符号、环境，最后给一句能照做的建议。
@@ -35,3 +42,40 @@ function advice(verdict) {
   if (verdict === 'compatible') return '  结论：可以装。装不上就是管理器那边的检查没过，用 /doctor install 走本插件的路径。';
   return '  结论：要修得先让它要的东西能被提供；缺符号时本插件会尝试装入插件声明的旧版本。';
 }
+
+// /doctor list 的入口：没有扫描结果就先扫一轮。
+//
+// 刚启动时诊断里什么都没有，直接说「还没有结果」等于把活推回给用户。
+// 扫描本身是幂等的，顺手做掉更省事。
+export async function listAudited(deps) {
+  if (auditedOf(deps).length === 0 && deps.versionRepair !== undefined) {
+    try {
+      await deps.versionRepair.run('list');
+    } catch {
+      // 扫描失败不影响回答：下面会如实说还没结果。
+    }
+  }
+  return formatList(deps);
+}
+
+// 列出所有被审计过的插件：不先知道包名也能看现状。
+export function formatList(deps) {
+  const audited = auditedOf(deps);
+  if (audited.length === 0) return { kind: 'success', text: '还没有扫描结果，先执行 /doctor 或等下一轮扫描' };
+
+  const lines = [`已审计 ${audited.length} 个插件：`];
+  const width = Math.max(...audited.map((item) => item.name.length));
+  for (const item of audited) {
+    const name = item.name.padEnd(width);
+    const where = item.environment === undefined ? '' : `　${firstClause(item.environment)}`;
+    lines.push(`  ${name}  ${item.verdict}${where}`);
+  }
+  lines.push('', '用 /doctor why <包名> 看某个插件的完整理由。');
+  return { kind: 'success', text: linesText(lines) };
+}
+
+// 长句在列表里只留前半句，完整内容留给 why。
+function firstClause(text) {
+  const cut = text.split('；')[0];
+  return cut.length > 24 ? `${cut.slice(0, 24)}…` : cut;
+}

package/package.json

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