@luolingp/request-doctor 0.16.1 → 0.16.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.16.1
+**版本**：0.16.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.16.1
+**版本**：0.16.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.16.1
+**版本**：0.16.2
 **编制依据**：GB/T 8567-2006《计算机软件文档编制规范》6.6；GB/T 8566-2007 验证与确认过程
 
 ---
@@ -62,6 +62,7 @@
 | `test/client-half.test.mjs` | 11 | 客户端半：模块身份、注入声明、apply 注册、组件能渲染 |
 | `test/diagnostics.test.mjs` | 3 | 快照可选写入：不配置不写盘、突发合并、坏路径不致命 |
 | `test/restart-notice.test.mjs` | 3 |
+| `test/status-restore.test.mjs` | 7 | 跨重启恢复：快照可读、缺失/损坏/旧格式均当无历史、非法条目丢弃 |
 | `test/status-path.test.mjs` | 6 | 诊断落盘路径：默认兜底、空串表示不写、非字符串当未设 |
 | `test/skip-path.test.mjs` | 2 | 端到端：真实 TLS 失败走到记账，同类累加 |
 | `test/skipped-summary.test.mjs` | 3 | 诊断收拢 skip 记录：按类归并、其它类别不入账 |
@@ -75,7 +76,7 @@
 | `test/panel-blocked.test.mjs` | 7 | 冲突判定：审计兼容却被拒装、清单形状解析、给 allow 动作 |
 | `test/panel-briefs.test.mjs` | 6 | 界面摘要：按名索引、只送可见行、缺数据不抛、不污染诊断 |
 | `test/verdict-report.test.mjs` | 29 | why 与 list：判定、理由、环境摘要、自动扫描、分组、缺口、按形态给建议 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
-| **合计** | **252** | **全部通过** |
+| **合计** | **259** | **全部通过** |
 
 执行结果：
 
@@ -229,7 +230,7 @@
 
 ### 7.2 分文件执行结果
 
-42 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 252。
+43 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 259。
 ## 8 覆盖率实测
 
 用 Node 自带的 `--experimental-test-coverage` 跑一遍，作为「分支有没有被真的走一遍」的证据。这不替代对断言质量的判断，只说明哪些代码从未被执行。

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.16.1
+**版本**：0.16.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.16.1
+**版本**：0.16.2
 **编制依据**：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.16.1
