dsh-knit 0.22.0 → 0.23.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.
- package/CHANGELOG.md +118 -3
- package/SECURITY.md +11 -5
- package/package.json +2 -2
- package/src/client/client.js +522 -99
- package/src/host/context.js +42 -3
- package/src/host/index.js +196 -7
- package/src/host/semantic.js +465 -0
- package/src/host/tool.js +44 -1
- package/test/client.test.mjs +636 -153
- package/test/harness.mjs +3 -1
- package/test/host-http.test.mjs +23 -0
- package/test/hybrid-eval.test.mjs +184 -0
- package/test/hybrid-retrieval.test.mjs +313 -0
- package/test/retrieval-corpus.mjs +379 -0
- package/test/retrieval-eval.mjs +231 -0
- package/test/semantic.test.mjs +257 -0
- package/test/tool.test.mjs +59 -4
package/src/client/client.js
CHANGED
|
@@ -146,6 +146,9 @@ window.__ModuleLoader__.load({
|
|
|
146
146
|
'prov.retrieval': '检索',
|
|
147
147
|
'prov.relation': '关系',
|
|
148
148
|
'prov.manual': '用户固定',
|
|
149
|
+
// v0.23:第四档来源。它**只**由「标题 + 摘要」的向量与任务相似而来 ——
|
|
150
|
+
// 不是关键词命中、也不是关系证据,而且只可能落在「相关」那一层。
|
|
151
|
+
'prov.semantic': '语义相关',
|
|
149
152
|
'control.pin': '固定',
|
|
150
153
|
'control.unpin': '取消固定',
|
|
151
154
|
'control.exclude': '排除',
|
|
@@ -177,6 +180,59 @@ window.__ModuleLoader__.load({
|
|
|
177
180
|
// 不写「固定覆盖」这种内部说法;也不带量词 —— 固定对象可能是文档、代码或媒体。
|
|
178
181
|
'pipe.pin': '固定 {n}',
|
|
179
182
|
'pipe.pack': '入包 {n}',
|
|
183
|
+
// v0.23(Phase A):混合检索。**默认词法** —— 这一格说的是实际生效的模式,不是用户的点击。
|
|
184
|
+
'pipe.rankHybrid': 'BM25 + 语义补充',
|
|
185
|
+
// 语义候选**只计数**(Phase A 不进包)。它是「有界」的:上限由消融定(方案 §5.2)。
|
|
186
|
+
'pipe.semantic': '语义候选 {n} 条',
|
|
187
|
+
// 检索模式选择器(工具栏第三组)
|
|
188
|
+
'sem.mode.aria': '检索模式',
|
|
189
|
+
'sem.mode.lexical': '词法',
|
|
190
|
+
'sem.mode.hybrid': '混合',
|
|
191
|
+
'sem.mode.lexicalTitle': '词法检索:BM25 + IDF,纯本地、零模型调用(默认)',
|
|
192
|
+
'sem.mode.hybridTitle': '混合检索(实验):在词法候选之外补充语义候选;需要先配置 provider',
|
|
193
|
+
// 2026-10-11:检索模式改成**搜索框右端的小下拉** —— 这两个是按钮上的短标签(带一个 ⌄)。
|
|
194
|
+
'sem.mode.lexicalShort': '词法⌄',
|
|
195
|
+
'sem.mode.hybridShort': '混合⌄',
|
|
196
|
+
// 菜单里两个选项的副文案(长解释收进菜单,工具栏不再挤第三组)
|
|
197
|
+
'sem.mode.lexicalOption': '词法检索',
|
|
198
|
+
'sem.mode.hybridOption': '混合检索 · 实验',
|
|
199
|
+
'sem.mode.lexicalDesc': '默认模式;沿用当前 BM25 + IDF 排序。',
|
|
200
|
+
'sem.mode.hybridDesc': '在词法候选之外补充语义候选;需先配置 provider。',
|
|
201
|
+
// 菜单底部的**状态行**(如实说这一档现在到底生效成什么,不美化)
|
|
202
|
+
'sem.state.lexical': '当前按词法检索。',
|
|
203
|
+
'sem.state.hybridLive': '混合已生效:语义候选只追加在「相关」层最后,主要 / 辅助两层不动。',
|
|
204
|
+
'sem.state.noProvider': '未配置 provider —— 混合还没生效。',
|
|
205
|
+
// 就地配置入口(未配 provider 时菜单里那一条)
|
|
206
|
+
'sem.cfg.show': '配置语义 provider…',
|
|
207
|
+
'sem.cfg.hide': '收起配置',
|
|
208
|
+
// 混合没生效时的**事实**(宿主只给码,文案在这里)
|
|
209
|
+
'sem.reason.noProvider': '混合检索不可用:还没有配置 provider',
|
|
210
|
+
'sem.reason.probeFailed': '混合检索不可用:provider 连不上',
|
|
211
|
+
'sem.reason.timeout': '混合检索不可用:provider 超时',
|
|
212
|
+
'sem.reason.badResponse': '混合检索不可用:provider 返回了无法解析的结果',
|
|
213
|
+
'sem.reason.noQuery': '混合检索不可用:这一轮没有可用的查询文本',
|
|
214
|
+
'sem.reason.unknown': '混合检索不可用:原因未知(已退回词法)',
|
|
215
|
+
// 防御性:时间序下宿主整层短路,回的是这个码(界面极少走到 —— 那档根本不出现这个下拉)
|
|
216
|
+
'sem.reason.notApplicable': '混合检索不适用:时间序没有相关性分层(已按词法)',
|
|
217
|
+
// 老宿主没有 `semantic` 字段 ⇒ 如实说是宿主的问题,不让用户去配一个用不上的 provider
|
|
218
|
+
'sem.unsupported': '混合检索不可用:当前宿主版本不支持(已退回词法)',
|
|
219
|
+
// 最小配置区(就地一行,不是面板)
|
|
220
|
+
'sem.kindAria': 'provider 类型',
|
|
221
|
+
'sem.kind.ollama': 'Ollama(本地)',
|
|
222
|
+
'sem.kind.openai': 'OpenAI 兼容',
|
|
223
|
+
'sem.basePlaceholder': '服务地址,如 http://127.0.0.1:11434',
|
|
224
|
+
'sem.baseAria': 'provider 服务地址',
|
|
225
|
+
'sem.modelPlaceholder': '模型名,如 nomic-embed-text',
|
|
226
|
+
'sem.modelAria': 'provider 模型名',
|
|
227
|
+
'sem.save': '保存并测试',
|
|
228
|
+
'sem.saving': '测试中…',
|
|
229
|
+
'sem.saveTitle': '保存配置并让宿主探测一次(会发一次请求)',
|
|
230
|
+
'sem.savedOk': '已保存:provider 可用',
|
|
231
|
+
'sem.savedFail': '已保存,但 provider 现在还不可用',
|
|
232
|
+
// ⚠️ 披露措辞不许含糊:回环 = 不离开本机;其余一律明写「会发送到 <地址>」
|
|
233
|
+
'sem.disclose.local': '本地服务:内容不离开这台机器',
|
|
234
|
+
'sem.disclose.empty': '填上服务地址后,这里会写明内容会不会离开这台机器',
|
|
235
|
+
'sem.disclose.remote': '内容会发送到你配置的服务 {base}',
|
|
180
236
|
// 理由码 → 文案。宿主只给码(AGENTS.md §4.5),翻译在这里。
|
|
181
237
|
// ⚠️ 2026-09-29 用户要求把这行压得更克制:原来是「直接命中当前话题:…」,
|
|
182
238
|
// 读起来像调试信息。现在它是**标签 + 值**,词之间用「 · 」分隔。
|
|
@@ -200,6 +256,9 @@ window.__ModuleLoader__.load({
|
|
|
200
256
|
'why.linkTarget': '被主要上下文引用',
|
|
201
257
|
'why.linkSource': '引用了主要上下文',
|
|
202
258
|
'why.related': '与当前任务相关',
|
|
259
|
+
// v0.23:语义补进来的理由。**只陈述可复核的事实**(标题 + 摘要的向量与任务相似),
|
|
260
|
+
// 不许写成「模型觉得相关」这类不可核查的话。
|
|
261
|
+
'why.semantic': '语义相关',
|
|
203
262
|
|
|
204
263
|
'row.tooltip': '{path}\n单击就地预览 · 双击在新标签页打开',
|
|
205
264
|
/* v0.20:命中片段(需求 §12)。**纯 metadata**:行号区间,不是分数、不是评分、
|
|
@@ -229,8 +288,6 @@ window.__ModuleLoader__.load({
|
|
|
229
288
|
'media.play': '播放视频',
|
|
230
289
|
|
|
231
290
|
// 「全部」的分区:类型名复用 kind.doc / kind.media,这里只补计数与跳转
|
|
232
|
-
'section.count': '{shown} / {total}',
|
|
233
|
-
'section.more': '查看全部 →',
|
|
234
291
|
|
|
235
292
|
'preview.loading': '正在读取…',
|
|
236
293
|
'preview.truncated': '(文件较大,仅预览前 512 KB)',
|
|
@@ -412,6 +469,8 @@ window.__ModuleLoader__.load({
|
|
|
412
469
|
'prov.retrieval': 'retrieved',
|
|
413
470
|
'prov.relation': 'relation',
|
|
414
471
|
'prov.manual': 'pinned',
|
|
472
|
+
// v0.23: the fourth provenance (semantic) — same neutral, lowercase word group.
|
|
473
|
+
'prov.semantic': 'semantic',
|
|
415
474
|
'control.pin': 'Pin',
|
|
416
475
|
'control.unpin': 'Unpin',
|
|
417
476
|
'control.exclude': 'Exclude',
|
|
@@ -433,6 +492,48 @@ window.__ModuleLoader__.load({
|
|
|
433
492
|
'pipe.relations': '{n} relations',
|
|
434
493
|
'pipe.pin': '{n} pinned',
|
|
435
494
|
'pipe.pack': '{n} in pack',
|
|
495
|
+
// v0.23 (Phase A): hybrid retrieval. This cell states the mode **in effect**, not the click.
|
|
496
|
+
'pipe.rankHybrid': 'BM25 + semantic',
|
|
497
|
+
'pipe.semantic': '{n} semantic candidates',
|
|
498
|
+
'sem.mode.aria': 'Retrieval mode',
|
|
499
|
+
'sem.mode.lexical': 'Lexical',
|
|
500
|
+
'sem.mode.hybrid': 'Hybrid',
|
|
501
|
+
'sem.mode.lexicalTitle': 'Lexical retrieval: BM25 + IDF, fully local, no model call (default)',
|
|
502
|
+
'sem.mode.hybridTitle': 'Hybrid retrieval (experimental): adds semantic candidates on top of lexical ones; needs a configured provider',
|
|
503
|
+
'sem.mode.lexicalShort': 'lexical⌄',
|
|
504
|
+
'sem.mode.hybridShort': 'hybrid⌄',
|
|
505
|
+
'sem.mode.lexicalOption': 'Lexical retrieval',
|
|
506
|
+
'sem.mode.hybridOption': 'Hybrid retrieval · experimental',
|
|
507
|
+
'sem.mode.lexicalDesc': 'Default: keeps the current BM25 + IDF ranking.',
|
|
508
|
+
'sem.mode.hybridDesc': 'Adds semantic candidates on top of the lexical ones; needs a configured provider.',
|
|
509
|
+
'sem.state.lexical': 'Currently lexical retrieval.',
|
|
510
|
+
'sem.state.hybridLive': 'Hybrid is live: semantic candidates are appended to the related tier only; primary and supporting are unchanged.',
|
|
511
|
+
'sem.state.noProvider': 'No provider configured — hybrid is not active yet.',
|
|
512
|
+
'sem.cfg.show': 'Configure semantic provider…',
|
|
513
|
+
'sem.cfg.hide': 'Hide configuration',
|
|
514
|
+
'sem.reason.noProvider': 'Hybrid retrieval unavailable: no provider configured yet',
|
|
515
|
+
'sem.reason.probeFailed': 'Hybrid retrieval unavailable: provider is unreachable',
|
|
516
|
+
'sem.reason.timeout': 'Hybrid retrieval unavailable: provider timed out',
|
|
517
|
+
'sem.reason.badResponse': 'Hybrid retrieval unavailable: provider returned an unusable response',
|
|
518
|
+
'sem.reason.noQuery': 'Hybrid retrieval unavailable: no usable query text this round',
|
|
519
|
+
'sem.reason.unknown': 'Hybrid retrieval unavailable: unknown reason (fell back to lexical)',
|
|
520
|
+
'sem.reason.notApplicable': 'Hybrid retrieval does not apply: a time-ordered list has no relevance tiers (kept lexical)',
|
|
521
|
+
'sem.unsupported': 'Hybrid retrieval unavailable: this host version does not support it (fell back to lexical)',
|
|
522
|
+
'sem.kindAria': 'Provider kind',
|
|
523
|
+
'sem.kind.ollama': 'Ollama (local)',
|
|
524
|
+
'sem.kind.openai': 'OpenAI-compatible',
|
|
525
|
+
'sem.basePlaceholder': 'Service URL, e.g. http://127.0.0.1:11434',
|
|
526
|
+
'sem.baseAria': 'Provider service URL',
|
|
527
|
+
'sem.modelPlaceholder': 'Model name, e.g. nomic-embed-text',
|
|
528
|
+
'sem.modelAria': 'Provider model name',
|
|
529
|
+
'sem.save': 'Save and test',
|
|
530
|
+
'sem.saving': 'Testing…',
|
|
531
|
+
'sem.saveTitle': 'Save the configuration and let the host probe it once (sends one request)',
|
|
532
|
+
'sem.savedOk': 'Saved: provider is available',
|
|
533
|
+
'sem.savedFail': 'Saved, but the provider is still unavailable',
|
|
534
|
+
'sem.disclose.local': 'Local service: content stays on this machine',
|
|
535
|
+
'sem.disclose.empty': 'Once a service URL is filled in, this line says whether content leaves this machine',
|
|
536
|
+
'sem.disclose.remote': 'Content will be sent to your configured service {base}',
|
|
436
537
|
// Reason codes → copy. The host only ships codes (AGENTS.md §4.5).
|
|
437
538
|
// ⚠️ Flattened on 2026-09-29: "direct topic match: …" read like debug output.
|
|
438
539
|
'why.direct': 'direct match: {term}',
|
|
@@ -445,6 +546,9 @@ window.__ModuleLoader__.load({
|
|
|
445
546
|
'why.linkTarget': 'referenced by a primary document',
|
|
446
547
|
'why.linkSource': 'references a primary document',
|
|
447
548
|
'why.related': 'related to the current task',
|
|
549
|
+
// v0.23: semantic match — states the verifiable fact (title + summary embedding),
|
|
550
|
+
// never "the model thinks this is relevant".
|
|
551
|
+
'why.semantic': 'semantic match',
|
|
448
552
|
|
|
449
553
|
'row.tooltip': '{path}\nClick to preview here · double-click to open in a new tab',
|
|
450
554
|
/* v0.20:matched passage range (requirement §12) — metadata only, never a score. */
|
|
@@ -474,8 +578,6 @@ window.__ModuleLoader__.load({
|
|
|
474
578
|
'media.play': 'Play video',
|
|
475
579
|
|
|
476
580
|
// "All" sections: titles reuse kind.doc / kind.media, only count + jump live here
|
|
477
|
-
'section.count': '{shown} / {total}',
|
|
478
|
-
'section.more': 'View all →',
|
|
479
581
|
|
|
480
582
|
'preview.loading': 'Loading…',
|
|
481
583
|
'preview.truncated': '(large file — showing the first 512 KB)',
|
|
@@ -691,6 +793,14 @@ window.__ModuleLoader__.load({
|
|
|
691
793
|
*/
|
|
692
794
|
const USAGE_KEY = 'dsh-knit:usage'
|
|
693
795
|
|
|
796
|
+
/* ── v0.23(Phase A):检索模式 ──────────────────────────
|
|
797
|
+
默认**词法**。「混合」只是把语义候选**补进候选集**的一种可选模式,
|
|
798
|
+
它要用户显式选、并且配了 provider 才会真的跑 —— 「零模型调用 / 零网络出口」
|
|
799
|
+
这条对外承诺只在默认模式成立(细则见 v0.23 方案 §2 的文案纪律)。 */
|
|
800
|
+
const RETRIEVAL_KEY = 'dsh-knit:retrieval'
|
|
801
|
+
/** 语义 provider 的**唯一写路由**;读走 `/api/recent` 的 `semantic.provider`。 */
|
|
802
|
+
const SEMANTIC_API = '/knit/api/semantic'
|
|
803
|
+
|
|
694
804
|
/** 列表类型:仅文档 / 仅代码 / 仅图片视频 / 全部混排。默认 doc,与旧版体验一致。 */
|
|
695
805
|
const KIND_DOC = 'doc'
|
|
696
806
|
/**
|
|
@@ -738,9 +848,10 @@ window.__ModuleLoader__.load({
|
|
|
738
848
|
⚠️ 留着一套只服务于已删 UI 的常量,下一个人只会以为它还在生效。 */
|
|
739
849
|
|
|
740
850
|
/** 「全部」视图里文档区的固定上限。 */
|
|
741
|
-
|
|
851
|
+
/* v0.23(方案 A):「全部」档的**两个类型上限**已整体删除 ——
|
|
852
|
+
「全部」不再是「文档前 4 + 代码前 4 + 媒体」,而是**整份包的原样**
|
|
853
|
+
(三层混排文档 + 代码,媒体在三层之后一个不截断的网格)。 */
|
|
742
854
|
/** 「全部」视图里代码区的固定上限(与文档区同量级 —— 代码不该在这一档里压过文档)。 */
|
|
743
|
-
const ALL_CODE_CAP = 4
|
|
744
855
|
/**
|
|
745
856
|
* 一屏基准:两行 × 4 列的观感(只在「媒体」这一档决定一屏铺几行时用)。
|
|
746
857
|
* **它不决定列数** —— 列数交给 CSS 的 `auto-fill`,见 mediaLayoutFor。
|
|
@@ -924,6 +1035,32 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
924
1035
|
那根竖线是**边界**,不是把六个选项连成一个整体:排序与类型是两个互不干扰的条件,
|
|
925
1036
|
搜索只过滤当前范围、不重置它们(用户规格 §三.3)。 */
|
|
926
1037
|
.knit-bar{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none}
|
|
1038
|
+
/* v0.23(Phase A):检索模式的两条行 —— 都只在**用户选了混合**时出现,默认词法时一个节点都不产生。
|
|
1039
|
+
① .knit-retnote = 混合没生效时的**事实行**(未配置 / 连不上 / 超时 / 返回不合法 / 没有可用查询文本 /
|
|
1040
|
+
宿主版本较旧)。它是说明,不是错误提示,所以用次级文字色、不占卡片、不弹窗。
|
|
1041
|
+
② .knit-semcfg = 「选了混合 + provider 不可用」时**就地**展开的一行最小配置。
|
|
1042
|
+
不是 Dashboard、不加滚动容器;三格控件都 flex:0/1 + min-width:0,窄面板先缩输入框。 */
|
|
1043
|
+
/* 检索模式那两组控件(工具栏第三组 / 配置区的 provider 类型)用**自己的类名**:
|
|
1044
|
+
样式与 .knit-seg / .knit-seg-btn **逐字同值**(同一套 token、同一组数值、同一档 0.5px 描边),
|
|
1045
|
+
只是它们是**另一个控件** —— 用同一个类名会让「工具栏里恰好两个排序按钮」那类老守卫
|
|
1046
|
+
在查询 knit-seg-btn 时把检索模式的按钮也算进去。
|
|
1047
|
+
⚠️ 这段注释里不许出现反引号 —— 整个 CSS 在一个模板串里,一个反引号就会提前截断它。 */
|
|
1048
|
+
.knit-retseg{display:inline-flex;flex:none;border-radius:10px;overflow:hidden;
|
|
1049
|
+
border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
|
|
1050
|
+
.knit-retseg-btn{height:28px;padding:0 15px;cursor:pointer;font-size:13px;font-weight:400;
|
|
1051
|
+
border:none;background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6);
|
|
1052
|
+
transition:background .16s ease,color .16s ease}
|
|
1053
|
+
.knit-retseg-btn + .knit-retseg-btn{border-left:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
|
|
1054
|
+
.knit-retseg-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
|
|
1055
|
+
.knit-retseg-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
|
|
1056
|
+
color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
|
|
1057
|
+
.knit-retnote{flex:none;padding:0 12px 8px;font-size:11px;line-height:1.5;
|
|
1058
|
+
color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
1059
|
+
.knit-semcfg{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none;flex-wrap:wrap}
|
|
1060
|
+
.knit-semcfg-input{flex:1 1 140px;min-width:0;max-width:240px;height:28px;padding:0 12px;border-radius:10px;
|
|
1061
|
+
font-size:13px;background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);
|
|
1062
|
+
border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12))}
|
|
1063
|
+
.knit-semcfg-note{flex:1 1 100%;font-size:11px;line-height:1.5;color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
927
1064
|
/* 排序组与类型组之间**就这一根线**(用户规格 §二.2:中间用一条浅灰竖线与排序区隔开)。
|
|
928
1065
|
色号取 .knit-seg 外框、.knit-filter 描边同一个 border-l3 ⇒ 三处一样淡;粗细写 1px ——
|
|
929
1066
|
0.5px 的竖线在高分屏上会淡到看不见,它不是描边而是分隔。纯装饰:aria-hidden。 */
|
|
@@ -940,12 +1077,42 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
940
1077
|
/* 搜索框在工具栏**尾部**(用户规格 §二.3:搜索是对当前列表的进一步过滤,放最右符合
|
|
941
1078
|
工具栏惯例)。flex-basis 180px + grow ⇒ 常规面板里就是 180–240px 并贴住右边;
|
|
942
1079
|
max-width 240px 封顶之后剩下的空间交给 margin-left:auto(否则它会一路长到面板边缘)。
|
|
943
|
-
⚠️ min-width:0 = 面板窄了**先缩搜索框**;前面两组都 flex:none,永远不被它挤。
|
|
944
|
-
.
|
|
945
|
-
|
|
946
|
-
|
|
1080
|
+
⚠️ min-width:0 = 面板窄了**先缩搜索框**;前面两组都 flex:none,永远不被它挤。
|
|
1081
|
+
v0.23(2026-10-11 用户裁决):描边从 input 挪到**外层容器** —— 因为检索模式那个小下拉
|
|
1082
|
+
就贴在容器右端(中间一条细左线),两者共用一圈描边才像一个整体控件。
|
|
1083
|
+
焦点态挪到 :focus-within(输入框与下拉谁拿到焦点,外框都亮)—— 行为与原来一致。 */
|
|
1084
|
+
.knit-searchwrap{display:flex;align-items:center;flex:1 1 180px;min-width:0;max-width:240px;margin-left:auto;
|
|
1085
|
+
border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));border-radius:10px;
|
|
947
1086
|
transition:border-color .16s ease}
|
|
948
|
-
.knit-
|
|
1087
|
+
.knit-searchwrap:focus-within{border-color:var(--knit-accent)}
|
|
1088
|
+
.knit-filter{flex:1 1 auto;min-width:0;height:28px;padding:0 12px;border:none;border-radius:10px;font-size:13px;
|
|
1089
|
+
background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);outline:none}
|
|
1090
|
+
/* 检索模式:搜索框右端的小下拉。**只在相关档出现**,不出现时搜索框自己占满,
|
|
1091
|
+
没有空位、也没有置灰的禁用态。 */
|
|
1092
|
+
.knit-retmode{position:relative;flex:none}
|
|
1093
|
+
.knit-retmode-btn{height:28px;padding:0 10px;cursor:pointer;font-size:12px;font-weight:400;white-space:nowrap;
|
|
1094
|
+
border:none;border-left:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));
|
|
1095
|
+
background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
1096
|
+
.knit-retmode-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
|
|
1097
|
+
color:var(--dsw-alias-label-primary,#e8eaed)}
|
|
1098
|
+
.knit-retmode-btn[aria-expanded="true"]{background:var(--knit-active-bg,rgba(255,255,255,.085));
|
|
1099
|
+
color:var(--dsw-alias-label-primary,#e8eaed)}
|
|
1100
|
+
.knit-retmenu{position:absolute;right:0;top:32px;z-index:20;width:272px;padding:6px;text-align:left;
|
|
1101
|
+
background:var(--dsw-alias-bg-base,#151517);border:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));
|
|
1102
|
+
border-radius:10px;box-shadow:0 10px 26px rgba(0,0,0,.28)}
|
|
1103
|
+
.knit-retmenu-item{display:block;width:100%;text-align:left;cursor:pointer;padding:8px 9px;border-radius:8px;
|
|
1104
|
+
border:none;background:transparent;color:var(--dsw-alias-label-primary,#e8eaed)}
|
|
1105
|
+
.knit-retmenu-item:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
|
|
1106
|
+
.knit-retmenu-item.active{background:var(--knit-active-bg,rgba(255,255,255,.085))}
|
|
1107
|
+
.knit-retmenu-item strong{display:block;font-size:12.5px;font-weight:600}
|
|
1108
|
+
.knit-retmenu-item span{display:block;margin-top:3px;font-size:11px;line-height:1.5;
|
|
1109
|
+
color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
1110
|
+
.knit-retmenu-note{margin-top:4px;padding:7px 9px 4px;font-size:11px;line-height:1.5;
|
|
1111
|
+
border-top:0.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.12));
|
|
1112
|
+
color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
1113
|
+
.knit-retmenu-cfg{display:block;width:100%;text-align:left;cursor:pointer;padding:7px 9px;border:none;
|
|
1114
|
+
background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);font-size:12px}
|
|
1115
|
+
.knit-retmenu-cfg:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
|
|
949
1116
|
.knit-filter::placeholder{color:var(--dsw-alias-label-caption,#80868b)}
|
|
950
1117
|
/* v0.15「使用情况」→ v0.18「Context Usage Lens」:**列表上方的一块轻量观察层**。
|
|
951
1118
|
不是弹窗、不是新页面、不是 Dashboard、不画卡片、不画进度条、不用品牌色。
|
|
@@ -1577,7 +1744,6 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
1577
1744
|
padding:8px 12px 16px;align-content:start;min-height:0}
|
|
1578
1745
|
/* 分区里的网格:不留内边距。滚动一律交给 .knit-list,网格自己**不滚** ——
|
|
1579
1746
|
嵌套滚动会在「全部」里变成滚动陷阱,而且封顶高度必然截断最后一行。 */
|
|
1580
|
-
.knit-media-grid.in-section{padding:0}
|
|
1581
1747
|
.knit-media-card{min-width:0;cursor:pointer;border-radius:10px}
|
|
1582
1748
|
.knit-media-thumbbox{position:relative;width:100%;height:var(--knit-media-cell,auto);aspect-ratio:1/1;
|
|
1583
1749
|
border-radius:9px;overflow:hidden;
|
|
@@ -1610,16 +1776,6 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
1610
1776
|
background:rgba(0,0,0,.7);color:#fff;font-size:10px;line-height:1.5;font-variant-numeric:tabular-nums;
|
|
1611
1777
|
pointer-events:none}
|
|
1612
1778
|
|
|
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
1779
|
/* ── 预览面板里的图片 / 视频 ───────────────────────── */
|
|
1624
1780
|
.knit-preview-body.is-media{display:flex;align-items:center;justify-content:center;
|
|
1625
1781
|
padding:12px;background:rgba(0,0,0,.22)}
|
|
@@ -1738,6 +1894,60 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
1738
1894
|
return readPref(USAGE_KEY) === '1'
|
|
1739
1895
|
}
|
|
1740
1896
|
|
|
1897
|
+
/**
|
|
1898
|
+
* 读用户上次选的检索模式。**没写过、写坏了都回词法**(默认值是安全的那一个)。
|
|
1899
|
+
* @returns {'lexical'|'hybrid'} 检索模式
|
|
1900
|
+
*/
|
|
1901
|
+
function readRetrievalPref() {
|
|
1902
|
+
return readPref(RETRIEVAL_KEY) === 'hybrid' ? 'hybrid' : 'lexical'
|
|
1903
|
+
}
|
|
1904
|
+
|
|
1905
|
+
/**
|
|
1906
|
+
* provider 地址是不是**本机回环**。只有回环才敢说「内容不离开这台机器」;
|
|
1907
|
+
* 其它(含空地址)一律按「会发送到你配置的服务」披露 —— 宁可说得重一点。
|
|
1908
|
+
* @param {string} base - 服务地址
|
|
1909
|
+
* @returns {boolean} 是否回环
|
|
1910
|
+
*/
|
|
1911
|
+
function isLoopbackBase(base) {
|
|
1912
|
+
const text = String(base || '').trim().toLowerCase()
|
|
1913
|
+
if (!text) return false
|
|
1914
|
+
const host = text.replace(/^[a-z][a-z0-9+.-]*:\/\//, '').split('/')[0].replace(/:\d+$/, '')
|
|
1915
|
+
return host === '127.0.0.1' || host === 'localhost' || host === '::1' || host === '[::1]'
|
|
1916
|
+
}
|
|
1917
|
+
|
|
1918
|
+
/**
|
|
1919
|
+
* 把一个选择器对应的元素聚焦。**只在真浏览器里有用**:测试替身(test/harness.mjs)
|
|
1920
|
+
* 没有真 `document`,SSR 里也没有 —— 所以整段包在 try 里,失败一律静默(聚焦失败
|
|
1921
|
+
* 不该影响任何行为,更不能让面板崩)。
|
|
1922
|
+
* @param {string} selector - CSS 选择器
|
|
1923
|
+
*/
|
|
1924
|
+
function focusFirst(selector) {
|
|
1925
|
+
try {
|
|
1926
|
+
if (typeof document === 'undefined' || !document || typeof document.querySelector !== 'function') return
|
|
1927
|
+
const node = document.querySelector(selector)
|
|
1928
|
+
if (node && typeof node.focus === 'function') node.focus()
|
|
1929
|
+
} catch (error) {
|
|
1930
|
+
// 故意吞掉:焦点是锦上添花,不是功能
|
|
1931
|
+
}
|
|
1932
|
+
}
|
|
1933
|
+
|
|
1934
|
+
/**
|
|
1935
|
+
* 宿主给的 reason 码 → i18n 键。**宿主只给码、不给文案**(AGENTS.md §4.5)。
|
|
1936
|
+
* @param {string} reason - 宿主码
|
|
1937
|
+
* @returns {string} i18n 键
|
|
1938
|
+
*/
|
|
1939
|
+
function semanticReasonKey(reason) {
|
|
1940
|
+
if (reason === 'no-provider') return 'sem.reason.noProvider'
|
|
1941
|
+
if (reason === 'probe-failed') return 'sem.reason.probeFailed'
|
|
1942
|
+
if (reason === 'timeout') return 'sem.reason.timeout'
|
|
1943
|
+
if (reason === 'bad-response') return 'sem.reason.badResponse'
|
|
1944
|
+
if (reason === 'no-query') return 'sem.reason.noQuery'
|
|
1945
|
+
// 防御性:时间序下宿主整层短路(`not-applicable`)。那档下拉根本不出现,
|
|
1946
|
+
// 但老/新宿主混合时仍可能回这个码 ⇒ 不许掉进「原因未知」。
|
|
1947
|
+
if (reason === 'not-applicable') return 'sem.reason.notApplicable'
|
|
1948
|
+
return 'sem.reason.unknown'
|
|
1949
|
+
}
|
|
1950
|
+
|
|
1741
1951
|
/**
|
|
1742
1952
|
* 把预览高度比例夹到合法区间。
|
|
1743
1953
|
* @param {number} value - 原始比例
|
|
@@ -2044,8 +2254,12 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
2044
2254
|
// 「直接命中」后面跟一个「knit · client」)—— 它读起来是**标签 + 值**,不是一句话。
|
|
2045
2255
|
const shown = terms.slice(0, 2).join(' · ')
|
|
2046
2256
|
const key = `why.${reason.code}`
|
|
2047
|
-
//
|
|
2048
|
-
//
|
|
2257
|
+
// v0.23 加固:**先看词典里有没有这个码**,再有条件地交给 `t()`。
|
|
2258
|
+
// 未知码不赌官方 `bind()` 的缺失键行为(可能是 `undefined`),而是把键名显示出来 ——
|
|
2259
|
+
// 宿主加了新码而客户端还没跟上时,用户看到 `why.xxx` 这种明显异常,
|
|
2260
|
+
// 而不是一条静默的空行,更不是一个 `undefined`。
|
|
2261
|
+
// (`ZH` 与 `EN` 的键集由 `test/i18n.test.mjs` 守齐,所以只查一本就够。)
|
|
2262
|
+
if (ZH[key] === undefined) return key
|
|
2049
2263
|
if (!terms.length) {
|
|
2050
2264
|
const plain = `${key}Plain`
|
|
2051
2265
|
return ZH[plain] !== undefined ? t(plain) : t(key)
|
|
@@ -2053,6 +2267,23 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
2053
2267
|
return t(key, { term: shown })
|
|
2054
2268
|
}
|
|
2055
2269
|
|
|
2270
|
+
/**
|
|
2271
|
+
* v0.23:来源徽标的文案。**只认词典里真有的那几档**
|
|
2272
|
+
* (`retrieval` / `relation` / `manual` / `semantic`);未知值一律 `null` ⇒ **不给徽标**。
|
|
2273
|
+
*
|
|
2274
|
+
* 为什么不把未知值交给 `t()`:来源是宿主给的字符串,客户端不认识时既不该抛,
|
|
2275
|
+
* 也不该把裸码(`prov.mystery`)或 `undefined` 渲染到界面上 —— 与 `DocRow` 调用点
|
|
2276
|
+
* 那条纪律同源:「平铺列表里的条目来源未知,不能替它认领一个『检索』」。
|
|
2277
|
+
*
|
|
2278
|
+
* @param {unknown} provenance - 宿主给的那一档
|
|
2279
|
+
* @returns {string|null} 文案或 null
|
|
2280
|
+
*/
|
|
2281
|
+
function provText(provenance) {
|
|
2282
|
+
if (typeof provenance !== 'string' || provenance.length === 0) return null
|
|
2283
|
+
const key = `prov.${provenance}`
|
|
2284
|
+
return ZH[key] !== undefined ? t(key) : null
|
|
2285
|
+
}
|
|
2286
|
+
|
|
2056
2287
|
function docOptionId(doc) {
|
|
2057
2288
|
const rel = String(doc.rel || doc.path || '')
|
|
2058
2289
|
const safe = rel.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 48)
|
|
@@ -2188,9 +2419,7 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
2188
2419
|
const MOTION_EASE = 'cubic-bezier(.22,1,.36,1)'
|
|
2189
2420
|
/** 幽灵行所在的「区」:分层视图用层名,平铺与「全部」各一个 —— 幽灵要插回原位。 */
|
|
2190
2421
|
const MOTION_TIER_FLAT = 'flat'
|
|
2191
|
-
const MOTION_TIER_ALL_DOCS = 'all-docs'
|
|
2192
2422
|
/** v0.19:「全部」档里的代码区自己的区名 —— 幽灵行要插回**它原来那一区**,共用会插错位置。 */
|
|
2193
|
-
const MOTION_TIER_ALL_CODE = 'all-code'
|
|
2194
2423
|
/** 幸存行位移(换层 / 重排)的 FLIP 时长:比进入略长,它要真的「走」完一段距离。 */
|
|
2195
2424
|
const MOTION_MOVE_MS = 340
|
|
2196
2425
|
/** 位移小于这个像素数(含亚像素抖动)就当没动过,不排补间。 */
|
|
@@ -3529,6 +3758,9 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3529
3758
|
// `{pinned, excluded, skipped, persisted}`;`skipped` 是**这一批真的被排掉几篇**
|
|
3530
3759
|
// (不是 excluded 的长度 —— 被排除的文件可能已经不在工作区里了)。
|
|
3531
3760
|
control: null,
|
|
3761
|
+
// v0.23:宿主回的 `semantic`(模式 / 是否可用 / 原因 / 候选数 / provider)。
|
|
3762
|
+
// ⚠️ **老宿主没有这个字段** ⇒ 保持 null,界面按「宿主不支持混合检索」如实降级。
|
|
3763
|
+
semantic: null,
|
|
3532
3764
|
})
|
|
3533
3765
|
const [preview, setPreview] = React.useState(null)
|
|
3534
3766
|
/* v0.20 性能治理:**一分钟一次**的刷新信号。相对时间标签是按分钟变的,所以轮询只在
|
|
@@ -3567,6 +3799,16 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3567
3799
|
// 为什么在这里」的补充说明,同时展开多条就不是在看一行了。仍然放在最后(同上)。
|
|
3568
3800
|
const [whyOpen, setWhyOpen] = React.useState('')
|
|
3569
3801
|
|
|
3802
|
+
/* v0.23(Phase A):检索模式 + provider 配置。
|
|
3803
|
+
⚠️ 四个 hook 都**追加在最后**:前面的槽位被测试按位预置(notice / sort / …),
|
|
3804
|
+
插队会让老用例读到错的状态。`semForm` 用 `null` 表示「还没编辑过」——
|
|
3805
|
+
那时表单值从宿主回的 `semantic.provider` 现推(见渲染里的 `semForm0`),
|
|
3806
|
+
所以不需要额外的同步 effect。 */
|
|
3807
|
+
const [retrieval, setRetrieval] = React.useState(readRetrievalPref)
|
|
3808
|
+
const [semForm, setSemForm] = React.useState(null)
|
|
3809
|
+
const [semBusy, setSemBusy] = React.useState(false)
|
|
3810
|
+
const [semNotice, setSemNotice] = React.useState('')
|
|
3811
|
+
|
|
3570
3812
|
/* ── 曾经在这里的三个状态 + 一个 ref:右栏的形态 ──────────
|
|
3571
3813
|
`packWidth`(310) / `packFloat`(null) / `packSnap`(false) / `packColRef`。
|
|
3572
3814
|
**2026-09-29 随右栏一起删除**。当时它们**只存在内存里**(刷新回默认值),
|
|
@@ -3606,7 +3848,9 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3606
3848
|
try {
|
|
3607
3849
|
// `usage=1` 是**开闸**(不是「顺便取一下」):宿主只有看到它才会开始给这个会话记账。
|
|
3608
3850
|
// 没打开「使用情况」的会话,宿主侧一个事件都不读。
|
|
3609
|
-
|
|
3851
|
+
// v0.23:`retrieval` 是**选填**参数 —— 老宿主忽略它(那就等于词法),
|
|
3852
|
+
// 而词法模式下宿主**一次 provider 调用都不会发**(方案 §9.2 判据 1)。
|
|
3853
|
+
const url = `${LIST_API}?sessionId=${encodeURIComponent(sessionId)}&limit=40&sort=${sort}&kind=${kind}&retrieval=${sort === 'relevance' && retrieval === 'hybrid' ? 'hybrid' : 'lexical'}${usageOn ? '&usage=1' : ''}`
|
|
3610
3854
|
const res = await fetch(url, { headers: { accept: 'application/json' }, cache: 'no-store' })
|
|
3611
3855
|
const data = await res.json()
|
|
3612
3856
|
if (!live()) return
|
|
@@ -3630,6 +3874,8 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3630
3874
|
usage: data.usage || null,
|
|
3631
3875
|
// v0.21:固定 / 排除的原始记录(面板要拿它画固定区、排除说明与管道条)。
|
|
3632
3876
|
control: data.control || null,
|
|
3877
|
+
// v0.23:`semantic` 可能不存在(老宿主)⇒ null,界面据此如实降级。
|
|
3878
|
+
semantic: data.semantic || null,
|
|
3633
3879
|
sig,
|
|
3634
3880
|
}))
|
|
3635
3881
|
} else {
|
|
@@ -3643,7 +3889,7 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3643
3889
|
// 返回同一个值,React 直接跳过这次更新)。标签读的是渲染时刻的钟,不受这里影响。
|
|
3644
3890
|
const now = Date.now()
|
|
3645
3891
|
bumpTick((prev) => (Math.floor(now / 60000) === Math.floor(prev / 60000) ? prev : now))
|
|
3646
|
-
}, [sessionId, sort, kind, usageOn])
|
|
3892
|
+
}, [sessionId, sort, kind, usageOn, retrieval])
|
|
3647
3893
|
|
|
3648
3894
|
React.useEffect(() => {
|
|
3649
3895
|
// 看不见就一个定时器都不挂:`visible` 变回 true 时本 effect 重跑,立刻 load 一次。
|
|
@@ -3701,16 +3947,14 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3701
3947
|
|| String(doc.rel || '').toLowerCase().includes(q))
|
|
3702
3948
|
}, [state.docs, query])
|
|
3703
3949
|
|
|
3704
|
-
/* ──
|
|
3705
|
-
|
|
3706
|
-
|
|
3707
|
-
|
|
3708
|
-
|
|
3709
|
-
|
|
3710
|
-
const
|
|
3711
|
-
const
|
|
3712
|
-
const shownDocs = docItems.slice(0, ALL_DOC_CAP)
|
|
3713
|
-
const shownCode = codeItems.slice(0, ALL_CODE_CAP)
|
|
3950
|
+
/* ── 「全部」= **整份包的原样**(v0.23 方案 A,2026-10-12 用户裁决)──────
|
|
3951
|
+
三层(主要 / 辅助 / 相关)里**文档与代码混排**,顺序就是阅读顺序;没有类型分区、
|
|
3952
|
+
没有「每区 4 条」、没有「查看全部 →」。媒体**不在包里**(宿主已把媒体剔出装配),
|
|
3953
|
+
所以它们在三层之后**单独一个不截断的网格**,也不会与层里的条目重复。
|
|
3954
|
+
⇒ 四个类型档的关系因此变得一句话说得清:`全部` = 包的原样;
|
|
3955
|
+
`文档 / 代码 / 媒体` = 把同一个包(或同一批语料)过滤到某类。 */
|
|
3956
|
+
const allRows = kind === KIND_ALL ? visibleDocs.filter((doc) => !isMedia(doc)) : []
|
|
3957
|
+
const allMedia = kind === KIND_ALL ? visibleDocs.filter(isMedia) : []
|
|
3714
3958
|
// ResizeObserver 量到的是 .knit-list(它自己也有左右内边距),
|
|
3715
3959
|
// 网格的可用宽度 = 列表宽度 − 列表内边距 − 网格内边距。
|
|
3716
3960
|
// 文档列表**没有列数可算**:永远一个文档一行(见 `DOC_GRID` 那段说明)。
|
|
@@ -3719,8 +3963,10 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3719
3963
|
|
|
3720
3964
|
/** 媒体网格:列数由 CSS 的 auto-fill 自己数;JS 只下发「一格多宽」用于正方形兜底。
|
|
3721
3965
|
* **不设 maxHeight** —— 有多少行就铺多少行,纵向滚动统一交给 `.knit-list`。 */
|
|
3722
|
-
|
|
3723
|
-
|
|
3966
|
+
// v0.23:`inSection` 参数随「全部」的类型分区一起删除 —— 媒体网格只有一种形态
|
|
3967
|
+
// (不带 `.in-section`,外层自己带内边距)。
|
|
3968
|
+
const mediaGrid = (docs) => h('div', {
|
|
3969
|
+
className: 'knit-media-grid',
|
|
3724
3970
|
role: 'group',
|
|
3725
3971
|
style: {
|
|
3726
3972
|
'--knit-media-cell': `${mediaLayout.cell}px`,
|
|
@@ -3811,13 +4057,18 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3811
4057
|
*/
|
|
3812
4058
|
const contextView = React.useMemo(() => {
|
|
3813
4059
|
const pack = state.context
|
|
3814
|
-
|
|
4060
|
+
// v0.23:`全部` 与 `文档`/`代码` 走**同一条**分层渲染路径 —— 区别只在
|
|
4061
|
+
// `visibleDocs` 是哪个类型档过滤出来的那一批(媒体由下面的末尾网格接手)。
|
|
4062
|
+
if (!relevance || (kind !== KIND_DOC && kind !== KIND_CODE && kind !== KIND_ALL) || !pack) return null
|
|
3815
4063
|
const tiers = [
|
|
3816
4064
|
['primary', 'context.primary', 'context.primaryHint'],
|
|
3817
4065
|
['supporting', 'context.supporting', 'context.supportingHint'],
|
|
3818
4066
|
['related', 'context.related', 'context.relatedHint'],
|
|
3819
4067
|
]
|
|
3820
|
-
|
|
4068
|
+
// v0.23:层级过滤只认**成行的条目**(文档 / 代码)—— 媒体**永远不进层**。
|
|
4069
|
+
// 宿主侧已经在装配之前把媒体剔掉了(`contextPayload()`),这里是第二道防线:
|
|
4070
|
+
// 就算哪天宿主把一个靠文件名命中的 `.mp4` 塞进包里,界面也不会把它当上下文渲染。
|
|
4071
|
+
const visible = new Set(visibleDocs.filter((doc) => !isMedia(doc)).map((doc) => doc.rel))
|
|
3821
4072
|
/* v0.20 修正:宿主给三层条目的投影**只有 7 个键**(`context.js` 的
|
|
3822
4073
|
`rel/title/summary/mtimeMs/kind/source/reason`)—— 那里**没有 `matches`**,
|
|
3823
4074
|
而「命中片段」那一行读的是 `doc.matches`(下面的 `firstMatchOf`)。
|
|
@@ -3882,7 +4133,9 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
3882
4133
|
* 会被算两次。「全部」档里文档只到上限,媒体全部可达。
|
|
3883
4134
|
*/
|
|
3884
4135
|
const navDocs = kind === KIND_ALL
|
|
3885
|
-
|
|
4136
|
+
// 「全部」:三层里真的渲染出来的那些(文档 + 代码)**加上**末尾网格里的媒体 ——
|
|
4137
|
+
// 媒体不是行,但它照样要能被键盘选中、也能被预览。
|
|
4138
|
+
? (contextView ? contextView.flat : allRows).concat(allMedia)
|
|
3886
4139
|
: (contextView ? contextView.flat : visibleDocs)
|
|
3887
4140
|
|
|
3888
4141
|
// cursor 消失(被过滤掉 / 被上限截断 / 列表刷新)时落回第一项
|
|
@@ -4240,6 +4493,17 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4240
4493
|
/** 媒体条目的同源字节地址(缩略图 / 就地预览)。 */
|
|
4241
4494
|
const srcFor = React.useCallback((doc) => mediaUrl(sessionId, doc.rel), [sessionId])
|
|
4242
4495
|
|
|
4496
|
+
/**
|
|
4497
|
+
* 切换检索模式并记住偏好。**只切偏好**:真正的 provider 调用发生在宿主侧,
|
|
4498
|
+
* 下一次 `load()` 会带上新的 `retrieval`。切回词法时把配置区的提示清掉。
|
|
4499
|
+
* @param {'lexical'|'hybrid'} value - 检索模式
|
|
4500
|
+
*/
|
|
4501
|
+
const pickRetrieval = React.useCallback((value) => {
|
|
4502
|
+
writePref(RETRIEVAL_KEY, value)
|
|
4503
|
+
setRetrieval(value)
|
|
4504
|
+
setSemNotice('')
|
|
4505
|
+
}, [])
|
|
4506
|
+
|
|
4243
4507
|
/** 切换列表类型并记住偏好;同时收起上一类型的预览。 */
|
|
4244
4508
|
const pickKind = React.useCallback((value) => {
|
|
4245
4509
|
writePref(KIND_KEY, value)
|
|
@@ -4344,6 +4608,34 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4344
4608
|
/** 面板高度(px)。0 = 量不到(测试替身 / 首帧)——那时按「不矮」处理,不降级。 */
|
|
4345
4609
|
const [panelH, setPanelH] = React.useState(0)
|
|
4346
4610
|
|
|
4611
|
+
/* v0.23(2026-10-11):检索模式改成搜索框右端的小下拉后的两个状态。
|
|
4612
|
+
⚠️ 与上面那条注释同一条纪律:**必须留在本组件所有既有 hook 之后**,
|
|
4613
|
+
否则 `harness.seed()` 的位置预置会整体错位。 */
|
|
4614
|
+
/** 那个小菜单开着没有。 */
|
|
4615
|
+
const [retMenuOpen, setRetMenuOpen] = React.useState(false)
|
|
4616
|
+
/** 就地配置区(`.knit-semcfg`)展开了没有 —— 由菜单里「配置语义 provider…」开关。 */
|
|
4617
|
+
const [semCfgOpen, setSemCfgOpen] = React.useState(false)
|
|
4618
|
+
|
|
4619
|
+
/** 配置区一展开就把焦点送进第一个输入框(键盘用户不用自己 Tab 过去)。 */
|
|
4620
|
+
React.useEffect(() => {
|
|
4621
|
+
if (semCfgOpen) focusFirst('.knit-semcfg-input')
|
|
4622
|
+
}, [semCfgOpen])
|
|
4623
|
+
|
|
4624
|
+
/** 点面板别处就收起菜单。判据用「点在 `.knit-retmode` 之内就放过」——
|
|
4625
|
+
* 否则按钮自己的点击会先关(pointerdown)再开(click),菜单根本打不开。
|
|
4626
|
+
* ⚠️ 测试替身里 `window.addEventListener` 是空实现 ⇒ 这条只在真机生效,
|
|
4627
|
+
* 所以 Esc 那条**必须**另外挂在按钮与菜单上(可被断言)。 */
|
|
4628
|
+
React.useEffect(() => {
|
|
4629
|
+
if (!retMenuOpen) return undefined
|
|
4630
|
+
const onPointerDown = (event) => {
|
|
4631
|
+
const node = event && event.target
|
|
4632
|
+
if (node && typeof node.closest === 'function' && node.closest('.knit-retmode')) return
|
|
4633
|
+
setRetMenuOpen(false)
|
|
4634
|
+
}
|
|
4635
|
+
window.addEventListener('pointerdown', onPointerDown)
|
|
4636
|
+
return () => window.removeEventListener('pointerdown', onPointerDown)
|
|
4637
|
+
}, [retMenuOpen])
|
|
4638
|
+
|
|
4347
4639
|
/** 点 Coverage 的某一层 → 滚到那一层 + 短暂高亮。
|
|
4348
4640
|
* ⚠️ 滚的是 `.knit-list`(唯一滚动容器):Lens 自己不滚动,也不新增容器。
|
|
4349
4641
|
* ⚠️ 高亮走 state 而不是直接改 classList —— 这样测试替身里也能断言到结果。 */
|
|
@@ -4395,16 +4687,8 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4395
4687
|
const motionRows = (() => {
|
|
4396
4688
|
if (state.status === 'error' || state.docs.length === 0 || visibleDocs.length === 0) return []
|
|
4397
4689
|
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
4690
|
if (contextView) {
|
|
4691
|
+
// 有包(相关序):三层的 key 就是运动分组 —— 「全部」与「文档」走同一条路。
|
|
4408
4692
|
const rows = []
|
|
4409
4693
|
for (const section of contextView.sections) {
|
|
4410
4694
|
section.docs.forEach((doc, index) => rows.push(
|
|
@@ -4412,7 +4696,9 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4412
4696
|
}
|
|
4413
4697
|
return rows
|
|
4414
4698
|
}
|
|
4415
|
-
|
|
4699
|
+
// 平铺(时间序 / 没有包):**媒体不进行**,它们走末尾那个网格。
|
|
4700
|
+
const flatRows = kind === KIND_ALL ? allRows : visibleDocs
|
|
4701
|
+
return flatRows.map((doc, index) => (
|
|
4416
4702
|
{ rel: doc.rel, tierKey: MOTION_TIER_FLAT, index, doc }))
|
|
4417
4703
|
})()
|
|
4418
4704
|
const motion = (() => {
|
|
@@ -4537,7 +4823,7 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4537
4823
|
// 平铺列表里的条目来源未知,不能替它认领一个「检索」。
|
|
4538
4824
|
const controllable = Boolean(contextView && !isMedia(doc))
|
|
4539
4825
|
return h(DocRow, { ...common, relevance, why: whyText(doc.reason), num, mark, primary,
|
|
4540
|
-
prov:
|
|
4826
|
+
prov: provText(doc.provenance),
|
|
4541
4827
|
pinned: doc.provenance === 'manual',
|
|
4542
4828
|
onAct: controllable ? act : null,
|
|
4543
4829
|
whyOpen: Boolean(whyOpen) && whyOpen === doc.rel,
|
|
@@ -4560,37 +4846,6 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4560
4846
|
leaving: Boolean(doc.knitLeaving) })
|
|
4561
4847
|
}
|
|
4562
4848
|
|
|
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
4849
|
// 媒体视图:一格都不隐藏 —— 一屏两行以外的部分在媒体区**内部滚动**,
|
|
4595
4850
|
// 既不让面板被整面媒体墙顶爆,也不会像旧版那样把剩下的条目直接切掉。
|
|
4596
4851
|
const emptyText = kind === KIND_MEDIA
|
|
@@ -4607,9 +4862,13 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4607
4862
|
: visibleDocs.length === 0
|
|
4608
4863
|
? h('div', { className: 'knit-msg' }, t('list.noMatch', { query: query.trim() }))
|
|
4609
4864
|
: kind === KIND_MEDIA
|
|
4610
|
-
? mediaGrid(visibleDocs
|
|
4865
|
+
? mediaGrid(visibleDocs)
|
|
4611
4866
|
: kind === KIND_ALL
|
|
4612
|
-
|
|
4867
|
+
// 「全部」= 包的原样(或时间序下一条平铺的最近改动)+ 末尾**不截断**的媒体网格。
|
|
4868
|
+
// 顺序是语义的一部分:媒体排在整份阅读顺序之后,不与层里的条目穿插。
|
|
4869
|
+
? h(React.Fragment, null,
|
|
4870
|
+
contextView ? contextBody(contextView) : docsGrid(withGhosts(MOTION_TIER_FLAT, allRows)),
|
|
4871
|
+
allMedia.length > 0 ? mediaGrid(allMedia) : null)
|
|
4613
4872
|
: contextView
|
|
4614
4873
|
? contextBody(contextView)
|
|
4615
4874
|
: docsGrid(withGhosts(MOTION_TIER_FLAT, visibleDocs))
|
|
@@ -4907,6 +5166,114 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4907
5166
|
const pipeDot = () => h('span', { className: 'knit-pipedot', 'aria-hidden': 'true' }, '·')
|
|
4908
5167
|
const pipeSep = () => h('span', { className: 'knit-pipesep', 'aria-hidden': 'true' }, '|')
|
|
4909
5168
|
const pinnedCount = pack && Array.isArray(pack.pinned) ? pack.pinned.length : 0
|
|
5169
|
+
|
|
5170
|
+
/* ── v0.23(Phase A):从宿主回的 `semantic` 推出来的几个量 ─────────────
|
|
5171
|
+
`semLive` 只看**实际生效**的模式:`mode === 'hybrid'` 才算语义真的在跑;
|
|
5172
|
+
点了混合而宿主回 lexical(不可用 / 未配置 / 老宿主)⇒ 一律走「如实说明」这条。 */
|
|
5173
|
+
const semInfo = state.semantic || null
|
|
5174
|
+
const semOn = retrieval === 'hybrid'
|
|
5175
|
+
const semLive = !!(semInfo && semInfo.mode === 'hybrid')
|
|
5176
|
+
const semCandidateCount = semInfo ? Math.max(0, Number(semInfo.candidates) || 0) : 0
|
|
5177
|
+
const semProvider = semInfo && semInfo.provider ? semInfo.provider : null
|
|
5178
|
+
const semForm0 = semForm || (semProvider
|
|
5179
|
+
? { kind: semProvider.kind, base: semProvider.base, model: semProvider.model }
|
|
5180
|
+
: { kind: 'ollama', base: '', model: '' })
|
|
5181
|
+
const semReasonText = semInfo
|
|
5182
|
+
? t(semanticReasonKey(semInfo.reason))
|
|
5183
|
+
: t('sem.unsupported')
|
|
5184
|
+
|
|
5185
|
+
/* v0.23(2026-10-11 用户裁决):**检索模式贴在搜索框右端的小下拉里**,而且只在「相关」档出现。
|
|
5186
|
+
理由(都在代码里):时间序没有 Context Pack 分层(宿主 `contextPayload()` 要求
|
|
5187
|
+
`sort === 'relevance'`),语义候选无处可落;宿主那侧也已按 `not-applicable` 整层短路。
|
|
5188
|
+
⚠️ **不再看 provider 配没配**(本次放宽):未配也出现 —— Knit 还没有设置页,
|
|
5189
|
+
藏起来用户就永远打不开这个功能;菜单里如实写状态,并就地给配置入口。
|
|
5190
|
+
⚠️ **永远不做置灰禁用态**。 */
|
|
5191
|
+
const showRetrieval = sort === 'relevance'
|
|
5192
|
+
const semReason = semInfo && typeof semInfo.reason === 'string' ? semInfo.reason : null
|
|
5193
|
+
/** 菜单底部那行状态:如实说这一档现在到底生效成什么(不美化、不猜)。 */
|
|
5194
|
+
const semStateText = !semOn
|
|
5195
|
+
? t('sem.state.lexical')
|
|
5196
|
+
: (semLive
|
|
5197
|
+
? t('sem.state.hybridLive')
|
|
5198
|
+
: (semReason && semReason !== 'no-provider'
|
|
5199
|
+
? t(semanticReasonKey(semReason))
|
|
5200
|
+
: t('sem.state.noProvider')))
|
|
5201
|
+
/** 「配置语义 provider…」入口只在「选了混合但没生效」时给 —— 其它状态下配置是无意义的动作。 */
|
|
5202
|
+
const semCanConfigure = semOn && !semLive
|
|
5203
|
+
/** Esc:关菜单并把焦点还给按钮(键盘可达性)。挂按钮与菜单两处,测试可断言。 */
|
|
5204
|
+
const closeRetMenuOnEscape = (event) => {
|
|
5205
|
+
if (!event || event.key !== 'Escape') return
|
|
5206
|
+
event.stopPropagation()
|
|
5207
|
+
setRetMenuOpen(false)
|
|
5208
|
+
focusFirst('.knit-retmode-btn')
|
|
5209
|
+
}
|
|
5210
|
+
|
|
5211
|
+
/* 保存并测试:**一次 POST**(宿主会 probe 一次,并在响应里回 `available` / `reason`)。
|
|
5212
|
+
成功后把表单交还给宿主的回值(`setSemForm(null)`),再重取一次列表 ——
|
|
5213
|
+
配置区/事实行下一帧就按宿主的事实重画,不在客户端自己猜。 */
|
|
5214
|
+
const saveSemantic = async () => {
|
|
5215
|
+
if (semBusy) return
|
|
5216
|
+
setSemBusy(true)
|
|
5217
|
+
setSemNotice('')
|
|
5218
|
+
try {
|
|
5219
|
+
const res = await fetch(SEMANTIC_API, {
|
|
5220
|
+
method: 'POST',
|
|
5221
|
+
headers: { 'content-type': 'application/json', accept: 'application/json' },
|
|
5222
|
+
body: JSON.stringify({ kind: semForm0.kind, base: semForm0.base, model: semForm0.model }),
|
|
5223
|
+
})
|
|
5224
|
+
const data = await res.json().catch(() => null)
|
|
5225
|
+
if (data && data.ok) {
|
|
5226
|
+
setSemForm(null)
|
|
5227
|
+
setSemNotice(data.available ? t('sem.savedOk') : t('sem.savedFail'))
|
|
5228
|
+
await load()
|
|
5229
|
+
} else {
|
|
5230
|
+
setSemNotice(data ? hostMessage(data) : t('sem.savedFail'))
|
|
5231
|
+
}
|
|
5232
|
+
} catch (error) {
|
|
5233
|
+
setSemNotice(String((error && error.message) || error))
|
|
5234
|
+
} finally {
|
|
5235
|
+
setSemBusy(false)
|
|
5236
|
+
}
|
|
5237
|
+
}
|
|
5238
|
+
|
|
5239
|
+
const semcfgNode = h('div', { className: 'knit-semcfg' },
|
|
5240
|
+
h('div', { className: 'knit-retseg', role: 'group', 'aria-label': t('sem.kindAria') },
|
|
5241
|
+
[['ollama', 'sem.kind.ollama'], ['openai-compatible', 'sem.kind.openai']].map(([value, labelKey]) =>
|
|
5242
|
+
h('button', {
|
|
5243
|
+
type: 'button',
|
|
5244
|
+
key: value,
|
|
5245
|
+
className: `knit-retseg-btn${semForm0.kind === value ? ' active' : ''}`,
|
|
5246
|
+
'aria-pressed': semForm0.kind === value,
|
|
5247
|
+
onClick: () => setSemForm({ ...semForm0, kind: value }),
|
|
5248
|
+
}, t(labelKey)))),
|
|
5249
|
+
h('input', {
|
|
5250
|
+
className: 'knit-semcfg-input',
|
|
5251
|
+
value: semForm0.base,
|
|
5252
|
+
placeholder: t('sem.basePlaceholder'),
|
|
5253
|
+
'aria-label': t('sem.baseAria'),
|
|
5254
|
+
onChange: (event) => setSemForm({ ...semForm0, base: event.target.value }),
|
|
5255
|
+
}),
|
|
5256
|
+
h('input', {
|
|
5257
|
+
className: 'knit-semcfg-input',
|
|
5258
|
+
value: semForm0.model,
|
|
5259
|
+
placeholder: t('sem.modelPlaceholder'),
|
|
5260
|
+
'aria-label': t('sem.modelAria'),
|
|
5261
|
+
onChange: (event) => setSemForm({ ...semForm0, model: event.target.value }),
|
|
5262
|
+
}),
|
|
5263
|
+
h('button', {
|
|
5264
|
+
type: 'button',
|
|
5265
|
+
className: 'knit-btn',
|
|
5266
|
+
disabled: semBusy,
|
|
5267
|
+
title: t('sem.saveTitle'),
|
|
5268
|
+
onClick: saveSemantic,
|
|
5269
|
+
}, semBusy ? t('sem.saving') : t('sem.save')),
|
|
5270
|
+
// 披露:只有回环地址才敢说「不离开这台机器」,其余一律明写会发到哪个服务(方案 §2)。
|
|
5271
|
+
h('span', { className: 'knit-semcfg-note' },
|
|
5272
|
+
!semForm0.base
|
|
5273
|
+
? t('sem.disclose.empty')
|
|
5274
|
+
: (isLoopbackBase(semForm0.base)
|
|
5275
|
+
? t('sem.disclose.local')
|
|
5276
|
+
: t('sem.disclose.remote', { base: semForm0.base }))))
|
|
4910
5277
|
const pipeNode = h('div', { className: 'knit-pipe' },
|
|
4911
5278
|
pipeCell(t('pipe.collect', { n: collected })),
|
|
4912
5279
|
pipeDot(),
|
|
@@ -4914,7 +5281,10 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4914
5281
|
pipeDot(),
|
|
4915
5282
|
pipeCell(t('pipe.candidates', { n: state.total })),
|
|
4916
5283
|
pipeSep(),
|
|
4917
|
-
|
|
5284
|
+
// 这一格说的是**实际生效**的模式(`semantic.mode`),不是你点了什么:
|
|
5285
|
+
// 点了混合但不可用时,宿主回的是 lexical,这里就必须还写「BM25 词法检索」。
|
|
5286
|
+
pipeCell(t(semLive ? 'pipe.rankHybrid' : 'pipe.rank')),
|
|
5287
|
+
...(semLive ? [pipeDot(), pipeCell(t('pipe.semantic', { n: semCandidateCount }))] : []),
|
|
4918
5288
|
pipeDot(),
|
|
4919
5289
|
pipeCell(t('pipe.relations', { n: relCount })),
|
|
4920
5290
|
pipeDot(),
|
|
@@ -4990,17 +5360,61 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
4990
5360
|
title: t('kind.title'),
|
|
4991
5361
|
onClick: () => pickKind(value),
|
|
4992
5362
|
}, t(labelKey)))),
|
|
4993
|
-
|
|
4994
|
-
|
|
4995
|
-
|
|
4996
|
-
|
|
4997
|
-
|
|
4998
|
-
|
|
4999
|
-
|
|
5000
|
-
|
|
5001
|
-
|
|
5002
|
-
|
|
5003
|
-
|
|
5363
|
+
/* v0.23(2026-10-11 用户裁决):检索模式从「左端第三组」改成**贴在搜索框右端的小下拉**
|
|
5364
|
+
(形态照 `02_方案与 Demo/Knit-v0.22-v0.24-Demo.html` 那份原型,用户觉得那种更好:
|
|
5365
|
+
左端只留「排序 | 类型」两组、不再挤第三组,长解释收进菜单)。
|
|
5366
|
+
只在「相关」档出现;**未配 provider 也出现**(菜单里如实说状态 + 就地给配置入口)。
|
|
5367
|
+
⚠️ 它是**搜索框容器里的第二个孩子** —— 出现/不出现都不改左端布局:
|
|
5368
|
+
藏起来时搜索框自己占满,没有空位、没有置灰的死控件。
|
|
5369
|
+
⚠️ 搜索仍是对**当前这一份列表**再过滤,不动排序与类型。 */
|
|
5370
|
+
h('div', { className: 'knit-searchwrap' },
|
|
5371
|
+
h('input', {
|
|
5372
|
+
className: 'knit-filter',
|
|
5373
|
+
value: query,
|
|
5374
|
+
placeholder: t('filter.placeholder'),
|
|
5375
|
+
'aria-label': t('filter.aria'),
|
|
5376
|
+
onChange: (event) => setQuery(event.target.value),
|
|
5377
|
+
onKeyDown: (event) => {
|
|
5378
|
+
if (event.key === 'Escape') { event.stopPropagation(); setQuery('') }
|
|
5379
|
+
},
|
|
5380
|
+
}),
|
|
5381
|
+
showRetrieval ? h('div', { className: 'knit-retmode' },
|
|
5382
|
+
h('button', {
|
|
5383
|
+
type: 'button',
|
|
5384
|
+
className: 'knit-retmode-btn',
|
|
5385
|
+
'aria-haspopup': 'true',
|
|
5386
|
+
'aria-expanded': retMenuOpen,
|
|
5387
|
+
// 悬停提示给**整句话**(两根长键在这里被用上;菜单里则是逐选项的副文案)
|
|
5388
|
+
title: t(retrieval === 'hybrid' ? 'sem.mode.hybridTitle' : 'sem.mode.lexicalTitle'),
|
|
5389
|
+
onClick: () => setRetMenuOpen((value) => !value),
|
|
5390
|
+
onKeyDown: closeRetMenuOnEscape,
|
|
5391
|
+
}, t(retrieval === 'hybrid' ? 'sem.mode.hybridShort' : 'sem.mode.lexicalShort')),
|
|
5392
|
+
retMenuOpen ? h('div', {
|
|
5393
|
+
className: 'knit-retmenu',
|
|
5394
|
+
role: 'menu',
|
|
5395
|
+
'aria-label': t('sem.mode.aria'),
|
|
5396
|
+
onKeyDown: closeRetMenuOnEscape,
|
|
5397
|
+
},
|
|
5398
|
+
[['lexical', 'sem.mode.lexicalOption', 'sem.mode.lexicalDesc'],
|
|
5399
|
+
['hybrid', 'sem.mode.hybridOption', 'sem.mode.hybridDesc']].map(([value, labelKey, descKey]) =>
|
|
5400
|
+
h('button', {
|
|
5401
|
+
type: 'button',
|
|
5402
|
+
key: value,
|
|
5403
|
+
role: 'menuitemradio',
|
|
5404
|
+
'aria-checked': retrieval === value,
|
|
5405
|
+
className: `knit-retmenu-item${retrieval === value ? ' active' : ''}`,
|
|
5406
|
+
onClick: () => { pickRetrieval(value); setRetMenuOpen(false) },
|
|
5407
|
+
},
|
|
5408
|
+
h('strong', null, t(labelKey)),
|
|
5409
|
+
h('span', null, t(descKey)))),
|
|
5410
|
+
// 状态行:如实写这一档现在到底生效成什么(判据 5 的界面面)
|
|
5411
|
+
h('div', { className: 'knit-retmenu-note' }, semStateText),
|
|
5412
|
+
// 就地配置入口:只在「选了混合且没生效」时给;点开的是 Phase A 那行最小配置区
|
|
5413
|
+
semCanConfigure ? h('button', {
|
|
5414
|
+
type: 'button',
|
|
5415
|
+
className: 'knit-retmenu-cfg',
|
|
5416
|
+
onClick: () => { setRetMenuOpen(false); setSemCfgOpen((value) => !value) },
|
|
5417
|
+
}, t(semCfgOpen ? 'sem.cfg.hide' : 'sem.cfg.show')) : null) : null) : null)),
|
|
5004
5418
|
/* ── v0.21:检索状态摘要 + 排除说明(需求 §6.3)──────────────────────
|
|
5005
5419
|
两条都是**事实行**,都在列表上方、都只在相关序出现(那是唯一有「包」的视图)。
|
|
5006
5420
|
⚠️ 它们的排位是**紧贴工具栏**的(2026-10-09 用户反馈):观察层排在它们下面,
|
|
@@ -5011,6 +5425,15 @@ video.knit-preview-media{width:100%;background:#000}
|
|
|
5011
5425
|
② 排除说明:被排掉的那几篇 + 一个「恢复」。它说的是「这一批少了什么」,
|
|
5012
5426
|
空的时候**不出现、也不占位**。 */
|
|
5013
5427
|
relevance && contextView ? pipeNode : null,
|
|
5428
|
+
/* ── v0.23(Phase A):混合检索的两条行 ─────────────────────────────
|
|
5429
|
+
⚠️ 排位固定在这里(**状态摘要之后**):摘要的前一个兄弟必须是 `.knit-bar`,
|
|
5430
|
+
插到工具栏与摘要之间会把那条守卫顶掉(见 test/client.test.mjs 的顺序用例)。
|
|
5431
|
+
两条都只在**用户选了混合**时出现:默认词法时一个节点都不产生(判据 2 的回归面)。
|
|
5432
|
+
① 事实行:混合**没生效**时如实写原因(含「宿主版本较旧」这一档静默降级);
|
|
5433
|
+
② 配置行:只有「选了混合 + provider 不可用」才就地展开,一行三格 + 一句披露。 */
|
|
5434
|
+
showRetrieval && semOn && !semLive ? h('div', { className: 'knit-retnote' }, semReasonText) : null,
|
|
5435
|
+
showRetrieval && semCfgOpen && semInfo && !semInfo.available ? semcfgNode : null,
|
|
5436
|
+
semOn && semNotice ? h('div', { className: 'knit-notice' }, semNotice) : null,
|
|
5014
5437
|
relevance && excludedList.length > 0 ? h('div', { className: 'knit-excl' },
|
|
5015
5438
|
h('span', { className: 'knit-excl-what' },
|
|
5016
5439
|
t('control.excluded', { rel: excludedList.map((item) => item.rel).join('、') })),
|