dsh-request-doctor 0.12.7 → 0.12.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
4
  **产品标识**:request-doctor
5
- **版本**:0.12.7
5
+ **版本**:0.12.9
6
6
 
7
7
  ---
8
8
 
@@ -1,7 +1,7 @@
1
1
  # 软件设计说明
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
- **版本**:0.12.7
4
+ **版本**:0.12.9
5
5
  **编制依据**:GB/T 8567-2006《计算机软件文档编制规范》6.2
6
6
 
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  # 软件测试报告
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
- **版本**:0.12.7
4
+ **版本**:0.12.9
5
5
  **编制依据**:GB/T 8567-2006《计算机软件文档编制规范》6.6;GB/T 8566-2007 验证与确认过程
6
6
 
7
7
  ---
@@ -62,8 +62,8 @@
62
62
  | `test/client-half.test.mjs` | 5 | 客户端半:模块身份、注入声明、apply 注册、组件能渲染 |
63
63
  | `test/diagnostics.test.mjs` | 3 | 快照可选写入:不配置不写盘、突发合并、坏路径不致命 |
64
64
  | `test/restart-notice.test.mjs` | 3 |
65
- | `test/verdict-report.test.mjs` | 24 | why 与 list:判定、理由、环境摘要、自动扫描、分组、共同缺口 | 缺导出判为需要重启;其它失败不误判;多次累积不覆盖 |
66
- | **合计** | **185** | **全部通过** |
65
+ | `test/verdict-report.test.mjs` | 29 | why 与 list:判定、理由、环境摘要、自动扫描、分组、缺口、按形态给建议 | 缺导出判为需要重启;其它失败不误判;多次累积不覆盖 |
66
+ | **合计** | **190** | **全部通过** |
67
67
 
68
68
  执行结果:
69
69
 
@@ -214,4 +214,4 @@
214
214
 
215
215
  ### 7.2 分文件执行结果
216
216
 
217
- 31 个测试文件逐个单独执行,每个都有用例且全部通过,不存在因导入失败而静默跳过的文件。用例数分布:compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13,其余按职能分散,合计 185。
217
+ 31 个测试文件逐个单独执行,每个都有用例且全部通过,不存在因导入失败而静默跳过的文件。用例数分布:compat.test.mjs 17、plugin.test.mjs 15、compat-env.test.mjs 14、classify.test.mjs 13,其余按职能分散,合计 190。
@@ -1,7 +1,7 @@
1
1
  # 软件安装部署说明
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
- **版本**:0.12.7
4
+ **版本**:0.12.9
5
5
  **编制依据**:GB/T 8567-2006《计算机软件文档编制规范》6.7
6
6
 
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  # 软件用户手册
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
- **版本**:0.12.7
4
+ **版本**:0.12.9
5
5
  **编制依据**:GB/T 8567-2006《计算机软件文档编制规范》6.5
6
6
 
7
7
  ---
@@ -208,9 +208,15 @@ dsh-hyper-tools@0.1.0:incompatible
208
208
  declares @deepseek-ai/dsh-llm ^0.1.5-rc.1
209
209
  缺符号:offloadRequestImagesWithPolicy
210
210
  环境:真实旧版本 3 个(需重启):@deepseek-ai/dsh-llm, @deepseek-ai/schemastery, @deepseek-ai/cosmokit