+**版本**：0.16.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-29T17:08:43.683Z",
+  "generatedAt": "2026-10-29T17:11:56.729Z",
   "scope": {
-    "files": 40,
-    "totalLines": 5511,
-    "sourceLines": 3966,
-    "commentLines": 1027
+    "files": 41,
+    "totalLines": 5538,
+    "sourceLines": 3984,
+    "commentLines": 1034
   },
   "measures": {
-    "commentDensity": 25.9,
-    "duplicationPercent": 4.95,
-    "functionCount": 423,
+    "commentDensity": 25.95,
+    "duplicationPercent": 4.93,
+    "functionCount": 425,
     "maxComplexity": 10,
     "maxFunctionLines": 58,
     "maxFileLines": 500,
-    "averageComplexity": 3.82
+    "averageComplexity": 3.84
   },
   "limits": {
     "maxComplexity": 10,

package/lib/diagnostics.js

@@ -1,81 +1,83 @@
-// 诊断记录。
-//
-// 管三件事：各项修复计数、最近若干条事件、可选的快照文件。单独拎出来是因为组合根要
-// 关心的是"怎么修"，不该顺带管状态怎么记。
-import { writeFileSync } from 'node:fs';
-import { createSkipLog } from './skip-log.js';
-
-// 最近事件留多少条给 /doctor 看
-const MAX_LOG = 30;
-
-// 突发重试时按这个间隔合并写盘
-const WRITE_COALESCE_MS = 250;
-
-export function createDiagnostics(input) {
-  const stats = {
-    startedAt: Date.now(),
-    modelRepairs: 0,
-    modelSkips: 0,
-    toolRepairs: 0,
-    connectionRepairs: 0,
-    versionRepairs: 0,
-    last: [],
-  };
-  const diagnostics = { versionScan: null };
-  const skipped = createSkipLog();
-  let pending;
-
-  const snapshot = () => ({
-    pid: process.pid,
-    ...stats,
-    diagnostics,
-    ...(input.describe === undefined ? {} : { config: input.describe() }),
-  });
-
-  // 立刻写。诊断不是正确性数据，写失败就算了——磁盘满了也不该把请求修复带崩。
-  const writeNow = () => {
-    if (input.statusFile === '') return;
-    try {
-      writeFileSync(input.statusFile, `${JSON.stringify(snapshot(), null, 2)}\n`, 'utf8');
-    } catch {
-      // 只有诊断，丢了就丢了
-    }
-  };
-
-  // 合并写。record 每次修复都会调，而修复是会扎堆的——网络抖一下一秒能来好几次，
-  // 每次都同步写盘等于在 agent 最忙的时候卡住事件循环。
-  const scheduleWrite = () => {
-    if (input.statusFile === '' || pending !== undefined) return;
-    pending = setTimeout(() => {
-      pending = undefined;
-      writeNow();
-    }, WRITE_COALESCE_MS);
-    pending.unref?.();
-    input.trackTimer?.(pending);
-  };
-
-  const record = (kind, detail) => {
-    stats.last.push({ at: new Date().toISOString(), kind, detail: String(detail).slice(0, 240) });
-    if (stats.last.length > MAX_LOG) stats.last.shift();
-    input.log('info', `request-doctor: ${kind}: ${detail}`);
-    // 没救回来的失败按类别归并：日志是流式的，翻起来费事。
-    if (kind === 'skip') skipped.add(detail);
-    scheduleWrite();
-  };
-
-  // 把扫描错误挂到当前这轮结果上，别让调用方去翻嵌套对象。
-  const scanError = (detail) => {
-    diagnostics.versionScan = { ...(diagnostics.versionScan ?? {}), ok: false, error: detail };
-  };
-
-  // 收尾时把攒着的写掉
-  const flush = () => {
-    if (pending !== undefined) {
-      clearTimeout(pending);
-      pending = undefined;
-    }
-    writeNow();
-  };
-
-  return { record, scheduleWrite, writeNow, flush, scanError, stats, skipped: () => skipped.read(), diagnostics, snapshot };
-}
+// 诊断记录。
+//
+// 管三件事：各项修复计数、最近若干条事件、可选的快照文件。单独拎出来是因为组合根要
+// 关心的是"怎么修"，不该顺带管状态怎么记。
+import { writeFileSync } from 'node:fs';
+import { createSkipLog } from './skip-log.js';
+import { restoreSkipped } from './status-restore.js';
+
+// 最近事件留多少条给 /doctor 看
+const MAX_LOG = 30;
+
+// 突发重试时按这个间隔合并写盘
+const WRITE_COALESCE_MS = 250;
+
+export function createDiagnostics(input) {
+  const stats = {
+    startedAt: Date.now(),
+    modelRepairs: 0,
+    modelSkips: 0,
+    toolRepairs: 0,
+    connectionRepairs: 0,
+    versionRepairs: 0,
+    last: [],
+  };
+  const diagnostics = { versionScan: null };
+  const skipped = createSkipLog(restoreSkipped(input.statusFile));
+  let pending;
+
+  const snapshot = () => ({
+    skipped: skipped.read(),
+    pid: process.pid,
+    ...stats,
+    diagnostics,
+    ...(input.describe === undefined ? {} : { config: input.describe() }),
+  });
+
+  // 立刻写。诊断不是正确性数据，写失败就算了——磁盘满了也不该把请求修复带崩。
+  const writeNow = () => {
+    if (input.statusFile === '') return;
+    try {
+      writeFileSync(input.statusFile, `${JSON.stringify(snapshot(), null, 2)}\n`, 'utf8');
+    } catch {
+      // 只有诊断，丢了就丢了
+    }
+  };
+
+  // 合并写。record 每次修复都会调，而修复是会扎堆的——网络抖一下一秒能来好几次，
+  // 每次都同步写盘等于在 agent 最忙的时候卡住事件循环。
+  const scheduleWrite = () => {
+    if (input.statusFile === '' || pending !== undefined) return;
+    pending = setTimeout(() => {
+      pending = undefined;
+      writeNow();
+    }, WRITE_COALESCE_MS);
+    pending.unref?.();
+    input.trackTimer?.(pending);
+  };
+
+  const record = (kind, detail) => {
+    stats.last.push({ at: new Date().toISOString(), kind, detail: String(detail).slice(0, 240) });
+    if (stats.last.length > MAX_LOG) stats.last.shift();
+    input.log('info', `request-doctor: ${kind}: ${detail}`);
+    // 没救回来的失败按类别归并：日志是流式的，翻起来费事。
+    if (kind === 'skip') skipped.add(detail);
+    scheduleWrite();
+  };
+
+  // 把扫描错误挂到当前这轮结果上，别让调用方去翻嵌套对象。
+  const scanError = (detail) => {
+    diagnostics.versionScan = { ...(diagnostics.versionScan ?? {}), ok: false, error: detail };
+  };
+
+  // 收尾时把攒着的写掉
+  const flush = () => {
+    if (pending !== undefined) {
+      clearTimeout(pending);
+      pending = undefined;
+    }
+    writeNow();
+  };
+
+  return { record, scheduleWrite, writeNow, flush, scanError, stats, skipped: () => skipped.read(), diagnostics, snapshot };
+}

package/lib/skip-log.js

@@ -6,8 +6,12 @@
 const MAX_KINDS = 12;
 
 // 可读的汇总对象：add 记账，read 取回按次数排序的列表。
-export function createSkipLog() {
+// 初始条目来自上次落盘的快照，让「没能修复的失败」跨重启可见。
+export function createSkipLog(initial = []) {
   const entries = new Map();
+  for (const entry of initial) {
+    if (entry !== null && typeof entry === 'object') entries.set(entry.kind, { ...entry });
+  }
   return {
     add(detail) {
       const kind = String(detail).split(':')[0].trim();

package/lib/status-restore.js

@@ -0,0 +1,20 @@
+// 从上次的快照里恢复 skip 汇总。
+//
+// 诊断不是正确性数据：文件缺失、损坏、字段变了，都只当没有历史，
+// 绝不能让插件因为读不到旧文件而启动失败。
+import { readFileSync } from 'node:fs';
+
+// @param {string} statusFile - 快照路径；空串表示不读。
+// @returns {object[]} 上次记录的 skip 条目；读不到就是空数组。
+export function restoreSkipped(statusFile) {
+  if (typeof statusFile !== 'string' || statusFile === '') return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(statusFile, 'utf8'));
+  } catch {
+    return [];
+  }
+  const entries = parsed?.skipped;
+  if (!Array.isArray(entries)) return [];
+  return entries.filter((entry) => typeof entry?.kind === 'string' && typeof entry?.count === 'number');
+}

package/package.json

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