dsh-subagent-default-model 2.0.2 → 2.0.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,119 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.0.7 (2026-09-26)
4
+
5
+ ### Fixed
6
+
7
+ - **真机报告:「切换出去之后还是之前的状态」——保存保持随卡片卸载丢失**。2.0.6 的「保存保持」放在组件 ref 里,用户离开 Plugins 页即卸载、保持随之死亡;回来重挂的卡片从**仍滞后的 mirror** 播种,删除的路由又回来了。
8
+ 修复:**保持提升到 scope 层**(插件生命周期,不随卡片卸载)。scope 新增 `savedForm()/setSavedForm()/clearSavedForm()`;重挂的卡片**播种优先用保存的表单**(从 held 路由重建完整分节,含 effort 折叠规则),mirror 与保存一致前 re-seed 一律拒绝;收敛轮询改为读 scope 上的 held,**跨卸载存活**,收敛即释放。
9
+ 测试基建同步修复一个真缺陷:测试沙箱里 bundle 在 factory 时一次性捕获 `React`,第二次挂载的 hooks 全写进首个 double 的 cells——用 Proxy 转发到当前挂载的 double 后,删除/保存类交互测试才真正驱动了被测组件。
10
+
11
+ ## 2.0.6 (2026-09-26)
12
+
13
+ ### Fixed
14
+
15
+ - **真机报告:「删掉一个路由,保存,删掉的那个又出现了」**。保存不再报错了(2.0.5 的滞后接受生效),但删除的路由会复活。机制已用沙箱复现钉死:写入**确实落盘**(patch 与草稿一致),但 describe mirror 在保存后仍返回旧文档,**re-seed 效应用旧值覆盖了刚保存的表单**——被删除的路由此复活。沙箱对照证明:宿主行为正常时路由不复活,复活只发生在 mirror 滞后时。
16
+ 修复(两条互补):
17
+ 1. **保存后设「保持」**:re-seed 效应从此只接受与刚保存的表单**一致**的 mirror 值;不一致(滞后)时拒绝用它覆盖表单,杜绝复活。
18
+ 2. **后台收敛轮询**:滞后接受后有界地持续重读 mirror(20 次 × 500ms),一旦它与保存值一致即释放保持、恢复正常同步;始终不一致则表单保持已保存的真值(patch 即真值),并在 console 留 warn。
19
+ 回归测试两个:mirror 永不收敛时删除不复活;mirror 有限次重读后收敛时,全程不复活且最终同步。
20
+
21
+ ## 2.0.5 (2026-09-26)
22
+
23
+ ### Fixed
24
+
25
+ - **真机实锤的最终根因:写入成功了,是回读校验把它误报成失败**。带着 2.0.5 的取证报错在真机复现,三条铁证拼出完整图景:
26
+ ① `write=atomic` 且无 `:refused=` —— 原子写入**被宿主接受**;
27
+ ② profile patch 的 mtime 正是点击保存的那一秒,内容与草稿**逐字段一致** —— **写入已落盘**;
28
+ ③ 报错里 `rev=2`(revision 已前进)但 `got=` 仍是旧值 —— describe **mirror 在整个重试窗口内一直返回旧文档**。
29
+ 即「已接受的写入 ⟹ 必然落盘」(`configEditor.edit()` 只有在 patch 写盘且 Loader 完成调和后才 resolve;任何失败都会抛错并让 `mutate()` 返回 `false` 走 `:refused=` 路径),而严格六字段回读等值校验把 mirror 的滞后当成了保存失败——这正是 `notApplied:ready:writable=true` 的全部真相。
30
+ 修复:**已接受的写入 ⟹ 报告保存成功**,表单从草稿重置;回读重试保留(快速收敛时用存量真值校准),最终仍不匹配时取草稿为真值并在 console 留 warn。原有的 revision-change 重播种效应会在 mirror 追上后把显示收敛到宿主实际保存的内容。
31
+
32
+ - **revision 栅栏拒绝现在会重试一次**(同一次保存的另一条硬化)。用真实宿主代码复现了机制:`configEditor.edit()` 先 `reconcileProfilePatches()`(重建条目 fiber → revision 由 `entry.fiber.uid` 派生而变化)再做 revision 检查,携带旧 revision 的写入会被 `SettingsConflictError` 拒绝、`ConfigFormController.mutate()` 回 `false`。控制器在返回 `false` 前已调 `recover() → mirror.load()` 折入新鲜 revision,因此**紧接着的重试必然携带正确 revision 并落盘**;第二次仍被拒才报错。同时把一次保存从六次独立 `set()` 合并为**一次原子 `mutate(ops)`**(六个 op 一笔事务、一个 revision)。
33
+
34
+ ### Changed
35
+
36
+ - **失败报告自带完整取证**:`notApplied` 报错附带 `scope 状态 + writable + mirror revision + 写入路径(atomic/sequential) + 逐字段差异(got/exp)`。正是这套取证让最终根因在真机上一次定位(2.0.4 及之前只有一个笼统的 scope 状态)。
37
+ - **设置卡常显 `[diag <build>]` 诊断行**(mirror 状态、绑定命名空间、scope 状态、revision、构建标记)。之前它只在 `!writable || status!=="ready"` 时显示——恰好把最需要它的故障窗口藏掉了。构建标记(`DSM_CLIENT_BUILD`)用于确认页面实际运行的 client bundle;宿主在启动时快照 bundle,排查期间每次修改 client.js 必须递增它。
38
+
39
+ ### Testing
40
+
41
+ - 全量 **112 项通过**(+4)。新增用例都驱动**真实注册卡片 + 真实 `persistDefaultModels`**(从注入的 slot face 捕获,而非桩),对照一个忠实建模 `ConfigFormController` 语义(拒绝先 `recover()` 折入新 revision、接受即折入新值)的控制器:
42
+ ① **栅栏拒绝被重试一次并落盘**;② 慢 reload 被回读重试等过去,不误报;③ **已接受但回读永不收敛的写入报「已保存」而非失败**(真机根因的回归守卫);④ 真正被拒的写入报错带 rev / write 路径 / `:refused=` 标记,与回读滞后可区分。
43
+
44
+ ## 2.0.4 (2026-09-26)
45
+
46
+ ### Fixed
47
+
48
+ - **设置卡片保存永久失败(P0):插件自带的 schemastery 缺 `.volatile()`,整段设置命名空间被宿主静默丢弃**。用户报告的现象是保存时报
49
+ `本机宿主未为此插件提供设置存储(notApplied:unavailable:writable=false),暂时无法保存;请确认插件已在当前 profile 中启用,然后重启 DSH。`——而该插件确实已启用、宿主也确实在服务它,重启与重装都无法改变。
50
+ 根因链条(每一环都已用真实宿主代码验证):
51
+ 1. `@deepseek-ai/dsh-settings` 从 Config schema 派生设置面时调用 `volatileForm()`;**没有任何字段带 volatile 标记时它返回 `undefined`,`describe()` 随即 `return []` 丢弃该条目**——插件因此根本不出现在设置命名空间目录里。
52
+ 2. 客户端卡片的 scope 从 describe mirror 的这份目录里解析命名空间;目录里没有它,`servedNamespaceNow()` 永远返回 `null`,scope 永不绑定。
53
+ 3. 未绑定的 scope 其快照就是字面量 `{ status: "unavailable", value: undefined, writable: false }`,于是保存走完全程后落到
54
+ `notApplied:unavailable:writable=false`——**这正是用户看到的那句话**。
55
+ 4. 标记为何没打上:`volatileField()` 只在 `schema.volatile` 是函数时才调用它,而插件 `node_modules` 里实际装的是 **schemastery 3.18.1**,该版本尚无 `volatile()`(3.18.4 才引入)。`package.json` 声明的是 `>=3.18.4`、lockfile 也钉的是 3.18.4,**实际安装树却是 3.18.1**,于是降级分支的恒等 no-op 被当作正常路径执行。
56
+ 修复:`volatileField()` 在 `volatile()` 缺失时回退到 `extra("volatile", true)`——3.18.4 的 `volatile()` 本体就是这一句(外加一个重复标记守卫),故该回退在旧构建上语义完全一致、在新构建上仍走原路径。同时把 `@deepseek-ai/schemastery` 依赖下限由 `>=3.18.4` 放宽为 `>=3.18.1`,因为代码已不再依赖 3.18.4 专有方法。
57
+ 证据(`SettingsForms.describe()` 与宿主写入门,均为真实宿主代码,对照 git HEAD 的修复前模块):
58
+ | | 命名空间是否出现在设置目录 | Save(`mutate`)结果 |
59
+ |---|---|---|
60
+ | 修复前 | **0 个(被丢弃)** | `REFUSED -> Plugin entry "dsh-subagent-default-model" has no volatile fields` |
61
+ | 修复后 | 1 个,字段全部可编辑 | `ACCEPTED`,且落盘分节内容正确 |
62
+
63
+ - **上一条修好后的第二层故障(同一张卡、另一条根因):`provider` / `model` / `reasoningEffort` 三个字段在「空分节」下被宿主从设置表单里静默剔除**。第一层修复后,保存报错从
64
+ `notApplied:unavailable:writable=false` 变成 **`notApplied:ready:writable=true`**——scope 已 ready 且可写,写入却「没生效」。
65
+ `@deepseek-ai/dsh-settings` 的设置面由 `projectForm()` 逐字段投影,而它会**丢弃任何解析值为 `undefined` 的字段**:
66
+
67
+ ```js
68
+ return field === void 0 ? [] : [[key, projectForm(child, field)]];
69
+ ```
70
+
71
+ 三个字符串字段当初只写了 `z.string()`、**没有 `.default(...)`**,于是空分节下解析为 `undefined`、整条被剔除。后果是卡片读到的 descriptor 里根本没有这三个键:它写进去、回读时该键不存在,于是判定不一致并抛 `notApplied:ready:writable=true`。**一个表单看不见的字段,就是它既写不了也验不了的字段。**
72
+ 修复:三者补上 `.default("")`(空串正是本插件各处既有的「未设置 → 继承父会话路由」语义,`defaultModel()` 判的就是 `length > 0`)。
73
+ **作用范围已精确界定**(两种输入都实测过,不夸大):
74
+ | 分节状态 | 无 `.default("")` | 有 `.default("")` |
75
+ |---|---|---|
76
+ | **空分节**(首次保存、刚装好) | 缺失 **provider, model, reasoningEffort** | 六个齐全 |
77
+ | 已存过值的分节 | 六个齐全(该键已非 `undefined`,`projectForm` 不再剔除) | 六个齐全 |
78
+ 也就是说:本缺陷打击的是**首次保存**(以及任何把这三个键清空的路径);已经存过值以后它不再发作——这正是它难被发现的原因。用户 14:05 那次报错发生在**已有存值**的状态下,因此主要成因见下一条(回读竞态 / 半写入),本缺陷是同一张卡上独立存在的第二个坑。
79
+
80
+ - **同一次修复:把「一次保存」从六次独立写入合并为一次原子写入,并让回读等待真正落盘**。这一条解释用户 14:05 的报错(该次写入**确实落盘了**:profile patch 的 mtime 与内容都证明六个字段都写进去了):
81
+ 1. **六次独立事务**——卡片原先对六个字段各调一次 `scope.set()`,每笔各自取一次 `expectedRevision`;而 `configEditor.edit()` 会在写入后重建条目 fiber(`dsh-settings` 的 revision 正是由 `entry.fiber.uid` 派生),链中靠后的字段会被 revision 栅栏挡下、`remote.settings.mutate` 回 `ok:false`、`ConfigFormController.mutate()` 返回 **`false`**——旧代码**忽略了这个返回值**,把半写入当成成功。现优先走单次 `mutate(ops)`(服务端把全部 op 收进**一次** `write()`),原子落盘;控制器无原子形态时回退顺序写入,但**在第一个被拒处即中断**。
82
+ 2. **回读竞态**——`edit()` 落盘后 Loader 重建 fiber,mirror 要等这次 reload 提交才看得到新文档;旧代码在写 promise 一 resolve 就立刻读快照判定,于是把「已落盘但回读还是旧值」报成 `notApplied:ready:writable=true`。现改为经 scope 的 `refresh()` **强制重读**并在有界次数内重试,再判定。
83
+
84
+ ### Testing
85
+
86
+ - 全量 **108 项通过**(原 101 项 + 7 项新增守卫)。
87
+ - 新增守卫(`plugin/test/settings-install.test.mjs`):① 无 `volatile()` 的旧构建上 `extra()` 回退必须**真的打上标记**(而非恒等 no-op 直接返回,那正是缺陷形态);② 有 `volatile()` 时优先走 `volatile()`;③ 两者皆无的字段原样返回,不在模块求值期炸掉;④ **回归守卫**:遍历真实 `Config` 每个字段断言 `meta.volatile === true`;⑤ **每个字段必须声明 `.default(...)`**,并逐个断言那三个空串默认值;⑥ 以空分节解析 schema、解开 volatile 引用后断言**六个键一个不少**(`projectForm` 判的就是这个)。
88
+ - 新增守卫(`plugin/test/client-trajectory.test.mjs`):⑦ scope 必须提供原子写入 `setMany`,且一次保存只产生**一次** `mutate`、op 为宿主要求的 path-addressed 形态;⑧ scope 必须提供 `refresh()` 强制 mirror 重读(否则「已落盘但回读仍是旧值」会被误报);⑨ 未绑定的 scope 对 `set` 回 `false`、对 `setMany` 回 **`undefined`(绝不谎报成功)**,快照如实报 `unavailable` / `writable: false`。
89
+ - **变异验证**(守卫必须能变红):把 `.default("")` 从 `provider` 去掉 → 2 项测试变红;把 `extra()` 回退改为死代码 → 2 项测试变红;未变异基线 0 失败。模块在每次变异后**逐字节还原**(已断言)。
90
+ - 修复前的 `volatile() absence degrades to an identity field` 用例断言的是**缺陷本身**,已按上述替换。
91
+
92
+ ## 2.0.3 (2026-09-26)
93
+
94
+ ### Fixed
95
+
96
+ - **Windows 全平台受支持(此前存在只在 Windows 上暴露的硬故障)**:`plugin/test/dependency-integrity.test.mjs` 用 `new URL("..", import.meta.url).pathname` 推导插件根目录。Windows 上文件 URL 形如 `file:///C:/...`,其 `pathname` 为 `/C:/Users/...`,经 `path.join` 折成 `\C:\Users\...`——一个不存在的路径,于是 `readFileSync` 在任何断言执行前抛 ENOENT,**整套测试在 Windows 检出上直接死掉**。该缺陷在 macOS/Linux 上不可见(两种写法结果一致),因此只有 Windows 才会暴露。已改为 `fileURLToPath(new URL("..", import.meta.url))`;后者同时也解析 `%20` 等转义,含空格路径(如 `C:\Users\My Project\...`)一并修好。
97
+ 新增两条守卫:① 扫描 `lib/`、`scripts/`、`test/` 全部源码,禁止出现 `new URL(...).pathname` / `import.meta.url.pathname`(先剥离注释,避免守卫自身的说明文字自匹配);② 断言本守卫文件自身确实使用 `fileURLToPath`。已**变异验证**:在 `test/` 放入一个使用 `.pathname` 的文件后该守卫立刻变红。
98
+ - **两个开发脚本在 0.1.7 上启动即崩(与平台无关的既有回归)**:`scripts/simulate-retry.mjs` 与 `scripts/verify-mock-failover.mjs` 仍 `import { SettingsProvider } from "@deepseek-ai/dsh-settings"`,而该命名导出在 0.1.7 线已被删除(当前 0.1.7-rc.2 的导出只剩 `SettingsConflictError` / `SettingsForms` / `default` / `redactSecrets`)。两脚本因此抛 `SyntaxError: does not provide an export named 'SettingsProvider'`,一行断言都没跑到。已改用 0.1.7 的设置模型——把配置段**直接**传给 `apply(ctx, config)`(`root.registry.plugin(plugin, config)`),并把配置段由旧的 `{ "subagent-default-model": { … } }` 嵌套形态改为扁平形态。此改动与 2.0.0 起 `test/` 已采用的范式对齐,属测试脚手架未同步的遗漏。
99
+ - **`simulate-retry.mjs` 的客户端桩停留在 0.1.6 契约**:修好导入后随即抛 `TypeError: ctx.effect is not a function`——桩里仍在提供已删除的 `settingsScope` 与 `conversationEvents` 服务,缺少 `ctx.effect` 与 `ctx.inject(["configForms"], …)`。已按 `test/client-trajectory.test.mjs` 的现行桩重写(`configForms` 的 `describe`/`get`、`uiConversation.events.register`)。该脚本现已恢复完整链路输出。
100
+ - **`verify-mock-failover.mjs` 的成功路径解析错误**:mock 服务器对成功响应默认走 SSE 流式(DSH 默认请求流式),而脚本用 `res.json()` 解析,得到空对象,最后一条断言必然失败。已按 `content-type` 分流:`text/event-stream` 走 `data:` 帧聚合 `delta.content`,`application/json` 走 JSON 解析。
101
+
102
+ ### Changed
103
+
104
+ - **`npm test` 改为不带 glob 的 `node --test`**(原为 `node --test test/*.test.mjs`)。glob 由 shell 展开:POSIX sh 会展开,Windows 的 cmd/PowerShell 会**原样传入**,于是同一命令在两个平台语义不同。改由 Node 测试运行器自行发现用例后,两平台行为一致(已验证发现结果与显式 glob 完全相同)。
105
+ - **`integration.mjs` / `prove.mjs` 改用 `dirname(fileURLToPath(import.meta.url))`**(原为 `import.meta.dirname`)。后者需 Node ≥ 20.11 / 21.2;本次不提升任何运行门槛。
106
+ - **CI 增加 `windows-latest` 与 `macos-latest` 矩阵**(原仅 `ubuntu-latest`)。单一 Linux 任务无法捕获平台路径类缺陷——`new URL(...).pathname` 与 `path.join` 在 POSIX 上一致、在 Windows 上分叉,正是本次修掉的故障类别。
107
+ - **README(中/英,根目录 + `plugin/`)新增「平台支持」章节**:明确 Windows / macOS / Linux 三平台受支持,给出三平台配置路径对照表,并列明已检查并持续验证的平台面(依赖树跨平台、CRLF 安全、路径解析、测试发现)。根 README 以表格给出结论,`plugin/README` 给出逐条依据。
108
+ - **`DEVELOPMENT.md` 新增「平台影响面」检查清单**:此后每次改动都须复盘八个面(路径解析、路径拼接、shell 依赖、测试发现、换行符、依赖树、进程/信号、大小写),并注明 CI 门禁为持续验证手段;同时勘正文档内 macOS 专属写法(`⌘Q` 补 Windows 退出方式、安装路径补 Windows 形态)。
109
+
110
+ ### Testing
111
+
112
+ - 全量 **92 项通过**(原 90 项 + 2 项新增跨平台守卫);`integration.mjs` 与 `prove.mjs` 均通过。
113
+ - **CRLF 检出验证**:在整仓按 CRLF 重写的副本上跑全套测试,**92/92 通过**——证明按源码文本做断言的用例不依赖行尾(仓库未固定 `core.autocrlf`,Windows 检出即该形态)。
114
+ - **脚本恢复验证**:`simulate-retry.mjs` 输出完整五段链路(失败 → 切换 → 帧追加 → 轨迹渲染 → 对话渲染);`verify-mock-failover.mjs` 对真实 mock 服务器跑通「真实 429 → 插件切换 → 真实 200」全链路。
115
+ - **平台守卫变异验证**:向 `test/` 放入使用 `.pathname` 的文件 → 守卫变红并指名该文件;移除后复绿。
116
+
3
117
  ## 2.0.2 (2026-09-25)
