dsh-stm32 0.1.5 → 0.1.7

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.
Files changed (100) hide show
  1. package/README.md +2 -2
  2. package/README_EN.md +2 -2
  3. package/client/client.js +24 -24
  4. package/docs/reading-guide.md +32 -0
  5. package/lib/client.js +24 -24
  6. package/lib/commands/register.js +5 -5
  7. package/lib/data/chips.js +4 -4
  8. package/lib/data/clock-db.js +24 -24
  9. package/lib/data/clock-f1.js +2 -2
  10. package/lib/data/cmsis-sources.js +6 -6
  11. package/lib/data/db-presets.js +4 -4
  12. package/lib/data/device-facts.js +6 -6
  13. package/lib/data/family.js +16 -16
  14. package/lib/data/firmware-packages.js +10 -10
  15. package/lib/data/install-guides.js +18 -18
  16. package/lib/data/ioc-presets.js +3 -3
  17. package/lib/data/ioc-schema.js +32 -32
  18. package/lib/data/rm-topics.js +6 -6
  19. package/lib/data/search-roots.js +62 -16
  20. package/lib/data/serial-config.js +7 -7
  21. package/lib/data/stm32f1.js +1 -1
  22. package/lib/data/svd.js +7 -7
  23. package/lib/data/toolchain-config.js +3 -3
  24. package/lib/engine/assets.js +5 -5
  25. package/lib/engine/breakpoints.js +5 -5
  26. package/lib/engine/cache.js +4 -4
  27. package/lib/engine/clock-derived.js +2 -2
  28. package/lib/engine/clock-direct.js +3 -3
  29. package/lib/engine/clock-plan.js +7 -7
  30. package/lib/engine/clock-pllmn.js +6 -6
  31. package/lib/engine/cmake-sources.js +9 -9
  32. package/lib/engine/code-patch.js +5 -5
  33. package/lib/engine/cube-mx-guard.js +3 -3
  34. package/lib/engine/cube-programmer.js +4 -4
  35. package/lib/engine/cubemx-db.js +7 -7
  36. package/lib/engine/debug-session.js +12 -12
  37. package/lib/engine/debug.js +3 -3
  38. package/lib/engine/doctor.js +12 -12
  39. package/lib/engine/download.js +1 -1
  40. package/lib/engine/facts-acquire.js +3 -3
  41. package/lib/engine/fetch.js +2 -2
  42. package/lib/engine/firmware-install.js +16 -16
  43. package/lib/engine/firmware-official.js +8 -8
  44. package/lib/engine/flash.js +22 -22
  45. package/lib/engine/fs-longpath.js +1 -1
  46. package/lib/engine/gdb-mi.js +7 -7
  47. package/lib/engine/generate-script.js +2 -2
  48. package/lib/engine/generate.js +17 -17
  49. package/lib/engine/hal-chip.js +7 -7
  50. package/lib/engine/ioc-plan.js +80 -58
  51. package/lib/engine/ioc-rules.js +9 -9
  52. package/lib/engine/ioc-verify.js +34 -34
  53. package/lib/engine/msys2-install.js +50 -50
  54. package/lib/engine/probe-error.js +8 -8
  55. package/lib/engine/probe-session.js +3 -3
  56. package/lib/engine/probe.js +47 -50
  57. package/lib/engine/project-export.js +1 -1
  58. package/lib/engine/register-clock.js +5 -5
  59. package/lib/engine/register-gpio.js +3 -3
  60. package/lib/engine/register-linker.js +7 -7
  61. package/lib/engine/register-template.js +22 -22
  62. package/lib/engine/regs.js +3 -3
  63. package/lib/engine/rm-extract.js +2 -2
  64. package/lib/engine/rm-sources.js +1 -1
  65. package/lib/engine/route-plan.js +9 -9
  66. package/lib/engine/rtt.js +18 -18
  67. package/lib/engine/scaffold.js +22 -22
  68. package/lib/engine/serial.js +34 -30
  69. package/lib/engine/tar.js +1 -1
  70. package/lib/engine/text-file.js +1 -1
  71. package/lib/engine/thirdparty.js +3 -3
  72. package/lib/engine/tool-env.js +2 -2
  73. package/lib/engine/toolchain-gate.js +8 -8
  74. package/lib/engine/usercode-merge.js +2 -2
  75. package/lib/engine/vscode-config.js +2 -2
  76. package/lib/engine/web-api.js +1 -1
  77. package/lib/engine/xcube-catalog.js +1 -1
  78. package/lib/index.js +5 -5
  79. package/lib/skill/stm32-workflow.js +1 -1
  80. package/lib/tools/assets.js +9 -4
  81. package/lib/tools/build.js +0 -1
  82. package/lib/tools/cache.js +2 -2
  83. package/lib/tools/debug-session.js +5 -5
  84. package/lib/tools/doctor.js +2 -2
  85. package/lib/tools/download.js +1 -1
  86. package/lib/tools/env-install.js +3 -3
  87. package/lib/tools/firmware-install.js +5 -5
  88. package/lib/tools/flash.js +8 -8
  89. package/lib/tools/generate.js +1 -1
  90. package/lib/tools/ioc-apply.js +1 -1
  91. package/lib/tools/ioc-plan.js +18 -8
  92. package/lib/tools/ioc-verify.js +11 -11
  93. package/lib/tools/project-create.js +4 -4
  94. package/lib/tools/project-dir.js +1 -1
  95. package/lib/tools/regs.js +10 -10
  96. package/lib/tools/route-plan.js +9 -9
  97. package/lib/tools/rtt.js +9 -9
  98. package/lib/tools/serial.js +8 -8
  99. package/package.json +1 -1
  100. package/templates/scaffold/RTT.md +26 -34
