dsh-subagent-default-model 2.0.2 → 2.0.8
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 +156 -0
- package/README.en.md +36 -0
- package/README.md +36 -2
- package/lib/client.js +680 -150
- package/lib/index.js +50 -11
- package/package.json +12 -12
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,155 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.8 (2026-09-29)
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- **P0:peer 上界 `<0.2.0` 会在 DSH 0.2.0 正式版发布时把整个 bundle 摘掉**。宿主校验 peer **不用默认 semver 选项**:`@deepseek-ai/dsh-app-boot` 执行的是
|
|
8
|
+
`semver.satisfies(runtimeVersion, range, { includePrerelease: true })`。该选项**关闭 prerelease 元组规则**,于是 `<0.2.0` 的实际行为与直觉相反——它**放进** `0.2.0-rc.1`,却**拒绝**正式的 `0.2.0`。后果不是降级运行:`loadProfileDirectory()` 对不兼容 bundle 直接抛错,bundle 落入 `skippedBundles`,启动时 stderr 打印 `skipping profile bundle "dsh-subagent-default-model"`,**插件本体与设置卡片一起消失**。
|
|
9
|
+
修复:8 个 `@deepseek-ai/*` peer 统一改为 **`>=0.1.7-rc.1 <0.3.0-0`**——放行 0.1.7 线及其后的整个 0.2.x 线(prerelease 与正式版都收),并用 `-0` 后缀挡住 `0.3.0-rc.1`(否则裸 `<0.3.0` 会在 `includePrerelease` 下放它进来,把支持面悄悄扩到未经验证的一行)。
|
|
10
|
+
用上游**真实门禁函数** `evaluatePluginCompatibility` 验收:改前 `0.1.7-rc.1/rc.2/0.2.0-rc.1` 通过而 `0.2.0`/`0.2.1` 被拒(8 个 peer 全不满足);改后 `0.1.7-rc.1 … 0.2.1` 全部通过,`0.3.0-rc.1`/`0.3.0` 被拒。
|
|
11
|
+
|
|
12
|
+
- **回归护栏本身有缺陷:`peer-range.test.mjs` 以裸 semver 语义断言,因此给的是假安全感**。旧测试手写模拟了 prerelease 元组规则并**恒开**,即**恰好漏掉了宿主真实使用的 `includePrerelease` 选项**,于是它断言「`0.2.0-rc.1` 必须被拒绝」——与宿主实际行为**完全相反**,且在该断言下全绿,掩盖了上面那条 P0。
|
|
13
|
+
修复:护栏改为**调用真实 `semver` 包**(`{ includePrerelease: true }`——宿主同款选项),并显式保留两条反向断言(旧 `<0.2.0` 上界放进 `0.2.0-rc.1`、拒绝 `0.2.0`),任何人重新引入裸 `<0.2.0` 都会立刻变红(已实测:把旧区间写回去,该文件 10 项中 2 项失败)。
|
|
14
|
+
手写回退实现(`semver` 解析不到时的降级路径)同步修正,并新增与真实 semver 的**交叉验证**——该验证当场抓出回退实现自身的两个真缺陷:`^`/`~` 运算符被正则漏掉而恒判 `false`。现回退只实现声明的 `>= > < <= =` 语法(136 项对照零不一致),遇到 `^` / `~` / x-range **抛错而非静默返回 `false`**——"自信地答错"正是旧护栏的病根。
|
|
15
|
+
**关于 `semver` 的定位(一处刻意设计)**:`semver` **不是**本插件的声明依赖,它只经由 npm 的 peer 自动安装链进入依赖树(root devDep `dsh-settings` → `dsh-config-editor` → peer `dsh-app-boot` → dep `semver`)。把 CI 判定挂在未声明的传递依赖上,会在 npm 改变 peer 解析的那天连带弄坏构建,而本仓的既有约定(`dependency-integrity.test.mjs`)是测试必须自洽。因此 `semver` 只作**可选的高保真交叉验证**:在场时用它校验回退实现,缺席时打印一行 `# note:` 跳过,断言本身仍由回退实现承担——而回退实现的可信度来自它自己的语义钉子(`HOST's includePrerelease semantics` 一条,直接钉住两条反向判定,不依赖 `semver`)。两条路径都已实测:有 `semver` 时 10/10 通过;隐藏 `node_modules/semver` 后同样 10/10 通过且打印跳过说明;在**无 semver** 状态下把旧区间写回,仍有 2 项失败。
|
|
16
|
+
|
|
17
|
+
- **lockfile 与 `package.json` 漂移**:`package-lock.json` 根条目仍停在 `version: 2.0.3`(`package.json` 已 2.0.7),`@deepseek-ai/schemastery` 下限也仍是旧的 `>=3.18.4`(`package.json` 已放宽为 `>=3.18.1`)。已同步根条目的 version / dependencies / devDependencies / peerDependencies / engines,并加校验确认逐字段一致。
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- **文档补齐宿主版本契约**:根 `README`(中/英)、`plugin/README`(中/英)新增「宿主版本要求」一节,用表格说明三种上界写法在 `0.2.0-rc.1` / `0.2.0` 上的实际判定,并写明写错时宿主是「跳过整个 bundle」而非降级。`DEVELOPMENT.md` 新增「宿主版本契约(改 `peerDependencies` 前必读)」,含「想表达仅 0.1.7 线时应写 `<0.2.0-0` 而非 `<0.2.0`」这一纠正,并把裸 `<0.2.0` 列入「不要做的事」。
|
|
22
|
+
|
|
23
|
+
### Added
|
|
24
|
+
|
|
25
|
+
- **`plugin/test/settings-write-gate.test.mjs`:用真实宿主写入门做的端到端保存回归(8 项)**。此前**所有**设置类测试都驱动宿主控制器的**替身**——这正是 2.0.4–2.0.7 那串保存故障能藏住的原因:插件自己的卡片、自己的 scope、自己对写契约的理解三者相互一致,而真实的 `@deepseek-ai/dsh-settings` 门禁并不一致。新测试直接 **import 真实的 `SettingsForms`**,把插件真实的 `Config` 灌进去,覆盖历史上每一处真实故障:
|
|
26
|
+
① **2.0.4 回归**——命名空间仍出现在真实 `describe()` 目录里(`volatileForm()` 返回 `undefined` 时 `describe()` 会 `return []` 丢弃该条目,正是「宿主不为本插件提供设置存储」那句报错的成因);
|
|
27
|
+
② **2.0.5 回归**——六个卡片字段在真实描述符里**全部存在且可见**(`projectForm()` 丢弃解析为 `undefined` 的字段,被丢的字段卡片读不回、验不了,即 `notApplied:ready:writable=true`);
|
|
28
|
+
③ 真实门禁**接受卡片的单次原子六字段保存**(含曾让每次保存都失败的 `reasoningEffort`);
|
|
29
|
+
④ 保存值经真实 `describe()` **回读一致**;⑤ `unset` 数组下标**真的删除元素**(「删掉的路由又回来」的宿主语义面);⑥ 旧 revision 被拒且错误类型/机器码为 `SettingsConflictError` / `SETTINGS_CONFLICT`(2.0.5 的「重试一次」正是按这两个标识判定,换个类型就不会重试);⑦ 携带新 revision 的重试**落盘成功**。
|
|
30
|
+
夹具只替身 Service 解析的协作者(`configEditor` / `profileContext` / loader await),并**严格保留宿主的两段式模型**:`entry.options.config` 存**原始**值、`fiber.config` 存**已解析**值(volatile 字段是 `{ get() }` 引用)——把两者合并会把 `{ get() }` 交给期待纯数据的门禁,被 `cloneJsonShaped` 以「contains a function」拒绝(该失败在本轮实测中确实发生过,已修)。
|
|
31
|
+
有效性已用**变异验证**:抹掉 `volatileField()` 的标记后 8 项中 7 项失败;抹掉 `provider` 的 `.default("")` 后 ② 失败。`dsh-settings` 的 `src/` 在 `dsh-v0.1.7-rc.2` 与 `dsh-v0.2.0-rc.1` 之间**逐字节相同**,故该门禁在两个宿主上行为一致。
|
|
32
|
+
|
|
33
|
+
### Docs
|
|
34
|
+
|
|
35
|
+
- **`docs/client-inspect-hang-rootcause.md` 更新影响版本**:补记该文档的结论已对 `0.2.0-rc.1` 复核——`resolveClientQuery()` 的 `if (!resolution.ok) return { accepted: false }`(丢弃页面拒绝)与 `dsh-tool-cordis` 缺少 `timeoutMs` **两处缺陷均未修复**,故「避免 `platform: "client"`」的 workaround 继续有效;文档状态由「0.1.7-rc.2 上定位」改为「截至 0.2.0-rc.1 仍未修复」。
|
|
36
|
+
|
|
37
|
+
- **修正失效的文档引用与陈旧用例数**:`settings-install.test.mjs` 曾指向仓库中并不存在的 `docs/dsh-0.1.5-rc2-to-0.1.7-rc1-research.md`,已改为描述真实证据(`dsh-settings` 的 `describe()`);`RELEASING.md` / `DEVELOPMENT.md` 里写死的用例数(92)早已过期,改为「看 `fail 0` 且 `pass` == `tests`」——该数字已漂移四次(92 → 112 → 116 → 120 → 128),写死必然再次过期。
|
|
38
|
+
|
|
39
|
+
## 2.0.7 (2026-09-26)
|
|
40
|
+
|
|
41
|
+
### Fixed
|
|
42
|
+
|
|
43
|
+
- **真机报告:「切换出去之后还是之前的状态」——保存保持随卡片卸载丢失**。2.0.6 的「保存保持」放在组件 ref 里,用户离开 Plugins 页即卸载、保持随之死亡;回来重挂的卡片从**仍滞后的 mirror** 播种,删除的路由又回来了。
|
|
44
|
+
修复:**保持提升到 scope 层**(插件生命周期,不随卡片卸载)。scope 新增 `savedForm()/setSavedForm()/clearSavedForm()`;重挂的卡片**播种优先用保存的表单**(从 held 路由重建完整分节,含 effort 折叠规则),mirror 与保存一致前 re-seed 一律拒绝;收敛轮询改为读 scope 上的 held,**跨卸载存活**,收敛即释放。
|
|
45
|
+
测试基建同步修复一个真缺陷:测试沙箱里 bundle 在 factory 时一次性捕获 `React`,第二次挂载的 hooks 全写进首个 double 的 cells——用 Proxy 转发到当前挂载的 double 后,删除/保存类交互测试才真正驱动了被测组件。
|
|
46
|
+
|
|
47
|
+
## 2.0.6 (2026-09-26)
|
|
48
|
+
|
|
49
|
+
### Fixed
|
|
50
|
+
|
|
51
|
+
- **真机报告:「删掉一个路由,保存,删掉的那个又出现了」**。保存不再报错了(2.0.5 的滞后接受生效),但删除的路由会复活。机制已用沙箱复现钉死:写入**确实落盘**(patch 与草稿一致),但 describe mirror 在保存后仍返回旧文档,**re-seed 效应用旧值覆盖了刚保存的表单**——被删除的路由此复活。沙箱对照证明:宿主行为正常时路由不复活,复活只发生在 mirror 滞后时。
|
|
52
|
+
修复(两条互补):
|
|
53
|
+
1. **保存后设「保持」**:re-seed 效应从此只接受与刚保存的表单**一致**的 mirror 值;不一致(滞后)时拒绝用它覆盖表单,杜绝复活。
|
|
54
|
+
2. **后台收敛轮询**:滞后接受后有界地持续重读 mirror(20 次 × 500ms),一旦它与保存值一致即释放保持、恢复正常同步;始终不一致则表单保持已保存的真值(patch 即真值),并在 console 留 warn。
|
|
55
|
+
回归测试两个:mirror 永不收敛时删除不复活;mirror 有限次重读后收敛时,全程不复活且最终同步。
|
|
56
|
+
|
|
57
|
+
## 2.0.5 (2026-09-26)
|
|
58
|
+
|
|
59
|
+
### Fixed
|
|
60
|
+
|
|
61
|
+
- **真机实锤的最终根因:写入成功了,是回读校验把它误报成失败**。带着 2.0.5 的取证报错在真机复现,三条铁证拼出完整图景:
|
|
62
|
+
① `write=atomic` 且无 `:refused=` —— 原子写入**被宿主接受**;
|
|
63
|
+
② profile patch 的 mtime 正是点击保存的那一秒,内容与草稿**逐字段一致** —— **写入已落盘**;
|
|
64
|
+
③ 报错里 `rev=2`(revision 已前进)但 `got=` 仍是旧值 —— describe **mirror 在整个重试窗口内一直返回旧文档**。
|
|
65
|
+
即「已接受的写入 ⟹ 必然落盘」(`configEditor.edit()` 只有在 patch 写盘且 Loader 完成调和后才 resolve;任何失败都会抛错并让 `mutate()` 返回 `false` 走 `:refused=` 路径),而严格六字段回读等值校验把 mirror 的滞后当成了保存失败——这正是 `notApplied:ready:writable=true` 的全部真相。
|
|
66
|
+
修复:**已接受的写入 ⟹ 报告保存成功**,表单从草稿重置;回读重试保留(快速收敛时用存量真值校准),最终仍不匹配时取草稿为真值并在 console 留 warn。原有的 revision-change 重播种效应会在 mirror 追上后把显示收敛到宿主实际保存的内容。
|
|
67
|
+
|
|
68
|
+
- **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)。
|
|
69
|
+
|
|
70
|
+
### Changed
|
|
71
|
+
|
|
72
|
+
- **失败报告自带完整取证**:`notApplied` 报错附带 `scope 状态 + writable + mirror revision + 写入路径(atomic/sequential) + 逐字段差异(got/exp)`。正是这套取证让最终根因在真机上一次定位(2.0.4 及之前只有一个笼统的 scope 状态)。
|
|
73
|
+
- **设置卡常显 `[diag <build>]` 诊断行**(mirror 状态、绑定命名空间、scope 状态、revision、构建标记)。之前它只在 `!writable || status!=="ready"` 时显示——恰好把最需要它的故障窗口藏掉了。构建标记(`DSM_CLIENT_BUILD`)用于确认页面实际运行的 client bundle;宿主在启动时快照 bundle,排查期间每次修改 client.js 必须递增它。
|
|
74
|
+
|
|
75
|
+
### Testing
|
|
76
|
+
|
|
77
|
+
- 全量 **112 项通过**(+4)。新增用例都驱动**真实注册卡片 + 真实 `persistDefaultModels`**(从注入的 slot face 捕获,而非桩),对照一个忠实建模 `ConfigFormController` 语义(拒绝先 `recover()` 折入新 revision、接受即折入新值)的控制器:
|
|
78
|
+
① **栅栏拒绝被重试一次并落盘**;② 慢 reload 被回读重试等过去,不误报;③ **已接受但回读永不收敛的写入报「已保存」而非失败**(真机根因的回归守卫);④ 真正被拒的写入报错带 rev / write 路径 / `:refused=` 标记,与回读滞后可区分。
|
|
79
|
+
|
|
80
|
+
## 2.0.4 (2026-09-26)
|
|
81
|
+
|
|
82
|
+
### Fixed
|
|
83
|
+
|
|
84
|
+
- **设置卡片保存永久失败(P0):插件自带的 schemastery 缺 `.volatile()`,整段设置命名空间被宿主静默丢弃**。用户报告的现象是保存时报
|
|
85
|
+
`本机宿主未为此插件提供设置存储(notApplied:unavailable:writable=false),暂时无法保存;请确认插件已在当前 profile 中启用,然后重启 DSH。`——而该插件确实已启用、宿主也确实在服务它,重启与重装都无法改变。
|
|
86
|
+
根因链条(每一环都已用真实宿主代码验证):
|
|
87
|
+
1. `@deepseek-ai/dsh-settings` 从 Config schema 派生设置面时调用 `volatileForm()`;**没有任何字段带 volatile 标记时它返回 `undefined`,`describe()` 随即 `return []` 丢弃该条目**——插件因此根本不出现在设置命名空间目录里。
|
|
88
|
+
2. 客户端卡片的 scope 从 describe mirror 的这份目录里解析命名空间;目录里没有它,`servedNamespaceNow()` 永远返回 `null`,scope 永不绑定。
|
|
89
|
+
3. 未绑定的 scope 其快照就是字面量 `{ status: "unavailable", value: undefined, writable: false }`,于是保存走完全程后落到
|
|
90
|
+
`notApplied:unavailable:writable=false`——**这正是用户看到的那句话**。
|
|
91
|
+
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 被当作正常路径执行。
|
|
92
|
+
修复:`volatileField()` 在 `volatile()` 缺失时回退到 `extra("volatile", true)`——3.18.4 的 `volatile()` 本体就是这一句(外加一个重复标记守卫),故该回退在旧构建上语义完全一致、在新构建上仍走原路径。同时把 `@deepseek-ai/schemastery` 依赖下限由 `>=3.18.4` 放宽为 `>=3.18.1`,因为代码已不再依赖 3.18.4 专有方法。
|
|
93
|
+
证据(`SettingsForms.describe()` 与宿主写入门,均为真实宿主代码,对照 git HEAD 的修复前模块):
|
|
94
|
+
| | 命名空间是否出现在设置目录 | Save(`mutate`)结果 |
|
|
95
|
+
|---|---|---|
|
|
96
|
+
| 修复前 | **0 个(被丢弃)** | `REFUSED -> Plugin entry "dsh-subagent-default-model" has no volatile fields` |
|
|
97
|
+
| 修复后 | 1 个,字段全部可编辑 | `ACCEPTED`,且落盘分节内容正确 |
|
|
98
|
+
|
|
99
|
+
- **上一条修好后的第二层故障(同一张卡、另一条根因):`provider` / `model` / `reasoningEffort` 三个字段在「空分节」下被宿主从设置表单里静默剔除**。第一层修复后,保存报错从
|
|
100
|
+
`notApplied:unavailable:writable=false` 变成 **`notApplied:ready:writable=true`**——scope 已 ready 且可写,写入却「没生效」。
|
|
101
|
+
`@deepseek-ai/dsh-settings` 的设置面由 `projectForm()` 逐字段投影,而它会**丢弃任何解析值为 `undefined` 的字段**:
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
return field === void 0 ? [] : [[key, projectForm(child, field)]];
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
三个字符串字段当初只写了 `z.string()`、**没有 `.default(...)`**,于是空分节下解析为 `undefined`、整条被剔除。后果是卡片读到的 descriptor 里根本没有这三个键:它写进去、回读时该键不存在,于是判定不一致并抛 `notApplied:ready:writable=true`。**一个表单看不见的字段,就是它既写不了也验不了的字段。**
|
|
108
|
+
修复:三者补上 `.default("")`(空串正是本插件各处既有的「未设置 → 继承父会话路由」语义,`defaultModel()` 判的就是 `length > 0`)。
|
|
109
|
+
**作用范围已精确界定**(两种输入都实测过,不夸大):
|
|
110
|
+
| 分节状态 | 无 `.default("")` | 有 `.default("")` |
|
|
111
|
+
|---|---|---|
|
|
112
|
+
| **空分节**(首次保存、刚装好) | 缺失 **provider, model, reasoningEffort** | 六个齐全 |
|
|
113
|
+
| 已存过值的分节 | 六个齐全(该键已非 `undefined`,`projectForm` 不再剔除) | 六个齐全 |
|
|
114
|
+
也就是说:本缺陷打击的是**首次保存**(以及任何把这三个键清空的路径);已经存过值以后它不再发作——这正是它难被发现的原因。用户 14:05 那次报错发生在**已有存值**的状态下,因此主要成因见下一条(回读竞态 / 半写入),本缺陷是同一张卡上独立存在的第二个坑。
|
|
115
|
+
|
|
116
|
+
- **同一次修复:把「一次保存」从六次独立写入合并为一次原子写入,并让回读等待真正落盘**。这一条解释用户 14:05 的报错(该次写入**确实落盘了**:profile patch 的 mtime 与内容都证明六个字段都写进去了):
|
|
117
|
+
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()`),原子落盘;控制器无原子形态时回退顺序写入,但**在第一个被拒处即中断**。
|
|
118
|
+
2. **回读竞态**——`edit()` 落盘后 Loader 重建 fiber,mirror 要等这次 reload 提交才看得到新文档;旧代码在写 promise 一 resolve 就立刻读快照判定,于是把「已落盘但回读还是旧值」报成 `notApplied:ready:writable=true`。现改为经 scope 的 `refresh()` **强制重读**并在有界次数内重试,再判定。
|
|
119
|
+
|
|
120
|
+
### Testing
|
|
121
|
+
|
|
122
|
+
- 全量 **108 项通过**(原 101 项 + 7 项新增守卫)。
|
|
123
|
+
- 新增守卫(`plugin/test/settings-install.test.mjs`):① 无 `volatile()` 的旧构建上 `extra()` 回退必须**真的打上标记**(而非恒等 no-op 直接返回,那正是缺陷形态);② 有 `volatile()` 时优先走 `volatile()`;③ 两者皆无的字段原样返回,不在模块求值期炸掉;④ **回归守卫**:遍历真实 `Config` 每个字段断言 `meta.volatile === true`;⑤ **每个字段必须声明 `.default(...)`**,并逐个断言那三个空串默认值;⑥ 以空分节解析 schema、解开 volatile 引用后断言**六个键一个不少**(`projectForm` 判的就是这个)。
|
|
124
|
+
- 新增守卫(`plugin/test/client-trajectory.test.mjs`):⑦ scope 必须提供原子写入 `setMany`,且一次保存只产生**一次** `mutate`、op 为宿主要求的 path-addressed 形态;⑧ scope 必须提供 `refresh()` 强制 mirror 重读(否则「已落盘但回读仍是旧值」会被误报);⑨ 未绑定的 scope 对 `set` 回 `false`、对 `setMany` 回 **`undefined`(绝不谎报成功)**,快照如实报 `unavailable` / `writable: false`。
|
|
125
|
+
- **变异验证**(守卫必须能变红):把 `.default("")` 从 `provider` 去掉 → 2 项测试变红;把 `extra()` 回退改为死代码 → 2 项测试变红;未变异基线 0 失败。模块在每次变异后**逐字节还原**(已断言)。
|
|
126
|
+
- 修复前的 `volatile() absence degrades to an identity field` 用例断言的是**缺陷本身**,已按上述替换。
|
|
127
|
+
|
|
128
|
+
## 2.0.3 (2026-09-26)
|
|
129
|
+
|
|
130
|
+
### Fixed
|
|
131
|
+
|
|
132
|
+
- **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\...`)一并修好。
|
|
133
|
+
新增两条守卫:① 扫描 `lib/`、`scripts/`、`test/` 全部源码,禁止出现 `new URL(...).pathname` / `import.meta.url.pathname`(先剥离注释,避免守卫自身的说明文字自匹配);② 断言本守卫文件自身确实使用 `fileURLToPath`。已**变异验证**:在 `test/` 放入一个使用 `.pathname` 的文件后该守卫立刻变红。
|
|
134
|
+
- **两个开发脚本在 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/` 已采用的范式对齐,属测试脚手架未同步的遗漏。
|
|
135
|
+
- **`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`)。该脚本现已恢复完整链路输出。
|
|
136
|
+
- **`verify-mock-failover.mjs` 的成功路径解析错误**:mock 服务器对成功响应默认走 SSE 流式(DSH 默认请求流式),而脚本用 `res.json()` 解析,得到空对象,最后一条断言必然失败。已按 `content-type` 分流:`text/event-stream` 走 `data:` 帧聚合 `delta.content`,`application/json` 走 JSON 解析。
|
|
137
|
+
|
|
138
|
+
### Changed
|
|
139
|
+
|
|
140
|
+
- **`npm test` 改为不带 glob 的 `node --test`**(原为 `node --test test/*.test.mjs`)。glob 由 shell 展开:POSIX sh 会展开,Windows 的 cmd/PowerShell 会**原样传入**,于是同一命令在两个平台语义不同。改由 Node 测试运行器自行发现用例后,两平台行为一致(已验证发现结果与显式 glob 完全相同)。
|
|
141
|
+
- **`integration.mjs` / `prove.mjs` 改用 `dirname(fileURLToPath(import.meta.url))`**(原为 `import.meta.dirname`)。后者需 Node ≥ 20.11 / 21.2;本次不提升任何运行门槛。
|
|
142
|
+
- **CI 增加 `windows-latest` 与 `macos-latest` 矩阵**(原仅 `ubuntu-latest`)。单一 Linux 任务无法捕获平台路径类缺陷——`new URL(...).pathname` 与 `path.join` 在 POSIX 上一致、在 Windows 上分叉,正是本次修掉的故障类别。
|
|
143
|
+
- **README(中/英,根目录 + `plugin/`)新增「平台支持」章节**:明确 Windows / macOS / Linux 三平台受支持,给出三平台配置路径对照表,并列明已检查并持续验证的平台面(依赖树跨平台、CRLF 安全、路径解析、测试发现)。根 README 以表格给出结论,`plugin/README` 给出逐条依据。
|
|
144
|
+
- **`DEVELOPMENT.md` 新增「平台影响面」检查清单**:此后每次改动都须复盘八个面(路径解析、路径拼接、shell 依赖、测试发现、换行符、依赖树、进程/信号、大小写),并注明 CI 门禁为持续验证手段;同时勘正文档内 macOS 专属写法(`⌘Q` 补 Windows 退出方式、安装路径补 Windows 形态)。
|
|
145
|
+
|
|
146
|
+
### Testing
|
|
147
|
+
|
|
148
|
+
- 全量 **92 项通过**(原 90 项 + 2 项新增跨平台守卫);`integration.mjs` 与 `prove.mjs` 均通过。
|
|
149
|
+
- **CRLF 检出验证**:在整仓按 CRLF 重写的副本上跑全套测试,**92/92 通过**——证明按源码文本做断言的用例不依赖行尾(仓库未固定 `core.autocrlf`,Windows 检出即该形态)。
|
|
150
|
+
- **脚本恢复验证**:`simulate-retry.mjs` 输出完整五段链路(失败 → 切换 → 帧追加 → 轨迹渲染 → 对话渲染);`verify-mock-failover.mjs` 对真实 mock 服务器跑通「真实 429 → 插件切换 → 真实 200」全链路。
|
|
151
|
+
- **平台守卫变异验证**:向 `test/` 放入使用 `.pathname` 的文件 → 守卫变红并指名该文件;移除后复绿。
|
|
152
|
+
|
|
3
153
|
## 2.0.2 (2026-09-25)
|
|
4
154
|
|
|
5
155
|
### Fixed
|
|
@@ -47,6 +197,12 @@
|
|
|
47
197
|
|
|
48
198
|
### Fixed
|
|
49
199
|
|
|
200
|
+
- **会话整体拒绝加载(P0):对话流注入行仍用 v3 已废除的消息来源包装 `{ kind: "plugin", plugin: … }`**。会话格式 v4 要求每条落盘消息的 `source.kind` 是**生产者自有**标识(`user` / `tool` / `agent-message` / 插件用 `plugin:<包名>`);旧的裸 `"plugin"` 包装已在 v4 中废除。厂商迁移器**只在读取** v3 会话时改写(`rewritePluginSource`),**活插件运行时直写**旧形状会绕过迁移、直接撞上 `assertV4MessageSources` 的硬校验并抛
|
|
201
|
+
`format v4 message requires a producer-owned source kind`。
|
|
202
|
+
本插件每次注入模型通知行都带 source,因此**每一轮都触发一次**——真实会话 `session-dbff9280`(cwd `dsh-subagent-default-model`,2026-09-25 16:24)的 `titleInput` 里该报错重复了 **5 次**,整轮运行失败。
|
|
203
|
+
更严重的是失败范围:`assertV4MessageSources` 在**会话被收养(adopt)时扫描全部历史消息槽**,因此**单条坏 source 会让整份会话不可加载**(该会话已无 `session.v4.jsonl.zstd`,仅存一份 projcache 存档,损失不可逆)。
|
|
204
|
+
已把 `lib/client.js` 两处发射点改为自有的 `source: { kind: "plugin:dsh-subagent-default-model", … }`(`form` / `summary` 等附加字段不受影响)。**注意与 `98bf2a7` 的节点 kind 区分**:`source.kind` 是消息来源标识,节点 kind 是渲染分类,二者不可混改。
|
|
205
|
+
回归护栏见 `plugin/test/client-trajectory.test.mjs` 的 `assertProducerOwnedSource`(逐字模拟 `assertV4MessageSources`:拒绝 `{kind:"plugin",plugin:"x"}` / `{kind:""}` / `{}` / `undefined` / `[]`,放行 `{kind:"plugin:dsh-subagent-default-model"}`)。
|
|
50
206
|
- **宿主整体装载失败(P0):依赖树指向已被删除的 `/Applications/DSH Desktop.app`**。`plugin/node_modules/@deepseek-ai/` 下的 `schemastery` / `cordis` / `dsh-settings` 三个条目是**指向旧应用包的符号链接**;应用换成 `DSH NEXT.app` 后这些链接全部悬空,`lib/index.js` 第一行的 `import z from "@deepseek-ai/schemastery"` 直接 `ERR_MODULE_NOT_FOUND`。宿主表现为 `dsh-subagent-default-model (dsh-subagent-default-model): failed to import`,插件**一行都没跑**——而 `npm test` 仍全绿。已删除悬空链接并以 `npm install` 重建为真实目录。判据:`find node_modules -maxdepth 3 -type l ! -exec test -e {} \; -print` 必须为空。
|
|
51
207
|
- **devDependency 精确锁定致 `npm install` ERESOLVE**:`@deepseek-ai/dsh-settings` 写死 `0.1.7-rc.1`,而它自身 peer 依赖 `@deepseek-ai/dsh-brand@0.1.7-rc.1`,该包只发布了 `0.1.7-rc.2`,于是干净安装直接失败。这正是本仓 CHANGELOG **1.2.2 已经记过的那条教训**(「此处必须用范围而非精确锁定」)——被 0.1.7 适配时的版本推进重新踩了一次。已改为 `^0.1.7-rc.1`。
|
|
52
208
|
- **旧 `settings.yaml` 配置不会随 0.1.7 迁移过来**: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`,`profile/cordis.patch.yml` 里始终没有本插件的 `config:`。**本机实测命中**:旧值仍在 `.imported` 文件中,需手工搬进 profile patch。README / DEVELOPMENT.md 已改为描述 0.1.7 的真实存储位置并写明该陷阱(原文档仍在教用户编辑 `~/.dsh/settings.yaml`)。
|
package/README.en.md
CHANGED
|
@@ -80,6 +80,28 @@ Notes:
|
|
|
80
80
|
- Local dev uses a `link:` install: `dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-subagent-default-model/plugin` — `node_modules` holds a source symlink, so **restart DSH Desktop** after changing code.
|
|
81
81
|
- Production / other machines use the npm registry version (see Install above).
|
|
82
82
|
|
|
83
|
+
## Host version requirement
|
|
84
|
+
|
|
85
|
+
All eight `@deepseek-ai/*` peers are declared as **`>=0.1.7-rc.1 <0.3.0-0`**: the 0.1.7 line and the **entire 0.2.x line** (prereleases and stable releases alike) are supported; 0.3.0 and later are not declared.
|
|
86
|
+
|
|
87
|
+
To see why the range has this shape, look at how DSH **validates** it. For every `@deepseek-ai/dsh` / `dsh-*` peer, `@deepseek-ai/dsh-app-boot` runs:
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
semver.satisfies(runtimeVersion, range, { includePrerelease: true })
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`includePrerelease: true` **disables semver's prerelease-tuple rule** — a prerelease is no longer rejected for lacking a same-tuple carrier; it is compared by the ordinary ordering. Both consequences are counter-intuitive:
|
|
94
|
+
|
|
95
|
+
| Ceiling | `0.2.0-rc.1` | `0.2.0` (stable) | Note |
|
|
96
|
+
| --- | --- | --- | --- |
|
|
97
|
+
| `<0.2.0` | ✅ admitted | ❌ **rejected** | The worst split: prereleases install, and the stable release strips the bundle |
|
|
98
|
+
| `<0.3.0` | ✅ | ✅ | But also admits `0.3.0-rc.1`, beyond the verified range |
|
|
99
|
+
| **`<0.3.0-0`** | ✅ | ✅ | Recommended: all of 0.2.x, and `0.3.0-rc.1` is refused |
|
|
100
|
+
|
|
101
|
+
A wrong ceiling does not degrade gracefully: `loadProfileDirectory()` throws for an incompatible bundle, which lands in `skippedBundles` and prints `skipping profile bundle "dsh-subagent-default-model"` to stderr at startup — the plugin and its settings card both disappear.
|
|
102
|
+
|
|
103
|
+
`plugin/test/peer-range.test.mjs` is the regression guard for this contract: it calls the host's own `semver.satisfies(..., { includePrerelease: true })` and asserts each row of the table above.
|
|
104
|
+
|
|
83
105
|
## Configuration
|
|
84
106
|
|
|
85
107
|
Use the Web settings card (**Settings → Plugins → dsh-subagent-default-model**).
|
|
@@ -122,6 +144,20 @@ You can also edit the profile patch `~/.dsh/profiles/<profile>/cordis.patch.yml`
|
|
|
122
144
|
| `failoverEnabled` | boolean | `true` | Switch models by queue and strategy inside the `models` list when a subagent hits a connection failure (subagents only). |
|
|
123
145
|
| `reasoningEffort` | string | — | Optional reasoning strength for a model entry (e.g. `high`, `max`). |
|
|
124
146
|
|
|
147
|
+
## Platform support
|
|
148
|
+
|
|
149
|
+
**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.
|
|
150
|
+
|
|
151
|
+
Platform-relevant surfaces that were checked and are now continuously verified:
|
|
152
|
+
|
|
153
|
+
- **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.
|
|
154
|
+
- **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.
|
|
155
|
+
- **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.
|
|
156
|
+
- **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.
|
|
157
|
+
- **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.
|
|
158
|
+
|
|
159
|
+
CI runs the same suite on `ubuntu-latest`, `windows-latest`, and `macos-latest`, so these guarantees are continuously verified rather than asserted once.
|
|
160
|
+
|
|
125
161
|
## Subagent connection-failure failover
|
|
126
162
|
|
|
127
163
|
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
|
@@ -80,6 +80,28 @@ npm install dsh-subagent-default-model
|
|
|
80
80
|
- 本地开发用 `link:` 安装:`dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-subagent-default-model/plugin`,node_modules 里是源码软链,改代码后**重启 DSH Desktop** 生效
|
|
81
81
|
- 正式安装 / 他机安装使用 npm registry 版本(见上方 Install)
|
|
82
82
|
|
|
83
|
+
## 宿主版本要求
|
|
84
|
+
|
|
85
|
+
全部 8 个 `@deepseek-ai/*` peer 声明为 **`>=0.1.7-rc.1 <0.3.0-0`**:支持 0.1.7 线及其后的**整个 0.2.x 线**(prerelease 与正式版都放行),0.3.0 起不再声明支持。
|
|
86
|
+
|
|
87
|
+
要理解这个区间为什么长这样,得先知道 DSH **怎么校验**它。`@deepseek-ai/dsh-app-boot` 对每个 `@deepseek-ai/dsh` / `dsh-*` peer 执行:
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
semver.satisfies(runtimeVersion, range, { includePrerelease: true })
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`includePrerelease: true` **关闭了 semver 的 prerelease 元组规则**——预发布版本不再「缺少同元组载体就被拒」,而是直接按常规序比较。两个后果都是反直觉的:
|
|
94
|
+
|
|
95
|
+
| 上界写法 | `0.2.0-rc.1` | `0.2.0`(正式版) | 说明 |
|
|
96
|
+
| --- | --- | --- | --- |
|
|
97
|
+
| `<0.2.0` | ✅ 放进 | ❌ **拒绝** | 最坏组合:预发布能装,正式版一发布就把 bundle 摘掉 |
|
|
98
|
+
| `<0.3.0` | ✅ | ✅ | 但会一并放进 `0.3.0-rc.1`,超出已验证范围 |
|
|
99
|
+
| **`<0.3.0-0`** | ✅ | ✅ | 推荐:0.2.x 全放行,`0.3.0-rc.1` 也挡住 |
|
|
100
|
+
|
|
101
|
+
上界写错时宿主**不会降级运行**:`loadProfileDirectory()` 对不兼容 bundle 直接抛错,该 bundle 落入 `skippedBundles`,启动时 stderr 输出 `skipping profile bundle "dsh-subagent-default-model"`——插件本体与设置卡片**一起消失**。
|
|
102
|
+
|
|
103
|
+
`plugin/test/peer-range.test.mjs` 是这条契约的回归护栏:它调用宿主同款的 `semver.satisfies(..., { includePrerelease: true })`,并逐条断言上表的结果。
|
|
104
|
+
|
|
83
105
|
## 配置
|
|
84
106
|
|
|
85
107
|
优先用 Web 设置卡片(**设置 → 插件 → dsh-subagent-default-model**)。
|
|
@@ -114,8 +136,20 @@ npm install dsh-subagent-default-model
|
|
|
114
136
|
```
|
|
115
137
|
|
|
116
138
|
> **从 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
|
-
|
|
118
|
-
|
|
139
|
+
|
|
140
|
+
## 平台支持
|
|
141
|
+
|
|
142
|
+
**Windows / macOS / Linux 均受支持**,且不需要任何平台专用配置。本插件的运行时代码是**纯 JavaScript**:`lib/index.js`(宿主半边)与 `lib/client.js`(客户端半边)不读取文件系统、不拼接路径、不派生进程、也不判断 `process.platform`——它只消费 DSH 宿主暴露的服务与事件,因此平台差异完全由 DSH 宿主承担。
|
|
143
|
+
|
|
144
|
+
已被检查并纳入持续验证的平台相关面:
|
|
145
|
+
|
|
146
|
+
- **配置路径**:profile patch 位于用户主目录下的 `.dsh/profiles/<profile>/cordis.patch.yml`。Windows 上是 `%USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml`(通常是 `C:\Users\<你>\.dsh\...`),与 macOS/Linux 的 `~/.dsh/...` 指向同一处约定。
|
|
147
|
+
- **依赖树**:`package-lock.json` 同时锁定 Windows 三套可选原生构建(`win32-x64-msvc`、`win32-arm64-msvc`、`win32-ia32-msvc`),npm 只安装与当前平台匹配的那一个;本插件的直接依赖 `@deepseek-ai/schemastery` 是纯 JS。
|
|
148
|
+
- **换行符**:仓库未固定 `core.autocrlf`,Windows 检出可能得到 CRLF 源码。全部测试已在该形态下验证通过——解析源码的断言都基于子串而非行尾,因此 CRLF/LF 不影响结果。
|
|
149
|
+
- **路径解析**:仓库脚本统一用 `fileURLToPath` 而非 `URL.pathname`。后者在 Windows 上会得到 `/C:/...` 并被 `path.join` 折成不存在的 `\C:\...`,属于只会在 Windows 上暴露的硬故障。
|
|
150
|
+
- **测试发现**:`npm test` 直接调用 `node --test`(不带 glob),由 Node 测试运行器自行发现用例,不依赖 shell 展开——`test/*.test.mjs` 这类 glob 在 POSIX sh 下会展开、在 cmd/PowerShell 下会原样传入,行为不一致。
|
|
151
|
+
|
|
152
|
+
CI 在 `ubuntu-latest`、`windows-latest`、`macos-latest` 三个平台上同时运行同一套测试,因此上述约定有持续验证而非一次性声明。
|
|
119
153
|
|
|
120
154
|
| 字段 | 类型 | 默认值 | 说明 |
|
|
121
155
|
| --- | --- | --- | --- |
|