4
118
 
5
119
  ### Fixed
package/README.en.md CHANGED
@@ -122,6 +122,20 @@ You can also edit the profile patch `~/.dsh/profiles/<profile>/cordis.patch.yml`
122
122
  | `failoverEnabled` | boolean | `true` | Switch models by queue and strategy inside the `models` list when a subagent hits a connection failure (subagents only). |
123
123
  | `reasoningEffort` | string | — | Optional reasoning strength for a model entry (e.g. `high`, `max`). |
124
124
 
125
+ ## Platform support
126
+
127
+ **Windows, macOS, and Linux are all supported**, and no platform-specific configuration is needed. The plugin's runtime code is **pure JavaScript**: `lib/index.js` (host half) and `lib/client.js` (client half) never touch the filesystem, join paths, spawn processes, or branch on `process.platform` — they only consume services and events the DSH host exposes, so platform differences are owned entirely by the host.
128
+
129
+ Platform-relevant surfaces that were checked and are now continuously verified:
130
+
131
+ - **Config path**: the profile patch lives at `.dsh/profiles/<profile>/cordis.patch.yml` under the user's home directory. On Windows that is `%USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml` (typically `C:\Users\<you>\.dsh\...`), the same convention as `~/.dsh/...` on macOS/Linux.
132
+ - **Dependency tree**: `package-lock.json` locks all three Windows optional native builds (`win32-x64-msvc`, `win32-arm64-msvc`, `win32-ia32-msvc`), and npm installs only the one matching the current platform. This plugin's direct dependency `@deepseek-ai/schemastery` is pure JS.
133
+ - **Line endings**: the repo does not pin `core.autocrlf`, so a Windows checkout may produce CRLF sources. The full suite was verified in that shape — assertions that parse source text match on substrings, never on line terminators, so CRLF vs LF does not change the result.
134
+ - **Path derivation**: repository scripts use `fileURLToPath`, never `URL.pathname`. The latter yields `/C:/...` on Windows, which `path.join` folds into the non-existent `\C:\...` — a hard failure that only ever appears on Windows.
135
+ - **Test discovery**: `npm test` invokes `node --test` with no glob, letting the Node test runner discover cases itself rather than depending on shell expansion — a glob like `test/*.test.mjs` expands under POSIX sh but is passed through literally by cmd/PowerShell.
136
+
137
+ CI runs the same suite on `ubuntu-latest`, `windows-latest`, and `macos-latest`, so these guarantees are continuously verified rather than asserted once.
138
+
125
139
  ## Subagent connection-failure failover