@@ -1,7 +1,7 @@
1
1
  /**
2
- * L2:.ioc 的「CubeMX 会怎么读它」离线规则检查。
2
+ * L2:.ioc 的「CubeMX 读取方式」离线规则检查。
3
3
  *
4
- * 规则来源不是猜的:把 D:/app/STM32CubeMX/STM32CubeMX.exe(其实是 227 MB 的 jar)解开,
4
+ * 规则来源明确:把 D:/app/STM32CubeMX/STM32CubeMX.exe(实际为 227 MB 的 jar)解开,
5
5
  * 反汇编 com.st.microxplorer.importproject 包得到的。证据链见 docs/development-notes.md 第 35 节:
6
6
  * - ImportParameterContext 按 IP 名分发 ADC / DAC / RCC / DMA / NVIC;
7
7
  * - ImportDMAParameter 读 Dma.RequestsNb(默认 0)、按冒号切子字段、认 MEMTOMEM;
@@ -18,7 +18,7 @@ const DMA_KEY = /^Dma[.]([A-Za-z0-9_]+)[.]([0-9]+)[.]/u;
18
18
  const ADC_RANK_KEY = /^(ADC[0-9]*)[.](Rank|Channel|SamplingTime)-([0-9]+)#/u;
19
19
  /**
20
20
  * R7:<IP>.IPParameters 是「这个 IP 有哪些参数」的白名单。
21
- * 只写 <IP>.Prescaler=71 而不把它列进 IPParameters,CubeMX 会当没写(实测 TIM2 的 Prescaler/Period 就这么丢的)。
21
+ * 只写 <IP>.Prescaler=71 而未将该键列进 IPParameters 时,CubeMX 视为未写(实测 TIM2 的 Prescaler/Period 即按此方式丢失)。
22
22
  */