211
- 结论:要修得先让它要的东西能被提供;缺符号时本插件会尝试装入插件声明的旧版本。
211
+ 结论:它要的旧版本已经装好,重启 DSH 后重新扫描即可生效。
212
212
  ```
213
213
 
214
+ 结论那一行按环境形态给,三种情况不同:
215
+
216
+ - 已装入真实旧版本 → 只差重启
217
+ - 环境为空 → 下一轮扫描会尝试装入,也可直接 `/doctor install <包名>`
218
+ - 只有薄垫片且不缺符号 → 环境已按现行实现转发,仍装不上就重试
219
+
214
220
  判定为兼容但界面里装不上时,它也会告诉你该走 `/doctor install`。查不到这个插件时会列出已经审计过的插件名。
215
221
 
216
222
  想先看全貌:
@@ -240,4 +246,12 @@ dsh-hyper-tools@0.1.0:incompatible
240
246
 
241
247
  这种情况修一次能同时解开几个插件,所以值得先处理。
242
248
 
249
+ 需要处理时列表末尾会给一句能照做的事:
250
+
251
+ ```
252
+ 修复会在下一轮扫描时自动尝试;想立刻重试:/doctor install <包名>
253
+ ```
254
+
255
+ 全部兼容时不会出现这句。
256
+
243
257
  列表里只留环境提示的前半句,完整内容用 `/doctor why` 看。
@@ -1,7 +1,7 @@
1
1
  # 软件质量度量报告
2
2
 
3
3
  **产品名称**:request-doctor(请求急救员)
4
- **版本**:0.12.7
4
+ **版本**:0.12.9
5
5
  **度量标准**:GB/T 45717-2025《信息技术 软件测量 软件质量测量 自动化的源代码质量测度》
6
6
  **度量工具**:`tools/quality-measure.mjs`(本仓库自带,可复现)
7
7
 
@@ -1,20 +1,20 @@
1
1
  {
2
2
  "standard": "GB/T 45717-2025 信息技术 软件测量 软件质量测量 自动化的源代码质量测度",
3
- "generatedAt": "2026-10-29T15:45:25.564Z",
3
+ "generatedAt": "2026-10-29T15:51:31.395Z",
4
4
  "scope": {
5
5
  "files": 31,
6
- "totalLines": 5163,
7
- "sourceLines": 3743,
8
- "commentLines": 945
6
+ "totalLines": 5180,
7
+ "sourceLines": 3754,
8
+ "commentLines": 949
9
9
  },
10
10
  "measures": {
11
- "commentDensity": 25.25,
11
+ "commentDensity": 25.28,
12
12
  "duplicationPercent": 4.9,
13
- "functionCount": 392,
13
+ "functionCount": 393,
14
14
  "maxComplexity": 10,
15
15
  "maxFunctionLines": 59,
16
16
  "maxFileLines": 500,
17
- "averageComplexity": 3.85
17
+ "averageComplexity": 3.86
18
18
  },
19
19
  "limits": {
20
20
  "maxComplexity": 10,
@@ -1,6 +1,9 @@
1
1
  import { linesText } from './text-lines.js';
2
2
 
3
3
  // 已经在扫的时候,告诉用户等一下,而不是报「没有结果」。
4
+ // 有插件需要处理时给出的动作提示。诊断必须配一句能照做的事。
5
+ const NEXT_STEP = '修复会在下一轮扫描时自动尝试;想立刻重试:/doctor install <包名>';
6
+
4
7
  const BUSY_TEXT = '正在扫描,几秒后再执行 /doctor list 就能看到结果。';
5
8
 
6
9
  // 最近一轮审计的清单。没扫过就是空数组。
@@ -42,7 +45,7 @@ function reportLines(hit) {
42
45
  for (const reason of hit.reasons ?? []) lines.push(` ${reason}`);
43
46
  if ((hit.missing ?? []).length > 0) lines.push(` 缺符号:${hit.missing.join(', ')}`);
44
47
  if (hit.environment !== undefined) lines.push(` 环境:${hit.environment}`);
45
- lines.push(advice(hit.verdict));
48
+ lines.push(advice(hit));
46
49
  return lines;
47
50
  }
48
51
 
@@ -53,9 +56,20 @@ function missingText(name, audited) {
53
56
  }
54
57
 
55
58
  // 结论后面跟一句能直接照做的话。
56
- function advice(verdict) {
57
- if (verdict === 'compatible') return ' 结论:可以装。装不上就是管理器那边的检查没过,用 /doctor install 走本插件的路径。';
58
- return ' 结论:要修得先让它要的东西能被提供;缺符号时本插件会尝试装入插件声明的旧版本。';
59
+ //
60
+ // 环境形态决定下一步:旧版本已经装好的只差重启,没环境的等下一轮扫描,
61
+ // 兼容的则要去走安装路径——三种情况给同一句话等于没说。
62
+ function advice(hit) {
63
+ if (hit.verdict === 'compatible') return ' 结论:可以装。装不上就是管理器那边的检查没过,用 /doctor install 走本插件的路径。';
64
+
65
+ const environment = hit.environment ?? '';
66
+ if (environment.includes('真实旧版本')) {
67
+ return ' 结论:它要的旧版本已经装好,重启 DSH 后重新扫描即可生效。';
68
+ }
69
+ if (environment.includes('薄垫片') && (hit.missing ?? []).length === 0) {
70
+ return ' 结论:环境已按现行实现转发,若仍装不上用 /doctor install <包名> 重试。';
71
+ }
72
+ return ' 结论:下一轮扫描会尝试装入插件声明的旧版本;也可直接 /doctor install <包名> 重试。';
59
73
  }
60
74
 
61
75
  // /doctor list 的入口:没有扫描结果就先扫一轮。
@@ -85,8 +99,11 @@ export function formatList(deps) {
85
99
  if (fine.length > 0) pushGroup(lines, `可以直接用 ${fine.length} 个`, fine, width);
86
100
 
87
101
  // 几个插件被同一个符号卡住时,修一次能全解开,值得单独点出来。
88
- const gap = gapSummary(broken);
89
- if (gap !== undefined) lines.push('', `先修这个:${gap}`);
102
+ if (broken.length > 0) {
103
+ const gap = gapSummary(broken);
104
+ if (gap !== undefined) lines.push('', `先修这个:${gap}`);
105
+ lines.push('', NEXT_STEP);
106
+ }
90
107
  lines.push('', '用 /doctor why <包名> 看某个插件的完整理由。');
91
108
  return { kind: 'success', text: linesText(lines) };
92
109
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-request-doctor",
3
- "version": "0.12.7",
3
+ "version": "0.12.9",
4
4
  "description": "自动修复客户端引起的请求失败,并让版本不匹配的 DSH 插件能装上、能跑起来。",
5
5
  "keywords": [
6
6
  "dsh-plugin",