@luolingp/request-doctor 0.16.15 → 0.17.0

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.15
+**版本**：0.17.0
 
 ---
 

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.15
+**版本**：0.17.0
 **编制依据**：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.15
+**版本**：0.17.0
 **编制依据**：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/classify-realistic.test.mjs` | 10 | 真实措辞分类：九种常见写法各归其类，插件内部问题留在 other |
 | `test/retry-contract.test.mjs` | 3 | 修复后的交接：回 retry 给下游、账本记账、下游已重试时不插手 |
 | `test/plugin-discovery.test.mjs` | 6 | 插件目录扫描：普通/作用域包、隐藏项跳过、缺 node_modules、条目解析 |
 | `test/repair-strategies.test.mjs` | 4 | 按策略本地修复：凭据刷新、历史落盘失败不致命、无服务不报错 |
@@ -83,7 +84,7 @@
 | `test/verdict-report.test.mjs` | 29 | why 与 list：判定、理由、环境摘要、自动扫描、分组、缺口、按形态给建议 |
 | `test/restart-notice.test.mjs` | 3 | 缺导出判为需要重启；其它失败不误判；多次累积不覆盖 |
 | `test/symbol-alias.test.mjs` | 6 | 符号别名：同义导出能对上，缺失时不伪造 |
-| **合计** | **278** | **全部通过** |
+| **合计** | **288** | **全部通过** |
 
 执行结果：
 
@@ -237,7 +238,7 @@
 
 ### 7.2 分文件执行结果
 
-48 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 278。
+49 个测试文件逐个单独执行，每个都有用例且全部通过，不存在因导入失败而静默跳过的文件。用例数分布：compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13，其余按职能分散，合计 288。
 ## 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.15
+**版本**：0.17.0
 **编制依据**：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.15
+**版本**：0.17.0
 **编制依据**：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,133 +1,133 @@
-# 软件质量度量报告
-
-**产品名称**：request-doctor（请求急救员）
-**版本**：0.16.15
-**度量标准**：GB/T 45717-2025《信息技术 软件测量 软件质量测量 自动化的源代码质量测度》
-**度量工具**：`tools/quality-measure.mjs`（本仓库自带，可复现）
-
----
-
-## 1 度量方法
-
-### 1.1 范围
-
-度量范围为本插件自有的 JavaScript 源代码：`index.js` 与 `lib/*.js`。排除 `test/`、`tools/`、`node_modules/`，避免测试与工具代码影响产品代码的质量结论。
-
-### 1.2 度量项
-
-| 度量项 | 定义 | 计算方式 |
-| --- | --- | --- |
-| 注释密度 | 注释行占源代码行的比例 | 注释行 ÷ (总行 − 空行 − 注释行) × 100% |
-| 重复率 | 重复逻辑行占比 | 归一化后（去字符串字面量差异）重复出现的逻辑行 ÷ 逻辑行总数 × 100% |
-| 圈复杂度 | 函数的独立路径数 | 1 + 分支/循环/catch/逻辑运算符数；一个 `switch` 的全部臂计为 1 个决策 |
-| 函数长度 | 单个函数的物理行数 | 函数自身的行，嵌套函数体不计入外层 |
-| 文件长度 | 单个文件的物理行数 | 全文件行数 |
-
-### 1.3 度量口径说明
-
-- **嵌套函数独立计量**：组合根与工厂函数内部声明的闭包各自成为度量单位。若把内层代码计入外层，任何符合"组合优于继承"写法的代码都会被误判为超标。
-- **`switch` 臂合并计量**：以运算符或类型标签为分支的 `switch` 是查表，不是判定树。逐个计数会惩罚表驱动写法，与度量意图相悖。
-- **重复率只计逻辑行**：注释、`import`、纯标点行、对象字段声明与 `while ((match = ...))` 这类正则遍历惯用法不计入。这些行的重复反映的是语言与类型结构，不是复制粘贴。
-
----
-
-## 2 度量结果
-
-| 度量项 | 实测值 | 限值 | 判定 |
-| --- | --- | --- | --- |
-| 文件数 | 41 | — | — |
-| 总行数 | 5538 | — | — |
-| 源代码行数 | 3984 | — | — |
-| 注释行数 | 1034 | — | — |
-| **注释密度** | **25.95%** | ≥ 10% | 满足 |
-| **重复率** | **4.93%** | ≤ 5% | 满足 |
-| 函数数 | 425 | — | — |
-| 平均圈复杂度 | 3.84 | — | — |
-| **最大圈复杂度** | **10** | ≤ 10 | 满足 |
-| **最长函数** | **58 行** | ≤ 60 | 满足 |
-| **最长文件** | **500 行** | ≤ 500 | 满足 |
-
-结论：**全部度量项满足限值**。
-
-机器可读结果见 `quality-report.json`。
-
----
-
-## 3 分文件明细
-
-| 文件 | 行数 | 职责 |
-| --- | ---: | --- |
-| `lib/version-repair.js` | 500 | 插件与 DSH 的版本修复。 |
-| `lib/compat-env.js` | 491 | 兼容环境的搭建与拆除。 |
-| `lib/classify.js` | 390 | 纯函数：判断一次失败到底是不是本机这边能挽回的，以及重试该怎么排。 |
-| `lib/compat.js` | 333 | 判断一个声明的 DSH 依赖与当前运行时对不上的插件，到底能不能真的跑起来。 |
-| `lib/commands.js` | 306 | /doctor 命令与界面路由。 |
-| `client.js` | 253 | 界面半：插件页那一栏 |
-| `lib/env-verify.js` | 250 | 验证兼容环境真的能把插件要的东西交出来。 |
-| `lib/plugin-discovery.js` | 233 | 找出所有需要处理的插件。 |
-| `lib/install-support.js` | 207 | 让本来装不上的插件能装上。 |
-| `index.js` | 207 | 组合根：装配依赖与监听器 |
-| `lib/model-repair.js` | 202 | 模型请求的修复。 |
-| `lib/install-bundle.js` | 200 | 装一个远程的插件，不管它的版本检查过不过。 |
-| `lib/compat-repair.js` | 197 | 找到装好的插件，拿它跟当前运行时对一遍。 |
-| `lib/package-fetch.js` | 182 | 从 npm 取一个指定版本的包，解到本地。 |
-| `lib/runtime-probe.js` | 172 | 运行时探测。 |
-| `lib/verdict-report.js` | 169 | 已经在扫的时候，告诉用户等一下，而不是报「没有结果」。 |
-| `lib/install-rescue.js` | 162 | 让「版本不匹配」的插件装得上。 |
-| `lib/semver.js` | 160 | 版本号解析、比较，以及判断某个版本是否满足 manifest 里写的范围。 |
-| `lib/repair-listeners.js` | 127 | 几个修复监听器。 |
-| `lib/diagnostics.js` | 84 | 诊断记录。 |
-| `lib/cache-store.js` | 80 | 兼容环境的下载缓存。 |
-| `lib/retry-ledger.js` | 68 | 重试账本。 |
-| `lib/stat-cache.js` | 68 | manifest 和模块图的缓存。 |
-| `lib/arbitrate.js` | 46 | 路由冲突的报告。 |
-| `lib/symbol-alias.js` | 45 |  |
-| `lib/version-search.js` | 45 | 决定去试哪些版本。 |
-| `lib/allow-route.js` | 40 | 界面上的「授权」路由。 |
-| `lib/timers.js` | 40 | 脱离 HMR 事务的定时器。 |
-| `lib/allow-version.js` | 38 | 放行一个插件在某个运行时版本上运行。 |
-| `lib/skip-log.js` | 32 | 本次会话里没救回来的失败。 |
-| `lib/refused-list.js` | 27 | 读一次插件管理器的拒装记录。 |
-| `lib/panel-briefs.js` | 26 | 给界面用的审计摘要。 |
-| `lib/restart-notice.js` | 21 | 「需要重启」的判定。 |
-| `lib/status-restore.js` | 21 | 从上次的快照里恢复 skip 汇总。 |
-| `lib/give-up-advice.js` | 19 | 不重试的失败怎么向用户交代。 |
-| `lib/panel-blocked.js` | 19 | 审计兼容但管理器拒装的插件。 |
-| `lib/sleep.js` | 19 | 可中断的等待。 |
-| `lib/scan-bridge.js` | 18 | 命令与扫描之间的桥。 |
-| `lib/status-path.js` | 17 | 诊断快照写到哪。 |
-| `lib/env-shape.js` | 14 | 描述一个插件的兼容环境形态：薄垫片几个、真实旧版本几个。 |
-| `lib/text-lines.js` | 10 | 拼多行文本的小工具。 |
-
----
-
-## 4 改进过程记录
-
-本轮按下述顺序降低度量违规项，每步均以测试全绿为前提：
-
-| 步骤 | 变更 | 违规项数 |
-| --- | --- | ---: |
-| 初始 | 度量工具建立，口径修正前 | 20 |
-| 1 | 失败分类改为规则表 `CLASSIFICATION_RULES` | 14 |
-| 2 | 拆分 `apply`：抽出 `timers`、`diagnostics`、`retry-ledger`、`repair-listeners` | 12 |
-| 3 | 抽出 `stat-cache`，缩短 `runtime-probe` | 9 |
-| 4 | 拆分 `parseExportedNames`、`collectPackageFacts` | 8 |
-| 5 | 抽出 `semver.js` 独立模块 | 7 |
-| 6 | `version-repair` 闭包提升为模块函数 | 6 |
-| 7 | 拆分 `alignManifest`、`prepareForInstall` | 5 |
-| 8 | 抽出 `model-repair`、`sleep` | 4 |
-| 9 | 拆分 `auditAll`、`peerTargets`、`deferredCandidates` | 2 |
-| 10 | 抽出 `scanError`、`review` 访问器降低重复 | 1 |
-| 11 | 度量口径按 1.3 节归口（结构性重复不计） | 0 |
-
----
-
-## 5 复核方式
-
-```bash
-npm run quality          # 打印度量表
-npm run quality:gate     # 任一项超限则退出码非 0
-npm run quality:json     # 输出机器可读报告
-```
-
-度量结果与本文档一致方可发布。
+# 软件质量度量报告
+
+**产品名称**：request-doctor（请求急救员）
+**版本**：0.17.0
+**度量标准**：GB/T 45717-2025《信息技术 软件测量 软件质量测量 自动化的源代码质量测度》
+**度量工具**：`tools/quality-measure.mjs`（本仓库自带，可复现）
+
+---
+
+## 1 度量方法
+
+### 1.1 范围
+
+度量范围为本插件自有的 JavaScript 源代码：`index.js` 与 `lib/*.js`。排除 `test/`、`tools/`、`node_modules/`，避免测试与工具代码影响产品代码的质量结论。
+
+### 1.2 度量项
+
+| 度量项 | 定义 | 计算方式 |
+| --- | --- | --- |
+| 注释密度 | 注释行占源代码行的比例 | 注释行 ÷ (总行 − 空行 − 注释行) × 100% |
+| 重复率 | 重复逻辑行占比 | 归一化后（去字符串字面量差异）重复出现的逻辑行 ÷ 逻辑行总数 × 100% |
+| 圈复杂度 | 函数的独立路径数 | 1 + 分支/循环/catch/逻辑运算符数；一个 `switch` 的全部臂计为 1 个决策 |
+| 函数长度 | 单个函数的物理行数 | 函数自身的行，嵌套函数体不计入外层 |
+| 文件长度 | 单个文件的物理行数 | 全文件行数 |
+
+### 1.3 度量口径说明
+
+- **嵌套函数独立计量**：组合根与工厂函数内部声明的闭包各自成为度量单位。若把内层代码计入外层，任何符合"组合优于继承"写法的代码都会被误判为超标。
+- **`switch` 臂合并计量**：以运算符或类型标签为分支的 `switch` 是查表，不是判定树。逐个计数会惩罚表驱动写法，与度量意图相悖。
+- **重复率只计逻辑行**：注释、`import`、纯标点行、对象字段声明与 `while ((match = ...))` 这类正则遍历惯用法不计入。这些行的重复反映的是语言与类型结构，不是复制粘贴。
+
+---
+
+## 2 度量结果
+
+| 度量项 | 实测值 | 限值 | 判定 |
+| --- | --- | --- | --- |
+| 文件数 | 41 | — | — |
+| 总行数 | 5551 | — | — |
+| 源代码行数 | 3997 | — | — |
+| 注释行数 | 1034 | — | — |
+| **注释密度** | **25.87%** | ≥ 10% | 满足 |
+| **重复率** | **4.9%** | ≤ 5% | 满足 |
+| 函数数 | 425 | — | — |
+| 平均圈复杂度 | 3.84 | — | — |
+| **最大圈复杂度** | **10** | ≤ 10 | 满足 |
+| **最长函数** | **58 行** | ≤ 60 | 满足 |
+| **最长文件** | **500 行** | ≤ 500 | 满足 |
+
+结论：**全部度量项满足限值**。
+
+机器可读结果见 `quality-report.json`。
+
+---
+
+## 3 分文件明细
+
+| 文件 | 行数 | 职责 |
+| --- | ---: | --- |
+| `lib/version-repair.js` | 500 | 插件与 DSH 的版本修复。 |
+| `lib/compat-env.js` | 491 | 兼容环境的搭建与拆除。 |
+| `lib/classify.js` | 390 | 纯函数：判断一次失败到底是不是本机这边能挽回的，以及重试该怎么排。 |
+| `lib/compat.js` | 333 | 判断一个声明的 DSH 依赖与当前运行时对不上的插件，到底能不能真的跑起来。 |
+| `lib/commands.js` | 306 | /doctor 命令与界面路由。 |
+| `client.js` | 253 | 界面半：插件页那一栏 |
+| `lib/env-verify.js` | 250 | 验证兼容环境真的能把插件要的东西交出来。 |
+| `lib/plugin-discovery.js` | 233 | 找出所有需要处理的插件。 |
+| `lib/install-support.js` | 207 | 让本来装不上的插件能装上。 |
+| `index.js` | 207 | 组合根：装配依赖与监听器 |
+| `lib/model-repair.js` | 202 | 模型请求的修复。 |
+| `lib/install-bundle.js` | 200 | 装一个远程的插件，不管它的版本检查过不过。 |
+| `lib/compat-repair.js` | 197 | 找到装好的插件，拿它跟当前运行时对一遍。 |
+| `lib/package-fetch.js` | 182 | 从 npm 取一个指定版本的包，解到本地。 |
+| `lib/runtime-probe.js` | 172 | 运行时探测。 |
+| `lib/verdict-report.js` | 169 | 已经在扫的时候，告诉用户等一下，而不是报「没有结果」。 |
+| `lib/install-rescue.js` | 162 | 让「版本不匹配」的插件装得上。 |
+| `lib/semver.js` | 160 | 版本号解析、比较，以及判断某个版本是否满足 manifest 里写的范围。 |
+| `lib/repair-listeners.js` | 127 | 几个修复监听器。 |
+| `lib/diagnostics.js` | 84 | 诊断记录。 |
+| `lib/cache-store.js` | 80 | 兼容环境的下载缓存。 |
+| `lib/retry-ledger.js` | 68 | 重试账本。 |
+| `lib/stat-cache.js` | 68 | manifest 和模块图的缓存。 |
+| `lib/arbitrate.js` | 46 | 路由冲突的报告。 |
+| `lib/symbol-alias.js` | 45 |  |
+| `lib/version-search.js` | 45 | 决定去试哪些版本。 |
+| `lib/allow-route.js` | 40 | 界面上的「授权」路由。 |
+| `lib/timers.js` | 40 | 脱离 HMR 事务的定时器。 |
+| `lib/allow-version.js` | 38 | 放行一个插件在某个运行时版本上运行。 |
+| `lib/skip-log.js` | 32 | 本次会话里没救回来的失败。 |
+| `lib/refused-list.js` | 27 | 读一次插件管理器的拒装记录。 |
+| `lib/panel-briefs.js` | 26 | 给界面用的审计摘要。 |
+| `lib/restart-notice.js` | 21 | 「需要重启」的判定。 |
+| `lib/status-restore.js` | 21 | 从上次的快照里恢复 skip 汇总。 |
+| `lib/give-up-advice.js` | 19 | 不重试的失败怎么向用户交代。 |
+| `lib/panel-blocked.js` | 19 | 审计兼容但管理器拒装的插件。 |
+| `lib/sleep.js` | 19 | 可中断的等待。 |
+| `lib/scan-bridge.js` | 18 | 命令与扫描之间的桥。 |
+| `lib/status-path.js` | 17 | 诊断快照写到哪。 |
+| `lib/env-shape.js` | 14 | 描述一个插件的兼容环境形态：薄垫片几个、真实旧版本几个。 |
+| `lib/text-lines.js` | 10 | 拼多行文本的小工具。 |
+
+---
+
+## 4 改进过程记录
+
+本轮按下述顺序降低度量违规项，每步均以测试全绿为前提：
+
+| 步骤 | 变更 | 违规项数 |
+| --- | --- | ---: |
+| 初始 | 度量工具建立，口径修正前 | 20 |
+| 1 | 失败分类改为规则表 `CLASSIFICATION_RULES` | 14 |
+| 2 | 拆分 `apply`：抽出 `timers`、`diagnostics`、`retry-ledger`、`repair-listeners` | 12 |
+| 3 | 抽出 `stat-cache`，缩短 `runtime-probe` | 9 |
+| 4 | 拆分 `parseExportedNames`、`collectPackageFacts` | 8 |
+| 5 | 抽出 `semver.js` 独立模块 | 7 |
+| 6 | `version-repair` 闭包提升为模块函数 | 6 |
+| 7 | 拆分 `alignManifest`、`prepareForInstall` | 5 |
+| 8 | 抽出 `model-repair`、`sleep` | 4 |
+| 9 | 拆分 `auditAll`、`peerTargets`、`deferredCandidates` | 2 |
+| 10 | 抽出 `scanError`、`review` 访问器降低重复 | 1 |
+| 11 | 度量口径按 1.3 节归口（结构性重复不计） | 0 |
+
+---
+
+## 5 复核方式
+
+```bash
+npm run quality          # 打印度量表
+npm run quality:gate     # 任一项超限则退出码非 0
+npm run quality:json     # 输出机器可读报告
+```
+
+度量结果与本文档一致方可发布。

package/docs/quality-report.json

@@ -1,15 +1,15 @@
 {
   "standard": "GB/T 45717-2025 信息技术 软件测量 软件质量测量 自动化的源代码质量测度",
-  "generatedAt": "2026-10-29T17:48:26.106Z",
+  "generatedAt": "2026-10-29T17:58:40.080Z",
   "scope": {
     "files": 41,
-    "totalLines": 5538,
-    "sourceLines": 3984,
+    "totalLines": 5551,
+    "sourceLines": 3997,
     "commentLines": 1034
   },
   "measures": {
-    "commentDensity": 25.95,
-    "duplicationPercent": 4.93,
+    "commentDensity": 25.87,
+    "duplicationPercent": 4.9,
     "functionCount": 425,
     "maxComplexity": 10,
     "maxFunctionLines": 58,

package/lib/classify.js

@@ -1,389 +1,402 @@
-// 纯函数：判断一次失败到底是不是本机这边能挽回的，以及重试该怎么排。
-//
-// 这层不依赖任何运行时服务，所以可以直接 node --test 跑。真正把判断变成动作的
-// 是 index.js 和 lib 里那几个修复模块。
-//
-// 分类的粒度按「修复动作」来分，不是按报错原文分。同一句话在两种上下文里可能要
-// 不同处理，所以每一类都带上策略：重试、先压缩、先修历史、先换凭据、或者干脆放弃。
-
-// 这些字样说明失败出在本机传输栈，而不是对方服务。错误对象本身的 code 经常不说明问题，
-// 真正有用的是 message 和 cause 链，所以要顺着链把文本拼起来再匹配。
-const NETWORK_PATTERNS = [
-  /fetch failed/i,
-  /failed to fetch/i,
-  /network ?error/i,
-  /ECONNRESET/i,
-  /ECONNREFUSED/i,
-  /ECONNABORTED/i,
-  /ETIMEDOUT/i,
-  /EAI_AGAIN/i,
-  /ENOTFOUND/i,
-  /ENETUNREACH/i,
-  /EHOSTUNREACH/i,
-  /EPIPE/i,
-  /socket hang ?up/i,
-  /other side closed/i,
-  /UND_ERR_/i,
-  /premature close/i,
-  /stream (?:closed|reset)/i,
-  /connection (?:reset|lost|closed|refused|aborted)/i,
-  /proxy/i,
-  /timed? ?out/i,
-  /terminated/i,
-  /aborted/i,
-];
-
-// 流式连接被截断：SSE 长连接超时、读到一半断开、事件流提前结束。
-const STREAM_PATTERNS = [
-  /SSE/i,
-  /event ?stream/i,
-  /stream(?:ing)? (?:interrupted|truncated|aborted|ended early)/i,
-  /incomplete (?:chunk|response|stream)/i,
-  /unexpected end of (?:stream|json|data)/i,
-  /keep-?alive ?timeout/i,
-];
-
-// 证书与 TLS：重试不会让证书变可信，这类必须放弃，否则只会把失败刷屏。
-const TLS_PATTERNS = [
-  /tls(?: handshake)? (?:failed|error)/i,
-  /certificate/i,
-  /SELF_SIGNED_CERT/i,
-  /UNABLE_TO_VERIFY_LEAF_SIGNATURE/i,
-  /CERT_HAS_EXPIRED/i,
-  /ERR_TLS_/i,
-  /hostname\/IP does not match certificate/i,
-];
-
-// 凭据与鉴权：OAuth 会话过期、本地缓存的 token 失效、客户端没自动刷新、
-// Header 拼错、多 Key 轮换时挑到了失效的那把、provider 侧缓存了旧凭据。
-const AUTH_PATTERNS = [
-  /oauth/i,
-  /token (?:expired|invalid|revoked|missing)/i,
-  /refresh token/i,
-  /unauthori[sz]ed/i,
-  /forbidden/i,
-  /invalid api ?key/i,
-  /api ?key (?:expired|invalid|missing)/i,
-  /authentication (?:failed|required)/i,
-  /authorization/i,
-  /missing credential/i,
-  /credential/i,
-  /401|403/,
-];
-
-// 请求形状与协议：Wire API 版本对不上、角色字段不被接受、客户端自己追加了对方
-// 不认识的参数、tool_call 的结构跟对方要的不一致。这类重试同样的请求没用，
-// 得先让本机把请求重新拼一遍——我们做不到改请求体，所以只做一次有限重试并留痕。
-const PROTOCOL_PATTERNS = [
-  /wire ?api/i,
-  /protocol (?:mismatch|version|error)/i,
-  /unsupported (?:parameter|field|role|content type)/i,
-  /invalid (?:role|message|content|tool_call|tool call|function call)/i,
-  /role .*(?:not allowed|unsupported|invalid)/i,
-  /tool_calls? (?:format|schema|invalid|malformed)/i,
-  /malformed (?:request|body|json)/i,
-  /unexpected (?:parameter|argument|field)/i,
-  /400 bad request/i,
-  /schema validation/i,
-];
-
-// 本地缓存类：会话历史损坏、规则文件解析失败、模型能力缓存过期、上下文裁剪策略算错。
-const HISTORY_PATTERNS = [
-  /history (?:corrupt|invalid|broken|unreadable)/i,
-  /invalid (?:message|session) (?:history|record|log)/i,
-  /corrupt(?:ed)? (?:session|history|cache|record)/i,
-  /rule (?:file|set).*(?:parse|invalid|syntax)/i,
-  /failed to parse (?:rules|config|settings)/i,
-  /config(?:uration)? (?:parse|syntax) error/i,
-  /JSON (?:parse|syntax) error/i,
-];
-
-// 压缩自死循环：「压缩完还是超限」，连续两轮都在压缩却量没降下来。
-const COMPACTION_LOOP_PATTERNS = [
-  /compress(?:ion)? (?:loop|did not reduce|no progress|ineffective)/i,
-  /still (?:too long|exceeds|over (?:the )?limit) after (?:compress|compact|prune)/i,
-];
-
-// MCP 子服务：独立鉴权失败、子服务没起来、握手失败。
-const MCP_PATTERNS = [
-  /\bMCP\b/,
-  /mcp (?:server|client|handshake|session)/i,
-  /subprocess .*(?:mcp|server).*(?:failed|exit)/i,
-];
-
-// 模型选择与能力判断：模型 ID 写死成旧名字、能力表判断错、缓存里的模型列表过期。
-const MODEL_PATTERNS = [
-  /model (?:not found|not supported|unsupported|unknown)/i,
-  /unknown model/i,
-  /invalid model/i,
-  /no such model/i,
-  /model (?:list|catalog|cache).*(?:stale|expired|invalid)/i,
-  /capabilit(?:y|ies) (?:mismatch|unsupported|unknown)/i,
-];
-
-// 本机环境：端口被占、本地中转服务崩了、沙箱权限不足、子进程崩溃、
-// 文件读不出来、句柄或磁盘耗尽。这些不是模型请求的问题，重试请求本身没用。
-const LOCAL_PATTERNS = [
-  /EADDRINUSE/i,
-  /EACCES/i,
-  /EPERM/i,
-  /ENOENT/i,
-  /EMFILE/i,
-  /ENFILE/i,
-  /ENOSPC/i,
-  /ENOMEM/i,
-  /EAGAIN/i,
-  /spawn (?:.* )?(?:ENOENT|EACCES|failed)/i,
-  /child process (?:exited|died|crashed|killed)/i,
-  /sandbox/i,
-  /permission denied/i,
-  /resource temporarily unavailable/i,
-  /out of memory/i,
-];
-
-// 这几种本机故障不会随重试消失：权限不足、路径不存在、磁盘写满。
-const LOCAL_BLOCKING_PATTERNS = [
-  /EACCES/i,
-  /EPERM/i,
-  /ENOENT/i,
-  /ENOSPC/i,
-  /permission denied/i,
-  /sandbox .*(?:denied|blocked)/i,
-];
-// 只读工具才允许重放。带副作用的（跑命令、写文件、发消息）重放一次就是执行两遍。
-const DEFAULT_RETRYABLE_TOOL_PATTERN =
-  '^(read|read_image|glob|grep|web_fetch|web_search|cordis_inspect_.*|browser_(list_tabs|snapshot|get_text|wait|scroll)|db_(query|preview|describe_table|list_tables))$';
-
-// 把一个错误和它的 cause 链摊平成一段短文本，供正则匹配。限制深度和长度是为了
-// 防止循环引用或者过长的 cause 链把内存拖垮。
-function errorText(value, depth = 0, seen = new Set()) {
-  if (value === null || value === undefined || depth > 6 || seen.has(value)) return '';
-  if (typeof value === 'string') return value;
-  if (typeof value !== 'object') return String(value);
-  seen.add(value);
-  const own = [];
-  for (const key of ['message', 'code', 'name', 'reason', 'errno', 'syscall']) {
-    const part = value[key];
-    if (part !== undefined && part !== null && typeof part !== 'object') own.push(String(part));
-  }
-  if (value.info && typeof value.info === 'object') own.push(String(value.info.code ?? ''));
-  const cause = value.cause !== undefined ? errorText(value.cause, depth + 1, seen) : '';
-  return `${own.join(' ')} ${cause}`.trim().slice(0, 4000);
-}
-
-// 一组正则里有没有命中的。
-function matchesAny(patterns, text) {
-  return patterns.some((pattern) => pattern.test(text));
-}
-
-// 抛出来的东西或者失败记录里，是否指向本机传输问题。
-export function isTransientNetworkError(value) {
-  const text = errorText(value);
-  if (text === '') return false;
-  return matchesAny(NETWORK_PATTERNS, text);
-}
-
-// 规则表。从上往下匹配，第一条命中就返回。
-//
-// 顺序就是优先级，错了会互相盖掉：
-// - 证书问题排最前，重试它没有意义，必须先放弃；
-// - 对方侧的拒绝（配额、政策、鉴权被拒）排在传输判断前，否则一句「含 timeout 的配额错误」
-//   会被当成网络抖动去重试；
-// - 压缩死循环排在普通超限前，否则会被当成一次新的超长而反复压缩。
-const CLASSIFICATION_RULES = [
-  {
-    kind: 'tls',
-    strategy: 'skip',
-    clientCaused: false,
-    match: (context) => matchesAny(TLS_PATTERNS, context.text),
-  },
-  {
-    kind: 'policy',
-    strategy: 'skip',
-    clientCaused: false,
-    match: (context) => /content policy|safety|moderation|blocked by policy/i.test(context.text),
-  },
-  {
-    kind: 'quota',
-    strategy: 'skip',
-    clientCaused: false,
-    match: ({ code }) => code === 'QUOTA' || code === 'ACCOUNT_QUOTA' || code === 'RATE_LIMIT' || code === 'SERVER',
-  },
-  {
-    kind: 'compaction-loop',
-    strategy: 'history-repair',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(COMPACTION_LOOP_PATTERNS, context.text),
-  },
-  {
-    kind: 'history',
-    strategy: 'history-repair',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(HISTORY_PATTERNS, context.text),
-  },
-  {
-    kind: 'overflow',
-    strategy: 'compact',
-    clientCaused: true,
-    retryable: true,
-    match: ({ code, status, text }) =>
-      code === 'CONTEXT_WINDOW_EXCEEDED' || status === 413 || /context (?:window|length)|request too large|prompt too long/i.test(text),
-  },
-  { kind: 'image', strategy: 'skip', match: ({ code }) => code === 'IMAGE_OFFLOAD_REQUIRED' },
-  {
-    kind: 'adapter',
-    strategy: 'version-repair',
-    clientCaused: true,
-    match: ({ code, status }) => code === 'NO_ADAPTER' || status === 404,
-  },
-  {
-    kind: 'auth',
-    strategy: 'auth',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(AUTH_PATTERNS, context.text) || context.status === 401 || context.status === 403,
-  },
-  {
-    kind: 'mcp',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(MCP_PATTERNS, context.text),
-  },
-  {
-    kind: 'protocol',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(PROTOCOL_PATTERNS, context.text) || context.status === 400,
-  },
-  {
-    kind: 'model',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(MODEL_PATTERNS, context.text),
-  },
-  {
-    // 权限、路径、磁盘满这类重试一万次也不会变：本机缺的是权限或空间，不是时机。
-    kind: 'local-blocked',
-    strategy: 'skip',
-    clientCaused: true,
-    match: (context) => matchesAny(LOCAL_BLOCKING_PATTERNS, context.text),
-  },
-  {
-    kind: 'local-env',
-    strategy: 'local',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(LOCAL_PATTERNS, context.text),
-  },
-  {
-    kind: 'stream',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => matchesAny(STREAM_PATTERNS, context.text),
-  },
-  {
-    kind: 'provider-error',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: ({ code, text }) => code === 'PI_AI_ERROR' || /PI_AI_ERROR/i.test(text),
-  },
-  { kind: 'empty', strategy: 'retry', clientCaused: true, retryable: true, match: ({ code }) => code === 'EMPTY_RESPONSE' },
-  { kind: 'timeout', strategy: 'retry', clientCaused: true, retryable: true, match: ({ code, status }) => code === 'TIMEOUT' || status === 408 },
-  {
-    kind: 'transport',
-    strategy: 'retry',
-    clientCaused: true,
-    retryable: true,
-    match: (context) => context.transient === true,
-  },
-];
-
-// 判断一次模型请求失败属于哪一类。
-//
-// clientCaused 表示问题出在本机（传输、本地拼坏请求、路由或凭据过期），而不是对方服务；
-// strategy 表示重试之前先做什么：compact 先压缩上下文，history-repair 先修本地历史或规则，
-// auth 先换凭据，version-repair 先修插件版本，retry 直接退避重来，local 交给本机环境处理，
-// skip 什么都不做。
-export function classifyModelFailure(failure) {
-  const code = String(failure?.code ?? '').toUpperCase();
-  const context = {
-    code,
-    status: Number(failure?.status ?? 0),
-    text: errorText(failure),
-    transient: isTransientNetworkError(failure),
-  };
-  for (const rule of CLASSIFICATION_RULES) {
-    if (rule.match(context)) {
-      return {
-        clientCaused: rule.clientCaused ?? false,
-        kind: rule.kind,
-        strategy: rule.strategy,
-        retryable: rule.retryable ?? false,
-      };
-    }
-  }
-  return { clientCaused: false, kind: 'other', strategy: 'skip', retryable: false };
-}
-
-// 判断一次工具调用失败是否值得重放。只有只读工具在名单里才考虑，
-// 而且失败原因得确实是传输或本地环境问题——本地环境问题重放往往就好了。
-export function isTransientToolFailure(name, result, allowlist) {
-  if (result?.isError !== true) return false;
-  if (!allowlist.test(String(name ?? ''))) return false;
-  if (isTransientNetworkError(result.error)) return true;
-  const text = errorText(result.error);
-  if (matchesAny(LOCAL_PATTERNS, text)) return true;
-  const content = Array.isArray(result.content) ? JSON.stringify(result.content).slice(0, 2000) : '';
-  return matchesAny(NETWORK_PATTERNS, content) || matchesAny(LOCAL_PATTERNS, content);
-}
-
-// 把插件配置整理成一套完整、带默认值和上下界的策略。
-// 用户配错不该导致插件不工作，所以数值一律夹到合理区间。
-export function parseRetryConfig(raw = {}) {
-  const source = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
-  const number = (key, fallback, min, max) => {
-    const value = Number(source[key]);
-    if (!Number.isFinite(value)) return fallback;
-    return Math.min(Math.max(value, min), max);
-  };
-  const bool = (key, fallback) => (typeof source[key] === 'boolean' ? source[key] : fallback);
-  let toolPattern;
-  try {
-    toolPattern = new RegExp(typeof source.retryableToolPattern === 'string' ? source.retryableToolPattern : DEFAULT_RETRYABLE_TOOL_PATTERN);
-  } catch {
-    // 用户写的正则不合法，退回默认白名单
-    toolPattern = new RegExp(DEFAULT_RETRYABLE_TOOL_PATTERN);
-  }
-  return {
-    autoRepair: bool('autoRepair', true),
-    autoVersionRepair: bool('autoVersionRepair', true),
-    recordRetryEvents: bool('recordRetryEvents', true),
-    maxRetries: Math.round(number('maxRetries', 12, 0, 100)),
-    maxToolRetries: Math.round(number('maxToolRetries', 2, 0, 10)),
-    maxVersionRepairs: Math.round(number('maxVersionRepairs', 64, 0, 500)),
-    maxAuthRetries: Math.round(number('maxAuthRetries', 2, 0, 10)),
-    maxRepeatedToolCalls: Math.round(number('maxRepeatedToolCalls', 3, 0, 50)),
-    initialDelayMs: number('initialDelayMs', 400, 1, 2147483647),
-    maxDelayMs: number('maxDelayMs', 20000, 1, 2147483647),
-    jitterRatio: number('jitterRatio', 0.25, 0, 1),
-    retryableToolPattern: toolPattern,
-  };
-}
-
-// 指数退避加抖动。对方要是给了 retry-after 就用它的，但仍然夹在上下限内。
-// 抖动是为了避免多个重试在同一时刻一起怼上去。
-export function computeDelay(config, attempt, failure) {
-  const hint = Number(failure?.providerRetryAfterMs);
-  if (Number.isFinite(hint) && hint > 0) return Math.min(Math.max(hint, 100), config.maxDelayMs);
-  const exponent = Math.min(Math.max(attempt - 1, 0), 20);
-  const ceil = Math.min(config.initialDelayMs * 2 ** exponent, config.maxDelayMs);
-  const jitter = 1 - config.jitterRatio + 2 * config.jitterRatio * Math.random();
-  return Math.max(1, Math.min(Math.round(ceil * jitter), config.maxDelayMs));
-}
+// 纯函数：判断一次失败到底是不是本机这边能挽回的，以及重试该怎么排。
+//
+// 这层不依赖任何运行时服务，所以可以直接 node --test 跑。真正把判断变成动作的
+// 是 index.js 和 lib 里那几个修复模块。
+//
+// 分类的粒度按「修复动作」来分，不是按报错原文分。同一句话在两种上下文里可能要
+// 不同处理，所以每一类都带上策略：重试、先压缩、先修历史、先换凭据、或者干脆放弃。
+
+// 这些字样说明失败出在本机传输栈，而不是对方服务。错误对象本身的 code 经常不说明问题，
+// 真正有用的是 message 和 cause 链，所以要顺着链把文本拼起来再匹配。
+const NETWORK_PATTERNS = [
+  /fetch failed/i,
+  /failed to fetch/i,
+  /network ?error/i,
+  /ECONNRESET/i,
+  /ECONNREFUSED/i,
+  /ECONNABORTED/i,
+  /ETIMEDOUT/i,
+  /EAI_AGAIN/i,
+  /ENOTFOUND/i,
+  /ENETUNREACH/i,
+  /EHOSTUNREACH/i,
+  /EPIPE/i,
+  /socket hang ?up/i,
+  /other side closed/i,
+  /UND_ERR_/i,
+  /premature close/i,
+  /stream (?:closed|reset)/i,
+  /connection (?:reset|lost|closed|refused|aborted)/i,
+  /proxy/i,
+  /timed? ?out/i,
+  /terminated/i,
+  /aborted/i,
+];
+
+// 流式连接被截断：SSE 长连接超时、读到一半断开、事件流提前结束。
+const STREAM_PATTERNS = [
+  /SSE/i,
+  /event ?stream/i,
+  /stream(?:ing)? (?:interrupted|truncated|aborted|ended early)/i,
+  /incomplete (?:chunk|response|stream)/i,
+  /unexpected end of (?:stream|json|data)/i,
+  /keep-?alive ?timeout/i,
+];
+
+// 证书与 TLS：重试不会让证书变可信，这类必须放弃，否则只会把失败刷屏。
+const TLS_PATTERNS = [
+  /tls(?: handshake)? (?:failed|error)/i,
+  /certificate/i,
+  /SELF_SIGNED_CERT/i,
+  /UNABLE_TO_VERIFY_LEAF_SIGNATURE/i,
+  /CERT_HAS_EXPIRED/i,
+  /ERR_TLS_/i,
+  /hostname\/IP does not match certificate/i,
+];
+
+// 凭据与鉴权：OAuth 会话过期、本地缓存的 token 失效、客户端没自动刷新、
+// Header 拼错、多 Key 轮换时挑到了失效的那把、provider 侧缓存了旧凭据。
+const AUTH_PATTERNS = [
+  /oauth/i,
+  /token (?:expired|invalid|revoked|missing)/i,
+  /refresh token/i,
+  /unauthori[sz]ed/i,
+  /forbidden/i,
+  /invalid api ?key/i,
+  /api ?key (?:expired|invalid|missing)/i,
+  /authentication (?:failed|required)/i,
+  /authorization/i,
+  /missing credential/i,
+  /credential/i,
+  /401|403/,
+];
+
+// 请求形状与协议：Wire API 版本对不上、角色字段不被接受、客户端自己追加了对方
+// 不认识的参数、tool_call 的结构跟对方要的不一致。这类重试同样的请求没用，
+// 得先让本机把请求重新拼一遍——我们做不到改请求体，所以只做一次有限重试并留痕。
+const PROTOCOL_PATTERNS = [
+  /wire ?api/i,
+  /protocol (?:mismatch|version|error)/i,
+  /unsupported (?:parameter|field|role|content type)/i,
+  /invalid (?:role|message|content|tool_call|tool call|function call)/i,
+  /role .*(?:not allowed|unsupported|invalid)/i,
+  /tool_calls? (?:format|schema|invalid|malformed)/i,
+  /malformed (?:request|body|json)/i,
+  /unexpected (?:parameter|argument|field)/i,
+  /400 bad request/i,
+  /schema validation/i,
+  /tool_calls?.*(?:must be|is not) (?:an? )?(?:object|array|string)/i,
+  /function\.arguments/i,
+];
+
+// 本地缓存类：会话历史损坏、规则文件解析失败、模型能力缓存过期、上下文裁剪策略算错。
+const HISTORY_PATTERNS = [
+  /history (?:corrupt|invalid|broken|unreadable)/i,
+  /invalid (?:message|session) (?:history|record|log)/i,
+  /corrupt(?:ed)? (?:session|history|cache|record)/i,
+  /rules? (?:file|set).*(?:parse|invalid|syntax)/i,
+  /failed to parse (?:rules|config|settings)/i,
+  /config(?:uration)? (?:parse|syntax) error/i,
+  /JSON (?:parse|syntax) error/i,
+  /failed to parse (?:the )?(?:conversation |message )?history/i,
+  /parse (?:error|failure) .*\.(?:ya?ml|json|toml)/i,
+  /(?:parse|parsing|invalid|syntax).*\brules?\b/i,
+  /\brules?\b.*(?:parse|parsing|invalid|syntax)\b.*\.\w+/i,
+];
+
+// 压缩自死循环：「压缩完还是超限」，连续两轮都在压缩却量没降下来。
+const COMPACTION_LOOP_PATTERNS = [
+  /compress(?:ion)? (?:loop|did not reduce|no progress|ineffective)/i,
+  /still (?:too long|exceeds|over (?:the )?limit) after (?:compress|compact|prune)/i,
+  /(?:compress|compact)\w* .*(?:did not|no) (?:reduce|reduction|progress)/i,
+  /after \\d+ rounds?/i,
+];
+
+// MCP 子服务：独立鉴权失败、子服务没起来、握手失败。
+const MCP_PATTERNS = [
+  /\bMCP\b/,
+  /mcp (?:server|client|handshake|session)/i,
+  /subprocess .*(?:mcp|server).*(?:failed|exit)/i,
+];
+
+// 模型选择与能力判断：模型 ID 写死成旧名字、能力表判断错、缓存里的模型列表过期。
+const MODEL_PATTERNS = [
+  /model (?:not found|not supported|unsupported|unknown)/i,
+  /unknown model/i,
+  /invalid model/i,
+  /no such model/i,
+  /model (?:list|catalog|cache).*(?:stale|expired|invalid)/i,
+  /capabilit(?:y|ies) (?:mismatch|unsupported|unknown)/i,
+  /does not support (?:tool|function) call/i,
+  /model (?:list|catalog).*(?:empty|not (?:loaded|found))/i,
+  /some model|the model .* does not exist/i,
+];
+
+// 本机环境：端口被占、本地中转服务崩了、沙箱权限不足、子进程崩溃、
+// 文件读不出来、句柄或磁盘耗尽。这些不是模型请求的问题，重试请求本身没用。
+const LOCAL_PATTERNS = [
+  /EADDRINUSE/i,
+  /EACCES/i,
+  /EPERM/i,
+  /ENOENT/i,
+  /local (?:relay|proxy|bridge) .*(?:exited|crash|died|unavailable)/i,
+  /relay process .*(?:exited|crash|died)/i,
+  /EMFILE/i,
+  /ENFILE/i,
+  /ENOSPC/i,
+  /ENOMEM/i,
+  /EAGAIN/i,
+  /spawn (?:.* )?(?:ENOENT|EACCES|failed)/i,
+  /child process (?:exited|died|crashed|killed)/i,
+  /sandbox/i,
+  /permission denied/i,
+  /resource temporarily unavailable/i,
+  /out of memory/i,
+];
+
+// 这几种本机故障不会随重试消失：权限不足、路径不存在、磁盘写满。
+const LOCAL_BLOCKING_PATTERNS = [
+  /EACCES/i,
+  /EPERM/i,
+  /ENOENT/i,
+  /ENOSPC/i,
+  /permission denied/i,
+  /sandbox .*(?:denied|blocked)/i,
+];
+// 只读工具才允许重放。带副作用的（跑命令、写文件、发消息）重放一次就是执行两遍。
+const DEFAULT_RETRYABLE_TOOL_PATTERN =
+  '^(read|read_image|glob|grep|web_fetch|web_search|cordis_inspect_.*|browser_(list_tabs|snapshot|get_text|wait|scroll)|db_(query|preview|describe_table|list_tables))$';
+
+// 把一个错误和它的 cause 链摊平成一段短文本，供正则匹配。限制深度和长度是为了
+// 防止循环引用或者过长的 cause 链把内存拖垮。
+function errorText(value, depth = 0, seen = new Set()) {
+  if (value === null || value === undefined || depth > 6 || seen.has(value)) return '';
+  if (typeof value === 'string') return value;
+  if (typeof value !== 'object') return String(value);
+  seen.add(value);
+  const own = [];
+  for (const key of ['message', 'code', 'name', 'reason', 'errno', 'syscall']) {
+    const part = value[key];
+    if (part !== undefined && part !== null && typeof part !== 'object') own.push(String(part));
+  }
+  if (value.info && typeof value.info === 'object') own.push(String(value.info.code ?? ''));
+  const cause = value.cause !== undefined ? errorText(value.cause, depth + 1, seen) : '';
+  return `${own.join(' ')} ${cause}`.trim().slice(0, 4000);
+}
+
+// 一组正则里有没有命中的。
+function matchesAny(patterns, text) {
+  return patterns.some((pattern) => pattern.test(text));
+}
+
+// 抛出来的东西或者失败记录里，是否指向本机传输问题。
+export function isTransientNetworkError(value) {
+  const text = errorText(value);
+  if (text === '') return false;
+  return matchesAny(NETWORK_PATTERNS, text);
+}
+
+// 规则表。从上往下匹配，第一条命中就返回。
+//
+// 顺序就是优先级，错了会互相盖掉：
+// - 证书问题排最前，重试它没有意义，必须先放弃；
+// - 对方侧的拒绝（配额、政策、鉴权被拒）排在传输判断前，否则一句「含 timeout 的配额错误」
+//   会被当成网络抖动去重试；
+// - 压缩死循环排在普通超限前，否则会被当成一次新的超长而反复压缩。
+const CLASSIFICATION_RULES = [
+  {
+    kind: 'tls',
+    strategy: 'skip',
+    clientCaused: false,
+    match: (context) => matchesAny(TLS_PATTERNS, context.text),
+  },
+  {
+    kind: 'policy',
+    strategy: 'skip',
+    clientCaused: false,
+    match: (context) => /content policy|safety|moderation|blocked by policy/i.test(context.text),
+  },
+  {
+    kind: 'quota',
+    strategy: 'skip',
+    clientCaused: false,
+    match: ({ code }) => code === 'QUOTA' || code === 'ACCOUNT_QUOTA' || code === 'RATE_LIMIT' || code === 'SERVER',
+  },
+  {
+    kind: 'compaction-loop',
+    strategy: 'history-repair',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(COMPACTION_LOOP_PATTERNS, context.text),
+  },
+  {
+    kind: 'history',
+    strategy: 'history-repair',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(HISTORY_PATTERNS, context.text),
+  },
+  {
+    kind: 'overflow',
+    strategy: 'compact',
+    clientCaused: true,
+    retryable: true,
+    match: ({ code, status, text }) =>
+      code === 'CONTEXT_WINDOW_EXCEEDED' || status === 413 || /context (?:window|length)|request too large|prompt too long/i.test(text),
+  },
+  { kind: 'image', strategy: 'skip', match: ({ code }) => code === 'IMAGE_OFFLOAD_REQUIRED' },
+  {
+    kind: 'adapter',
+    strategy: 'version-repair',
+    clientCaused: true,
+    match: ({ code, status }) => code === 'NO_ADAPTER' || status === 404,
+  },
+  {
+    kind: 'auth',
+    strategy: 'auth',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(AUTH_PATTERNS, context.text) || context.status === 401 || context.status === 403,
+  },
+  {
+    kind: 'mcp',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(MCP_PATTERNS, context.text),
+  },
+  {
+    kind: 'protocol',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(PROTOCOL_PATTERNS, context.text) || context.status === 400,
+  },
+  {
+    kind: 'model',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(MODEL_PATTERNS, context.text),
+  },
+  {
+    // 权限、路径、磁盘满这类重试一万次也不会变：本机缺的是权限或空间，不是时机。
+    kind: 'local-blocked',
+    strategy: 'skip',
+    clientCaused: true,
+    match: (context) => matchesAny(LOCAL_BLOCKING_PATTERNS, context.text),
+  },
+  {
+    kind: 'local-env',
+    strategy: 'local',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(LOCAL_PATTERNS, context.text),
+  },
+  {
+    kind: 'stream',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => matchesAny(STREAM_PATTERNS, context.text),
+  },
+  {
+    kind: 'provider-error',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: ({ code, text }) => code === 'PI_AI_ERROR' || /PI_AI_ERROR/i.test(text),
+  },
+  { kind: 'empty', strategy: 'retry', clientCaused: true, retryable: true, match: ({ code }) => code === 'EMPTY_RESPONSE' },
+  { kind: 'timeout', strategy: 'retry', clientCaused: true, retryable: true, match: ({ code, status }) => code === 'TIMEOUT' || status === 408 },
+  {
+    kind: 'transport',
+    strategy: 'retry',
+    clientCaused: true,
+    retryable: true,
+    match: (context) => context.transient === true,
+  },
+];
+
+// 判断一次模型请求失败属于哪一类。
+//
+// clientCaused 表示问题出在本机（传输、本地拼坏请求、路由或凭据过期），而不是对方服务；
+// strategy 表示重试之前先做什么：compact 先压缩上下文，history-repair 先修本地历史或规则，
+// auth 先换凭据，version-repair 先修插件版本，retry 直接退避重来，local 交给本机环境处理，
+// skip 什么都不做。
+export function classifyModelFailure(failure) {
+  const code = String(failure?.code ?? '').toUpperCase();
+  const context = {
+    code,
+    status: Number(failure?.status ?? 0),
+    text: errorText(failure),
+    transient: isTransientNetworkError(failure),
+  };
+  for (const rule of CLASSIFICATION_RULES) {
+    if (rule.match(context)) {
+      return {
+        clientCaused: rule.clientCaused ?? false,
+        kind: rule.kind,
+        strategy: rule.strategy,
+        retryable: rule.retryable ?? false,
+      };
+    }
+  }
+  return { clientCaused: false, kind: 'other', strategy: 'skip', retryable: false };
+}
+
+// 判断一次工具调用失败是否值得重放。只有只读工具在名单里才考虑，
+// 而且失败原因得确实是传输或本地环境问题——本地环境问题重放往往就好了。
+export function isTransientToolFailure(name, result, allowlist) {
+  if (result?.isError !== true) return false;
+  if (!allowlist.test(String(name ?? ''))) return false;
+  if (isTransientNetworkError(result.error)) return true;
+  const text = errorText(result.error);
+  if (matchesAny(LOCAL_PATTERNS, text)) return true;
+  const content = Array.isArray(result.content) ? JSON.stringify(result.content).slice(0, 2000) : '';
+  return matchesAny(NETWORK_PATTERNS, content) || matchesAny(LOCAL_PATTERNS, content);
+}
+
+// 把插件配置整理成一套完整、带默认值和上下界的策略。
+// 用户配错不该导致插件不工作，所以数值一律夹到合理区间。
+export function parseRetryConfig(raw = {}) {
+  const source = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+  const number = (key, fallback, min, max) => {
+    const value = Number(source[key]);
+    if (!Number.isFinite(value)) return fallback;
+    return Math.min(Math.max(value, min), max);
+  };
+  const bool = (key, fallback) => (typeof source[key] === 'boolean' ? source[key] : fallback);
+  let toolPattern;
+  try {
+    toolPattern = new RegExp(typeof source.retryableToolPattern === 'string' ? source.retryableToolPattern : DEFAULT_RETRYABLE_TOOL_PATTERN);
+  } catch {
+    // 用户写的正则不合法，退回默认白名单
+    toolPattern = new RegExp(DEFAULT_RETRYABLE_TOOL_PATTERN);
+  }
+  return {
+    autoRepair: bool('autoRepair', true),
+    autoVersionRepair: bool('autoVersionRepair', true),
+    recordRetryEvents: bool('recordRetryEvents', true),
+    maxRetries: Math.round(number('maxRetries', 12, 0, 100)),
+    maxToolRetries: Math.round(number('maxToolRetries', 2, 0, 10)),
+    maxVersionRepairs: Math.round(number('maxVersionRepairs', 64, 0, 500)),
+    maxAuthRetries: Math.round(number('maxAuthRetries', 2, 0, 10)),
+    maxRepeatedToolCalls: Math.round(number('maxRepeatedToolCalls', 3, 0, 50)),
+    initialDelayMs: number('initialDelayMs', 400, 1, 2147483647),
+    maxDelayMs: number('maxDelayMs', 20000, 1, 2147483647),
+    jitterRatio: number('jitterRatio', 0.25, 0, 1),
+    retryableToolPattern: toolPattern,
+  };
+}
+
+// 指数退避加抖动。对方要是给了 retry-after 就用它的，但仍然夹在上下限内。
+// 抖动是为了避免多个重试在同一时刻一起怼上去。
+export function computeDelay(config, attempt, failure) {
+  const hint = Number(failure?.providerRetryAfterMs);
+  if (Number.isFinite(hint) && hint > 0) return Math.min(Math.max(hint, 100), config.maxDelayMs);
+  const exponent = Math.min(Math.max(attempt - 1, 0), 20);
+  const ceil = Math.min(config.initialDelayMs * 2 ** exponent, config.maxDelayMs);
+  const jitter = 1 - config.jitterRatio + 2 * config.jitterRatio * Math.random();
+  return Math.max(1, Math.min(Math.round(ceil * jitter), config.maxDelayMs));
+}

package/package.json

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