@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,328 @@
1
+ # DSH 0.2.2-rc.1 升级跟进调研 —— dsh-connect-qoder
2
+
3
+ > 调研日期:2026-11-05
4
+ > 宿主:DSH Desktop `0.2.2-rc.1`(`runtime/primary-runtime/runtime.json` → `desktopVersion`)
5
+ > 插件:`@dmh2002/dsh-connect-qoder` **1.17.5**(未改代码)
6
+ > 上一轮:[`docs/DSH-0.2.1-RC1-FOLLOWUP.md`](DSH-0.2.1-RC1-FOLLOWUP.md)
7
+ > 基线:本机 0.1.7 依赖树 `1221 passed / 8 skipped`;0.2.2 依赖树 `1216 passed / 5 failed / 8 skipped`
8
+
9
+ ---
10
+
11
+ ## 零、结论摘要
12
+
13
+ **结论:需要适配 —— 且已在 2026-11-05 同一轮内落地(见 §九)。** 与上一轮「0.2.1-rc.5 不需要任何运行时代码改动」不同,0.2.2-rc.1
14
+ 在插件**直接构造**的两个宿主对象上加了必填字段、给 pi-ai 的 api 加了品牌类型,
15
+ 因此 `pnpm run typecheck` 会红;另外 peer 范围在 npm 语义下**不覆盖** `0.2.2-rc.1`。
16
+
17
+ 但**不是** 0.2.1 那种「静默丢工具」级别的运行时事故:真实宿主栈(pi-ai 1.3.0)上
18
+ modern 直通路径实测**正常**,提示词与工具都在。
19
+
20
+ | 层 | 结论 | 所需动作 |
21
+ |---|---|---|
22
+ | `ResolvedPiAiProviderProfile` 新增两个必填字段 | 🔴 typecheck 失败 + 运行时丢「单请求图片条数上限」 | **改代码**(P0-1) |
23
+ | pi-ai 1.3.0 的 `TranscriptContext` 品牌类型 | 🔴 typecheck 失败(仅 legacy 分支) | **改代码**(P0-2) |
24
+ | `ctx.locale.register` 签名加宽 | 🔴 客户端 typecheck 失败 | **改代码**(P0-3) |
25
+ | peer 范围覆盖 `0.2.2-rc.1` | 🔴 npm/pnpm 语义判 false(宿主门禁判 true) | **改声明**(P1) |
26
+ | 测试树仍钉 0.1.7 线 | 🟡 本轮「没测到真宿主」的根因;升线后 5 条用例必红 | **改测试**(P2) |
27
+ | 中途 system 消息改写成 user reminder | 🟡 行为相对 0.2.1 变了,不报错 | 需实测后决定(P3-1) |
28
+ | 宿主默认窗口/输出上限改值 | 🟢 插件逐模型显式给值,预计无影响 | 确认即可 |
29
+ | `llm/models-updated` / `settings.section.icon` / 6 种新语言 | 🟢 新能力,非必需 | 可选增强 |
30
+
31
+ ---
32
+
33
+ ## 一、实测环境(先钉事实)
34
+
35
+ 宿主 `app.asar` 内 `/dsh/node_modules` 的实际版本:
36
+
37
+ | 包 | 0.2.1-rc.5 | **0.2.2-rc.1(本机)** |
38
+ |---|---|---|
39
+ | `@earendil-works/pi-ai` | 1.1.0 | **1.3.0** |
40
+ | `@deepseek-ai/dsh-*` | 0.2.1-rc.5 | **0.2.2-rc.1** |
41
+ | `@deepseek-ai/cordis` | 4.0.x(peer `~4.0.5`) | **4.1.0**(peer `~4.1.0`) |
42
+ | `@deepseek-ai/schemastery` | 3.18.5 | **3.19.0** |
43
+
44
+ 插件的**开发树**仍钉在 0.1.7 线(`pnpm-workspace.yaml` overrides:`dsh-* 0.1.7-rc.1`、
45
+ `cordis 4.0.2`、`schemastery 3.18.4`、`pi-ai 0.85.1`)。这意味着 1.17.5 的
46
+ `pnpm run typecheck` / `pnpm test` **从未对着 0.2.2 的声明跑过** —— 本轮所有
47
+ 破坏都是这样漏出来的。
48
+
49
+ 复现方法(不污染主仓):
50
+
51
+ ```bash
52
+ rsync -a --exclude node_modules --exclude .git ./ /tmp/qoder022/
53
+ cd /tmp/qoder022
54
+ # overrides 改成 0.2.2 线:dsh-*→0.2.2-rc.1、cordis→4.1.0、schemastery→3.19.0、pi-ai→1.3.0
55
+ rm -f pnpm-lock.yaml && pnpm install --no-frozen-lockfile
56
+ npx tsc -p tsconfig.json --noEmit # 3 处
57
+ npx tsc -p tsconfig.client.json --noEmit # 再加 1 处
58
+ npx vitest run
59
+ ```
60
+
61
+ ---
62
+
63
+ ## 二、P0:会让类型检查失败的四处
64
+
65
+ ### P0-1 · `ResolvedPiAiProviderProfile` 新增两个必填字段
66
+
67
+ `src/adapter.ts:506` 手工拼装的 profile 缺 `maxRequestImages` / `imageOffloadCountQuantum`:
68
+
69
+ ```
70
+ src/adapter.ts(506,9): error TS2739:
71
+ Type '{ piProvider: Provider<Api>; maxRequestImageBytes: 20971520; … }'
72
+ is missing the following properties from type 'ResolvedPiAiProviderProfile':
73
+ maxRequestImages, imageOffloadCountQuantum
74
+ ```
75
+
76
+ 宿主 0.2.2 在 `dsh-llm-pi-ai` 里新增了「**单请求图片条数上限**」(对齐 Azure OpenAI
77
+ 的 50 张),并在 `resolveProfile` 里默认化:
78
+
79
+ ```js
80
+ // dsh-llm-pi-ai 0.2.2 lib/index.js:1134-1137
81
+ const maxRequestImages = source.maxRequestImages ?? 50;
82
+ const imageOffloadCountQuantum = source.imageOffloadCountQuantum ?? Math.min(10, maxRequestImages);
83
+ ```
84
+
85
+ **运行时后果**:`PiAiAdapter` 直接读 `profile.maxRequestImages`(`lib/index.js:2018`),
86
+ 插件传的是 `undefined` → 该路由**静默失去**条数上界,只保留原有的
87
+ `maxRequestImageBytes`(20MB)。宿主自己的路由有 50 张的界,Qoder 路由没有。
88
+
89
+ **修法**:在 profile 里显式补两个字段,与宿主默认对齐:
90
+
91
+ ```ts
92
+ maxRequestImages: 50,
93
+ imageOffloadCountQuantum: 10, // = min(10, 50)
94
+ ```
95
+
96
+ (若 Qoder 网关实测能吃更多图,再按实测值上调;但**不要**留空。)
97
+
98
+ ### P0-2 · pi-ai 1.3.0 给 api 上下文加了品牌类型
99
+
100
+ `src/adapter.ts:443-444` 的 legacy 适配层把普通 `Context` 交给 `api.stream`:
101
+
102
+ ```
103
+ src/adapter.ts(443,60): error TS2345: Argument of type 'Context' is not assignable
104
+ to parameter of type 'TranscriptContext'.
105
+ Property '[transcriptContextBrand]' is missing…
106
+ ```
107
+
108
+ pi-ai 从 1.3.0 起把 `api.stream/streamSimple` 的入参声明为品牌化的
109
+ `TranscriptContext`(规范化后的 transcript),这与插件自己在 1.1.x 时实测出的
110
+ 「1.x 的 api 只读 messages」结论一致 —— 品牌类型只是把它写进了类型系统。
111
+
112
+ **影响面**:**只有 legacy 分支**。宿主 0.2.2 跑 pi-ai 1.3.0,
113
+ `generationOf()` 判 `modern`,`withLegacyContext` 直接透传,
114
+ **不经过** `adaptLegacyPiAiContext`。所以这是纯编译期问题。
115
+
116
+ **修法**:在 legacy 分支内做一次收窄/断言(保留 0.1.7 宿主支持),
117
+ 并在注释里写明「这是 0.85 世代的回填,1.3.0 的 api 不接受非品牌 transcript」。
118
+ 不要为了过编译把 modern 分支改成折叠(那是 0.2.1 已论证过的错误方向)。
119
+
120
+ ### P0-3 · `ctx.locale.register` 的签名加宽了
121
+
122
+ `src/client/index.tsx:55`:
123
+
124
+ ```
125
+ src/client/index.tsx(55,53): error TS2345:
126
+ Argument of type 'QoderLocale' is not assignable to parameter of type
127
+ 'Record<"zh" | "en", LocaleDictOf<"settings.qoder">> & Record<string, LocaleDictOf<"settings.qoder">>'.
128
+ Index signature for type 'string' is missing in type 'QoderLocale'.
129
+ ```
130
+
131
+ 0.2.2 的 locale 包把语言从 2 种扩到 8 种(新增 `de/es/fr/ja/pt/ru`),
132
+ `register` 的签名从 `Record<BuiltInLocaleId, …>` 变成
133
+ `Record<BuiltInLocaleId, …> & Record<LocaleId, …>`(`LocaleId = string`),
134
+ 于是要求字典对象带 string 索引签名;插件 `src/client/locales.ts:879` 的
135
+ `QoderLocale` 是固定 `{ zh, en }` 接口,没有索引签名。
136
+
137
+ **运行时不受影响**(JS 不做该检查,两种语言的字典照常注册、英文兜底),
138
+ 是**类型面**破坏。
139
+
140
+ **修法**:给 `QoderLocale` 加索引签名,或用 `satisfies` 保留字面量类型再行断言;
141
+ 若要顺便补齐新语言,这里就是唯一的落点(见 §五)。
142
+
143
+ ---
144
+
145
+ ## 三、P1:peer 范围在 npm 语义下不覆盖 0.2.2-rc.1
146
+
147
+ 当前声明(`package.json` 的 `peerDependencies`):
148
+
149
+ ```
150
+ >=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
151
+ ```
152
+
153
+ 实测两套语义(node-semver 直跑):
154
+
155
+ | 版本 | 标准语义(npm/pnpm 安装) | 宿主门禁(`includePrerelease: true`) |
156
+ |---|---|---|
157
+ | `0.2.1-rc.5` | true | true |
158
+ | **`0.2.2-rc.1`** | **false** ❌ | true |
159
+ | `0.2.2`(GA) | true | true |
160
+
161
+ 即:**宿主的兼容门禁会放行,但 `pnpm add` / npm 安装会判不兼容**。
162
+ 这正是 `tests/dsh-line.spec.ts:117` 那份 `UNGATED_PRERELEASES` 待办表列出的
163
+ `0.2.2-rc.1` —— 表里早就写着它待补,只是还没补。
164
+
165
+ **修法**:按 README「两套语义并存」一节的既定做法,加一条分支:
166
+
167
+ ```
168
+ >=0.2.1-rc.1 <0.3.0-0 || >=0.2.2-rc.1 <0.3.0-0
169
+ ```
170
+
171
+ 同步三处:`package.json` 的 `peerDependencies` / `devDependencies`、
172
+ README「受支持的宿主范围」表(`README.md:310` / `README.en.md`)、
173
+ `tests/dsh-line.spec.ts` 的 `DECLARED_RANGE` 与 `UNGATED_PRERELEASES`。
174
+
175
+ > 注意:`pi-ai` 那一行的 `>=1.0.0 <2.0.0` **已覆盖 1.3.0**,不用改。
176
+
177
+ ---
178
+
179
+ ## 四、P2:测试树要一起升线,否则「验证不到真宿主」
180
+
181
+ 把 overrides 升到 0.2.2 线后,全量用例从 `1221 passed / 8 skipped`
182
+ 变成 **`1216 passed / 5 failed / 8 skipped`**(3 个文件):
183
+
184
+ | 失败用例 | 原因 | 性质 |
185
+ |---|---|---|
186
+ | `tests/adapter-outgoing-body.spec.ts` ×3(legacy 世代) | 用例强制 `piAiGeneration: 'legacy'`,却跑在 pi-ai **1.3.0** 的 api 上;1.3.0 只读 `messages`,顶层 `tools` 必丢 | 用例前提失效 |
187
+ | `tests/pi-ai-runtime.spec.ts:115` | 硬编码 `expect(info.version).toMatch(/^0\.(8[5-7])\.\d+/)`,实测拿到 `1.3.0` | 版本 pin |
188
+ | `tests/fixtures/pi-ai-modern/modern-outgoing-body.spec.ts` | fixture 的 `package.json` 钉 `1.1.0`,断言「钉的就是 1.1.0」 | 版本 pin |
189
+
190
+ **关键结论**:把 fixture 升到 1.3.0 后,modern 直通那 4 条**全绿**
191
+ (`modern 直通:提示词与工具都出门`、`幂等`、`legacy 在 1.x 上会静默丢` 等),
192
+ 只有「版本 pin 断言」那条红。也就是说 **0.2.2 的真实运行时路径没有回归**。
193
+
194
+ 建议:
195
+
196
+ - legacy-only 那三条按「已装 pi-ai 世代」门控(`skipIf(generationOf(installed) !== 'legacy')`),
197
+ 而不是删掉 —— 0.1.7 宿主仍要这条护栏;
198
+ - `pi-ai-runtime.spec.ts` 的版本正则改成按世代断言,不再写死 0.85;
199
+ - `tests/fixtures/pi-ai-modern` 从 1.1.0 升到 **1.3.0**(与宿主同代),
200
+ 注释里「与 followup 文档同一个版本」随之更新;
201
+ - 主树是否整体升到 0.2.2,是个取舍:升了 CI 才对着真宿主跑,但会丢 0.1.7 的直接覆盖
202
+ (可用 fixture 补)。**建议升主树** —— 本轮的问题恰恰是主树停在 0.1.7 才没被发现。
203
+
204
+ ---
205
+
206
+ ## 五、P3:不报错但语义变了的几处
207
+
208
+ ### P3-1 · 中途 system 消息默认改成 user 味的 `<system-reminder>`
209
+
210
+ 0.2.2 的 `toPiContext` 新增 `supportsMidConvoSystemMessages` 形参,从
211
+ `PreparedAdapterCall.updates.systemPromptUpdate === 'in-history'` 推出;
212
+ 为 false 时,把对话**中途**的 system 文本包成 user 角色的
213
+ `<system-reminder>…</system-reminder>`(并转义闭合标签)。0.2.1 是**无条件**以
214
+ system 角色发送。
215
+
216
+ 插件的 `buildModels()` 只声明了 `compat: { supportsReasoningEffort, supportsDeveloperRole: false }`,
217
+ 没声明 `supportsMidConvoSystemMessages` → 取默认 false → **Qoder 路由的
218
+ 中途 system 行为相对 0.2.1 变了**(这在共享历史 / 中途注入提示的场景才会显出差异)。
219
+
220
+ **动作**:实测 Qoder 网关是否接受中途 system 角色;接受就显式声明,
221
+ 不接受就保持现状(默认的 reminder 其实更安全),并把结论写进注释。
222
+
223
+ ### P3-2 · 宿主默认值改了两个常数
224
+
225
+ `DEFAULT_CONTEXT_WINDOW` 262144 → **1000000**,`DEFAULT_MAX_TOKENS` 32768 → **128000**。
226
+ 只影响**没有显式给值**的路由。插件在 `src/adapter.ts:191` 逐模型用上游实测的
227
+ `info.contextWindow` / `info.maxOutputTokens`,预计无影响 —— 值得确认没有落到默认值上。
228
+
229
+ ### P3-3 · 新增若干错误码
230
+
231
+ `stream.d.ts` 新增 `MALFORMED_RESPONSE`(completed tool arguments 非法)。
232
+ 插件的 failover/重试分类基于**上游 HTTP 状态与 Qoder 业务码**(`context.code === '105'` 等),
233
+ 不基于 `LlmError.code`,因此新码不会误触发换号;但如果以后把 `LlmError.code`
234
+ 接进池排序,需要先给它归类。
235
+
236
+ ---
237
+
238
+ ## 六、可选增强(新钩子,非必需)
239
+
240
+ | 新能力 | 说明 | 对本插件的价值 |
241
+ |---|---|---|
242
+ | `llm/models-updated` 事件 | 「某路由的模型目录/显示元数据变了,消费者重读 `listModels()`」 | **中**:插件目录是动态的(换号、上游刷新、启用/禁用),目前从不通知,选择器可能显示旧列表 |
243
+ | `settings.section.icon` 槽位 | 设置左侧导航可为分区注册图标 | **已采用**(1.18.0):设置页注册了自己的 LD 品牌标,id 与页面一致(不一致会静默退回默认齿轮) |
244
+ | locale 新增 6 语言 | `de/es/fr/ja/pt/ru` | **低**:不补也合法(英文兜底),补的话落点就是 P0-3 那一处 |
245
+ | `llm-pi-ai/request-headers` waterfall | 推理调用前统一改请求头(**不含**模型发现) | **无**:插件的 loopback shim 自己造头;将来若要区分「推理 vs 发现」再考虑 |
246
+ | `WebResource` 路由 | `webServer.register` 可注册 Fetch 资源 | **无**:插件的 HTTP 路由仍是 handler 形态,类型兼容 |
247
+
248
+ ---
249
+
250
+ ## 七、不需要改的部分(明确排除)
251
+
252
+ - **modern 直通路径**:真实 pi-ai 1.3.0 上提示词与工具都在,`generationOf(1.3.0) → modern` 正确。
253
+ - **cordis 4.1.0**:`LoggerLevel` 的 `INFO/WARN` 数值对调、`notify()` 返回值变化等都在
254
+ 插件不碰的内部面上;插件只用 `ctx.effect` / `ctx.on` / `logger.warn|error`(非数值等级)。
255
+ - **`dsh-attachment` / `dsh-settings` / `dsh-atomic-write` / `dsh-home-paths`**:导出面未变。
256
+ - **`DirectoryRegistrationHandle` / `registerConfigurableProviders`**:签名与语义未变。
257
+ - **`dsh-host-webserver`**:`index-inject` 多了 `peer` 参数、新增 `WebResourceRoute`,
258
+ 插件既不监听该事件也不注册资源路由,类型兼容。
259
+ - **插件用到的槽位**(`conversation.input.model.label` / `conversation.input.right` /
260
+ `conversation.composer.dock` / `settings.section` / `settings.section.icon`):契约未变。
261
+ (本文写于 1.18.0 之前,当时配置入口还是 `plugins.bundle.config` /
262
+ `plugins.row.config` 两个 keyed 槽;1.18.0 起已改为设置页分区,那两个槽不再注册。)
263
+
264
+ ---
265
+
266
+ ## 八、建议的落地顺序
267
+
268
+ 1. **P0-1 + P0-2 + P0-3**:三处编译修复(约 10 行),先让 `typecheck` 在 0.2.2 树上绿;
269
+ 2. **P2**:主树 overrides 升 0.2.2、fixture 升 1.3.0、legacy 用例按世代门控,让 `test` 绿;
270
+ 3. **P1**:peer 加 `>=0.2.2-rc.1` 分支,同步 README 与 `dsh-line.spec.ts`;
271
+ 4. **P3-1**:实测 Qoder 的中途 system 行为后决定是否声明能力;
272
+ 5. 发版时把本文档加进 `package.json` 的 `files`(与 `DSH-0.2.1-RC1-FOLLOWUP.md` 并列)。
273
+
274
+ ---
275
+
276
+ ## 九、落地记录(2026-11-05,版本 1.17.5 未改号)
277
+
278
+ ### 9.1 代码
279
+
280
+ | 项 | 改动 | 位置 |
281
+ |---|---|---|
282
+ | P0-1 | `REQUEST_IMAGE_BUDGETS` 补 `maxRequestImages: 50` / `imageOffloadCountQuantum: 10`,并在注释里写明「插件手工拼 profile,宿主的 `?? 50` 默认化不会跑,漏了不报错只是静默无上界」 | `src/adapter.ts:78` |
283
+ | P0-2 | 新增 `ApiContext` / `legacyContextOf()`,把两次断言收敛到一处并注明「这是世代边界,1.3.0 宿主走不到」 | `src/adapter.ts`(`withLegacyContext` 旁) |
284
+ | P0-3 | `QoderLocale` 加 string 索引签名,注释说明它不降低 `zh`/`en` 的键校验 | `src/client/locales.ts:891` |
285
+ | P3-1 | `compat.supportsMidConvoSystemMessages` **显式写 false**,把「跟随宿主默认」变成写下来的决定(附可改回 true 的条件) | `src/adapter.ts`(`toPiModel`) |
286
+
287
+ ### 9.2 声明与文档
288
+
289
+ - `package.json`:26 处 dsh-* peer/dev 范围追加 `|| >=0.2.2-rc.1 <0.3.0-0`;
290
+ `files` 收入本文档。
291
+ - `README.md` / `README.en.md`:范围表更新;「当前宿主基线」整节换成 0.2.2-rc.1 的实测结论
292
+ (0.2.1-rc.4/rc.5 的逐条核查不再冒充「当前」)。
293
+ - `tests/dsh-line.spec.ts`:`DECLARED_RANGE` 加第四支;`0.2.2-rc.1` 从
294
+ `UNGATED_PRERELEASES` 移入 `ADMITTED_PRERELEASES`(余下待办为 `0.2.3-rc.1` / `0.2.9-rc.1`)。
295
+
296
+ ### 9.3 开发依赖树
297
+
298
+ `pnpm-workspace.yaml` 整体迁到 0.2.2 线:`dsh-* 0.2.2-rc.1`、`cordis 4.1.0`、
299
+ `schemastery 3.19.0`、`pi-ai 1.3.0`,并**删掉 `dsh-invariants`**
300
+ (它在 0.2.0-rc.2 之后停版,0.2.2 线已无包引用;留着会让 install 解析失败)。
301
+
302
+ ### 9.4 测试
303
+
304
+ - `tests/pi-ai-runtime.spec.ts`:版本断言从写死 `/^0\.(8[5-7])\.\d+/` 改成
305
+ 「落在声明的 pi-ai peer 范围里」(宿主换线时该改的是钉版,不是这条判据)。
306
+ - `tests/fixtures/pi-ai-modern`:钉版 1.1.0 → **1.3.0**(与宿主同代);「钉了什么」的断言
307
+ 改为「是确切版本 + `generationOf` 判 modern + 主版本是 1」,不再写死字符串。
308
+ - `tests/adapter-outgoing-body.spec.ts`:legacy 组按**已装世代**门控
309
+ (`describe.skipIf(INSTALLED_GENERATION !== 'legacy')`),跳过时用例名里带原因。
310
+
311
+ ### 9.5 结果
312
+
313
+ | 检查 | 改前(0.2.2 树) | 改后 |
314
+ |---|---|---|
315
+ | `tsc -p tsconfig.json` | 3 处错误 | **0** |
316
+ | `tsc -p tsconfig.client.json` | 4 处错误 | **0** |
317
+ | `vitest run` | 5 failed / 1216 passed / 8 skipped | **0 failed / 1217 passed / 12 skipped** |
318
+ | `tsdown` 构建 | — | 通过 |
319
+
320
+ ### 9.6 仍然悬着的两件事
321
+
322
+ 1. **legacy 分支没有活的覆盖**:主树迁到 1.3.0 后,`adapter-outgoing-body.spec.ts`
323
+ 整份跳过。要恢复覆盖,需要像 modern 那样再立一份 **0.85.1 fixture**,
324
+ 并给 `createQoderAdapter` 开一个注入 api 的缝(当前它自己 `openAICompletionsApi()`)。
325
+ 0.1.7 宿主线仍在 peer 范围里,所以这是真缺口,不是洁癖。
326
+ 2. **中途 system 消息没有对着真网关验证过**:现在取的是保守侧(改写成
327
+ `<system-reminder>`)。若实测 Qoder 接受中途 system 角色,把
328
+ `supportsMidConvoSystemMessages` 改成 `true` 即可,无需改别处。
@@ -0,0 +1,342 @@
1
+ # DSH 0.2.2-rc.2 升级跟进调研 —— dsh-connect-qoder
2
+
3
+ > 调研日期:2026-11-12
4
+ > 宿主:DSH Desktop **`0.2.2-rc.2`**(`app.asar` 内 `@deepseek-ai/dsh-*` 全部为
5
+ > `0.2.2-rc.2`,asar sha256 `1535941c…39d`)
6
+ > 插件:`@dmh2002/dsh-connect-qoder` **1.25.0 → 1.25.1**(本轮**不改运行时代码**,只重提取夹具)
7
+ > 上一轮:[`docs/DSH-0.2.2-RC1-FOLLOWUP.md`](DSH-0.2.2-RC1-FOLLOWUP.md)(`0.2.1-rc.5` → `0.2.2-rc.1`,那一轮要改代码)
8
+
9
+ ---
10
+
11
+ ## 零、结论摘要
12
+
13
+ **结论:不需要改运行时代码,但测试夹具必须重提取 —— 宿主改写了失败分类器的判据。**
14
+
15
+ 与上一轮(rc.1,四处类型破坏)不同,`0.2.2-rc.1 → 0.2.2-rc.2` 在**插件碰到的
16
+ 每一个宿主面**上都是纯新增:`typecheck` 一次通过,`build` 一次通过。唯一的红落在
17
+ **我们自己的 golden 夹具**上:宿主把 `classifyPiAiError` 的第一道判据从「扫全串」
18
+ 改成「先取报文开头的状态码」,并引入一个新常量,而那份夹具是**手抄**下来的。
19
+
20
+ | 层 | 结论 | 所需动作 |
21
+ |---|---|---|
22
+ | `classifyPiAiError` 判据改写(新增 `LEADING_HTTP_STATUS`) | 🔴 夹具自检红(与装机宿主不再逐字一致);手工补时若漏了这个常量,`new Function` 会 `ReferenceError` | **重提取夹具**(P0,已做) |
23
+ | `dsh-llm-pi-ai`:replay 加请求前缀摘要 + `onThinkingOmitted` | 🟢 纯新增,插件不构造 replay、不传该观察点 | 无 |
24
+ | `dsh-llm`:`HarnessError` 迁到新的 `@deepseek-ai/dsh-error` | 🟢 `dsh-llm` 仍重新导出它;插件从不用错误基类 | 无(但钉了 overrides,见 §3.2) |
25
+ | `dsh-attachment`:`AttachmentError` 改继承 `HarnessError` | 🟢 `code` 与 `name` 不变;插件只 `import type` | 无 |
26
+ | `dsh-client-ui-slots`:新增 `hoc` 槽位种类 | 🟢 插件只用 `single` / `list` / `keyed` / `chain` | 无 |
27
+ | `dsh-client-ui-settings`:`openSettings(sectionId?)` | 🟢 只加了一个可选形参 | 无 |
28
+ | peer 范围覆盖 `0.2.2-rc.2` | 🟢 同一元组,**不需要新分支** | 不用改 |
29
+ | 开发依赖树 | 🟡 仍钉在 rc.1 | **升到 rc.2**(已做) |
30
+
31
+ ---
32
+
33
+ ## 一、实测环境
34
+
35
+ 宿主 `app.asar` 内 `node_modules` 的实际版本:
36
+
37
+ | 包 | 0.2.2-rc.1 | **0.2.2-rc.2(本机)** |
38
+ |---|---|---|
39
+ | `@deepseek-ai/dsh` 及全部 `dsh-*` | 0.2.2-rc.1 | **0.2.2-rc.2** |
40
+ | `@deepseek-ai/dsh-error` | 不存在(`HarnessError` 写在 `dsh-llm` 里) | **0.2.2-rc.2(新包,npm 上首个版本)** |
41
+ | `@earendil-works/pi-ai` | 1.3.0 | **1.3.0(不变)** |
42
+ | `@deepseek-ai/cordis` | 4.1.0 | **4.1.0(不变)** |
43
+ | `@deepseek-ai/schemastery` | 3.19.0 | **3.19.0(不变)** |
44
+
45
+ 也就是说:这一轮**没有换 pi-ai、没有换 cordis、没有换 schemastery**,改动全部落在
46
+ `dsh-*` 自己的声明与实现里。复现方式:
47
+
48
+ ```bash
49
+ rsync -a --exclude node_modules --exclude .git ./ /tmp/qoder022rc2/
50
+ cd /tmp/qoder022rc2
51
+ # overrides 改成 rc.2 线
52
+ rm -f pnpm-lock.yaml && pnpm install --no-frozen-lockfile
53
+ npx tsc -p tsconfig.json --noEmit # 0
54
+ npx tsc -p tsconfig.client.json --noEmit # 0
55
+ npx vitest run # 1 failed(golden 自检)→ 修夹具后 0
56
+ npx tsdown # 通过
57
+ ```
58
+
59
+ ---
60
+
61
+ ## 二、P0:宿主改写了失败分类器,夹具必须重提取
62
+
63
+ ### 症状
64
+
65
+ `pnpm test` 只有一条红,是 `tests/shim.spec.ts` 里那条**自检**:
66
+
67
+ ```
68
+ classifyPiAiError 第 38 个字符起与装机宿主不一致:
69
+ 期望 "if (/\b(?:401|403)\b/.test(message)) return \"AUT",
70
+ 实为 "const statusSource = LEADING_HTTP_STATUS.exec(me"
71
+ ```
72
+
73
+ 这不是「期望值写错了一个字」,而是判据换了一种写法:
74
+
75
+ ```js
76
+ // 0.2.2-rc.2 · app.asar
77
+ const LEADING_HTTP_STATUS = /^[45]\d\d\b/;
78
+
79
+ function classifyPiAiError(message) {
80
+ const statusSource = LEADING_HTTP_STATUS.exec(message)?.[0] ?? message;
81
+ if (/\b(?:401|403)\b/.test(statusSource)) return "AUTH";
82
+ if (isQuotaExceededError(message)) return QUOTA_EXCEEDED_CODE;
83
+ if (/\b429\b/.test(statusSource) || /rate.?limit/i.test(message)) return "RATE_LIMIT";
84
+ if (/\b413\b/.test(statusSource) || /failed to buffer …/i.test(message)) return "INVALID_REQUEST";
85
+ if (/\b400\b/.test(statusSource) || /invalid.?request/i.test(message)) return "INVALID_REQUEST";
86
+ if (/\b5\d\d\b/.test(statusSource)) return "SERVER";
87
+ …
88
+ }
89
+ ```
90
+
91
+ 宿主的意图写在源码注释里(asar 里就是这段):
92
+
93
+ > The body can quote another hop's status, such as a gateway 500 that embeds its
94
+ > upstream's 401, so when a message leads with a status the status rules read
95
+ > only that status; other wordings scan the whole message.
96
+
97
+ 即:**只有报文开头那个状态码**参与状态判断,正文里转述的别人的状态码不再参与
98
+ (但 `isQuotaExceededError` 仍然扫全串、`rate.?limit` / `invalid.?request` 也扫全串)。
99
+ 这是一次**收紧**,方向与我们的净化逻辑一致。
100
+
101
+ ### 对本插件的行为影响:零
102
+
103
+ 把插件实际会发出的文案喂给新判定逐条对比(旧 → 新):
104
+
105
+ | 文案 | 旧 | 新 |
106
+ |---|---|---|
107
+ | `qoder upstream quota-exhausted (http 4xx): … HTTP 4xx {"code":"110"…}` | `QUOTA` | `QUOTA` |
108
+ | `qoder upstream rate-limited (http 4xx): …` | `RATE_LIMIT` | `RATE_LIMIT` |
109
+ | `qoder upstream transient (http 503): provider error` | `SERVER` | `SERVER` |
110
+ | `qoder upstream invalid-request (http 400): bad` | `INVALID_REQUEST` | `INVALID_REQUEST` |
111
+ | `401 TOKEN_EXPIRE`(`auth` 档原文照送) | `AUTH` | `AUTH` |
112
+ | `未配置 Qoder PAT` | `PI_AI_ERROR` | `PI_AI_ERROR` |
113
+
114
+ 原因:`src/shim.ts` 的 `hostFailureMessage` 一直把裸 401/403 改写成 `4xx`,并给非
115
+ auth 档加 `qoder upstream <kind> (http <4xx|5xx>)` 前缀 —— 于是**文案开头就是一个
116
+ 不带 401/403 的状态码**,新判据只看它,正好落在我们早已写进文案的那条线索上。
117
+ `4xx` 不匹配 `^[45]\d\d\b`(`x` 不是数字),因此 `statusSource === message` 全串扫描,
118
+ 与旧行为一致。
119
+
120
+ ### 修法:把「重提取」变成一条命令
121
+
122
+ 漏的恰恰是「再抄一遍」这件事本身。手工补夹具时先补了两个函数、漏了新常量,
123
+ `new Function(...)` 当场 `ReferenceError: LEADING_HTTP_STATUS is not defined` ——
124
+ **这才是真正的隐患**:如果只改 `classifyPiAiError` 而不补常量,测试会以「夹具坏」
125
+ 的形式红,而不是以「与宿主不一致」的形式红,读起来像别的问题。
126
+
127
+ 所以新增 `scripts/extract-host-classifier.mjs`:
128
+
129
+ - 按**签名**定位、按**花括号配平**截取(不用「截到下一个 `\n}`」——宿主打包后缩进不统一,
130
+ 函数体里本来就有顶格的 `}`);
131
+ - 三段一起提:`LEADING_HTTP_STATUS`(只存初始化部分)、`isQuotaExceededError`、
132
+ `classifyPiAiError`;
133
+ - `--check` 只比对不写(给 CI / 非 macOS 用);
134
+ - 记录 `occurrences`,并且 `classifyPiAiError` 出现两份时**直接报错停下**——那意味着
135
+ 宿主内嵌了两代 `dsh-llm-pi-ai`,取哪一份就不再是无所谓的决定。
136
+
137
+ `package.json` 加了 `pnpm run fixture:host-classifier`,夹具里也写了 `_refresh` 字段。
138
+ 顺带补掉了 `tests/host-piai.ts` 文件头一句悬空引用(原先写「提取脚本见该文件的
139
+ `source` 字段」,而 `source` 里从来没有那个字段 —— 本仓库禁止这类引用)。
140
+
141
+ ---
142
+
143
+ ## 三、P1:变了的五个包,一个都不在插件的路径上
144
+
145
+ 逐包比对 rc.1 与 rc.2 的 tarball(`lib/types/**/*.d.ts` + `lib/index.js` + `lib/client.js`)。
146
+ 插件声明的 13 个 `dsh-*` 里实际 import 的有 11 个(`dsh-client-ui-primitives` 与
147
+ `dsh-settings` 只声明、不 import —— 前者是刻意的,见 3.4)。这 11 个里:
148
+
149
+ - **5 个有变化**:`dsh-llm`、`dsh-llm-pi-ai`、`dsh-attachment`、
150
+ `dsh-client-ui-slots`、`dsh-client-ui-settings`(下面 3.1–3.4 逐条说);
151
+ - **6 个的 `lib/types` 与 host 侧 `lib/index.js` 逐字节相同**:`dsh-atomic-write`、
152
+ `dsh-client-locale`、`dsh-client-ui-renderer`、`dsh-home-paths`、
153
+ `dsh-host-webserver`、`dsh-client-ui-settings-plugins`。
154
+
155
+ 那 6 个里,`dsh-client-locale` / `dsh-client-ui-renderer` / `dsh-client-ui-settings-plugins`
156
+ 的**浏览器半边**(`lib/client.js`)确实重新打包过(rc.2 的 tarball 开始带 `src/`,
157
+ 产物也重压了),但插件对它们的用法是 `import type {}` 的**模块增强**(给 `SlotMap`
158
+ 补声明),运行时不向它们要任何东西 —— 而且它们提供的槽与语言行契约在两边一致。
159
+
160
+ ### 3.1 `dsh-llm-pi-ai`:replay 增加请求前缀摘要
161
+
162
+ 新增 `lib/types/prefix-binding.d.ts`:
163
+
164
+ ```ts
165
+ export type PrefixDigests = Map<AssistantMessage, string>
166
+ export declare function bindThinkingToPrefix(
167
+ context: PiContext, api: Api, prefixDigests: PrefixDigests,
168
+ manualThinking: boolean, onOmitted: (count: number) => void,
169
+ ): PrefixBoundContext
170
+ ```
171
+
172
+ 配套地,`toPiReplayState(…, prefixDigest?)`、`toPiAssistant(…, prefixDigests?)`、
173
+ `toPiContext(…, prefixDigests?)`、`toStreamChunks(…, prefixDigest?)` 各加了一个
174
+ **可选**尾参,`PiAiAdapterOptions` 新增可选观察点 `onThinkingOmitted`。
175
+
176
+ 它解决的是 Anthropic 的一个真实问题:signed thinking 块绑定在「生成它时的请求前缀」
177
+ 上,压缩或裁剪工具结果后前缀变了,端点会整条拒绝请求。rc.2 的做法是给每条
178
+ assistant 响应记一个前缀摘要,重放时前缀对不上就把 signed thinking 摘掉。
179
+
180
+ **对本插件的影响:零。** 全部是可选形参;插件从不自己调 `toPiContext` /
181
+ `toPiReplayState`(它交给 `PiAiAdapter`),也不传 `onThinkingOmitted`。
182
+ `bindThinkingToPrefix` 只在 `api === 'anthropic-messages'` 时才有意义,而 Qoder 路由
183
+ 走的是 `openai-completions`。
184
+
185
+ ### 3.2 `dsh-llm`:`HarnessError` 搬到 `@deepseek-ai/dsh-error`
186
+
187
+ `lib/types/error.d.ts` 里 `HarnessError` 的定义删了,改成
188
+
189
+ ```ts
190
+ import { HarnessError } from '@deepseek-ai/dsh-error'
191
+ export { HarnessError }
192
+ ```
193
+
194
+ 即两个 import 路径指向**同一个类**。同时 `LlmError` 的构造签名收紧:
195
+ `code: string → code: BuiltinLlmFailureCode`,并新增 `LlmError.fromFailure()` 供
196
+ 「外部提供方自定义 code」的场景使用。
197
+
198
+ **对本插件的影响:零。** 插件 `import` 的 `dsh-llm` 名字只有
199
+ `resolveRetryPolicy` / `ReasoningEffortId` / `LlmModelInfo` / `LlmResolvedModelInfo` /
200
+ `PreparedAdapterCall`,从不构造 `LlmError`、也不 `instanceof HarnessError`。
201
+ 插件失败分类读的是**上游 HTTP 状态与 Qoder 业务码**,不是 `LlmError.code`
202
+ (这一点上一轮已经记过,本轮再确认一遍仍然成立 —— 所以 `LlmError` 的构造签名收紧
203
+ 不会被我们踩到)。
204
+
205
+ > 但 `@deepseek-ai/dsh-error` 现在有 `dsh-llm` 与 `dsh-attachment` 两个**精确版本**的
206
+ > peer 声明。所以 `pnpm-workspace.yaml` 里显式钉了它:将来某个包改成 `^0.2.2` 时,
207
+ > 解析出第二个副本会让 `instanceof HarnessError` 在两个类之间失效,而这正是
208
+ > 宿主用来判断「附件失败」的机制。
209
+
210
+ ### 3.3 `dsh-client-ui-slots`:新增 `hoc` 槽位种类
211
+
212
+ `SlotKind` 从 `'single' | 'list' | 'keyed' | 'chain'` 变成了再**多**一档 `'hoc'`,配套
213
+ `HocRenderOpts` / `HocShare` / `HocKeysOf` 与 `KindOptions` 的 hoc 分支。宿主用它做
214
+ 「包裹层」:`conversation.hero.frame`(包住会话滚动体)就是第一个 hoc 槽。
215
+
216
+ **对本插件的影响:零。** 插件用到的槽位全是
217
+ `conversation.input.right`(list)、`conversation.composer.dock`(list)、
218
+ `settings.section`(list)、`settings.section.icon`(list)、
219
+ `sidebar.panellist`(list)、`conversation.input.model.label`(single/keyed 运行时探测)。
220
+ `model-label-seat.ts` 的 `declaredSlotKind()` 遇到不认识的 kind 会**返回 undefined**
221
+ (落回单格形状)——所以即便哪天它读到 `'hoc'` 也不会崩,只是退回保守形状。
222
+
223
+ ### 3.4 其余「有变化但无关」
224
+
225
+ | 包 | 变化 | 为什么无关 |
226
+ |---|---|---|
227
+ | `dsh-client-ui-settings` | `SettingsLauncherOwnerProps.openSettings: () => void` → `(sectionId?: string) => void` | 只加可选形参;插件从不注册 `settings.launcher`,它跳设置页走的是 `sidebar.settings` 的 store 座位(`openSection(id)`),rc.2 里那段座位代码逐字未变 |
228
+ | `dsh-client-ui-primitives` | 删 `useAnchoredPosition` / 新增 `usePointerGrace`、`Modal.tone`、`Checkbox.modalAutofocus` | 插件**从不 import** 这个包(`src/client/popover.ts` 是本地 40 行实现,文件头写着为什么),这是刻意的,正好躲过一次被删的导出 |
229
+ | `dsh-client-ui-conversation` | 新增 `conversation.hero.frame`(hoc)、`insertQuote(text, summary?)`、`ComposerBarProps.occurrence` | 插件不碰 hero、不调 `insertQuote`、不读 `occurrence` |
230
+ | `dsh-client-ui-model-selection` | 新增 `conversation.input.model.options`(list)槽 | 新增槽;标签订阅用的 `conversation.input.model.label` 声明**没变**(仍是 `single`) |
231
+ | `dsh-client-locale` | client 产物重压过,`register` 签名逐字相同;另有新的语言行组件与 `settings-store` | rc.1 已适配过的索引签名仍够用;插件只注册自己的命名空间,不碰语言行 |
232
+ | `dsh-client-ui-settings-plugins` | client 产物重压过;`settings.plugins` / `settings.plugins.tab` 两个槽在两边一致 | 插件自 1.18.0 起不再注册这两个槽(配置搬进 `settings.section`) |
233
+
234
+ `dsh-host-webserver` / `dsh-settings` / `dsh-atomic-write` / `dsh-home-paths` 的
235
+ `lib/types` 与 `lib/index.js` 逐字节相同(rc.2 只是多发了 `.d.ts.map` 与 `src/`),
236
+ 不单独列行。
237
+
238
+ ### 3.5 有一条**看起来要改、实际不用**的
239
+
240
+ `dsh-client-ui-settings-general` 的 rc.2 client bundle 里,侧边栏设置触发器**仍是**
241
+
242
+ ```js
243
+ <button type="button" aria-haspopup="dialog" aria-expanded={open} …>
244
+ ```
245
+
246
+ 只是同一份文件里又多了一颗 `aria-haspopup="menu"` 的按钮(「发行通道」选择器)。
247
+ `src/client/settings-jump.ts` 的 `TRIGGER_SELECTOR` 是
248
+ `button[aria-haspopup="dialog"][aria-expanded]`,**不会**误命中新按钮;
249
+ `sidebar.settings` 的 store 座位(`create()` 钉在唯一活动实例上)在 rc.2 里逐字未变。
250
+ 两条路径都仍然可用。
251
+
252
+ ---
253
+
254
+ ## 四、P2:peer 范围不需要新分支(这一条要写下来,因为直觉相反)
255
+
256
+ 当前声明(`package.json` 的 `peerDependencies`):
257
+
258
+ ```
259
+ >=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
260
+ ```
261
+
262
+ `0.2.2-rc.2` 与 `0.2.2-rc.1` **同一元组**,第四支的比较符自带预发布标签,于是整个
263
+ `0.2.2` 元组都开闸。实测(node-semver 直跑):
264
+
265
+ | 版本 | 标准语义(npm/pnpm) | 宿主门禁(`includePrerelease`) |
266
+ |---|---|---|
267
+ | `0.2.2-rc.1` | true | true |
268
+ | **`0.2.2-rc.2`** | **true** | **true** |
269
+ | `0.2.3-rc.1` | false ❌ | true |
270
+
271
+ **加分支的判据是「补丁号变了」,不是「rc 号变了」** —— 上一轮为 rc.1 补分支,是因为
272
+ `0.2.2` 这个元组此前没有任何带预发布标签的比较符;现在有了,rc.2 / rc.3 / … 都跟着
273
+ 开闸。真正的下一个待办仍是 `0.2.3-rc.1`(`tests/dsh-line.spec.ts` 的
274
+ `UNGATED_PRERELEASES` 里钉着)。
275
+
276
+ 本轮在 `tests/dsh-line.spec.ts` 把 `0.2.2-rc.2` 加进 `ADMITTED_PRERELEASES` 与
277
+ 「宿主门禁覆盖整条 0.2.x」那条用例 —— **用断言把「不需要新分支」这个判断钉住**,
278
+ 免得下次升级又去手工加一支没有意义的范围。
279
+
280
+ ---
281
+
282
+ ## 五、P3:开发依赖树
283
+
284
+ `pnpm-workspace.yaml` 整体迁到 `0.2.2-rc.2`(`dsh-*` 全部、外加新钉的
285
+ `@deepseek-ai/dsh-error`)。`cordis 4.1.0` / `schemastery 3.19.0` / `pi-ai 1.3.0`
286
+ 不变 —— 宿主本来就没换。
287
+
288
+ 实测结果:
289
+
290
+ | 检查 | rc.1 树 | **rc.2 树** |
291
+ |---|---|---|
292
+ | `tsc -p tsconfig.json` | 0 | **0** |
293
+ | `tsc -p tsconfig.client.json` | 0 | **0** |
294
+ | `vitest run` | 1471 passed / 1 failed(夹具) | **1472 passed / 12 skipped / 0 failed** |
295
+ | `tsdown` | 通过 | **通过** |
296
+
297
+ (rc.1 树的 1 failed 就是本轮修掉的那条自检;跳过数两边一致,都是 `live-intl-session`
298
+ 这类需要真凭据的用例。)
299
+
300
+ ---
301
+
302
+ ## 六、明确排除的部分
303
+
304
+ - **`ResolvedPiAiProviderProfile` 的两个图片预算字段**:rc.1 补的
305
+ `maxRequestImages: 50` / `imageOffloadCountQuantum: 10` 仍然必需,rc.2 的
306
+ `resolveProfile` 里 `?? 50` / `?? Math.min(10, maxRequestImages)` 逐字未变。
307
+ - **中途 system 消息**:`conversationUpdates()` 的判据在 rc.2 里逐字未变,
308
+ 插件显式写下的 `supportsMidConvoSystemMessages: false` 仍然是「改写成
309
+ `<system-reminder>`」那一侧,与上一轮的结论一致。
310
+ - **`toolUpdate`**:插件不声明它(于是每次请求都声明完整工具表),rc.2 对
311
+ `addition-only` 的变更(`projectToolUpdates` 的注释变长了一截:重建时已激活的声明
312
+ 变成立即可用、未激活的保持延后)走不到我们这条路由。
313
+ - **窗口拖拽区域**:`v0.2.2-rc.1/window-drag-regions` 那条指南讲的是 macOS 上依赖
314
+ 「全局 no-drag 排除」的自定义浮层。本插件的积分浮层是 `position: fixed` 的
315
+ body portal,**向上**挂在输入框上方(`side: 'top'`),不会覆盖页头 —— 所以那条
316
+ 「被裁剪到视口上方的内容挡住页头拖动」的场景构造不出来;它也没有任何
317
+ `data-window-drag*`。无需声明区域。(值得注意的是这类判断**只在 macOS Desktop 上
318
+ 能看出来** —— 普通 Web 与 Windows 行为不变,CI 也测不到。)
319
+ - **`BundleInfo.update` 取代 `updatable`**:插件不调 `pluginManager.listBundles()`。
320
+ - **`AttachmentError` 错误码进 `turn/end`**:插件只 `import type { AttachmentStore }`,
321
+ 从不抛附件错误。
322
+ - **`runtime-context` 的提醒包装**:那是宿主写会话日志的形状;插件不读也不写
323
+ `runtime-context` 记录。
324
+
325
+ ---
326
+
327
+ ## 七、落地记录(2026-11-12,1.25.1)
328
+
329
+ | 项 | 改动 | 位置 |
330
+ |---|---|---|
331
+ | P0 | 新增提取脚本(按签名定位 + 花括号配平 + 唯一性检查 + `--check`) | `scripts/extract-host-classifier.mjs` |
332
+ | P0 | 夹具重提取到 rc.2:`classifyPiAiError` 新版 + `isQuotaExceededError`(逐字未变)+ `LEADING_HTTP_STATUS`(新) | `tests/fixtures/host-piai-classifier.json` |
333
+ | P0 | 自检把新常量也纳入逐字比对;`new Function` 只在夹具带该常量时才拼那一行 | `tests/host-piai.ts` |
334
+ | P0 | 补掉「提取脚本见 `source` 字段」这句悬空引用;夹具里加 `_refresh` 字段 | 同上 + 夹具 |
335
+ | P2 | `0.2.2-rc.2` 加进 `ADMITTED_PRERELEASES` 与宿主门禁那条用例(**不新增分支**,用断言钉住这个判断) | `tests/dsh-line.spec.ts` |
336
+ | P3 | overrides 整体迁到 `0.2.2-rc.2`,并显式钉 `@deepseek-ai/dsh-error` | `pnpm-workspace.yaml` |
337
+ | 工具 | `pnpm run fixture:host-classifier` | `package.json` |
338
+ | 文档 | 本文 + README 双语「当前宿主」小节 + CHANGELOG `1.25.1` | — |
339
+
340
+ **没有改 `src/` 下的任何一行。** 这一轮的结论是「宿主换的是我们没碰的面,但换到了
341
+ 我们用来做证据的那份夹具上」——值得记下来的教训不是某个字段,而是:夹具的**重提取
342
+ 必须是一条命令**,因为「再抄一遍」这件事本身会漏。