126
140
 
127
141
  With `failoverEnabled` on (the default), when a subagent's own loop hits a connection-class failure, the plugin automatically switches models inside the `models` list and retries, following `strategy`:
package/README.md CHANGED
@@ -114,8 +114,20 @@ npm install dsh-subagent-default-model
114
114
  ```
115
115
 
116
116
  > **从 0.1.6 及更早版本升级**:旧版把配置写在 `~/.dsh/settings.yaml` 的 `subagent-default-model` 段。0.1.7 会在启动时把该文件**一次性导入并改名**为 `settings.yaml.imported`,改名后不再回读。导入按段名直接当条目 id 用,而本插件的条目 id 是 `dsh-subagent-default-model`,因此旧段**不会被导入**(宿主日志留一条 `section subagent-default-model … was not imported into entry subagent-default-model`),旧值只留在改名后的文件里——需要手工搬到上面的 `config:` 里。
117
- strategy: round-robin # round-robin | random
118
- ```
117
+
118
+ ## 平台支持
119
+
120
+ **Windows / macOS / Linux 均受支持**,且不需要任何平台专用配置。本插件的运行时代码是**纯 JavaScript**:`lib/index.js`(宿主半边)与 `lib/client.js`(客户端半边)不读取文件系统、不拼接路径、不派生进程、也不判断 `process.platform`——它只消费 DSH 宿主暴露的服务与事件,因此平台差异完全由 DSH 宿主承担。
121
+
122
+ 已被检查并纳入持续验证的平台相关面:
123
+
124
+ - **配置路径**:profile patch 位于用户主目录下的 `.dsh/profiles/<profile>/cordis.patch.yml`。Windows 上是 `%USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml`(通常是 `C:\Users\<你>\.dsh\...`),与 macOS/Linux 的 `~/.dsh/...` 指向同一处约定。
125
+ - **依赖树**:`package-lock.json` 同时锁定 Windows 三套可选原生构建(`win32-x64-msvc`、`win32-arm64-msvc`、`win32-ia32-msvc`),npm 只安装与当前平台匹配的那一个;本插件的直接依赖 `@deepseek-ai/schemastery` 是纯 JS。
126
+ - **换行符**:仓库未固定 `core.autocrlf`,Windows 检出可能得到 CRLF 源码。全部测试已在该形态下验证通过——解析源码的断言都基于子串而非行尾,因此 CRLF/LF 不影响结果。
127
+ - **路径解析**:仓库脚本统一用 `fileURLToPath` 而非 `URL.pathname`。后者在 Windows 上会得到 `/C:/...` 并被 `path.join` 折成不存在的 `\C:\...`,属于只会在 Windows 上暴露的硬故障。
128
+ - **测试发现**:`npm test` 直接调用 `node --test`(不带 glob),由 Node 测试运行器自行发现用例,不依赖 shell 展开——`test/*.test.mjs` 这类 glob 在 POSIX sh 下会展开、在 cmd/PowerShell 下会原样传入,行为不一致。
129
+
130
+ CI 在 `ubuntu-latest`、`windows-latest`、`macos-latest` 三个平台上同时运行同一套测试,因此上述约定有持续验证而非一次性声明。
119
131
 
120
132
  | 字段 | 类型 | 默认值 | 说明 |
121
133
  | --- | --- | --- | --- |