dsh-knit 0.22.0 → 0.23.1

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.
@@ -35,8 +35,6 @@ window.__ModuleLoader__.load({
35
35
  'count.code.filtered': '{hit} / {total} 个代码文件',
36
36
  'count.media': '{n} 个媒体',
37
37
  'count.media.filtered': '{hit} / {total} 个媒体',
38
- 'count.all': '{n} 项',
39
- 'count.all.filtered': '{hit} / {total} 项',
40
38
  'action.refresh': '刷新',
41
39
  'path.openTitle': '在文件管理器中打开',
42
40
  'peek.empty': '这个工作区里还没有 Markdown 文档。',
@@ -47,7 +45,6 @@ window.__ModuleLoader__.load({
47
45
  'sort.relevanceTitle': '按与当前对话的相关性排序(纯本地关键词匹配,不调模型)',
48
46
  'sort.timeTitle': '按文件修改时间倒序',
49
47
 
50
- 'kind.all': '全部',
51
48
  'kind.doc': '文档',
52
49
  // v0.19:「代码」这一档。文案口径刻意保持朴素 —— 不写「代码知识库 / AI Code
53
50
  // Intelligence / 智能代码分析」。Knit 只是把**当前任务真正需要的**代码文件
@@ -146,6 +143,9 @@ window.__ModuleLoader__.load({
146
143
  'prov.retrieval': '检索',
147
144
  'prov.relation': '关系',
148
145
  'prov.manual': '用户固定',
146
+ // v0.23:第四档来源。它**只**由「标题 + 摘要」的向量与任务相似而来 ——
147
+ // 不是关键词命中、也不是关系证据,而且只可能落在「相关」那一层。
148
+ 'prov.semantic': '语义相关',
149
149
  'control.pin': '固定',
150
150
  'control.unpin': '取消固定',
151
151
  'control.exclude': '排除',
@@ -169,7 +169,7 @@ window.__ModuleLoader__.load({
169
169
  // v0.21.x(2026-10-09 用户规格):排除之后的候选数原来是一个**光数字**(只有
170
170
  // 「→ 79」),现在给它一个名字 —— 状态摘要里每一格都必须能独立读懂。
171
171
  'pipe.candidates': '候选 {n}',
172
- 'pipe.rank': 'BM25 词法检索',
172
+ 'pipe.rank': 'BM25 检索',
173
173
  // ⚠️ 「关系 N 条」说的是**这一份包里带了几条关系证据**(三层各条 relations 之和),
174
174
  // 不是工作区里的关系总数、也不是候选数(那两类数字宿主另有字段,这里不展示)。
175
175
  'pipe.relations': '关系 {n} 条',
@@ -177,6 +177,59 @@ window.__ModuleLoader__.load({
177
177
  // 不写「固定覆盖」这种内部说法;也不带量词 —— 固定对象可能是文档、代码或媒体。
178
178
  'pipe.pin': '固定 {n}',
179
179
  'pipe.pack': '入包 {n}',
180
+ // v0.23(Phase A):混合检索。**默认词法** —— 这一格说的是实际生效的模式,不是用户的点击。
181
+ 'pipe.rankHybrid': 'BM25 + 语义补充',
182
+ // 语义候选**只计数**(Phase A 不进包)。它是「有界」的:上限由消融定(方案 §5.2)。
183
+ 'pipe.semantic': '语义候选 {n} 条',
184
+ // 检索模式选择器(工具栏第三组)
185
+ 'sem.mode.aria': '检索模式',
186
+ 'sem.mode.lexical': '词法',
187
+ 'sem.mode.hybrid': '混合',
188
+ 'sem.mode.lexicalTitle': '词法检索:BM25 + IDF,纯本地、零模型调用(默认)',
189
+ 'sem.mode.hybridTitle': '混合检索(实验):在词法候选之外补充语义候选;需要先配置 provider',
190
+ // ⚠️ 2026-10-13:原来的 sem.mode.lexicalShort / hybridShort 两个**短标签键已删除** ——
191
+ // 检索方式的可见文案改成状态行的 pipe.rank / pipe.rankHybrid(实际生效的模式),
192
+ // 键留着只会变成没人渲染的死键(i18n 的键集对齐守卫也查不出「定义了但没人用」)。
193
+ // 菜单里两个选项的副文案(长解释收进菜单,工具栏不再挤第三组)
194
+ 'sem.mode.lexicalOption': '词法检索',
195
+ 'sem.mode.hybridOption': '混合检索 · 实验',
196
+ 'sem.mode.lexicalDesc': '默认模式;沿用当前 BM25 + IDF 排序。',
197
+ 'sem.mode.hybridDesc': '在词法候选之外补充语义候选;需先配置 provider。',
198
+ // 菜单底部的**状态行**(如实说这一档现在到底生效成什么,不美化)
199
+ 'sem.state.lexical': '当前按词法检索。',
200
+ 'sem.state.hybridLive': '混合已生效:语义候选只追加在「相关」层最后,主要 / 辅助两层不动。',
201
+ 'sem.state.noProvider': '未配置 provider —— 混合还没生效。',
202
+ // 就地配置入口(未配 provider 时菜单里那一条)
203
+ 'sem.cfg.show': '配置语义 provider…',
204
+ 'sem.cfg.hide': '收起配置',
205
+ // 混合没生效时的**事实**(宿主只给码,文案在这里)
206
+ 'sem.reason.noProvider': '混合检索不可用:还没有配置 provider',
207
+ 'sem.reason.probeFailed': '混合检索不可用:provider 连不上',
208
+ 'sem.reason.timeout': '混合检索不可用:provider 超时',
209
+ 'sem.reason.badResponse': '混合检索不可用:provider 返回了无法解析的结果',
210
+ 'sem.reason.noQuery': '混合检索不可用:这一轮没有可用的查询文本',
211
+ 'sem.reason.unknown': '混合检索不可用:原因未知(已退回词法)',
212
+ // 防御性:时间序下宿主整层短路,回的是这个码(界面极少走到 —— 那档根本不出现这个下拉)
213
+ 'sem.reason.notApplicable': '混合检索不适用:时间序没有相关性分层(已按词法)',
214
+ // 老宿主没有 `semantic` 字段 ⇒ 如实说是宿主的问题,不让用户去配一个用不上的 provider
215
+ 'sem.unsupported': '混合检索不可用:当前宿主版本不支持(已退回词法)',
216
+ // 最小配置区(就地一行,不是面板)
217
+ 'sem.kindAria': 'provider 类型',
218
+ 'sem.kind.ollama': 'Ollama(本地)',
219
+ 'sem.kind.openai': 'OpenAI 兼容',
220
+ 'sem.basePlaceholder': '服务地址,如 http://127.0.0.1:11434',
221
+ 'sem.baseAria': 'provider 服务地址',
222
+ 'sem.modelPlaceholder': '模型名,如 nomic-embed-text',
223
+ 'sem.modelAria': 'provider 模型名',
224
+ 'sem.save': '保存并测试',
225
+ 'sem.saving': '测试中…',
226
+ 'sem.saveTitle': '保存配置并让宿主探测一次(会发一次请求)',
227
+ 'sem.savedOk': '已保存:provider 可用',
228
+ 'sem.savedFail': '已保存,但 provider 现在还不可用',
229
+ // ⚠️ 披露措辞不许含糊:回环 = 不离开本机;其余一律明写「会发送到 <地址>」
230
+ 'sem.disclose.local': '本地服务:内容不离开这台机器',
231
+ 'sem.disclose.empty': '填上服务地址后,这里会写明内容会不会离开这台机器',
232
+ 'sem.disclose.remote': '内容会发送到你配置的服务 {base}',
180
233
  // 理由码 → 文案。宿主只给码(AGENTS.md §4.5),翻译在这里。
181
234
  // ⚠️ 2026-09-29 用户要求把这行压得更克制:原来是「直接命中当前话题:…」,
182
235
  // 读起来像调试信息。现在它是**标签 + 值**,词之间用「 · 」分隔。
@@ -200,6 +253,9 @@ window.__ModuleLoader__.load({
200
253
  'why.linkTarget': '被主要上下文引用',
201
254
  'why.linkSource': '引用了主要上下文',
202
255
  'why.related': '与当前任务相关',
256
+ // v0.23:语义补进来的理由。**只陈述可复核的事实**(标题 + 摘要的向量与任务相似),
257
+ // 不许写成「模型觉得相关」这类不可核查的话。
258
+ 'why.semantic': '语义相关',
203
259
 
204
260
  'row.tooltip': '{path}\n单击就地预览 · 双击在新标签页打开',
205
261
  /* v0.20:命中片段(需求 §12)。**纯 metadata**:行号区间,不是分数、不是评分、
@@ -229,8 +285,6 @@ window.__ModuleLoader__.load({
229
285
  'media.play': '播放视频',
230
286
 
231
287
  // 「全部」的分区:类型名复用 kind.doc / kind.media,这里只补计数与跳转
232
- 'section.count': '{shown} / {total}',
233
- 'section.more': '查看全部 →',
234
288
 
235
289
  'preview.loading': '正在读取…',
236
290
  'preview.truncated': '(文件较大,仅预览前 512 KB)',
@@ -314,8 +368,6 @@ window.__ModuleLoader__.load({
314
368
  'count.code.filtered': '{hit} / {total} code files',
315
369
  'count.media': '{n} media',
316
370
  'count.media.filtered': '{hit} / {total} media',
317
- 'count.all': '{n} items',
318
- 'count.all.filtered': '{hit} / {total} items',
319
371
  'action.refresh': 'Refresh',
320
372
  'path.openTitle': 'Open in file manager',
321
373
  'peek.empty': 'No Markdown documents in this workspace yet.',
@@ -326,7 +378,6 @@ window.__ModuleLoader__.load({
326
378
  'sort.relevanceTitle': 'Sort by relevance to the current conversation (local keyword matching, no model call)',
327
379
  'sort.timeTitle': 'Sort by file modified time, newest first',
328
380
 
329
- 'kind.all': 'All',
330
381
  'kind.doc': 'Docs',
331
382
  'kind.code': 'Code',
332
383
  // 2026-10-06: user picked 「媒体」 for the tab + the "All" section title, so English
@@ -412,6 +463,8 @@ window.__ModuleLoader__.load({
412
463
  'prov.retrieval': 'retrieved',
413
464
  'prov.relation': 'relation',
414
465
  'prov.manual': 'pinned',
466
+ // v0.23: the fourth provenance (semantic) — same neutral, lowercase word group.
467
+ 'prov.semantic': 'semantic',
415
468
  'control.pin': 'Pin',
416
469
  'control.unpin': 'Unpin',
417
470
  'control.exclude': 'Exclude',
@@ -429,10 +482,50 @@ window.__ModuleLoader__.load({
429
482
  'pipe.collect': '{n} collected',
430
483
  'pipe.exclude': '{n} excluded',
431
484
  'pipe.candidates': '{n} candidates',
432
- 'pipe.rank': 'BM25 lexical retrieval',
485
+ 'pipe.rank': 'BM25 retrieval',
433
486
  'pipe.relations': '{n} relations',
434
487
  'pipe.pin': '{n} pinned',
435
488
  'pipe.pack': '{n} in pack',
489
+ // v0.23 (Phase A): hybrid retrieval. This cell states the mode **in effect**, not the click.
490
+ 'pipe.rankHybrid': 'BM25 + semantic',
491
+ 'pipe.semantic': '{n} semantic candidates',
492
+ 'sem.mode.aria': 'Retrieval mode',
493
+ 'sem.mode.lexical': 'Lexical',
494
+ 'sem.mode.hybrid': 'Hybrid',
495
+ 'sem.mode.lexicalTitle': 'Lexical retrieval: BM25 + IDF, fully local, no model call (default)',
496
+ 'sem.mode.hybridTitle': 'Hybrid retrieval (experimental): adds semantic candidates on top of lexical ones; needs a configured provider',
497
+ 'sem.mode.lexicalOption': 'Lexical retrieval',
498
+ 'sem.mode.hybridOption': 'Hybrid retrieval · experimental',
499
+ 'sem.mode.lexicalDesc': 'Default: keeps the current BM25 + IDF ranking.',
500
+ 'sem.mode.hybridDesc': 'Adds semantic candidates on top of the lexical ones; needs a configured provider.',
501
+ 'sem.state.lexical': 'Currently lexical retrieval.',
502
+ 'sem.state.hybridLive': 'Hybrid is live: semantic candidates are appended to the related tier only; primary and supporting are unchanged.',
503
+ 'sem.state.noProvider': 'No provider configured — hybrid is not active yet.',
504
+ 'sem.cfg.show': 'Configure semantic provider…',
505
+ 'sem.cfg.hide': 'Hide configuration',
506
+ 'sem.reason.noProvider': 'Hybrid retrieval unavailable: no provider configured yet',
507
+ 'sem.reason.probeFailed': 'Hybrid retrieval unavailable: provider is unreachable',
508
+ 'sem.reason.timeout': 'Hybrid retrieval unavailable: provider timed out',
509
+ 'sem.reason.badResponse': 'Hybrid retrieval unavailable: provider returned an unusable response',
510
+ 'sem.reason.noQuery': 'Hybrid retrieval unavailable: no usable query text this round',
511
+ 'sem.reason.unknown': 'Hybrid retrieval unavailable: unknown reason (fell back to lexical)',
512
+ 'sem.reason.notApplicable': 'Hybrid retrieval does not apply: a time-ordered list has no relevance tiers (kept lexical)',
513
+ 'sem.unsupported': 'Hybrid retrieval unavailable: this host version does not support it (fell back to lexical)',
514
+ 'sem.kindAria': 'Provider kind',
515
+ 'sem.kind.ollama': 'Ollama (local)',
516
+ 'sem.kind.openai': 'OpenAI-compatible',
517
+ 'sem.basePlaceholder': 'Service URL, e.g. http://127.0.0.1:11434',
518
+ 'sem.baseAria': 'Provider service URL',
519
+ 'sem.modelPlaceholder': 'Model name, e.g. nomic-embed-text',
520
+ 'sem.modelAria': 'Provider model name',
521
+ 'sem.save': 'Save and test',
522
+ 'sem.saving': 'Testing…',
523
+ 'sem.saveTitle': 'Save the configuration and let the host probe it once (sends one request)',
524
+ 'sem.savedOk': 'Saved: provider is available',
525
+ 'sem.savedFail': 'Saved, but the provider is still unavailable',
526
+ 'sem.disclose.local': 'Local service: content stays on this machine',
527
+ 'sem.disclose.empty': 'Once a service URL is filled in, this line says whether content leaves this machine',
528
+ 'sem.disclose.remote': 'Content will be sent to your configured service {base}',
436
529
  // Reason codes → copy. The host only ships codes (AGENTS.md §4.5).
437
530
  // ⚠️ Flattened on 2026-09-29: "direct topic match: …" read like debug output.
438
531
  'why.direct': 'direct match: {term}',
@@ -445,6 +538,9 @@ window.__ModuleLoader__.load({
445
538
  'why.linkTarget': 'referenced by a primary document',
446
539
  'why.linkSource': 'references a primary document',
447
540
  'why.related': 'related to the current task',
541
+ // v0.23: semantic match — states the verifiable fact (title + summary embedding),
542
+ // never "the model thinks this is relevant".
543
+ 'why.semantic': 'semantic match',
448
544
 
449
545
  'row.tooltip': '{path}\nClick to preview here · double-click to open in a new tab',
450
546
  /* v0.20:matched passage range (requirement §12) — metadata only, never a score. */
@@ -474,8 +570,6 @@ window.__ModuleLoader__.load({
474
570
  'media.play': 'Play video',
475
571
 
476
572
  // "All" sections: titles reuse kind.doc / kind.media, only count + jump live here
477
- 'section.count': '{shown} / {total}',
478
- 'section.more': 'View all →',
479
573
 
480
574
  'preview.loading': 'Loading…',
481
575
  'preview.truncated': '(large file — showing the first 512 KB)',
@@ -691,6 +785,14 @@ window.__ModuleLoader__.load({
691
785
  */
692
786
  const USAGE_KEY = 'dsh-knit:usage'
693
787
 
788
+ /* ── v0.23(Phase A):检索模式 ──────────────────────────
789
+ 默认**词法**。「混合」只是把语义候选**补进候选集**的一种可选模式,
790
+ 它要用户显式选、并且配了 provider 才会真的跑 —— 「零模型调用 / 零网络出口」
791
+ 这条对外承诺只在默认模式成立(细则见 v0.23 方案 §2 的文案纪律)。 */
792
+ const RETRIEVAL_KEY = 'dsh-knit:retrieval'
793
+ /** 语义 provider 的**唯一写路由**;读走 `/api/recent` 的 `semantic.provider`。 */
794
+ const SEMANTIC_API = '/knit/api/semantic'
795
+
694
796
  /** 列表类型:仅文档 / 仅代码 / 仅图片视频 / 全部混排。默认 doc,与旧版体验一致。 */
695
797
  const KIND_DOC = 'doc'
696
798
  /**
@@ -701,7 +803,6 @@ window.__ModuleLoader__.load({
701
803
  */
702
804
  const KIND_CODE = 'code'
703
805
  const KIND_MEDIA = 'media'
704
- const KIND_ALL = 'all'
705
806
 
706
807
  /**
707
808
  * v0.19:分类层给的「生成产物」档(`.map` / `*.min.js` / `package-lock.json` …)。
@@ -738,9 +839,10 @@ window.__ModuleLoader__.load({
738
839
  ⚠️ 留着一套只服务于已删 UI 的常量,下一个人只会以为它还在生效。 */
739
840
 
740
841
  /** 「全部」视图里文档区的固定上限。 */
741
- const ALL_DOC_CAP = 4
842
+ /* v0.23(方案 A):「全部」档的**两个类型上限**已整体删除 ——
843
+ 「全部」不再是「文档前 4 + 代码前 4 + 媒体」,而是**整份包的原样**
844
+ (三层混排文档 + 代码,媒体在三层之后一个不截断的网格)。 */
742
845
  /** 「全部」视图里代码区的固定上限(与文档区同量级 —— 代码不该在这一档里压过文档)。 */
743
- const ALL_CODE_CAP = 4
744
846
  /**
745
847
  * 一屏基准:两行 × 4 列的观感(只在「媒体」这一档决定一屏铺几行时用)。
746
848
  * **它不决定列数** —— 列数交给 CSS 的 `auto-fill`,见 mediaLayoutFor。
@@ -918,16 +1020,43 @@ body[data-ds-dark-theme] .knit-root{
918
1020
  外框、.knit-seg 内部竖线、.knit-filter。CSS 里统一写 0.5px(与官方 .wSkVaW_header 的 .5px 同值)。
919
1021
  ⚠️ 选中态只改**底色 + 字重 600**(不是 700),hover 只改底色 —— 不许 scale / translate /
920
1022
  box-shadow(md §五)。暗色下靠 --knit-active-bg 这个 token,不写死颜色。
921
- ⚠️ 2026-10-09(v0.21.x 用户规格):这一行现在是**三组一行**,顺序就是控件顺序,
922
- 别再挪 —— ① 排序「相关 / 最新」(灰底分段控件)② 一条浅灰竖线
923
- ③ 类型「文档 / 代码 / 媒体 / 全部」(下划线页签)④ 搜索框(排尾、贴右、宽度自适应)。
1023
+ ⚠️ 2026-10-09(v0.21.x 用户规格)/ 2026-10-12(v0.23.1 用户裁决):这一行是
1024
+ **两组 + 一个右对齐容器**,顺序就是控件顺序,别再挪 —— ① 排序「相关 / 最新」(灰底分段控件)
1025
+ ② 一条浅灰竖线 ③ 类型「文档 / 代码 / 媒体」(下划线页签,**三档**)
1026
+ ④ .knit-bar-right:检索模式小下拉(只在相关档出现)+ 搜索框(贴右、宽度自适应、唯一可伸缩项)。
924
1027
  那根竖线是**边界**,不是把六个选项连成一个整体:排序与类型是两个互不干扰的条件,
925
1028
  搜索只过滤当前范围、不重置它们(用户规格 §三.3)。 */
926
1029
  .knit-bar{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none}
927
- /* 排序组与类型组之间**就这一根线**(用户规格 §二.2:中间用一条浅灰竖线与排序区隔开)。
928
- 色号取 .knit-seg 外框、.knit-filter 描边同一个 border-l3 ⇒ 三处一样淡;粗细写 1px ——
929
- 0.5px 的竖线在高分屏上会淡到看不见,它不是描边而是分隔。纯装饰:aria-hidden。 */
930
- .knit-bar-sep{flex:none;width:1px;height:16px;background:var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
1030
+ /* v0.23(Phase A):检索模式的两条行 —— 都只在**用户选了混合**时出现,默认词法时一个节点都不产生。
1031
+ ① .knit-retnote = 混合没生效时的**事实行**(未配置 / 连不上 / 超时 / 返回不合法 / 没有可用查询文本 /
1032
+ 宿主版本较旧)。它是说明,不是错误提示,所以用次级文字色、不占卡片、不弹窗。
1033
+ ② .knit-semcfg = 「选了混合 + provider 不可用」时**就地**展开的一行最小配置。
1034
+ 不是 Dashboard、不加滚动容器;三格控件都 flex:0/1 + min-width:0,窄面板先缩输入框。 */
1035
+ /* 检索模式那两组控件(工具栏第三组 / 配置区的 provider 类型)用**自己的类名**:
1036
+ 样式与 .knit-seg / .knit-seg-btn **逐字同值**(同一套 token、同一组数值、同一档 0.5px 描边),
1037
+ 只是它们是**另一个控件** —— 用同一个类名会让「工具栏里恰好两个排序按钮」那类老守卫
1038
+ 在查询 knit-seg-btn 时把检索模式的按钮也算进去。
1039
+ ⚠️ 这段注释里不许出现反引号 —— 整个 CSS 在一个模板串里,一个反引号就会提前截断它。 */
1040
+ .knit-retseg{display:inline-flex;flex:none;border-radius:10px;overflow:hidden;
1041
+ border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
1042
+ .knit-retseg-btn{height:28px;padding:0 15px;cursor:pointer;font-size:13px;font-weight:400;
1043
+ border:none;background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6);
1044
+ transition:background .16s ease,color .16s ease}
1045
+ .knit-retseg-btn + .knit-retseg-btn{border-left:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
1046
+ .knit-retseg-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
1047
+ .knit-retseg-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
1048
+ color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
1049
+ .knit-retnote{flex:none;padding:0 12px 8px;font-size:11px;line-height:1.5;
1050
+ color:var(--dsw-alias-label-secondary,#9aa0a6)}
1051
+ .knit-semcfg{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none;flex-wrap:wrap}
1052
+ .knit-semcfg-input{flex:1 1 140px;min-width:0;max-width:240px;height:28px;padding:0 12px;border-radius:10px;
1053
+ font-size:13px;background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);
1054
+ border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
1055
+ .knit-semcfg-note{flex:1 1 100%;font-size:11px;line-height:1.5;color:var(--dsw-alias-label-secondary,#9aa0a6)}
1056
+ /* 排序组与类型组之间**不再有竖线**(2026-10-12 用户裁决:「最新跟文档之间那条竖线可以去掉」)——
1057
+ 那根线的节点、类名与 CSS 规则**整体删除**,两组现在只靠 .knit-bar 的 gap 分隔。
1058
+ 留档:从前那根线取 .knit-seg 外框 / .knit-filter 描边同一个 border-l3(三处一样淡)、
1059
+ 粗细 1px(0.5px 在高分屏上看不见)、纯装饰 aria-hidden —— 这些理由随它一起作废。 */
931
1060
  .knit-seg{display:inline-flex;flex:none;border-radius:10px;overflow:hidden;
932
1061
  border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
933
1062
  .knit-seg-btn{height:28px;padding:0 15px;cursor:pointer;font-size:13px;font-weight:400;
@@ -940,12 +1069,76 @@ body[data-ds-dark-theme] .knit-root{
940
1069
  /* 搜索框在工具栏**尾部**(用户规格 §二.3:搜索是对当前列表的进一步过滤,放最右符合
941
1070
  工具栏惯例)。flex-basis 180px + grow ⇒ 常规面板里就是 180–240px 并贴住右边;
942
1071
  max-width 240px 封顶之后剩下的空间交给 margin-left:auto(否则它会一路长到面板边缘)。
943
- ⚠️ min-width:0 = 面板窄了**先缩搜索框**;前面两组都 flex:none,永远不被它挤。 */
944
- .knit-filter{flex:1 1 180px;min-width:0;max-width:240px;margin-left:auto;height:28px;padding:0 12px;border-radius:10px;font-size:13px;
945
- background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);
946
- border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));outline:none;
1072
+ ⚠️ min-width:0 = 面板窄了**先缩搜索框**;前面两组都 flex:none,永远不被它挤。
1073
+ v0.23(2026-10-11 用户裁决):描边从 input 挪到**外层容器** —— 因为检索模式那个小下拉
1074
+ 就贴在容器右端(中间一条细左线),两者共用一圈描边才像一个整体控件。
1075
+ 焦点态挪到 :focus-within(输入框与下拉谁拿到焦点,外框都亮)—— 行为与原来一致。 */
1076
+ /* v0.23.1:右侧两个控件的**右对齐容器** —— 检索模式在搜索框左边。
1077
+ margin-left:auto 从搜索框移交到这里;容器自身可缩(min-width:0),
1078
+ 里面**只有搜索框**是 flex:1 1 的可伸缩项 ⇒ 窄屏先缩搜索框。
1079
+ ⚠️ 这段注释里不许出现反引号 —— 整个 CSS 在一个模板串里。 */
1080
+ .knit-bar-right{display:flex;align-items:center;gap:8px;margin-left:auto;min-width:0;justify-content:flex-end}
1081
+ .knit-searchwrap{display:flex;align-items:center;flex:1 1 180px;min-width:0;max-width:240px;
1082
+ border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));border-radius:10px;
947
1083
  transition:border-color .16s ease}
948
- .knit-filter:focus{border-color:var(--knit-accent)}
1084
+ .knit-searchwrap:focus-within{border-color:var(--knit-accent)}
1085
+ .knit-filter{flex:1 1 auto;min-width:0;height:28px;padding:0 12px;border:none;border-radius:10px;font-size:13px;
1086
+ background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);outline:none}
1087
+ /* v0.24(2026-10-12 用户裁决 + Demo 参考):检索方式做成状态行里**可点的状态格**。
1088
+ 外观(2026-10-12 第三次裁决,用户:「UI 视觉参考命中段那种来修改」):
1089
+ **逐条对齐 .knit-hit(命中段)那套** —— 这是同一份视觉语言的复用,不是新造一个控件:
1090
+ · 底 = --knit-chip-bg(三档灰底里最深那档,命中段同源;比行选中那档深一点);
1091
+ · 圆角 6px、内边距 1px 6px、描边一根都没有(与命中段逐字同值);
1092
+ · 字色 = 次级灰,hover / 键盘焦点 → 主文本色 + 下划线(命中段同款提示);
1093
+ · **字号 / 行高 / 字重与命中段逐字同值**(font:inherit + font-size:11px + line-height:15px、
1094
+ 不设 font-weight ⇒ 跟随所在行):2026-10-13 用户裁决「字号与背景胶囊修改成命中段一样」。
1095
+ ⚠️ 这一格因此比它所在的状态行(10.5px)**大 0.5px** —— 那是有意的:它是这一行里唯一的可点控件,
1096
+ 与命中段同一档,才让人一眼认出「这两处是同一类东西」。 */
1097
+ .knit-pipe-method-wrap{position:relative;flex:none}
1098
+ .knit-pipe-method{display:inline-flex;align-items:center;flex:none;white-space:nowrap;cursor:pointer;
1099
+ padding:1px 6px;border:0;outline:none;border-radius:6px;
1100
+ background:var(--knit-chip-bg,rgba(255,255,255,.12));
1101
+ font:inherit;font-size:11px;line-height:15px;
1102
+ color:var(--dsw-alias-label-secondary,#61666b)}
1103
+ /* 悬停只提亮颜色;**下划线给包文字的那一层**,不给按钮本身 ——
1104
+ 父级的 text-decoration 会传播到全部子节点、子级又无法取消,
1105
+ 所以写在按钮上会让箭头 › 也一起被划上(2026-10-13 用户裁决)。 */
1106
+ .knit-pipe-method:hover,.knit-pipe-method:focus-visible{color:var(--dsw-alias-label-primary,#e8eaed)}
1107
+ .knit-pipe-method:hover .knit-pipe-method-label,
1108
+ .knit-pipe-method:focus-visible .knit-pipe-method-label{text-decoration:underline}
1109
+ .knit-pipe-method[aria-expanded="true"]{color:var(--dsw-alias-label-primary,#e8eaed)}
1110
+ /* 箭头:与「最近读取」行最右端那个 › 同一套视觉语言(同字形),基础态旋转 90° 变成「朝下」。
1111
+ ⚠️ 展开态用 **横向翻转 scaleX(-1)**,不是对调角度、也不是 scaleY(-1)(2026-10-13 用户裁决:
1112
+ 「修改成横向翻转……默认箭头向下,交互展开箭头向上」)。
1113
+ · 对调成 rotate(-90deg) ⇒ 箭头在 0.14s 里**原地转 180°**(像风车),读起来是「在转」;
1114
+ · **scaleY(-1) 是空操作** —— › 这个字形本来就沿水平轴对称,上下镜像后一模一样,
1115
+ 矩阵算出来仍是朝下(曾经写错过一次,被用户当场抓到,现在有几何守卫盯着);
1116
+ · scaleX(-1) 才是「同一个字形左右翻个面」:先把 › 镜像成 ‹,再转 90° ⇒ 朝上。
1117
+ ⇒ 关=朝下、开=朝上,过程是横向翻转。 */
1118
+ .knit-pipe-method-go{display:inline-block;margin-left:3px;font-size:12px;line-height:1;
1119
+ transform:rotate(90deg);transition:transform .14s ease}
1120
+ .knit-pipe-method[aria-expanded="true"] .knit-pipe-method-go{transform:rotate(90deg) scaleX(-1)}
1121
+ @media (prefers-reduced-motion:reduce){.knit-pipe-method-go{transition:none}}
1122
+ .knit-retmenu{position:absolute;left:0;top:22px;z-index:20;width:272px;padding:6px;text-align:left;
1123
+ background:var(--dsw-alias-bg-base,#151517);border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));
1124
+ border-radius:10px;box-shadow:0 10px 26px rgba(0,0,0,.28)}
1125
+ /* 菜单里那两个可选项:**沿用命中段那套**(2026-10-12 用户裁决「对,就这样修改」)——
1126
+ 圆角 6px(命中段同值)、选中态底 = --knit-chip-bg(命中段那档);
1127
+ 菜单**面板本身**仍是浮层(bg-base + l3 描边 + 阴影 + 10px 圆角):浮层必须读起来像浮层,
1128
+ 把它也压成灰胶囊就没有层级了。 */
1129
+ .knit-retmenu-item{display:block;width:100%;text-align:left;cursor:pointer;padding:8px 9px;border-radius:6px;
1130
+ border:none;background:transparent;color:var(--dsw-alias-label-primary,#e8eaed)}
1131
+ .knit-retmenu-item:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
1132
+ .knit-retmenu-item.active{background:var(--knit-chip-bg,rgba(255,255,255,.12))}
1133
+ .knit-retmenu-item strong{display:block;font-size:12.5px;font-weight:600}
1134
+ .knit-retmenu-item span{display:block;margin-top:3px;font-size:11px;line-height:1.5;
1135
+ color:var(--dsw-alias-label-secondary,#9aa0a6)}
1136
+ .knit-retmenu-note{margin-top:4px;padding:7px 9px 4px;font-size:11px;line-height:1.5;
1137
+ border-top:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));
1138
+ color:var(--dsw-alias-label-secondary,#9aa0a6)}
1139
+ .knit-retmenu-cfg{display:block;width:100%;text-align:left;cursor:pointer;padding:7px 9px;border:none;
1140
+ border-radius:6px;background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);font-size:12px}
1141
+ .knit-retmenu-cfg:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
949
1142
  .knit-filter::placeholder{color:var(--dsw-alias-label-caption,#80868b)}
950
1143
  /* v0.15「使用情况」→ v0.18「Context Usage Lens」:**列表上方的一块轻量观察层**。
951
1144
  不是弹窗、不是新页面、不是 Dashboard、不画卡片、不画进度条、不用品牌色。
@@ -1535,7 +1728,7 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
1535
1728
  2px 下划线表达,页签条本身不画线(也不是「下划线悬空」:它画在自己的文字下面)。
1536
1729
  ⚠️ 排序切换(.knit-seg-btn,Design §18)是**另一个控件**,它保持灰底不变。
1537
1730
  ⚠️ 2026-10-09(v0.21.x 用户规格):这一组从**自己一行**搬进了 .knit-bar,排在排序组
1538
- 右边、与它之间隔一根 .knit-bar-sep。于是这里**不再自带左右 12px 内边距**(那是
1731
+ 右边(2026-10-12 起中间**没有竖线了** —— 靠 .knit-bar 的 gap 分开)。于是这里**不再自带左右 12px 内边距**(那是
1539
1732
  .knit-bar 的事,再写一遍就是双重缩进、两组对不齐)。下划线式选中态**保持不变** ——
1540
1733
  用户这次说「选中项用浅色背景或文字强调即可」,下划线 + 主色文字正是「文字强调」,
1541
1734
  而且它覆盖 2026-09-29 那条「不要灰底」的裁决,不要因为并排就退回灰底按钮。 */
@@ -1577,7 +1770,6 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
1577
1770
  padding:8px 12px 16px;align-content:start;min-height:0}
1578
1771
  /* 分区里的网格:不留内边距。滚动一律交给 .knit-list,网格自己**不滚** ——
1579
1772
  嵌套滚动会在「全部」里变成滚动陷阱,而且封顶高度必然截断最后一行。 */
1580
- .knit-media-grid.in-section{padding:0}
1581
1773
  .knit-media-card{min-width:0;cursor:pointer;border-radius:10px}
1582
1774
  .knit-media-thumbbox{position:relative;width:100%;height:var(--knit-media-cell,auto);aspect-ratio:1/1;
1583
1775
  border-radius:9px;overflow:hidden;
@@ -1610,16 +1802,6 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
1610
1802
  background:rgba(0,0,0,.7);color:#fff;font-size:10px;line-height:1.5;font-variant-numeric:tabular-nums;
1611
1803
  pointer-events:none}
1612
1804
 
1613
- /* ── 「全部」按类型分上下两区(文档 / 图片与视频)──── */
1614
- .knit-section{display:flex;flex-direction:column;gap:6px}
1615
- .knit-section-head{display:flex;align-items:center;gap:6px;padding:0 2px}
1616
- .knit-section-title{font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary,#9aa0a6)}
1617
- .knit-section-count{font-size:10.5px;color:var(--dsw-alias-label-caption,#80868b);
1618
- font-variant-numeric:tabular-nums}
1619
- .knit-section-more{margin-left:auto;flex:none;padding:0;border:none;background:transparent;
1620
- cursor:pointer;font-family:inherit;font-size:10.5px;color:var(--knit-accent)}
1621
- .knit-section-more:hover{text-decoration:underline}
1622
-
1623
1805
  /* ── 预览面板里的图片 / 视频 ───────────────────────── */
1624
1806
  .knit-preview-body.is-media{display:flex;align-items:center;justify-content:center;
1625
1807
  padding:12px;background:rgba(0,0,0,.22)}
@@ -1723,11 +1905,14 @@ video.knit-preview-media{width:100%;background:#000}
1723
1905
 
1724
1906
  /**
1725
1907
  * 读上次选择的列表类型,非法值回落到 doc。
1726
- * @returns {'doc'|'media'|'all'} 类型
1908
+ *
1909
+ * v0.23.1:「全部」档已整体删除 ⇒ 白名单里的 `'all'` 也删掉 ——
1910
+ * 老用户 localStorage 里存着 `'all'` 时**回落到 `文档`**(不空白、不抛)。
1911
+ * @returns {'doc'|'code'|'media'} 类型
1727
1912
  */
1728
1913
  function readKindPref() {
1729
1914
  const v = readPref(KIND_KEY)
1730
- return v === KIND_MEDIA || v === KIND_ALL || v === KIND_CODE ? v : KIND_DOC
1915
+ return v === KIND_MEDIA || v === KIND_CODE ? v : KIND_DOC
1731
1916
  }
1732
1917
 
1733
1918
  /**
@@ -1738,6 +1923,60 @@ video.knit-preview-media{width:100%;background:#000}
1738
1923
  return readPref(USAGE_KEY) === '1'
1739
1924
  }
1740
1925
 
1926
+ /**
1927
+ * 读用户上次选的检索模式。**没写过、写坏了都回词法**(默认值是安全的那一个)。
1928
+ * @returns {'lexical'|'hybrid'} 检索模式
1929
+ */
1930
+ function readRetrievalPref() {
1931
+ return readPref(RETRIEVAL_KEY) === 'hybrid' ? 'hybrid' : 'lexical'
1932
+ }
1933
+
1934
+ /**
1935
+ * provider 地址是不是**本机回环**。只有回环才敢说「内容不离开这台机器」;
1936
+ * 其它(含空地址)一律按「会发送到你配置的服务」披露 —— 宁可说得重一点。
1937
+ * @param {string} base - 服务地址
1938
+ * @returns {boolean} 是否回环
1939
+ */
1940
+ function isLoopbackBase(base) {
1941
+ const text = String(base || '').trim().toLowerCase()
1942
+ if (!text) return false
1943
+ const host = text.replace(/^[a-z][a-z0-9+.-]*:\/\//, '').split('/')[0].replace(/:\d+$/, '')
1944
+ return host === '127.0.0.1' || host === 'localhost' || host === '::1' || host === '[::1]'
1945
+ }
1946
+
1947
+ /**
1948
+ * 把一个选择器对应的元素聚焦。**只在真浏览器里有用**:测试替身(test/harness.mjs)
1949
+ * 没有真 `document`,SSR 里也没有 —— 所以整段包在 try 里,失败一律静默(聚焦失败
1950
+ * 不该影响任何行为,更不能让面板崩)。
1951
+ * @param {string} selector - CSS 选择器
1952
+ */
1953
+ function focusFirst(selector) {
1954
+ try {
1955
+ if (typeof document === 'undefined' || !document || typeof document.querySelector !== 'function') return
1956
+ const node = document.querySelector(selector)
1957
+ if (node && typeof node.focus === 'function') node.focus()
1958
+ } catch (error) {
1959
+ // 故意吞掉:焦点是锦上添花,不是功能
1960
+ }
1961
+ }
1962
+
1963
+ /**
1964
+ * 宿主给的 reason 码 → i18n 键。**宿主只给码、不给文案**(AGENTS.md §4.5)。
1965
+ * @param {string} reason - 宿主码
1966
+ * @returns {string} i18n 键
1967
+ */
1968
+ function semanticReasonKey(reason) {
1969
+ if (reason === 'no-provider') return 'sem.reason.noProvider'
1970
+ if (reason === 'probe-failed') return 'sem.reason.probeFailed'
1971
+ if (reason === 'timeout') return 'sem.reason.timeout'
1972
+ if (reason === 'bad-response') return 'sem.reason.badResponse'
1973
+ if (reason === 'no-query') return 'sem.reason.noQuery'
1974
+ // 防御性:时间序下宿主整层短路(`not-applicable`)。那档下拉根本不出现,
1975
+ // 但老/新宿主混合时仍可能回这个码 ⇒ 不许掉进「原因未知」。
1976
+ if (reason === 'not-applicable') return 'sem.reason.notApplicable'
1977
+ return 'sem.reason.unknown'
1978
+ }
1979
+
1741
1980
  /**
1742
1981
  * 把预览高度比例夹到合法区间。
1743
1982
  * @param {number} value - 原始比例
@@ -2044,8 +2283,12 @@ video.knit-preview-media{width:100%;background:#000}
2044
2283
  // 「直接命中」后面跟一个「knit · client」)—— 它读起来是**标签 + 值**,不是一句话。
2045
2284
  const shown = terms.slice(0, 2).join(' · ')
2046
2285
  const key = `why.${reason.code}`
2047
- // 词典里没有这个码就把码本身显示出来 —— 宿主加了新码而客户端还没跟上时,
2048
- // 用户看到的是 `why.xxx` 这种明显异常,而不是一条静默的空行。
2286
+ // v0.23 加固:**先看词典里有没有这个码**,再有条件地交给 `t()`。
2287
+ // 未知码不赌官方 `bind()` 的缺失键行为(可能是 `undefined`),而是把键名显示出来 ——
2288
+ // 宿主加了新码而客户端还没跟上时,用户看到 `why.xxx` 这种明显异常,
2289
+ // 而不是一条静默的空行,更不是一个 `undefined`。
2290
+ // (`ZH` 与 `EN` 的键集由 `test/i18n.test.mjs` 守齐,所以只查一本就够。)
2291
+ if (ZH[key] === undefined) return key
2049
2292
  if (!terms.length) {
2050
2293
  const plain = `${key}Plain`
2051
2294
  return ZH[plain] !== undefined ? t(plain) : t(key)
@@ -2053,6 +2296,23 @@ video.knit-preview-media{width:100%;background:#000}
2053
2296
  return t(key, { term: shown })
2054
2297
  }
2055
2298
 
2299
+ /**
2300
+ * v0.23:来源徽标的文案。**只认词典里真有的那几档**
2301
+ * (`retrieval` / `relation` / `manual` / `semantic`);未知值一律 `null` ⇒ **不给徽标**。
2302
+ *
2303
+ * 为什么不把未知值交给 `t()`:来源是宿主给的字符串,客户端不认识时既不该抛,
2304
+ * 也不该把裸码(`prov.mystery`)或 `undefined` 渲染到界面上 —— 与 `DocRow` 调用点
2305
+ * 那条纪律同源:「平铺列表里的条目来源未知,不能替它认领一个『检索』」。
2306
+ *
2307
+ * @param {unknown} provenance - 宿主给的那一档
2308
+ * @returns {string|null} 文案或 null
2309
+ */
2310
+ function provText(provenance) {
2311
+ if (typeof provenance !== 'string' || provenance.length === 0) return null
2312
+ const key = `prov.${provenance}`
2313
+ return ZH[key] !== undefined ? t(key) : null
2314
+ }
2315
+
2056
2316
  function docOptionId(doc) {
2057
2317
  const rel = String(doc.rel || doc.path || '')
2058
2318
  const safe = rel.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 48)
@@ -2188,9 +2448,7 @@ video.knit-preview-media{width:100%;background:#000}
2188
2448
  const MOTION_EASE = 'cubic-bezier(.22,1,.36,1)'
2189
2449
  /** 幽灵行所在的「区」:分层视图用层名,平铺与「全部」各一个 —— 幽灵要插回原位。 */
2190
2450
  const MOTION_TIER_FLAT = 'flat'
2191
- const MOTION_TIER_ALL_DOCS = 'all-docs'
2192
2451
  /** v0.19:「全部」档里的代码区自己的区名 —— 幽灵行要插回**它原来那一区**,共用会插错位置。 */
2193
- const MOTION_TIER_ALL_CODE = 'all-code'
2194
2452
  /** 幸存行位移(换层 / 重排)的 FLIP 时长:比进入略长,它要真的「走」完一段距离。 */
2195
2453
  const MOTION_MOVE_MS = 340
2196
2454
  /** 位移小于这个像素数(含亚像素抖动)就当没动过,不排补间。 */
@@ -3529,6 +3787,9 @@ video.knit-preview-media{width:100%;background:#000}
3529
3787
  // `{pinned, excluded, skipped, persisted}`;`skipped` 是**这一批真的被排掉几篇**
3530
3788
  // (不是 excluded 的长度 —— 被排除的文件可能已经不在工作区里了)。
3531
3789
  control: null,
3790
+ // v0.23:宿主回的 `semantic`(模式 / 是否可用 / 原因 / 候选数 / provider)。
3791
+ // ⚠️ **老宿主没有这个字段** ⇒ 保持 null,界面按「宿主不支持混合检索」如实降级。
3792
+ semantic: null,
3532
3793
  })
3533
3794
  const [preview, setPreview] = React.useState(null)
3534
3795
  /* v0.20 性能治理:**一分钟一次**的刷新信号。相对时间标签是按分钟变的,所以轮询只在
@@ -3567,6 +3828,16 @@ video.knit-preview-media{width:100%;background:#000}
3567
3828
  // 为什么在这里」的补充说明,同时展开多条就不是在看一行了。仍然放在最后(同上)。
3568
3829
  const [whyOpen, setWhyOpen] = React.useState('')
3569
3830
 
3831
+ /* v0.23(Phase A):检索模式 + provider 配置。
3832
+ ⚠️ 四个 hook 都**追加在最后**:前面的槽位被测试按位预置(notice / sort / …),
3833
+ 插队会让老用例读到错的状态。`semForm` 用 `null` 表示「还没编辑过」——
3834
+ 那时表单值从宿主回的 `semantic.provider` 现推(见渲染里的 `semForm0`),
3835
+ 所以不需要额外的同步 effect。 */
3836
+ const [retrieval, setRetrieval] = React.useState(readRetrievalPref)
3837
+ const [semForm, setSemForm] = React.useState(null)
3838
+ const [semBusy, setSemBusy] = React.useState(false)
3839
+ const [semNotice, setSemNotice] = React.useState('')
3840
+
3570
3841
  /* ── 曾经在这里的三个状态 + 一个 ref:右栏的形态 ──────────
3571
3842
  `packWidth`(310) / `packFloat`(null) / `packSnap`(false) / `packColRef`。
3572
3843
  **2026-09-29 随右栏一起删除**。当时它们**只存在内存里**(刷新回默认值),
@@ -3606,7 +3877,9 @@ video.knit-preview-media{width:100%;background:#000}
3606
3877
  try {
3607
3878
  // `usage=1` 是**开闸**(不是「顺便取一下」):宿主只有看到它才会开始给这个会话记账。
3608
3879
  // 没打开「使用情况」的会话,宿主侧一个事件都不读。
3609
- const url = `${LIST_API}?sessionId=${encodeURIComponent(sessionId)}&limit=40&sort=${sort}&kind=${kind}${usageOn ? '&usage=1' : ''}`
3880
+ // v0.23:`retrieval` 是**选填**参数 —— 老宿主忽略它(那就等于词法),
3881
+ // 而词法模式下宿主**一次 provider 调用都不会发**(方案 §9.2 判据 1)。
3882
+ const url = `${LIST_API}?sessionId=${encodeURIComponent(sessionId)}&limit=40&sort=${sort}&kind=${kind}&retrieval=${sort === 'relevance' && retrieval === 'hybrid' ? 'hybrid' : 'lexical'}${usageOn ? '&usage=1' : ''}`
3610
3883
  const res = await fetch(url, { headers: { accept: 'application/json' }, cache: 'no-store' })
3611
3884
  const data = await res.json()
3612
3885
  if (!live()) return
@@ -3630,6 +3903,8 @@ video.knit-preview-media{width:100%;background:#000}
3630
3903
  usage: data.usage || null,
3631
3904
  // v0.21:固定 / 排除的原始记录(面板要拿它画固定区、排除说明与管道条)。
3632
3905
  control: data.control || null,
3906
+ // v0.23:`semantic` 可能不存在(老宿主)⇒ null,界面据此如实降级。
3907
+ semantic: data.semantic || null,
3633
3908
  sig,
3634
3909
  }))
3635
3910
  } else {
@@ -3643,7 +3918,7 @@ video.knit-preview-media{width:100%;background:#000}
3643
3918
  // 返回同一个值,React 直接跳过这次更新)。标签读的是渲染时刻的钟,不受这里影响。
3644
3919
  const now = Date.now()
3645
3920
  bumpTick((prev) => (Math.floor(now / 60000) === Math.floor(prev / 60000) ? prev : now))
3646
- }, [sessionId, sort, kind, usageOn])
3921
+ }, [sessionId, sort, kind, usageOn, retrieval])
3647
3922
 
3648
3923
  React.useEffect(() => {
3649
3924
  // 看不见就一个定时器都不挂:`visible` 变回 true 时本 effect 重跑,立刻 load 一次。
@@ -3701,16 +3976,6 @@ video.knit-preview-media{width:100%;background:#000}
3701
3976
  || String(doc.rel || '').toLowerCase().includes(q))
3702
3977
  }, [state.docs, query])
3703
3978
 
3704
- /* ── 「全部」:按类型分三区 ─────────────────────
3705
- 文档区与代码区各固定 4 条,多余的在分区标题给「查看全部」;
3706
- 媒体区**不截断** —— 一屏两行以外交给媒体区内部滚动(不隐藏、也不压小格子)。
3707
- v0.19 新增代码区,**顺序放在文档之后**:这不是排序(各区的条目顺序都来自
3708
- 同一套任务检索),只是混排时的展示次序 —— Markdown 仍然是这个面板的主角。 */
3709
- const docItems = kind === KIND_ALL ? visibleDocs.filter((doc) => doc.kind === ARTIFACT_DOC) : []
3710
- const codeItems = kind === KIND_ALL ? visibleDocs.filter((doc) => doc.kind === ARTIFACT_CODE) : []
3711
- const mediaItems = kind === KIND_ALL ? visibleDocs.filter(isMedia) : []
3712
- const shownDocs = docItems.slice(0, ALL_DOC_CAP)
3713
- const shownCode = codeItems.slice(0, ALL_CODE_CAP)
3714
3979
  // ResizeObserver 量到的是 .knit-list(它自己也有左右内边距),
3715
3980
  // 网格的可用宽度 = 列表宽度 − 列表内边距 − 网格内边距。
3716
3981
  // 文档列表**没有列数可算**:永远一个文档一行(见 `DOC_GRID` 那段说明)。
@@ -3719,8 +3984,10 @@ video.knit-preview-media{width:100%;background:#000}
3719
3984
 
3720
3985
  /** 媒体网格:列数由 CSS 的 auto-fill 自己数;JS 只下发「一格多宽」用于正方形兜底。
3721
3986
  * **不设 maxHeight** —— 有多少行就铺多少行,纵向滚动统一交给 `.knit-list`。 */
3722
- const mediaGrid = (docs, inSection) => h('div', {
3723
- className: `knit-media-grid${inSection ? ' in-section' : ''}`,
3987
+ // v0.23:`inSection` 参数随「全部」的类型分区一起删除 —— 媒体网格只有一种形态
3988
+ // (不带 `.in-section`,外层自己带内边距)。
3989
+ const mediaGrid = (docs) => h('div', {
3990
+ className: 'knit-media-grid',
3724
3991
  role: 'group',
3725
3992
  style: {
3726
3993
  '--knit-media-cell': `${mediaLayout.cell}px`,
@@ -3811,13 +4078,17 @@ video.knit-preview-media{width:100%;background:#000}
3811
4078
  */
3812
4079
  const contextView = React.useMemo(() => {
3813
4080
  const pack = state.context
4081
+ // v0.23.1:只认「文档 / 代码」两档 —— 「全部」档已整体删除(2026-10-12 用户裁决)。
3814
4082
  if (!relevance || (kind !== KIND_DOC && kind !== KIND_CODE) || !pack) return null
3815
4083
  const tiers = [
3816
4084
  ['primary', 'context.primary', 'context.primaryHint'],
3817
4085
  ['supporting', 'context.supporting', 'context.supportingHint'],
3818
4086
  ['related', 'context.related', 'context.relatedHint'],
3819
4087
  ]
3820
- const visible = new Set(visibleDocs.map((doc) => doc.rel))
4088
+ // v0.23:层级过滤只认**成行的条目**(文档 / 代码)—— 媒体**永远不进层**。
4089
+ // 宿主侧已经在装配之前把媒体剔掉了(`contextPayload()`),这里是第二道防线:
4090
+ // 就算哪天宿主把一个靠文件名命中的 `.mp4` 塞进包里,界面也不会把它当上下文渲染。
4091
+ const visible = new Set(visibleDocs.filter((doc) => !isMedia(doc)).map((doc) => doc.rel))
3821
4092
  /* v0.20 修正:宿主给三层条目的投影**只有 7 个键**(`context.js` 的
3822
4093
  `rel/title/summary/mtimeMs/kind/source/reason`)—— 那里**没有 `matches`**,
3823
4094
  而「命中片段」那一行读的是 `doc.matches`(下面的 `firstMatchOf`)。
@@ -3879,11 +4150,9 @@ video.knit-preview-media{width:100%;background:#000}
3879
4150
  *
3880
4151
  * 分了层时必须是**三层里那些真的渲染出来的条目**(`contextView.flat`)——
3881
4152
  * 否则「其他相关文档」区里的条目键盘到不了,而已经在 Related 层里的条目
3882
- * 会被算两次。「全部」档里文档只到上限,媒体全部可达。
4153
+ * 会被算两次。(媒体档走的是网格,`visibleDocs` 就是那批媒体。)
3883
4154
  */
3884
- const navDocs = kind === KIND_ALL
3885
- ? shownDocs.concat(mediaItems)
3886
- : (contextView ? contextView.flat : visibleDocs)
4155
+ const navDocs = contextView ? contextView.flat : visibleDocs
3887
4156
 
3888
4157
  // cursor 消失(被过滤掉 / 被上限截断 / 列表刷新)时落回第一项
3889
4158
  React.useEffect(() => {
@@ -4240,6 +4509,17 @@ video.knit-preview-media{width:100%;background:#000}
4240
4509
  /** 媒体条目的同源字节地址(缩略图 / 就地预览)。 */
4241
4510
  const srcFor = React.useCallback((doc) => mediaUrl(sessionId, doc.rel), [sessionId])
4242
4511
 
4512
+ /**
4513
+ * 切换检索模式并记住偏好。**只切偏好**:真正的 provider 调用发生在宿主侧,
4514
+ * 下一次 `load()` 会带上新的 `retrieval`。切回词法时把配置区的提示清掉。
4515
+ * @param {'lexical'|'hybrid'} value - 检索模式
4516
+ */
4517
+ const pickRetrieval = React.useCallback((value) => {
4518
+ writePref(RETRIEVAL_KEY, value)
4519
+ setRetrieval(value)
4520
+ setSemNotice('')
4521
+ }, [])
4522
+
4243
4523
  /** 切换列表类型并记住偏好;同时收起上一类型的预览。 */
4244
4524
  const pickKind = React.useCallback((value) => {
4245
4525
  writePref(KIND_KEY, value)
@@ -4344,6 +4624,34 @@ video.knit-preview-media{width:100%;background:#000}
4344
4624
  /** 面板高度(px)。0 = 量不到(测试替身 / 首帧)——那时按「不矮」处理,不降级。 */
4345
4625
  const [panelH, setPanelH] = React.useState(0)
4346
4626
 
4627
+ /* v0.23(2026-10-11):检索模式改成搜索框右端的小下拉后的两个状态。
4628
+ ⚠️ 与上面那条注释同一条纪律:**必须留在本组件所有既有 hook 之后**,
4629
+ 否则 `harness.seed()` 的位置预置会整体错位。 */
4630
+ /** 那个小菜单开着没有。 */
4631
+ const [retMenuOpen, setRetMenuOpen] = React.useState(false)
4632
+ /** 就地配置区(`.knit-semcfg`)展开了没有 —— 由菜单里「配置语义 provider…」开关。 */
4633
+ const [semCfgOpen, setSemCfgOpen] = React.useState(false)
4634
+
4635
+ /** 配置区一展开就把焦点送进第一个输入框(键盘用户不用自己 Tab 过去)。 */
4636
+ React.useEffect(() => {
4637
+ if (semCfgOpen) focusFirst('.knit-semcfg-input')
4638
+ }, [semCfgOpen])
4639
+
4640
+ /** 点面板别处就收起菜单。判据用「点在 `.knit-pipe-method-wrap` 之内就放过」——
4641
+ * 否则按钮自己的点击会先关(pointerdown)再开(click),菜单根本打不开。
4642
+ * ⚠️ 测试替身里 `window.addEventListener` 是空实现 ⇒ 这条只在真机生效,
4643
+ * 所以 Esc 那条**必须**另外挂在按钮与菜单上(可被断言)。 */
4644
+ React.useEffect(() => {
4645
+ if (!retMenuOpen) return undefined
4646
+ const onPointerDown = (event) => {
4647
+ const node = event && event.target
4648
+ if (node && typeof node.closest === 'function' && node.closest('.knit-pipe-method-wrap')) return
4649
+ setRetMenuOpen(false)
4650
+ }
4651
+ window.addEventListener('pointerdown', onPointerDown)
4652
+ return () => window.removeEventListener('pointerdown', onPointerDown)
4653
+ }, [retMenuOpen])
4654
+
4347
4655
  /** 点 Coverage 的某一层 → 滚到那一层 + 短暂高亮。
4348
4656
  * ⚠️ 滚的是 `.knit-list`(唯一滚动容器):Lens 自己不滚动,也不新增容器。
4349
4657
  * ⚠️ 高亮走 state 而不是直接改 classList —— 这样测试替身里也能断言到结果。 */
@@ -4395,16 +4703,8 @@ video.knit-preview-media{width:100%;background:#000}
4395
4703
  const motionRows = (() => {
4396
4704
  if (state.status === 'error' || state.docs.length === 0 || visibleDocs.length === 0) return []
4397
4705
  if (kind === KIND_MEDIA) return [] // 媒体格子不参与:网格里收起高度没有意义
4398
- if (kind === KIND_ALL) {
4399
- if (docItems.length === 0 && codeItems.length === 0) return []
4400
- return [
4401
- ...shownDocs.map((doc, index) => (
4402
- { rel: doc.rel, tierKey: MOTION_TIER_ALL_DOCS, index, doc })),
4403
- ...shownCode.map((doc, index) => (
4404
- { rel: doc.rel, tierKey: MOTION_TIER_ALL_CODE, index, doc })),
4405
- ]
4406
- }
4407
4706
  if (contextView) {
4707
+ // 有包(相关序):三层的 key 就是运动分组 —— 「全部」与「文档」走同一条路。
4408
4708
  const rows = []
4409
4709
  for (const section of contextView.sections) {
4410
4710
  section.docs.forEach((doc, index) => rows.push(
@@ -4412,6 +4712,7 @@ video.knit-preview-media{width:100%;background:#000}
4412
4712
  }
4413
4713
  return rows
4414
4714
  }
4715
+ // 平铺(时间序 / 没有包):媒体档走网格、不进行。
4415
4716
  return visibleDocs.map((doc, index) => (
4416
4717
  { rel: doc.rel, tierKey: MOTION_TIER_FLAT, index, doc }))
4417
4718
  })()
@@ -4537,7 +4838,7 @@ video.knit-preview-media{width:100%;background:#000}
4537
4838
  // 平铺列表里的条目来源未知,不能替它认领一个「检索」。
4538
4839
  const controllable = Boolean(contextView && !isMedia(doc))
4539
4840
  return h(DocRow, { ...common, relevance, why: whyText(doc.reason), num, mark, primary,
4540
- prov: doc.provenance ? t(`prov.${doc.provenance}`) : null,
4841
+ prov: provText(doc.provenance),
4541
4842
  pinned: doc.provenance === 'manual',
4542
4843
  onAct: controllable ? act : null,
4543
4844
  whyOpen: Boolean(whyOpen) && whyOpen === doc.rel,
@@ -4560,37 +4861,6 @@ video.knit-preview-media{width:100%;background:#000}
4560
4861
  leaving: Boolean(doc.knitLeaving) })
4561
4862
  }
4562
4863
 
4563
- /** 「全部」的分区标题:类型名 + 「已显示 / 总数」+ 被截断时的「查看全部」。 */
4564
- const sectionHead = (labelKey, shownCount, totalCount, targetKind) =>
4565
- h('div', { className: 'knit-section-head' },
4566
- h('span', { className: 'knit-section-title' }, t(labelKey)),
4567
- h('span', { className: 'knit-section-count' },
4568
- t('section.count', { shown: shownCount, total: totalCount })),
4569
- totalCount > shownCount
4570
- ? h('button', {
4571
- type: 'button',
4572
- className: 'knit-section-more',
4573
- title: t('section.more'),
4574
- onClick: () => pickKind(targetKind),
4575
- }, t('section.more'))
4576
- : null)
4577
-
4578
- /** 「全部」的上下两区:空的一区整个不渲染,免得只剩一个空标题。 */
4579
- const allSections = [
4580
- docItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'docs' },
4581
- sectionHead('kind.doc', shownDocs.length, docItems.length, KIND_DOC),
4582
- docsGrid(withGhosts(MOTION_TIER_ALL_DOCS, shownDocs))),
4583
- codeItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'code' },
4584
- sectionHead('kind.code', shownCode.length, codeItems.length, KIND_CODE),
4585
- docsGrid(withGhosts(MOTION_TIER_ALL_CODE, shownCode))),
4586
- mediaItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'media' },
4587
- // 媒体不截断,所以只给一个标题,不给「已显示 / 总数」和「查看全部」
4588
- h('div', { className: 'knit-section-head' },
4589
- h('span', { className: 'knit-section-title' }, t('kind.media')),
4590
- h('span', { className: 'knit-section-count' }, String(mediaItems.length))),
4591
- mediaGrid(mediaItems, true)),
4592
- ]
4593
-
4594
4864
  // 媒体视图:一格都不隐藏 —— 一屏两行以外的部分在媒体区**内部滚动**,
4595
4865
  // 既不让面板被整面媒体墙顶爆,也不会像旧版那样把剩下的条目直接切掉。
4596
4866
  const emptyText = kind === KIND_MEDIA
@@ -4607,12 +4877,10 @@ video.knit-preview-media{width:100%;background:#000}
4607
4877
  : visibleDocs.length === 0
4608
4878
  ? h('div', { className: 'knit-msg' }, t('list.noMatch', { query: query.trim() }))
4609
4879
  : kind === KIND_MEDIA
4610
- ? mediaGrid(visibleDocs, false)
4611
- : kind === KIND_ALL
4612
- ? allSections
4613
- : contextView
4614
- ? contextBody(contextView)
4615
- : docsGrid(withGhosts(MOTION_TIER_FLAT, visibleDocs))
4880
+ ? mediaGrid(visibleDocs)
4881
+ : contextView
4882
+ ? contextBody(contextView)
4883
+ : docsGrid(withGhosts(MOTION_TIER_FLAT, visibleDocs))
4616
4884
 
4617
4885
  // 排序说明那一行(.knit-topic)**2026-09-30 已整体删除**:排序方式由头部那个
4618
4886
  // 「相关 / 最新」切换按钮自己表达(按钮上就写着当前选的是哪个),再补一句
@@ -4867,9 +5135,7 @@ video.knit-preview-media{width:100%;background:#000}
4867
5135
  ? (filtering ? 'count.media.filtered' : 'count.media')
4868
5136
  : kind === KIND_CODE
4869
5137
  ? (filtering ? 'count.code.filtered' : 'count.code')
4870
- : kind === KIND_ALL
4871
- ? (filtering ? 'count.all.filtered' : 'count.all')
4872
- : (filtering ? 'count.filtered' : 'count')
5138
+ : (filtering ? 'count.filtered' : 'count')
4873
5139
  // 可见文本 = 纯数字;整句(含量词)只出现在 title 里。
4874
5140
  const countText = filtering
4875
5141
  ? `${visibleDocs.length} / ${state.total}`
@@ -4907,6 +5173,162 @@ video.knit-preview-media{width:100%;background:#000}
4907
5173
  const pipeDot = () => h('span', { className: 'knit-pipedot', 'aria-hidden': 'true' }, '·')
4908
5174
  const pipeSep = () => h('span', { className: 'knit-pipesep', 'aria-hidden': 'true' }, '|')
4909
5175
  const pinnedCount = pack && Array.isArray(pack.pinned) ? pack.pinned.length : 0
5176
+
5177
+ /* ── v0.23(Phase A):从宿主回的 `semantic` 推出来的几个量 ─────────────
5178
+ `semLive` 只看**实际生效**的模式:`mode === 'hybrid'` 才算语义真的在跑;
5179
+ 点了混合而宿主回 lexical(不可用 / 未配置 / 老宿主)⇒ 一律走「如实说明」这条。 */
5180
+ const semInfo = state.semantic || null
5181
+ const semOn = retrieval === 'hybrid'
5182
+ const semLive = !!(semInfo && semInfo.mode === 'hybrid')
5183
+ const semCandidateCount = semInfo ? Math.max(0, Number(semInfo.candidates) || 0) : 0
5184
+ const semProvider = semInfo && semInfo.provider ? semInfo.provider : null
5185
+ const semForm0 = semForm || (semProvider
5186
+ ? { kind: semProvider.kind, base: semProvider.base, model: semProvider.model }
5187
+ : { kind: 'ollama', base: '', model: '' })
5188
+ const semReasonText = semInfo
5189
+ ? t(semanticReasonKey(semInfo.reason))
5190
+ : t('sem.unsupported')
5191
+
5192
+ /* v0.23(2026-10-11 用户裁决):**检索模式贴在搜索框右端的小下拉里**,而且只在「相关」档出现。
5193
+ 理由(都在代码里):时间序没有 Context Pack 分层(宿主 `contextPayload()` 要求
5194
+ `sort === 'relevance'`),语义候选无处可落;宿主那侧也已按 `not-applicable` 整层短路。
5195
+ ⚠️ **不再看 provider 配没配**(本次放宽):未配也出现 —— Knit 还没有设置页,
5196
+ 藏起来用户就永远打不开这个功能;菜单里如实写状态,并就地给配置入口。
5197
+ ⚠️ **永远不做置灰禁用态**。 */
5198
+ const showRetrieval = sort === 'relevance'
5199
+ const semReason = semInfo && typeof semInfo.reason === 'string' ? semInfo.reason : null
5200
+ /** 菜单底部那行状态:如实说这一档现在到底生效成什么(不美化、不猜)。 */
5201
+ const semStateText = !semOn
5202
+ ? t('sem.state.lexical')
5203
+ : (semLive
5204
+ ? t('sem.state.hybridLive')
5205
+ : (semReason && semReason !== 'no-provider'
5206
+ ? t(semanticReasonKey(semReason))
5207
+ : t('sem.state.noProvider')))
5208
+ /** 「配置语义 provider…」入口只在「选了混合但没生效」时给 —— 其它状态下配置是无意义的动作。 */
5209
+ const semCanConfigure = semOn && !semLive
5210
+ /** Esc:关菜单并把焦点还给按钮(键盘可达性)。挂按钮与菜单两处,测试可断言。 */
5211
+ const closeRetMenuOnEscape = (event) => {
5212
+ if (!event || event.key !== 'Escape') return
5213
+ event.stopPropagation()
5214
+ setRetMenuOpen(false)
5215
+ focusFirst('.knit-retmode-btn')
5216
+ }
5217
+
5218
+ /* 保存并测试:**一次 POST**(宿主会 probe 一次,并在响应里回 `available` / `reason`)。
5219
+ 成功后把表单交还给宿主的回值(`setSemForm(null)`),再重取一次列表 ——
5220
+ 配置区/事实行下一帧就按宿主的事实重画,不在客户端自己猜。 */
5221
+ const saveSemantic = async () => {
5222
+ if (semBusy) return
5223
+ setSemBusy(true)
5224
+ setSemNotice('')
5225
+ try {
5226
+ const res = await fetch(SEMANTIC_API, {
5227
+ method: 'POST',
5228
+ headers: { 'content-type': 'application/json', accept: 'application/json' },
5229
+ body: JSON.stringify({ kind: semForm0.kind, base: semForm0.base, model: semForm0.model }),
5230
+ })
5231
+ const data = await res.json().catch(() => null)
5232
+ if (data && data.ok) {
5233
+ setSemForm(null)
5234
+ setSemNotice(data.available ? t('sem.savedOk') : t('sem.savedFail'))
5235
+ await load()
5236
+ } else {
5237
+ setSemNotice(data ? hostMessage(data) : t('sem.savedFail'))
5238
+ }
5239
+ } catch (error) {
5240
+ setSemNotice(String((error && error.message) || error))
5241
+ } finally {
5242
+ setSemBusy(false)
5243
+ }
5244
+ }
5245
+
5246
+ const semcfgNode = h('div', { className: 'knit-semcfg' },
5247
+ h('div', { className: 'knit-retseg', role: 'group', 'aria-label': t('sem.kindAria') },
5248
+ [['ollama', 'sem.kind.ollama'], ['openai-compatible', 'sem.kind.openai']].map(([value, labelKey]) =>
5249
+ h('button', {
5250
+ type: 'button',
5251
+ key: value,
5252
+ className: `knit-retseg-btn${semForm0.kind === value ? ' active' : ''}`,
5253
+ 'aria-pressed': semForm0.kind === value,
5254
+ onClick: () => setSemForm({ ...semForm0, kind: value }),
5255
+ }, t(labelKey)))),
5256
+ h('input', {
5257
+ className: 'knit-semcfg-input',
5258
+ value: semForm0.base,
5259
+ placeholder: t('sem.basePlaceholder'),
5260
+ 'aria-label': t('sem.baseAria'),
5261
+ onChange: (event) => setSemForm({ ...semForm0, base: event.target.value }),
5262
+ }),
5263
+ h('input', {
5264
+ className: 'knit-semcfg-input',
5265
+ value: semForm0.model,
5266
+ placeholder: t('sem.modelPlaceholder'),
5267
+ 'aria-label': t('sem.modelAria'),
5268
+ onChange: (event) => setSemForm({ ...semForm0, model: event.target.value }),
5269
+ }),
5270
+ h('button', {
5271
+ type: 'button',
5272
+ className: 'knit-btn',
5273
+ disabled: semBusy,
5274
+ title: t('sem.saveTitle'),
5275
+ onClick: saveSemantic,
5276
+ }, semBusy ? t('sem.saving') : t('sem.save')),
5277
+ // 披露:只有回环地址才敢说「不离开这台机器」,其余一律明写会发到哪个服务(方案 §2)。
5278
+ h('span', { className: 'knit-semcfg-note' },
5279
+ !semForm0.base
5280
+ ? t('sem.disclose.empty')
5281
+ : (isLoopbackBase(semForm0.base)
5282
+ ? t('sem.disclose.local')
5283
+ : t('sem.disclose.remote', { base: semForm0.base }))))
5284
+ /* v0.24(2026-10-12 用户裁决 + Demo 参考):检索方式不再是工具栏里的下拉,
5285
+ 而是状态行里一个**可点的状态格**(`BM25 词法检索 ›`)—— 虚线下划线 + 小箭头提示可点。
5286
+ 菜单**相对这一格定位**(`.knit-retmenu{left:0;top:22px}`),内容与行为逐字沿用原来的:
5287
+ 两个选项(menuitemradio / aria-checked)+ 现状说明 + 「不可用时就地配置」入口。
5288
+ ⚠️ 这一格说的是**实际生效**的模式(`semLive`):点了混合但不可用时,宿主回的是 lexical,
5289
+ 所以它仍然显示「BM25 词法检索」—— 不许把它写成「用户点了什么」。 */
5290
+ const pipeMethodNode = h('div', { className: 'knit-pipe-method-wrap' },
5291
+ h('button', {
5292
+ type: 'button',
5293
+ className: 'knit-pipe-method',
5294
+ 'aria-haspopup': 'true',
5295
+ 'aria-expanded': retMenuOpen,
5296
+ // 悬停给**整句话**(长键在这里被用上;菜单里则是逐选项的副文案)
5297
+ title: t(retrieval === 'hybrid' ? 'sem.mode.hybridTitle' : 'sem.mode.lexicalTitle'),
5298
+ onClick: () => setRetMenuOpen((value) => !value),
5299
+ onKeyDown: closeRetMenuOnEscape,
5300
+ },
5301
+ // 文字单独一层:悬停的下划线只划它,不划右边那个箭头(见 CSS 注释)。
5302
+ h('span', { className: 'knit-pipe-method-label' }, t(semLive ? 'pipe.rankHybrid' : 'pipe.rank')),
5303
+ // 箭头是**装饰**(对读屏隐藏),可访问名由上面的 title 承担。
5304
+ // 字形复用「最近读取」行最右端那个 `›`,CSS 旋转 90° 朝下、展开时转回朝上。
5305
+ h('span', { className: 'knit-pipe-method-go', 'aria-hidden': 'true' }, '›')),
5306
+ retMenuOpen ? h('div', {
5307
+ className: 'knit-retmenu',
5308
+ role: 'menu',
5309
+ 'aria-label': t('sem.mode.aria'),
5310
+ onKeyDown: closeRetMenuOnEscape,
5311
+ },
5312
+ [['lexical', 'sem.mode.lexicalOption', 'sem.mode.lexicalDesc'],
5313
+ ['hybrid', 'sem.mode.hybridOption', 'sem.mode.hybridDesc']].map(([value, labelKey, descKey]) =>
5314
+ h('button', {
5315
+ type: 'button',
5316
+ key: value,
5317
+ role: 'menuitemradio',
5318
+ 'aria-checked': retrieval === value,
5319
+ className: `knit-retmenu-item${retrieval === value ? ' active' : ''}`,
5320
+ onClick: () => { pickRetrieval(value); setRetMenuOpen(false) },
5321
+ },
5322
+ h('strong', null, t(labelKey)),
5323
+ h('span', null, t(descKey)))),
5324
+ // 状态行:如实写这一档现在到底生效成什么(判据 5 的界面面)
5325
+ h('div', { className: 'knit-retmenu-note' }, semStateText),
5326
+ // 就地配置入口:只在「选了混合且没生效」时给;点开的是那行最小配置区
5327
+ semCanConfigure ? h('button', {
5328
+ type: 'button',
5329
+ className: 'knit-retmenu-cfg',
5330
+ onClick: () => { setRetMenuOpen(false); setSemCfgOpen((value) => !value) },
5331
+ }, t(semCfgOpen ? 'sem.cfg.hide' : 'sem.cfg.show')) : null) : null)
4910
5332
  const pipeNode = h('div', { className: 'knit-pipe' },
4911
5333
  pipeCell(t('pipe.collect', { n: collected })),
4912
5334
  pipeDot(),
@@ -4914,7 +5336,10 @@ video.knit-preview-media{width:100%;background:#000}
4914
5336
  pipeDot(),
4915
5337
  pipeCell(t('pipe.candidates', { n: state.total })),
4916
5338
  pipeSep(),
4917
- pipeCell(t('pipe.rank')),
5339
+ // 这一格说的是**实际生效**的模式(`semantic.mode`),不是你点了什么:
5340
+ // 点了混合但不可用时,宿主回的是 lexical,这里就必须还写「BM25 词法检索」。
5341
+ pipeMethodNode,
5342
+ ...(semLive ? [pipeDot(), pipeCell(t('pipe.semantic', { n: semCandidateCount }))] : []),
4918
5343
  pipeDot(),
4919
5344
  pipeCell(t('pipe.relations', { n: relCount })),
4920
5345
  pipeDot(),
@@ -4960,7 +5385,7 @@ video.knit-preview-media{width:100%;background:#000}
4960
5385
  h('button', { className: 'knit-btn', onClick: load, title: t('action.refreshNow') }, t('action.refresh'))),
4961
5386
  h('div', { className: 'knit-bar' },
4962
5387
  /* v0.21.x(2026-10-09 用户规格):三组一行 —— 排序 | 类型 | 搜索。
4963
- ① 排序与类型**不做成一个整体**:中间那根 `.knit-bar-sep` 就是边界,两个条件各管各的。
5388
+ ① 排序与类型**不做成一个整体**:两组各管各的(中间的竖线 2026-10-12 已删除,靠 gap 分界)。
4964
5389
  ② 搜索排最后、贴最右:它只过滤当前列表,不重置排序与类型(§三.3)。
4965
5390
  ③ 六个选项彼此独立 —— 选「代码」再选「最新」= 最新的代码。
4966
5391
  顺序即控件顺序,别再挪(细则在 CSS 那边的 .knit-bar / .knit-filter 注释里)。 */
@@ -4975,12 +5400,13 @@ video.knit-preview-media{width:100%;background:#000}
4975
5400
  onClick: () => pickSort('time'),
4976
5401
  title: t('sort.timeTitle'),
4977
5402
  }, t('sort.time'))),
4978
- // 排序组 / 类型组之间**就这一根线**(2026-10-09 用户规格 §二.2)。
4979
- h('span', { className: 'knit-bar-sep', 'aria-hidden': 'true' }),
5403
+ // ⚠️ 2026-10-12 用户裁决:排序组与类型组之间**那根竖线去掉了** —— 它的类名与 CSS 规则都已整体删除。
5404
+ // 两组靠 `.knit-bar` 的 gap 分开就够 —— 「边界」不再需要一根线来表达。
4980
5405
  h('div', { className: 'knit-types', role: 'tablist', 'aria-label': t('kind.title') },
4981
- // v0.19:四档「文档 / 代码 / 媒体 / 全部」。**没有第二层分类** ——
4982
- // 代码里不再按语言(JS / TS / Python…)分组(需求 §46:不给代码加视觉层级压迫)。
4983
- [[KIND_DOC, 'kind.doc'], [KIND_CODE, 'kind.code'], [KIND_MEDIA, 'kind.media'], [KIND_ALL, 'kind.all']].map(([value, labelKey]) =>
5406
+ // v0.23.1(2026-10-12 用户裁决):**三档**「文档 / 代码 / 媒体」——
5407
+ // 「全部」那一档连同它的混合浏览视图在整个界面上删除了(三档等距、页签样式不变)。
5408
+ // **没有第二层分类** —— 代码里不按语言(JS / TS / Python…)分组(需求 §46)。
5409
+ [[KIND_DOC, 'kind.doc'], [KIND_CODE, 'kind.code'], [KIND_MEDIA, 'kind.media']].map(([value, labelKey]) =>
4984
5410
  h('button', {
4985
5411
  type: 'button',
4986
5412
  key: value,
@@ -4990,17 +5416,25 @@ video.knit-preview-media{width:100%;background:#000}
4990
5416
  title: t('kind.title'),
4991
5417
  onClick: () => pickKind(value),
4992
5418
  }, t(labelKey)))),
4993
- // 搜索排最后(工具栏尾部):它对**当前这一份列表**再过滤,不动排序与类型。
4994
- h('input', {
4995
- className: 'knit-filter',
4996
- value: query,
4997
- placeholder: t('filter.placeholder'),
4998
- 'aria-label': t('filter.aria'),
4999
- onChange: (event) => setQuery(event.target.value),
5000
- onKeyDown: (event) => {
5001
- if (event.key === 'Escape') { event.stopPropagation(); setQuery('') }
5002
- },
5003
- })),
5419
+ /* v0.24(2026-10-12 用户裁决):**检索方式搬去状态行了**(见下面 `pipeMethodNode`),
5420
+ 工具栏第二行只剩三样:排序、类型、搜索框。
5421
+ `[相关|最新] [文档|代码|媒体] …………………………… [ ……搜索框…… ]`
5422
+ ⚠️ 搜索框仍靠右:`margin-left:auto` 由它外面的 `.knit-bar-right` 承担(容器没被撤掉,
5423
+ 只是里面从「检索方式 + 搜索框」变成「只有搜索框」)。
5424
+ ⚠️ 容器里**只有搜索框**是 `flex:1 1 …` 的可伸缩项 —— 窄屏先缩它;排序 / 类型一律 `flex:none`。
5425
+ ⚠️ 搜索仍是对**当前这一份列表**再过滤,不动排序与类型。 */
5426
+ h('div', { className: 'knit-bar-right' },
5427
+ h('div', { className: 'knit-searchwrap' },
5428
+ h('input', {
5429
+ className: 'knit-filter',
5430
+ value: query,
5431
+ placeholder: t('filter.placeholder'),
5432
+ 'aria-label': t('filter.aria'),
5433
+ onChange: (event) => setQuery(event.target.value),
5434
+ onKeyDown: (event) => {
5435
+ if (event.key === 'Escape') { event.stopPropagation(); setQuery('') }
5436
+ },
5437
+ })))),
5004
5438
  /* ── v0.21:检索状态摘要 + 排除说明(需求 §6.3)──────────────────────
5005
5439
  两条都是**事实行**,都在列表上方、都只在相关序出现(那是唯一有「包」的视图)。
5006
5440
  ⚠️ 它们的排位是**紧贴工具栏**的(2026-10-09 用户反馈):观察层排在它们下面,
@@ -5011,6 +5445,15 @@ video.knit-preview-media{width:100%;background:#000}
5011
5445
  ② 排除说明:被排掉的那几篇 + 一个「恢复」。它说的是「这一批少了什么」,
5012
5446
  空的时候**不出现、也不占位**。 */
5013
5447
  relevance && contextView ? pipeNode : null,
5448
+ /* ── v0.23(Phase A):混合检索的两条行 ─────────────────────────────
5449
+ ⚠️ 排位固定在这里(**状态摘要之后**):摘要的前一个兄弟必须是 `.knit-bar`,
5450
+ 插到工具栏与摘要之间会把那条守卫顶掉(见 test/client.test.mjs 的顺序用例)。
5451
+ 两条都只在**用户选了混合**时出现:默认词法时一个节点都不产生(判据 2 的回归面)。
5452
+ ① 事实行:混合**没生效**时如实写原因(含「宿主版本较旧」这一档静默降级);
5453
+ ② 配置行:只有「选了混合 + provider 不可用」才就地展开,一行三格 + 一句披露。 */
5454
+ showRetrieval && semOn && !semLive ? h('div', { className: 'knit-retnote' }, semReasonText) : null,
5455
+ showRetrieval && semCfgOpen && semInfo && !semInfo.available ? semcfgNode : null,
5456
+ semOn && semNotice ? h('div', { className: 'knit-notice' }, semNotice) : null,
5014
5457
  relevance && excludedList.length > 0 ? h('div', { className: 'knit-excl' },
5015
5458
  h('span', { className: 'knit-excl-what' },
5016
5459
  t('control.excluded', { rel: excludedList.map((item) => item.rel).join('、') })),