@bokutake/dsh-connect-qoder 0.0.0-stage → 1.28.0

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.
@@ -0,0 +1,317 @@
1
+ # DSH 0.2.2-rc.3 升级跟进调研 —— dsh-connect-qoder
2
+
3
+ > 调研日期:2026-11-14
4
+ > 宿主:DSH Desktop **`0.2.2-rc.3`**(`app.asar` 内 329 个 `@deepseek-ai/dsh-*` 全部为
5
+ > `0.2.2-rc.3`,asar sha256 `c0ce89f7…e843`)
6
+ > 插件:`@dmh2002/dsh-connect-qoder` **1.25.1 → 1.25.2**(本轮**不改运行时代码**,
7
+ > 只升依赖树、重提取夹具元数据、补断言与文档)
8
+ > 上一轮:[`docs/DSH-0.2.2-RC2-FOLLOWUP.md`](DSH-0.2.2-RC2-FOLLOWUP.md)
9
+
10
+ ---
11
+
12
+ ## 零、结论摘要
13
+
14
+ **结论:不需要改运行时代码。** `0.2.2-rc.2 → 0.2.2-rc.3` 是一次**功能增量**发布
15
+ (几乎全部内容来自一个 commit:`feat(experimental): 导入 DeepSeek 官网对话导出为会话`),
16
+ 落在插件**没有触及**的面上。`typecheck` / `test` / `build` 在 rc.3 依赖树上第一次跑就全绿。
17
+
18
+ | 层 | 结论 | 所需动作 |
19
+ |---|---|---|
20
+ | `dsh-deepseek-chat-import`(新包、新 bundle 行) | 🟢 全新 experimental 包,需用户显式安装;插件不引用 | 无 |
21
+ | `dsh-client-ui-sidebar` 新增 `sidebar.session.action`(hoc) | 🟢 新槽 +「新建会话」行改成 `renderSlot` 包裹;插件用的 `sidebar.panellist`/`panellist.actions` 逐字未变 | 无 |
22
+ | `dsh-client-ui-workspace` 新增 `workspace.picker` Factory + 第三个 directory-flow 洞 | 🟢 插件既不用 workspace 也不用 directory-picker | 无 |
23
+ | `dsh-client-ui-directory-picker-{browse,native}` 改注册三处 | 🟢 宿主自家包之间的适配 | 无 |
24
+ | `dsh-session-log-export`:缺附件不再整包失败 | 🟢 插件不导出会话 | 无 |
25
+ | `dsh-client-ui-settings-general` 的 client bundle | 🟡 逐字比过:**只有版本串变了**(`0.2.2-rc.2` → `0.2.2-rc.3`)。`settings-jump.ts` 依赖的 store 座位、`aria-haspopup="dialog"` 触发器、`data-shortcut-modal` 全部逐字未变 | 无 |
26
+ | `dsh-client-ui-plugin-manager` | 🟡 `MORE_BUNDLES` / `EXPERIMENTAL_BUNDLES` 各多一条 `dsh-deepseek-chat-import`;插件不读这两张表 | 无 |
27
+ | 失败分类器夹具 | 🟢 宿主没动 `classifyPiAiError`(三段逐字相同),但**asar 换了 sha**,`source` 元数据必须重提取 | **重提取**(已做) |
28
+ | 回归:usage 解析夹具 | 🟢 逐字相同(手工核对过);`extractedAt` 仍停在 `2026-10-22`,是**夹具本身没动**,不是漏更新 | 无 |
29
+ | peer 范围覆盖 `0.2.2-rc.3` | 🟢 同一元组,仍**不需要新分支** | 补断言(已做) |
30
+ | 开发依赖树 | 🟡 仍钉在 rc.2 | **升到 rc.3**(已做) |
31
+
32
+ ---
33
+
34
+ ## 一、实测环境
35
+
36
+ 宿主 `app.asar` 内 `node_modules` 的实际版本:
37
+
38
+ | 包 | 0.2.2-rc.2 | **0.2.2-rc.3(本机)** |
39
+ |---|---|---|
40
+ | `@deepseek-ai/dsh` 及全部 `dsh-*` | 0.2.2-rc.2 | **0.2.2-rc.3**(329 个包,逐个核对) |
41
+ | `@deepseek-ai/cordis` | 4.1.0 | **4.1.0(不变)** |
42
+ | `@deepseek-ai/schemastery` | 3.19.0 | **3.19.0(不变)** |
43
+ | `@earendil-works/pi-ai` | 1.3.0 | **1.3.0(不变)** |
44
+
45
+ 也就是说:这一轮**没有换 pi-ai、没有换 cordis、没有换 schemastery** —— 与前两轮一致。
46
+
47
+ rc.3 里 `@deepseek-ai/*` 依赖共 337 个,其中 329 个是 `0.2.2-rc.3`,剩下 8 个是
48
+ **宿主一直没跟着发版**的那几个(`cordis` 4.1.0、`cordis-plugin-group/include/loader`
49
+ 1.1.0、`cordis-plugin-timer` 1.2.0、`cosmokit` 1.9.0、`node-addon-system` 0.1.2、
50
+ `schemastery` 3.19.0)。这 8 个的版本号在 rc.2 里逐字相同。
51
+
52
+ ### 1.1 逐包 diff 的方法与结果
53
+
54
+ 把 asar 里钉在 `0.2.2-rc.3` 的 **329 个** `@deepseek-ai/*` 依赖,逐个下载 rc.2 与 rc.3
55
+ 两个 tarball、解开、做 `diff -rq`,并剔除 `package.json` 与 `*.map`(前者必然只差版本号
56
+ 与内部 peer 版本,后者是构建噪声)。结果:
57
+
58
+ - **327 个真比过了**:其中 **17 个有实质内容差异**,**310 个**剔除噪声后逐字节相同;
59
+ - **2 个比不了**,两个原因不同,别混为一谈:
60
+ - `dsh-deepseek-chat-import` —— rc.2 时**还不存在**,随本轮首发(见 §3.0);
61
+ - `dsh-desktop-host` —— 桌面壳自有的包,**npm 上根本没有**(`404`),两个版本都
62
+ 取不到。它不在本插件声明的任何 peer 里,跳过无害。
63
+
64
+ 另有 **8 个** `@deepseek-ai/*` 依赖不在这 329 里,因为宿主一直没给它们换版号
65
+ (`cordis` / `cordis-plugin-*` / `cosmokit` / `node-addon-system` / `schemastery`)——
66
+ 它们在 rc.2 与 rc.3 的 `package.json` 里逐字相同。
67
+
68
+ ### 1.2 复现方式(一次性调研,不值得做成仓库里的脚本)
69
+
70
+ ```bash
71
+ # 1) 从装机 asar 的依赖表里取出钉在 rc.3 的包名
72
+ ASAR="/Applications/DeepSeek Harness.app/Contents/Resources/app.asar"
73
+ node -e 'const s=require("fs").readFileSync(process.argv[1],"latin1");
74
+ const i=s.indexOf("\"name\": \"@deepseek-ai/dsh-desktop-runtime\"");const o=s.lastIndexOf("{",i);
75
+ let d=0,e=-1;for(let k=o;k<s.length;k++){if(s[k]==="{")d++;else if(s[k]==="}"){if(--d===0){e=k+1;break}}}
76
+ const m=JSON.parse(s.slice(o,e));
77
+ console.log(Object.keys(m.dependencies).filter(n=>n.startsWith("@deepseek-ai/")&&m.dependencies[n]==="0.2.2-rc.3").join("\n"))' "$ASAR" > pkgs.txt
78
+
79
+ # 2) 逐包拉两个版本、解开、递归 diff(这里是 shell 版,等价于上面用的那套)
80
+ while read -r p; do
81
+ slug="${p#@deepseek-ai/}"
82
+ for v in 0.2.2-rc.2 0.2.2-rc.3; do
83
+ d="/tmp/rc3/$slug/$v"; mkdir -p "$d"
84
+ npm pack "$p@$v" --silent --pack-destination "$d" >/dev/null 2>&1 \
85
+ && tar xzf "$d"/*.tgz -C "$d" --strip-components=1 && rm "$d"/*.tgz \
86
+ || echo "MISSING $p@$v"
87
+ done
88
+ diff -rq "/tmp/rc3/$slug/0.2.2-rc.2" "/tmp/rc3/$slug/0.2.2-rc.3" 2>/dev/null \
89
+ | grep -Ev 'package\.json|\.map\b' | sed "s|^|$slug: |"
90
+ done < pkgs.txt
91
+ ```
92
+
93
+ > **为什么它不是仓库里的脚本**:上一轮的同类比对也是手工做的,结论进了文档、方法没留。
94
+ > 这次考虑过写成 `scripts/`,最后没写 —— 它只在宿主升级时跑一次、要十几分钟、还要
95
+ > 联网,而 `scripts/extract-host-classifier.mjs` 之所以必须存在,是因为它守的是**每次
96
+ > 测试都会读的夹具**(漂了会红)。一次性调研留可复跑的命令就够了,把它做成工具再加
97
+ > 一套测试,成本比它省下的时间高。
98
+
99
+ ---
100
+
101
+ ## 二、P0:夹具必须重提取(但只是元数据)
102
+
103
+ `classifyPiAiError` 在 rc.3 里**逐字没变** —— `node scripts/extract-host-classifier.mjs --check`
104
+ 在升级前就直接报「夹具与装机宿主一致」。变的是 asar 本身(sha256 变了),于是夹具里
105
+ `source.dshVersion` / `source.asarSha256` 已经是错的溯源信息。
106
+
107
+ 跑一次 `node scripts/extract-host-classifier.mjs` 即可,三段源码原样写回。
108
+
109
+ ### 2.1 顺手修掉一个只在凌晨发作的缺陷
110
+
111
+ `extractedAt` 原本是 `new Date().toISOString().slice(0, 10)` —— **UTC 日期**。在 UTC+8
112
+ 上,任何一次 00:00–08:00 之间跑的提取都会写下**前一天**。本轮就撞上了:11-14 凌晨
113
+ 00:47 跑的提取把日期记成 `2026-11-13`。
114
+
115
+ 这个字段只作溯源提示、不参与任何断言,所以错一天**永远不会让测试变红**——正因为它
116
+ 不会红,只能靠把它写对:改成 `new Date().toLocaleDateString('sv-SE')`
117
+ (`sv-SE` 的默认格式恰好是 ISO 形状的本地日期)。
118
+
119
+ > 这是本仓库「夹具的重新提取必须是一条命令」那条教训的延伸:脚本自动化了**抄写**,
120
+ > 但没自动化**抄对日期**。差异在于日期这件事没有任何断言能替你发现。
121
+
122
+ ---
123
+
124
+ ## 三、P1:变了的 17 个包,没有一个在插件的路径上
125
+
126
+ ### 3.0 先说那个「新增」的
127
+
128
+ `@deepseek-ai/dsh-deepseek-chat-import` 在 rc.2 里**不存在**(npm 上只有 `0.2.2-rc.3`
129
+ 与一个 `0.0.0-stage`),是随本轮一起首发的 experimental bundle。它需要用户显式安装才会
130
+ 激活,本插件既不引用它、也不在它的依赖里 —— 对使用者唯一的可见变化是插件市场里多出
131
+ 一张可选卡片。
132
+
133
+ ### 3.1 插件自己 import 的 11 个,逐字节相同
134
+
135
+ 插件声明 13 个 `dsh-*` peer,实际 import 的有 11 个。这 11 个里**全部**在 rc.3 中
136
+ 逐字节未变(`lib/index.js` 与 `lib/client.js` 的 sha256 相同):
137
+
138
+ | 包 | `lib/index.js` | `lib/client.js` |
139
+ |---|---|---|
140
+ | `dsh-atomic-write` | 相同 | —— |
141
+ | `dsh-attachment` | 相同 | —— |
142
+ | `dsh-client-locale` | 相同 | 相同 |
143
+ | `dsh-client-ui-renderer` | 相同 | 相同 |
144
+ | `dsh-client-ui-settings` | 相同 | 相同 |
145
+ | `dsh-client-ui-settings-plugins` | 相同 | 相同 |
146
+ | `dsh-client-ui-slots` | 相同(`lib/types` 逐字节相同) | —— |
147
+ | `dsh-home-paths` | 相同 | —— |
148
+ | `dsh-host-webserver` | 相同 | —— |
149
+ | `dsh-llm` | 相同 | —— |
150
+ | `dsh-llm-pi-ai` | 相同 | —— |
151
+
152
+ 另外两个只声明不 import 的(`dsh-client-ui-primitives` 与 `dsh-settings`):
153
+ `dsh-settings` 逐字节相同;`dsh-client-ui-primitives` 多了一个**图标**(`upload-outline`
154
+ 的 Regular/Medium 两条导出),是纯新增,而插件**从不 import 这个包**。
155
+
156
+ > 值得注意:rc.2 那一轮 `dsh-client-ui-primitives` 删过 `useAnchoredPosition`,本插件
157
+ > 因为「刻意的本地 40 行 popover」躲过了一次。这一轮它加图标,同样没碰到我们。
158
+
159
+ ### 3.2 那 17 个有实质变化的包,逐条说明
160
+
161
+ | 包 | 变化 | 为什么无关 |
162
+ |---|---|---|
163
+ | `dsh`(CLI) | 只改了 `docs/`:`capability-seams`、`config-catalog`、`subsystems/persistence` 三份(英中双份)新增 `deepseekChatImport` 一节 | 文档 |
164
+ | `dsh-agent-preset` | `skills/dsh-doc/references/packages.md` 多一行 `dsh-deepseek-chat-import` | 技能文档 |
165
+ | `dsh-api-session-controller` | `lib/typert.host.js` 的内嵌声明里多一个 `deepseekChatImport/owner-only` 错误码 | 插件不调 Remote 方法 |
166
+ | `dsh-client-modules` | 只差一行 build commit 常量(`a6b1b85` → `6b729fe`) | 构建噪声 |
167
+ | `dsh-client-ui-directory-picker-browse` | 注册点从「两个 directory-flow 洞」扩到「三个」,多注入一个 `workspace.picker.directoryFlow` | 插件不用 directory picker |
168
+ | `dsh-client-ui-directory-picker-native` | 同上 | 同上 |
169
+ | `dsh-client-ui-plugin-manager` | `MORE_BUNDLES` / `EXPERIMENTAL_BUNDLES` 各多一条新 bundle | 插件不读这两张表 |
170
+ | `dsh-client-ui-settings-account` | client bundle 里两处版本串 | 见下 §3.2 |
171
+ | `dsh-client-ui-settings-general` | 同上 | 见下 §3.3 |
172
+ | `dsh-client-ui-sidebar` | 新增 `sidebar.session.action`(hoc)槽 + 「新建会话」行改由它包裹 + CSS | 见下 §3.4 |
173
+ | `dsh-client-ui-workspace` | 新增 `workspace.picker` 槽 Factory 与第三个 directory-flow 洞 | 插件不碰 workspace |
174
+ | `dsh-cordis-client-runner` | `slot-catalog.ts` 新增两条槽(`sidebar.session.action`、`workspace.picker.directoryFlow`),其余条目逐字未变 | 见下 §3.5 |
175
+ | `dsh-experimental-cua-macos` | CUA helper 的 native 二进制换了 hash(build key 跟着变) | 插件不碰 CUA |
176
+ | `dsh-official-bundles` | bundle 清单多一条 `dsh-deepseek-chat-import` | 插件不在清单里 |
177
+ | `dsh-session-log-export` | 附件读不出来时改为写 `attachments-missing.txt` 继续导出,而不是整包失败 | 插件不导出会话 |
178
+ | `dsh-tool-cordis` | API 目录多 8 行(`deepseekChatImport` 服务) | 插件不读这份目录 |
179
+ | `dsh-web-frontend` | 前端 asset 换了 hash | 宿主自己的 Web 产物 |
180
+
181
+ ### 3.3 `settings-jump.ts` 依赖的两个「外壳形状」都还在
182
+
183
+ 这是本轮唯一值得**逐字核对**的地方:插件的「跳到设置页」按钮读的是宿主的外壳,
184
+ 而 rc.3 动过 `ui-sidebar` 与 `ui-settings-general`。核对结果:
185
+
186
+ - `sidebar.settings` 的 store 座位逐字未变:`const shellInstance = shellHandle.create()`、
187
+ `const shellStore = {...shellHandle, create: () => shellInstance}`、
188
+ `openSection: (d, id) => { d.activeId = id; d.open = true }` 全部原样。
189
+ - 设置触发器仍是 `aria-haspopup="dialog"` + `aria-expanded`(那颗 `menu` 语义的
190
+ 「发行通道」选择器也还在,`TRIGGER_SELECTOR` 不会误命中它 —— 与 rc.2 结论相同)。
191
+ - `data-shortcut-modal="settings"` 仍在。
192
+ - `ui-settings-general` 与 `ui-settings-account` 的 client bundle **只有版本串变了**
193
+ (strip 掉版本串后 `diff` 为空)。
194
+
195
+ ### 3.4 「新建会话」行被 `renderSlot` 包了一层 —— 与插件无关,但要知道
196
+
197
+ `ui-sidebar` 把原来直接渲染的 Tooltip + button 改成:
198
+
199
+ ```jsx
200
+ <div className={css.newSessionRow}>
201
+ {renderSlot('sidebar.session.action', { wide }, { children: (…原内容…) })}
202
+ </div>
203
+ ```
204
+
205
+ 新增槽 `sidebar.session.action` 的 kind 是 **`hoc`**(rc.2 才引入的那一档)。插件用的是
206
+ `sidebar.panellist`(list)与 `sidebar.panellist.actions`(list),**两处逐字未变** ——
207
+ `SidebarRoot.tsx` 里 `PanelRow` / `PanelIcon.tsx` 的渲染区域 `diff` 为空。
208
+
209
+ > 一条通用的防线:`model-label-seat.ts` 的 `declaredSlotKind()` 对**不认识的 kind 返回
210
+ > `undefined`**(落回单格形状),所以将来哪怕读到 `'hoc'` 也不会崩。这条在 rc.2 引入
211
+ > `hoc` 时就写下了,本轮仍然成立。
212
+
213
+ ### 3.5 槽位目录:114 → 116,新增的两条都不是我们的
214
+
215
+ `dsh-cordis-client-runner` 的 `slot-catalog.ts` 是本机唯一能一次性读到「所有槽的 kind
216
+ 与 scope」的产物。对比 rc.2 / rc.3:
217
+
218
+ | 槽 | rc.2 | rc.3 |
219
+ |---|---|---|
220
+ | `sidebar.session.action` | 不存在 | **新增** `hoc` / root |
221
+ | `workspace.picker.directoryFlow` | 不存在 | **新增** `single` / root |
222
+ | 其余 114 条 | —— | **kind 与 scope 逐条相同** |
223
+
224
+ 插件实际用到的 9 个槽在 rc.3 里的声明(直读装机 asar 的目录条目):
225
+
226
+ | 槽 | kind | scope |
227
+ |---|---|---|
228
+ | `main` | keyed | root |
229
+ | `sidebar.panellist` | list | root |
230
+ | `sidebar.settings` | single | root |
231
+ | `settings.section` | list | root |
232
+ | `settings.section.icon` | list | root |
233
+ | `conversation.input.right` | list | session |
234
+ | `conversation.composer.dock` | list | session |
235
+ | `conversation.input.model.label` | single | session |
236
+ | `conversation.input.model.options` | list | session(本插件不注册) |
237
+
238
+ `conversation.input.model.label` 仍是 **`single`**,且调用点**仍然没有 `entryKey`** ——
239
+ `model-label-seat.ts` 那条「keyed 要宿主两处一起改」的判断在 rc.3 上仍未被推翻,
240
+ 运行时探测路径照旧是必需的那条。
241
+
242
+ ---
243
+
244
+ ## 四、P2:peer 范围仍然不需要新分支
245
+
246
+ 当前声明:
247
+
248
+ ```
249
+ >=0.1.7-rc.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-rc.1 <0.3.0-0 || >=0.2.2-rc.1 <0.3.0-0
250
+ ```
251
+
252
+ `0.2.2-rc.3` 与 rc.1 / rc.2 **同一元组**,第四支已经开闸。实测(node-semver 直跑):
253
+
254
+ | 版本 | 标准语义(npm/pnpm) | 宿主门禁(`includePrerelease`) |
255
+ |---|---|---|
256
+ | `0.2.2-rc.2` | true | true |
257
+ | **`0.2.2-rc.3`** | **true** | **true** |
258
+ | `0.2.3-rc.1` | false ❌ | true |
259
+
260
+ 加分支的判据是「补丁号变了」,不是「rc 号变了」。这是**第二次**实证这个判断
261
+ (rc.2 是第一次)。本轮把 `0.2.2-rc.3` 加进 `tests/dsh-line.spec.ts` 的
262
+ `ADMITTED_PRERELEASES` 与宿主门禁那条用例,注释里写明「这是第二次实证,
263
+ 不是又一个待办」。真正的下一个待办仍是 `0.2.3-rc.1`(`UNGATED_PRERELEASES`)。
264
+
265
+ ---
266
+
267
+ ## 五、P3:开发依赖树
268
+
269
+ `pnpm-workspace.yaml` 整体迁到 `0.2.2-rc.3`(`dsh-*` 全部 + 钉住的 `dsh-error`)。
270
+ `cordis 4.1.0` / `schemastery 3.19.0` / `pi-ai 1.3.0` 不变。
271
+
272
+ 实测结果:
273
+
274
+ | 检查 | rc.2 树 | **rc.3 树** |
275
+ |---|---|---|
276
+ | `tsc -p tsconfig.json` | 0 | **0** |
277
+ | `tsc -p tsconfig.client.json` | 0 | **0** |
278
+ | `vitest run` | 1472 passed / 12 skipped | **1472 passed / 12 skipped** |
279
+ | `tsdown` | 通过 | **通过** |
280
+
281
+ ---
282
+
283
+ ## 六、明确排除的部分
284
+
285
+ - **`dsh-deepseek-chat-import`**:全新的 experimental 包(npm 上只有 `0.2.2-rc.3`
286
+ 与一个 `0.0.0-stage`),随 rc.3 一起首发。它要用户显式安装才会激活,插件不引用它、
287
+ 也不出现在它的依赖里。
288
+ - **`workspace.picker` 的 Factory 槽**:`ui-slots` 的 `SlotFactoryMap` 在 rc.2 里就已经
289
+ 存在(31 处引用,两版逐字节相同),rc.3 只是 workspace 包**第一次用它**。插件不注册
290
+ 也不渲染任何 Factory。
291
+ - **`sidebar.session.action` 的 hoc 形状**:插件不注册 hoc 槽。`declaredSlotKind()`
292
+ 对这种陌生 kind 的保守回退仍然有效(见 §3.4)。
293
+ - **CUA helper 的二进制变更**:`experimental-cua-macos` 的 native bundle hash 变了,
294
+ 这是宿主的 CUA 自更新,与插件无关。**注意**:macOS 上 CUA 权限按 bundle 身份授予,
295
+ 这个变化可能让用户被要求重新授权一次 —— 那是宿主侧的行为,不是本插件的问题。
296
+ - **`session-log-export` 的 `attachments-missing.txt`**:新行为是「缺附件不失败」。
297
+ 插件从不导出会话,也没有读取导出产物的路径。
298
+ - **usage 解析夹具的 `extractedAt: 2026-10-22`**:这不是漏更新。那段
299
+ `parseChunkUsage` 从 10-22 至今**逐字未变**(本轮逐字核对过装机 asar),
300
+ `source` 里记的是「这段文本是哪天提取的」,不是「最后一次检查是哪天」。
301
+ 没有 `--check` 模式给这份夹具,所以它只能靠手工核对 —— 本轮核过,结论是相同。
302
+
303
+ ---
304
+
305
+ ## 七、落地记录(2026-11-14,1.25.2)
306
+
307
+ | 项 | 改动 | 位置 |
308
+ |---|---|---|
309
+ | P0 | 夹具按 rc.3 asar 重提取(三段源码逐字相同,只有 `source` 元数据变) | `tests/fixtures/host-piai-classifier.json` |
310
+ | P0 | `extractedAt` 改用本地日期(`sv-SE`),修掉 UTC+8 凌晨跑会写前一天的缺陷 | `scripts/extract-host-classifier.mjs` |
311
+ | P2 | `0.2.2-rc.3` 加进 `ADMITTED_PRERELEASES` 与宿主门禁用例(**不新增分支**) | `tests/dsh-line.spec.ts` |
312
+ | P3 | overrides 整体迁到 `0.2.2-rc.3` | `pnpm-workspace.yaml`、`pnpm-lock.yaml` |
313
+ | 文档 | 本文 + README 双语「当前宿主」小节轮换 + CHANGELOG `1.25.2` + `files` 清单 | — |
314
+
315
+ **没有改 `src/` 下的任何一行。** 这一轮与 rc.2 的区别只在「变的是哪些包」:
316
+ rc.2 打到了我们用来做证据的夹具上,rc.3 连夹具都只是换了元数据。
317
+ 值得记下的教训是 §2.1 —— 自动化了抄写不等于抄对了元数据。
@@ -0,0 +1,219 @@
1
+ # DSH 0.2.2-rc.5 升级跟进调研 —— dsh-connect-qoder
2
+
3
+ > 调研日期:2026-11-19
4
+ > 宿主:DSH Desktop **`0.2.2-rc.5`**(`app.asar` 内 329 个 `dsh-*` 全部为
5
+ > `0.2.2-rc.5`,asar sha256 `6f019878…88e`)
6
+ > 插件:`@dmh2002/dsh-connect-qoder` **1.26.4 → 1.27.0**(本轮**不改运行时代码**,
7
+ > 只升依赖树、重提取夹具元数据、补版本基线与文档)
8
+ > 上一轮:[`docs/DSH-0.2.2-RC3-FOLLOWUP.md`](DSH-0.2.2-RC3-FOLLOWUP.md)
9
+
10
+ ---
11
+
12
+ ## 零、结论摘要
13
+
14
+ **结论:不需要改运行时代码。** `0.2.2-rc.3 → 0.2.2-rc.5` 跨 rc.4、rc.5 两个版本,
15
+ 适用的两条升级指南都落在 **DeepSeek 模型面**(拒答错误码、模型搜索默认提供方),
16
+ 本插件是 Qoder 桥接,**两条都不涉及**。逐包比对 329 个钉在 rc.5 的 `@deepseek-ai/*`
17
+ 包:插件 import 的 11 个里 10 个逐字节相同,唯一变了的 `dsh-llm` 只是**新增**一个
18
+ 错误码枚举。`pnpm run check` 在 rc.5 依赖树上第一次跑就全绿(1510 通过 / 12 跳过)。
19
+
20
+ | 层 | 结论 | 所需动作 |
21
+ |---|---|---|
22
+ | `v0.2.2-rc.3/deepseek-refusal-code`(rc.3→rc.4) | 🟢 拒答码 `MALFORMED_RESPONSE` → `CONTENT_REFUSED`;插件只用 `dsh-llm` 的 `resolveRetryPolicy` 与类型,不碰错误码 | 无 |
23
+ | `v0.2.2-rc.4/web-search-deepseek-model-default`(rc.4→rc.5) | 🟢 搜索默认提供方改由 `dsh-web` 按模型路由选,插件不碰 web 搜索 | 无 |
24
+ | 插件 import 的 11 个宿主包 | 🟢 10 个逐字节相同;`dsh-llm` 只多一个 `CONTENT_REFUSED` 枚举 | 无 |
25
+ | `settings-general` / `sidebar` 的 `client.js` | 🟡 只有内嵌构建版本串变了(`rc.3-6b729fe` → `rc.5-3f85d88`);归一化后逐字节相同,`settings-jump.ts` 依赖的座位全未变 | 无 |
26
+ | 失败分类器夹具 | 🟢 三段源码**逐字相同**,`--check` 已过;但 asar 换了 sha,溯源元数据要刷新 | **重提取**(已做) |
27
+ | peer 范围覆盖 `0.2.2-rc.5` | 🟢 同一元组,仍**不需要新分支**(第三次实证) | 补断言(已做) |
28
+ | 版本基线测试 `tests/dsh-line.spec.ts` | 🟡 只列到 rc.3 | **补 rc.4 / rc.5**(已做) |
29
+ | 开发依赖树 | 🟡 仍钉在 rc.3 | **升到 rc.5**(已做) |
30
+
31
+ ---
32
+
33
+ ## 一、实测环境
34
+
35
+ 宿主 `app.asar` 内 `node_modules` 的实际版本:
36
+
37
+ | 包 | 0.2.2-rc.3 | **0.2.2-rc.5(本机)** |
38
+ |---|---|---|
39
+ | `@deepseek-ai/dsh` 及全部 `dsh-*` | 0.2.2-rc.3 | **0.2.2-rc.5**(329 个包,逐个核对) |
40
+ | `@deepseek-ai/cordis` | 4.1.0 | **4.1.0(不变)** |
41
+ | `@deepseek-ai/schemastery` | 3.19.0 | **3.19.0(不变)** |
42
+ | `@earendil-works/pi-ai` | 1.3.0 | **1.3.0(不变)** |
43
+
44
+ 这一轮**没有换 pi-ai、没有换 cordis、没有换 schemastery** —— 与前几轮一致。
45
+
46
+ ### 1.1 逐包 diff 的方法与结果
47
+
48
+ 把 asar 里钉在 `0.2.2-rc.5` 的 **329 个** `@deepseek-ai/*` 依赖,逐个下载 rc.3 与
49
+ rc.5 两个 tarball、解开、做 `diff -rq`,剔除 `package.json` 与 `*.map`(前者必然只差
50
+ 版本号与内部 peer 版本,后者是构建噪声)。结果:
51
+
52
+ - **327 个真比过了**:其中约 20 个有实质内容差异,其余剔除噪声后逐字节相同;
53
+ - **2 个比不了**:`dsh-desktop-host` 是桌面壳自有包,npm 上 404,两个版本都取不到;
54
+ 它不在本插件声明的任何 peer 里,跳过无害。
55
+
56
+ 有实质差异的包集中在:**DeepSeek 搜索默认**(`dsh-web`、`dsh-web-search-deepseek`、
57
+ `dsh-tool-web`、`dsh-client-ui-settings-web-search`、`dsh-base` 的 `cordis.patch.yml`)、
58
+ **拒答码**(`dsh-llm`、`dsh-llm-deepseek`)、以及 liveshare / tmux / session-persistence /
59
+ repeat-tool-reminder / tool-cordis / api-remotes / client-modules 等面。逐条都不在本插件
60
+ import 的 11 个包里(唯一交集 `dsh-llm` 见 §二)。
61
+
62
+ ### 1.2 复现方式(一次性调研,不值得做成仓库里的脚本)
63
+
64
+ ```bash
65
+ # 1) 从装机 asar 的依赖表里取出钉在 rc.5 的包名
66
+ ELECTRON_RUN_AS_NODE=1 "$DSH_NODE_EXECUTABLE" -e '
67
+ const fs=require("node:fs"),path=require("node:path");
68
+ const nm=path.resolve(process.env.DSH_INSTALL_DIR,"../");
69
+ for(const p of fs.readdirSync(nm)){ if(!p.startsWith("dsh"))continue;
70
+ try{const j=JSON.parse(fs.readFileSync(path.join(nm,p,"package.json"),"utf8"));
71
+ if(j.version==="0.2.2-rc.5") console.log(j.name);}catch(e){} }
72
+ ' > pkgs.txt
73
+
74
+ # 2) 逐包拉两个版本、解开、递归 diff
75
+ while read -r p; do
76
+ slug="${p#@deepseek-ai/}"
77
+ for v in 0.2.2-rc.3 0.2.2-rc.5; do
78
+ d="/tmp/cmp/$slug/$v"; mkdir -p "$d"
79
+ npm pack "$p@$v" --silent --pack-destination "$d" >/dev/null 2>&1 \
80
+ && tar xzf "$d"/*.tgz -C "$d" --strip-components=1 && rm "$d"/*.tgz
81
+ done
82
+ diff -rq "/tmp/cmp/$slug/0.2.2-rc.3" "/tmp/cmp/$slug/0.2.2-rc.5" \
83
+ | grep -Ev 'package\.json|\.map\b' | sed "s|^|$slug: |"
84
+ done < pkgs.txt
85
+ ```
86
+
87
+ ---
88
+
89
+ ## 二、P0:两条升级指南逐条核对
90
+
91
+ ### 2.1 `v0.2.2-rc.3/deepseek-refusal-code`
92
+
93
+ 指南内容:DeepSeek 以 `stop_reason: "refusal"` 结束时,错误码从
94
+ `MALFORMED_RESPONSE` 改成 `CONTENT_REFUSED`。落实到包上:
95
+
96
+ - `dsh-llm` 的 `src/error.ts` **只新增**一行 `CONTENT_REFUSED: {},` 到错误码表;
97
+ - `dsh-llm-deepseek` 新增 `refusal()` 构造函数,在拒答时先吐 usage 再抛错。
98
+
99
+ 插件对 `dsh-llm` 的用法(见 `src/adapter.ts` / `src/index.ts`):`resolveRetryPolicy`、
100
+ `RetryPolicyConfig`、`LlmModelInfo` 等类型、`AdapterRegistrationHandle` —— **没有一处
101
+ 读错误码表或按错误码分支**。插件自己的失败分类走 `src/shim.ts` 的净化 +
102
+ `tests/fixtures/host-piai-classifier.json` 那份宿主分类器原文,与 `dsh-llm` 的错误码
103
+ 不是同一个东西。**无需改动。**
104
+
105
+ ### 2.2 `v0.2.2-rc.4/web-search-deepseek-model-default`
106
+
107
+ 指南内容:基础组合不再固定 `web.searchProvider = deepseek-search-api`,改由 `dsh-web`
108
+ 按模型提供方路由选择;DeepSeek 模型走一次辅助 Messages 请求(不按次收费、按 token
109
+ 计费),并追加 `web/deepseek-search-llm-request` 事件。落实到 `dsh-base/cordis.patch.yml`
110
+ 确实是删掉了 `searchProvider: deepseek-search-api` 那一行。
111
+
112
+ 插件不注册任何 web 搜索提供方、不读 `web.searchProvider`、不消费
113
+ `web/deepseek-search-llm-request` 事件、也不从 `@deepseek-ai/dsh-web` import 任何东西。
114
+ 这是宿主默认组合层的变更,**无需改动**。
115
+
116
+ ---
117
+
118
+ ## 三、P0:看起来要改、逐字比过其实不用改的面
119
+
120
+ ### 3.1 失败分类器夹具
121
+
122
+ 跑 `node scripts/extract-host-classifier.mjs --check`:三段源码
123
+ (`LEADING_HTTP_STATUS` / `isQuotaExceededError` / `classifyPiAiError`)与装机 rc.5 宿主
124
+ **逐字相同**(1088 字节的 `classifyPiAiError` 命中 1 处,两个 quota 函数命中 2 处、
125
+ 照旧取第一处)。也就是说 rc.4 / rc.5 没有再动 `dsh-llm-pi-ai` 的分类器 —— 上次 rc.2
126
+ 那次「先取报文开头状态码」的改动是最后一次实质变化。
127
+
128
+ 但 asar 换了 sha(`c0ce89f7…e843` → `6f019878…88e`),夹具 `source` 里的
129
+ `dshVersion` / `asarSha256` / `extractedAt` 是溯源元数据,必须跟着刷新 —— 否则将来
130
+ 查「这段分类器是哪一版宿主的」会读到过期的 rc.3。已跑一次不带 `--check` 的提取,
131
+ `source` 更新为 rc.5 / 新 sha / `2026-11-19`(本地日期)。**源码三段一个字节没动。**
132
+
133
+ ### 3.2 设置页外壳与侧边栏
134
+
135
+ `dsh-client-ui-settings-general` 与 `dsh-client-ui-sidebar` 的 `lib/client.js` 在 rc.3 /
136
+ rc.5 之间有差异,但把内嵌构建版本串归一化(`0.2.2-rc.N-<hash>` → `VERSION`)后
137
+ **逐字节相同**。逐条核对 `src/client/settings-jump.ts` 依赖的座位:
138
+
139
+ - `sidebar.settings` 仍是 `kind: single, scope: root` 的槽;
140
+ - 设置触发器仍是 `aria-haspopup="dialog"`;
141
+ - 置顶的「新建会话」行仍由 `renderSlot('sidebar.session.action', …)` 包裹(rc.3 引入的
142
+ hoc 形状没再变);
143
+ - `sidebar.panellist` / `panellist.actions` 的注册签名未变。
144
+
145
+ 插件的 `settings.section` 注入与 `openSection(id)` 调用路径不受影响。**无需改动。**
146
+
147
+ ### 3.3 槽位目录与模型徽章
148
+
149
+ `dsh-client-ui-slots`、`dsh-client-ui-settings`、`dsh-client-ui-settings-plugins`、
150
+ `dsh-client-ui-renderer`、`dsh-attachment`、`dsh-home-paths`、`dsh-host-webserver`、
151
+ `dsh-atomic-write`、`dsh-client-locale` 九个包 rc.3 / rc.5 逐字节相同。插件注册/消费的
152
+ 槽契约(含 `conversation.input.model.label` 的 `single` 形状)不变,无需重新核对清单。
153
+
154
+ ---
155
+
156
+ ## 四、P2:peer 范围仍然不需要新分支
157
+
158
+ 当前声明:
159
+
160
+ ```
161
+ >=0.1.7-rc.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-rc.1 <0.3.0-0 || >=0.2.2-rc.1 <0.3.0-0
162
+ ```
163
+
164
+ 实测(node-semver 直跑):
165
+
166
+ | 版本 | 标准语义(npm/pnpm) | 宿主门禁(`includePrerelease`) |
167
+ |---|---|---|
168
+ | `0.2.2-rc.3` | true | true |
169
+ | `0.2.2-rc.4` | true | true |
170
+ | **`0.2.2-rc.5`** | **true** | **true** |
171
+ | `0.2.3-rc.1` | false ❌ | true |
172
+
173
+ 加分支的判据是「补丁号变了」,不是「rc 号变了」。这是**第三次**实证这个判断
174
+ (rc.2 第一次、rc.3 第二次)。本轮把 `0.2.2-rc.4` / `0.2.2-rc.5` 加进
175
+ `tests/dsh-line.spec.ts` 的 `ADMITTED_PRERELEASES` 与宿主门禁用例,注释写明「第三次
176
+ 实证,不是又一个待办」。真正的下一个待办仍是 `0.2.3-rc.1`(`UNGATED_PRERELEASES`)。
177
+
178
+ ---
179
+
180
+ ## 五、P3:开发依赖树
181
+
182
+ `pnpm-workspace.yaml` 整体迁到 `0.2.2-rc.5`(27 个 `dsh-*` 钉版 + 钉住的 `dsh-error`),
183
+ `cordis 4.1.0` / `schemastery 3.19.0` / `pi-ai 1.3.0` 不变。`pnpm install --lockfile-only`
184
+ 重锁,`pnpm install --frozen-lockfile` 复核通过,lockfile 里 rc.3 归零、rc.5 共 187 处。
185
+
186
+ 实测结果:
187
+
188
+ | 检查 | rc.3 树 | **rc.5 树** |
189
+ |---|---|---|
190
+ | `tsc -p tsconfig.json` | 0 | **0** |
191
+ | `tsc -p tsconfig.client.json` | 0 | **0** |
192
+ | `vitest run` | 1510 passed / 12 skipped | **1510 passed / 12 skipped** |
193
+ | `tsdown` | 通过 | **通过** |
194
+
195
+ ---
196
+
197
+ ## 六、明确排除的部分
198
+
199
+ - **`dsh-llm` 的 `CONTENT_REFUSED`**:插件不使用错误码表(见 §2.1),新增枚举项对
200
+ `resolveRetryPolicy` 与类型导入没有影响。
201
+ - **DeepSeek 模型搜索默认**:纯宿主组合层变更(见 §2.2),插件不提供搜索提供方。
202
+ - **liveshare / tmux-context / session-persistence-jsonl / repeat-tool-reminder /
203
+ tool-cordis / api-remotes / client-modules**:rc.3→rc.5 有实质差异,但插件既不 import
204
+ 也不声明这些包,逐条排除。
205
+ - **CUA / worktree 等宿主自有行为**:与插件无关,沿用 rc.3 文档里的结论,不重复。
206
+
207
+ ---
208
+
209
+ ## 七、落地记录(2026-11-19,1.27.0)
210
+
211
+ | 项 | 改动 | 位置 |
212
+ |---|---|---|
213
+ | P0 | 夹具按 rc.5 asar 重提取(三段源码逐字相同,只有 `source` 元数据变) | `tests/fixtures/host-piai-classifier.json` |
214
+ | P1 | `0.2.2-rc.4` / `0.2.2-rc.5` 加进 `ADMITTED_PRERELEASES` 与宿主门禁用例(**不新增分支**) | `tests/dsh-line.spec.ts` |
215
+ | P2 | overrides 整体迁到 `0.2.2-rc.5` | `pnpm-workspace.yaml`、`pnpm-lock.yaml` |
216
+ | 文档 | 本文 + README 双语「当前宿主」小节轮换 + CHANGELOG `1.27.0` + `files` 清单 | — |
217
+
218
+ **没有改 `src/` 下的任何一行。** 这一轮与 rc.3 的区别只在「宿主把两个升级指南都落在
219
+ 了 DeepSeek 模型面」——连夹具源码都没动,只有溯源元数据跟着 asar 换了一次。