@luolingp/request-doctor 0.12.2 → 0.12.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.12.2
+**版本**：0.12.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.12.2
+**版本**：0.12.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.12.2
+**版本**：0.12.4
 **编制依据**：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` | 11 | why 与 list：判定、理由、缺符号、环境、空清单自动扫描 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
-| **合计** | **172** | **全部通过** |
+| `test/verdict-report.test.mjs` | 15 | why 与 list：判定、理由、环境、自动扫描、扫描中不误报 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
+| **合计** | **176** | **全部通过** |
 
 执行结果：
 
@@ -213,4 +213,4 @@
 
 ### 7.2 分文件执行结果
 
-31 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 172。
+31 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 176。

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.2
+**版本**：0.12.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.12.2
+**版本**：0.12.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.12.2
+**版本**：0.12.4
 **度量标准**：GB/T 45717-2025《信息技术 软件测量 软件质量测量 自动化的源代码质量测度》
 **度量工具**：`tools/quality-measure.mjs`（本仓库自带，可复现）
 

package/docs/quality-report.json

@@ -1,16 +1,16 @@
 {
   "standard": "GB/T 45717-2025 信息技术 软件测量 软件质量测量 自动化的源代码质量测度",
-  "generatedAt": "2026-10-29T15:17:19.719Z",
+  "generatedAt": "2026-10-29T15:30:57.373Z",
   "scope": {
-    "files": 30,
-    "totalLines": 5084,
-    "sourceLines": 3698,
-    "commentLines": 923
+    "files": 31,
+    "totalLines": 5113,
+    "sourceLines": 3712,
+    "commentLines": 932
   },
   "measures": {
-    "commentDensity": 24.96,
-    "duplicationPercent": 4.99,
-    "functionCount": 384,
+    "commentDensity": 25.11,
+    "duplicationPercent": 4.96,
+    "functionCount": 386,
     "maxComplexity": 10,
     "maxFunctionLines": 59,
     "maxFileLines": 500,

package/lib/scan-bridge.js

@@ -0,0 +1,17 @@
+// 命令与扫描之间的桥。
+//
+// 命令只想拿一份最新清单，而扫描是异步的：这里负责「没数据就扫一轮」、
+// 「正在扫就别再排」这两件事，命令侧不必各自重复这套判断。
+
+// 返回 { scanned, busy }：scanned 表示这一轮是否真触发了扫描，
+// busy 表示调用时是否已经在扫。
+export async function ensureAudited(versionRepair) {
+  if (versionRepair === undefined) return { scanned: false, busy: false };
+  if (versionRepair.isBusy?.() === true) return { scanned: false, busy: true };
+  try {
+    await versionRepair.run('list');
+  } catch {
+    // 扫描失败不影响回答，调用方会如实说还没结果。
+  }
+  return { scanned: true, busy: false };
+}

package/lib/verdict-report.js

@@ -1,10 +1,15 @@
 import { linesText } from './text-lines.js';
 
+// 已经在扫的时候，告诉用户等一下，而不是报「没有结果」。
+const BUSY_TEXT = '正在扫描，几秒后再执行 /doctor list 就能看到结果。';
+
 // 最近一轮审计的清单。没扫过就是空数组。
 function auditedOf(deps) {
   return deps.diagnostics?.versionScan?.audited ?? [];
 }
 
+import { ensureAudited } from './scan-bridge.js';
+
 // 讲清某个插件为什么被拦下。
 //
 // 审计把判定、理由、缺的符号都记在诊断里，平时只在整轮扫描的输出里一闪而过。
@@ -13,12 +18,22 @@ function auditedOf(deps) {
 // @param {string} name - 插件包名。
 // @param {object} deps - 组合根传进来的依赖，只需要 diagnostics。
 // @returns {{kind: string, text: string}} 命令结果。
-export function explainVerdict(name, deps) {
+export async function explainVerdict(name, deps) {
   if (name === '') return { kind: 'error', text: 'usage: /doctor why <包名>' };
-  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: linesText(reportLines(hit)) };
+  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);
 }
 
 // 一条一条拼出结论：判定、理由、缺的符号、环境，最后给一句能照做的建议。
@@ -48,13 +63,9 @@ function advice(verdict) {
 // 刚启动时诊断里什么都没有，直接说「还没有结果」等于把活推回给用户。
 // 扫描本身是幂等的，顺手做掉更省事。
 export async function listAudited(deps) {
-  if (auditedOf(deps).length === 0 && deps.versionRepair !== undefined) {
-    try {
-      await deps.versionRepair.run('list');
-    } catch {
-      // 扫描失败不影响回答：下面会如实说还没结果。
-    }
-  }
+  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);
 }
 

package/package.json

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