23
23
  function checkIpParameters(entries, report) {
24
24
  for (const [key, value] of entries) {
@@ -313,7 +313,7 @@ const IP_INSTANCE = /^(?:ADC|DAC|TIM|USART|UART|SPI|I2C|CAN|USB|SDIO|ETH|RTC|IWD
313
313
  * R15:外设参数键指向的实例不在 Mcu.IPn 里。
314
314
  *
315
315
  * 证据:CubeMX 的 ImportEngine 先按 Mcu.IPn 建「这次工程里有哪些外设实例」,再按实例名分发参数
316
- * (ImportParameterContext)。实例不存在时,挂在它下面的 USART2.BaudRate / TIM3.Prescaler 这类键
316
+ * (ImportParameterContext)。实例不存在时,归属于该实例的 USART2.BaudRate / TIM3.Prescaler 这类键
317
317
  * 没有接收方,会被静默丢掉——表现是「.ioc 里明明写了,生成出来的代码里没有」。
318
318
  *
319
319
  * 只查「首段看起来就是外设实例名」的键,RCC. / NVIC. / SH. / Dma. / Mcu. / ProjectManager. 这些
@@ -360,7 +360,7 @@ function checkModeSignalPairs(entries, report) {
360
360
  if (pin.startsWith("VP_") || pin.startsWith("SH"))
361
361
  continue;
362
362
  if (!entries.has(pin + ".Signal")) {
363
- report.warnings.push({ rule: "R12", message: pin + " 有 .Mode 却没有 .Signal(CubeMX 不会把它当外设引脚)" });
363
+ report.warnings.push({ rule: "R12", message: pin + " 有 .Mode 却没有 .Signal(CubeMX 不会将其视为外设引脚)" });
364
364
  }
365
365
  }
366
366
  }
@@ -470,7 +470,7 @@ function checkPinModes(entries, facts, db, report) {
470
470
  }
471
471
  const instance = instanceFromSignal(item.signal);
472
472
  // SYS 跳过:db 里 SYS 的 Modes.xml 列的是 TIM/TIM1… 这类时基复用,根本没有调试口的模式名,
473
- // 拿它校验 <pin>.Mode 必然误报。504 份板级 .ioc 的实测取值是 Serial_Wire(149)/Serial-Wire(44)/
473
+ // 以该名单校验 <pin>.Mode 必然误报。504 份板级 .ioc 的实测取值是 Serial_Wire(149)/Serial-Wire(44)/
474
474
  // Trace_Asynchronous_SW(33)/Serial-WireDebug(18)/JTAG_5_pins(5)/SYS_WakeUp*(20) —— 全部不在 db 名单里,
475
475
  // 而 CubeMX 自己保存时就是这么写的(F4 板级文件 4→9 段往返实测:PA13.Mode=Serial_Wire 原样保留)。
476
476
  if (instance === "SYS")
@@ -489,7 +489,7 @@ function checkPinModes(entries, facts, db, report) {
489
489
  });
490
490
  }
491
491
  }
492
- /** R17:同一根物理引脚被写了两份(PA0 与 PA0-WKUP),或同一个外设信号挂到两根脚上。 */
492
+ /** R17:同一根物理引脚被写了两份(PA0 与 PA0-WKUP),或同一个外设信号映射到两根脚上。 */
493
493
  function checkPinConflicts(entries, facts, report) {
494
494
  const byDbPin = new Map();
495
495
  const bySignal = new Map();
@@ -614,7 +614,7 @@ const EXTI_TOKENS = new Set(["GPIO_MODE_IT_RISING", "GPIO_MODE_IT_FALLING", "GPI
614
614
  * <pin>.Signal=GPXTI<line>、<pin>.GPIO_ModeDefaultEXTI、SH.GPXTI<line>.0=GPIO_EXTI<line>(+ ConfNb)、
615
615
  * NVIC.<EXTI 组>_IRQn。
616
616
  *
617
- * 真机证据(2026-11-02):链路齐全时 CubeMX 逐字保留、不补任何键;而 NVIC 那条它**从不自动补**——
617
+ * 真机证据(2026-11-02):链路齐全时 CubeMX 逐字保留、不补任何键;而 NVIC 条目**从不自动补**——
618
618
  * 缺了 EXTI 边沿照样能触发标志位,但中断服务永远进不去,.ioc 里也看不出来。
619
619
  */
620
620
  function checkExtiChains(entries, profile, report) {
@@ -645,7 +645,7 @@ function checkExtiChains(entries, profile, report) {
645
645
  if (shared === undefined) {
646
646
  report.warnings.push({
647
647
  rule: "R23",
648
- message: "缺 SH.GPXTI" + String(line) + ".0=GPIO_EXTI" + String(line) + "(共享信号块):CubeMX 靠它把 EXTI 归属还原出来",
648
+ message: "缺 SH.GPXTI" + String(line) + ".0=GPIO_EXTI" + String(line) + "(共享信号块):CubeMX 依据该键还原 EXTI 归属",
649
649
  });
650
650
  }
651
651
  // 该族没有 EXTI 向量表(Cortex-A 的 MP1/MP2)时 extiIrqName 返回空串:不写也告不了警。
@@ -1,11 +1,11 @@
1
1
  /**
2
2
  * L2:`.ioc` 的「CubeMX 到底怎么理解这份配置」诊断(oracle)。
3
3
  *
4
- * 为什么需要:CubeMX 遇到不认识的键**不报错,直接丢**。我们写对了 USART 却丢了 TIM/ADC 时,
4
+ * 设计动机:CubeMX 遇到不认识的键**不报错,直接丢弃**。本插件写对 USART 却丢失 TIM/ADC 时,
5
5
  * 生成日志里一个 ERROR 都没有,只能靠「生成完翻 main.c 看有没有 MX_xxx_Init」倒推。
6
6
  *
7
- * 这里利用 CubeMX 无头脚本的 `config save`:`config load` 之后把**它理解的工程**写回 .ioc。
8
- * 走的是文本导入(与 `stm32_generate` 同一条路),因此 save 出来的东西就是「它理解的结果」:
7
+ * 这里利用 CubeMX 无头脚本的 `config save`:`config load` 之后把**CubeMX 理解的工程**写回 .ioc。
8
+ * 采用文本导入(与 `stm32_generate` 同一条路),因此 save 输出即「CubeMX 理解的结果」:
9
9
  * 哪些外设真的激活了(`Mcu.IPn`)、引脚信号被规范化成什么、有没有补 `SH.*` 共享信号块、
10
10
  * 计划生成哪些 `MX_*_Init`(`ProjectManager.functionlistsort`)。
11
11
  *
@@ -69,11 +69,11 @@ function pinSignals(entries) {
69
69
  * RCC 的派生频率名(不带 `RCC.` 前缀):`SYSCLKFreq_VALUE`、`APB1Freq_Value`、`ADCFreqValue`、
70
70
  * `VCOOutputFreq_Value`、`VcooutputI2S` 这些。
71
71
  *
72
- * 它们不是设定,是 CubeMX 按 PLL/分频**算出来的结果**(db 里只有 Comment/Min/Max,公式在 java 里,
73
- * 我们不重算)。模板带的是上一版的旧值,改了 PLL 之后它必然重算一遍。
72
+ * 这些键并非设定,而是 CubeMX 按 PLL/分频**算出的结果**(db 中只有 Comment/Min/Max,公式在 java 里,
73
+ * 本插件不重算)。模板带的是上一版的旧值,修改 PLL 之后必然重算一遍。
74
74
  */
75
75
  export function isDerivedClockName(name) {
76
- // 注意别把 `SYSCLKFreq_VALUE` 放进来:它是「我们写进去的设定」(计划声明目标 SYSCLK),
76
+ // 注意不要把 `SYSCLKFreq_VALUE` 纳入:该键是「本插件写入的设定」(计划声明目标 SYSCLK),
77
77
  // 被 CubeMX 改成别的值就是模型错了,必须报 valueChanged 而不是归到派生重算。
78
78
  return /(?:Freq_Value|FreqValue|VcooutputI2S)$/u.test(name.trim());
79
79
  }
@@ -84,7 +84,7 @@ export function isDerivedClockKey(key) {
84
84
  }
85
85
  /**
86
86
  * 两边的值是否只差「CSV 成员顺序 / 空白」——CubeMX 维护自己的名单顺序(如 GPIOParameters、
87
- * functionlistsort)时会这样改,语义不变,不该算我们写错。
87
+ * functionlistsort)时会这样改写,语义不变,不应算作本插件写错。
88
88
  */
89
89
  export function isIocValueNormalized(before, after) {
90
90
  if (before === after)
@@ -211,7 +211,7 @@ function pinsPointingAt(before, device) {
211
211
  return pins;
212
212
  }
213
213
  /**
214
- * 把被丢/被补的键逐条过一遍真值表审计(auditIocKeys),得出「CubeMX 为什么不认它」。
214
+ * 将被丢/被补的键逐条过一遍真值表审计(auditIocKeys),得出「CubeMX 不认该键的原因」。
215
215
  *
216
216
  * 没有 db 上下文时返回 verdict 空串的条目:与其猜一个原因,不如明说没判。
217
217
  */
@@ -231,21 +231,21 @@ function explainKeys(keys, context, beforeIps) {
231
231
  let detail = finding.detail;
232
232
  if (finding.verdict === "ok") {
233
233
  // 「形状已登记、上下文也过」但键还是被丢了——必须说清这是「真机才知道」,
234
- // 不能让它看起来像「我们写对了、CubeMX 无理丢弃」。典型例子:RCC.<member> 的派生名
235
- // 由 CubeMX 自己按时钟树算(语料 847 个不同成员,跨族没法列白名单),写它基本不生效。
234
+ // 不能使结论呈现为「本插件写对了、CubeMX 无理丢弃」。典型例子:RCC.<member> 的派生名
235
+ // 由 CubeMX 按时钟树计算(语料 847 个不同成员,跨族无法列白名单),写入该键基本不生效。
236
236
  detail =
237
- "键名形状已登记(" + finding.specId + ")、上下文也没有明显问题,但它仍然被丢了:" +
237
+ "键名形状已登记(" + finding.specId + ")、上下文也没有明显问题,但该键仍然被丢弃:" +
238
238
  "这类键的生效条件只能靠真机实验确认(例如 RCC.<成员> 的派生名由 CubeMX 自己算)";
239
239
  }
240
240
  const ip = (matchIocKey(finding.key)?.params.ip ?? "").trim();
241
241
  if (finding.verdict === "inactive-instance" && ip !== "" && beforeSet.has(ip.toUpperCase())) {
242
242
  detail +=
243
- "(before 文本的 Mcu.IP<i> 里本来有它,是 CubeMX 回写时把整个外设删了:指出的引脚/模式不完整,见 hints)";
243
+ "(before 文本的 Mcu.IP<i> 里本来有该外设,是 CubeMX 回写时删除了整个外设:指出的引脚/模式不完整,见 hints)";
244
244
  }
245
245
  return { key: finding.key, verdict: finding.verdict, detail };
246
246
  });
247
247
  }
248
- /** 纯函数:把「我们写的」与「CubeMX 理解的」两份 .ioc 文本对比成诊断。 */
248
+ /** 纯函数:将「本插件写入的」与「CubeMX 理解的」两份 .ioc 文本对比为诊断。 */
249
249
  export function diffIocForVerify(beforeText, afterText, audit,
250
250
  /** 计划里写过的键(来自 <projectDir>/.dsh-stm32/plans/*.json)。null/缺省 = 不知道,按形状归类。 */
251
251
  planned,
@@ -322,7 +322,7 @@ clockTreeDerived) {
322
322
  const onlyAppended = keptPrefix.length === beforeItems.length &&
323
323
  keptPrefix.every((item, index) => item === beforeItems[index]) &&
324
324
  appended.length > 0 &&
325
- // 外设名里会出现 '+'(U0 的 CORTEX_M0+ 生成 MX_CORTEX_M0+_Init),别把它当成非法条目。
325
+ // 外设名中会出现 '+'(U0 的 CORTEX_M0+ 生成 MX_CORTEX_M0+_Init),不要将其视为非法条目。
326
326
  appended.every((item) => /^[0-9]+-MX_[A-Za-z0-9_+]+_Init-[^,]*$/u.test(item));
327
327
  if (onlyAppended) {
328
328
  autoAddedFunctions.push(...appended);
@@ -330,9 +330,9 @@ clockTreeDerived) {
330
330
  }
331
331
  }
332
332
  // RCC.IPParameters 只被 CubeMX **追加**派生频率名时不算差异:这一列是「这台 MCU 有哪些 RCC 参数」
333
- // 的登记表,我们写的是它的子集,它保存时把重算出来的频率名一并登记进去。
334
- // 判据:我们的名字**一个不少**(after ⊇ before),多出来的必须全是派生频率名,只多不少。
335
- // 顺序不参与判定——这一列是集合,CubeMX 按 ASCII 升序写,我们跟着排;
333
+ // 的登记表,本插件写入的是其子集,CubeMX 保存时把重算出的频率名一并登记进去。
334
+ // 判据:本插件的名字**一个不少**(after ⊇ before),多出来的必须全部是派生频率名,只多不少。
335
+ // 顺序不参与判定——该列是集合,CubeMX 按 ASCII 升序写,本插件跟随排列;
336
336
  // 删名/改名/插进非派生名仍然留在 changedValues 里。
337
337
  const ipParametersAdded = [];
338
338
  const ipParametersIndex = changedValues.findIndex((item) => item.key === "RCC.IPParameters");
@@ -358,8 +358,8 @@ clockTreeDerived) {
358
358
  const valueChanged = [];
359
359
  const derivedRecomputed = [];
360
360
  for (const item of changedValues) {
361
- // 派生频率键被 CubeMX 重算:计划里没写过它 → 这是它按树算出来的结果,不是我们写错;
362
- // 计划里写过它 → 两边对不上,那是我们算错了,得留在 valueChanged 里让人看见。
361
+ // 派生频率键被 CubeMX 重算:计划未写入该键 → 这是 CubeMX 按树算出的结果,不是本插件写错;
362
+ // 计划写入过该键 → 两边对不上,即本插件算错,需留在 valueChanged 中供查看。
363
363
  if (isDerived(item.key) && !(plannedKeys?.has(item.key) ?? false)) {
364
364
  derivedRecomputed.push(item);
365
365
  continue;
@@ -367,7 +367,7 @@ clockTreeDerived) {
367
367
  const bucket = isIocValueNormalized(item.before, item.after) ? valueNormalized : valueChanged;
368
368
  bucket.push(item);
369
369
  }
370
- // CubeMX 自己补出来的派生键(我们不写、它按树算)。计划里写过的仍算缺键。
370
+ // CubeMX 自行补出的派生键(本插件不写入、CubeMX 按树计算)。计划写入过的仍算缺键。
371
371
  const derivedAdded = addedKeys.filter((key) => isDerived(key) && !(plannedKeys?.has(key) ?? false));
372
372
  const keptAddedKeys = addedKeys.filter((key) => !derivedAdded.includes(key));
373
373
  const attribution = {
@@ -403,13 +403,13 @@ clockTreeDerived) {
403
403
  continue;
404
404
  if (peripheralsOf(after).includes(ip))
405
405
  continue;
406
- hints.push(key + " 被 CubeMX 删掉了:" + ip + " 不在它认的外设表里(Mcu.IPn)——" +
407
- "先启用外设(peripherals)再开它的中断,否则中断键会被静默丢弃");
406
+ hints.push(key + " 被 CubeMX 删除了:" + ip + " 不在 CubeMX 认的外设表里(Mcu.IPn)——" +
407
+ "先启用外设(peripherals)再启用该外设的中断,否则中断键会被静默丢弃");
408
408
  }
409
409
  for (const device of dropped) {
410
410
  const pins = pinsPointingAt(before, device);
411
411
  if (pins.length === 0) {
412
- hints.push(device + " 没有引脚指向它:补 <pin>.Signal=" + device + "_…(普通外设)——" +
412
+ hints.push(device + " 没有引脚指向该外设:补 <pin>.Signal=" + device + "_…(普通外设)——" +
413
413
  "CubeMX 只从引脚推导外设,光写 " + device + ".IPParameters 不够");
414
414
  continue;
415
415
  }
@@ -452,7 +452,7 @@ clockTreeDerived) {
452
452
  /**
453
453
  * 读最近一次 ioc 计划写过的键(planIocChanges 落的 <projectDir>/.dsh-stm32/plans/<id>.json)。
454
454
  *
455
- * 用途:区分「派生频率键是 CubeMX 自己重算的」和「我们算错了」。读不到就返回 null(按形状归类),
455
+ * 用途:区分「派生频率键由 CubeMX 自行重算」与「本插件算错」。读不到则返回 null(按形状归类),
456
456
  * 而不是让诊断失败——独立跑 verify 时本来就没有计划。
457
457
  */
458
458
  function readPlannedKeys(projectDir) {
@@ -509,7 +509,7 @@ function readdirSafe(dir) {
509
509
  * 给归因准备键名上下文:从 before 文本读 Mcu.Name,去本机 db 拿引脚表 / IP 实例表 / 参数清单。
510
510
  *
511
511
  * 拿不到 db 时就返回 audit=null(只报键名、不判成因),而不是让整次诊断失败:
512
- * 「CubeMX 不认这个键」这个结论不依赖 db,只有「为什么不认」依赖它。
512
+ * 「CubeMX 不认该键」这一结论不依赖 db,仅「不认的原因」依赖 db。
513
513
  */
514
514
  function buildAuditInput(beforeText, roots) {
515
515
  const entries = parseIocEntries(beforeText);
@@ -552,7 +552,7 @@ function buildAuditInput(beforeText, roots) {
552
552
  * 跑一次「load + save」诊断。
553
553
  *
554
554
  * 耗时(实测 2026-11,DB.6.0.150,Windows):**98–120 s**,不是早期记的 25–40 s——这台机器上
555
- * 光是 load 就要 ~98 s,而且保存完成之后进程有时还不退出(日志已有 `SaveConfig` 但 java 挂着)。
555
+ * 仅 load 就需 ~98 s,而且保存完成后进程有时仍不退出(日志已有 `SaveConfig` 但 java 尚未退出)。
556
556
  * 所以默认超时给 180 s(request.timeoutMs 可调),而判定「成功」只看日志里有没有
557
557
  * `SaveConfig`/`Bye bye`,不看进程有没有正常退出——反之,没这一行就绝不能报通过。
558
558
  */
@@ -605,7 +605,7 @@ export async function runIocVerify(subprocess, request) {
605
605
  });
606
606
  const log = outcome.stdout + "\n" + outcome.stderr;
607
607
  const afterText = readFileSync(snapshotPath, "utf8");
608
- // 判定成功的唯一依据是日志里走到了保存:CubeMX 卡死/崩溃/超时时快照还是我们复制进去的原文,
608
+ // 判定成功的唯一依据是日志中已完成保存:CubeMX 卡死/异常终止/超时时快照仍是本插件复制进去的原文,
609
609
  // 逐键比出来的「零 diff」是假通过(实测 F2 写错 AHB 枚举名时就是这样,>240 s 不返回)。
610
610
  const savedDone = /SaveConfig|Bye bye/iu.test(log);
611
611
  const logTail = log.trim().split(/\r?\n/u).slice(-3).join(" | ");
@@ -625,7 +625,7 @@ export async function runIocVerify(subprocess, request) {
625
625
  const auditInfo = buildAuditInput(beforeText, config.cubeMxRoots);
626
626
  const diff = diffIocForVerify(beforeText, afterText, auditInfo.audit, readPlannedKeys(projectDir), auditInfo.clockTreeDerived);
627
627
  const notes = [
628
- "CubeMX 写回的是「它理解的结果」,不是正确答案:被丢掉的外设不会自己补回来。",
628
+ "CubeMX 写回的是「CubeMX 理解的结果」,并非正确答案:被丢弃的外设不会自行补回。",
629
629
  "副本在 " + snapshotPath + "(工程里的 .ioc 没动过)。",
630
630
  "判定口径:Mcu.IPn = 真正激活的外设;functionlistsort = 计划生成的 MX_*_Init。",
631
631
  auditInfo.note,
@@ -637,8 +637,8 @@ export async function runIocVerify(subprocess, request) {
637
637
  }
638
638
  const derived = diff.attribution;
639
639
  if (derived.derivedRecomputed.length > 0 || derived.derivedAdded.length > 0 || derived.ipParametersAdded.length > 0) {
640
- notes.push("派生频率键(*Freq_Value/*FreqValue)是 CubeMX 按 PLL 与分频**算出来的**,不是我们写的设定:" +
641
- "重算 " + String(derived.derivedRecomputed.length) + " 个、它自己补 " + String(derived.derivedAdded.length) +
640
+ notes.push("派生频率键(*Freq_Value/*FreqValue)是 CubeMX 按 PLL 与分频**算出的**,不是本插件写入的设定:" +
641
+ "重算 " + String(derived.derivedRecomputed.length) + " 个、CubeMX 自行补充 " + String(derived.derivedAdded.length) +
642
642
  " 个、RCC.IPParameters 里追加 " + String(derived.ipParametersAdded.length) +
643
643
  " 个名字——都不算差异(计划里写过的派生键仍会报)。");
644
644
  }
@@ -670,18 +670,18 @@ export async function runIocVerify(subprocess, request) {
670
670
  "unknown-dma-parameter": "DMA 参数名不在白名单里",
671
671
  };
672
672
  const parts = [...counts.entries()].map(([verdict, count]) => String(count) + " 个" + (label[verdict] ?? verdict));
673
- return ";它丢掉的键里 " + parts.join("、") + "(attribution.droppedReasons 逐条给了原因)";
673
+ return ";CubeMX 丢弃的键中 " + parts.join("、") + "(attribution.droppedReasons 逐条给出原因)";
674
674
  })();
675
675
  const autoSuffix = diff.autoAddedFunctions.length === 0
676
676
  ? ""
677
- : ";它另外自己补了 " + String(diff.autoAddedFunctions.length) + " 条初始化清单(functionlistsort,不影响生成正确性)";
677
+ : ";CubeMX 另外补充了 " + String(diff.autoAddedFunctions.length) + " 条初始化清单(functionlistsort,不影响生成正确性)";
678
678
  const derivedCount = derived.derivedRecomputed.length + derived.derivedAdded.length;
679
679
  const derivedSuffix = derivedCount === 0
680
680
  ? ""
681
- : ";它按时钟树重算了 " + String(derivedCount) + " 个派生频率键(*Freq_Value,不是设定)";
681
+ : ";CubeMX 按时钟树重算了 " + String(derivedCount) + " 个派生频率键(*Freq_Value,不是设定)";
682
682
  const ipSuffix = derived.ipParametersAdded.length === 0
683
683
  ? ""
684
- : ";RCC.IPParameters 里它自己追加了 " + derived.ipParametersAdded.slice(0, 4).join("/") +
684
+ : ";RCC.IPParameters 里 CubeMX 自行追加了 " + derived.ipParametersAdded.slice(0, 4).join("/") +
685
685
  (derived.ipParametersAdded.length > 4 ? " 等 " + String(derived.ipParametersAdded.length) + " 个派生名" : "");
686
686
  return {
687
687
  ...base,