dsh-knit 0.12.0 → 0.13.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 +276 -0
- package/README.en.md +5 -3
- package/README.md +7 -4
- package/package.json +1 -1
- package/src/client/client.js +380 -147
- package/test/client.test.mjs +267 -93
- package/test/harness.mjs +4 -2
- package/test/i18n.test.mjs +123 -3
- package/test/tier1.test.mjs +97 -0
package/src/client/client.js
CHANGED
|
@@ -68,6 +68,17 @@ window.__ModuleLoader__.load({
|
|
|
68
68
|
'list.empty': '这个工作区里还没有 Markdown 文档。',
|
|
69
69
|
'list.emptyMedia': '这个工作区里还没有图片或视频。',
|
|
70
70
|
'list.noMatch': '没有匹配「{query}」的文档。',
|
|
71
|
+
// 文档列表这个 listbox 的无障碍名字(原先硬编码在 JSX 里,英文界面下会漏出中文)
|
|
72
|
+
'list.aria': '最近文档',
|
|
73
|
+
|
|
74
|
+
// 相对时间。⚠️ 这六条原先**硬编码在 relTime() 里**,英文界面下会漏出中文
|
|
75
|
+
// (2026-09-19 被真机截图抓出来的)。**加时间粒度时必须同时加中英两条。**
|
|
76
|
+
'time.justNow': '刚刚',
|
|
77
|
+
'time.minutesAgo': '{n}分钟前',
|
|
78
|
+
'time.hoursAgo': '{n}小时前',
|
|
79
|
+
'time.yesterday': '昨天',
|
|
80
|
+
'time.daysAgo': '{n}天前',
|
|
81
|
+
'time.monthDay': '{month}月{day}日',
|
|
71
82
|
|
|
72
83
|
'media.play': '播放视频',
|
|
73
84
|
|
|
@@ -166,6 +177,18 @@ window.__ModuleLoader__.load({
|
|
|
166
177
|
'list.empty': 'No Markdown documents in this workspace yet.',
|
|
167
178
|
'list.emptyMedia': 'No images or videos in this workspace yet.',
|
|
168
179
|
'list.noMatch': 'No documents match “{query}”.',
|
|
180
|
+
// Accessible name of the document listbox (was hardcoded in JSX before)
|
|
181
|
+
'list.aria': 'Recent documents',
|
|
182
|
+
|
|
183
|
+
// Relative time. ⚠️ These six used to be **hardcoded inside relTime()** and leaked
|
|
184
|
+
// Chinese into the English UI (caught by a real-machine screenshot, 2026-09-19).
|
|
185
|
+
// **Add both languages whenever you add a granularity.**
|
|
186
|
+
'time.justNow': 'just now',
|
|
187
|
+
'time.minutesAgo': '{n} min ago',
|
|
188
|
+
'time.hoursAgo': '{n} h ago',
|
|
189
|
+
'time.yesterday': 'yesterday',
|
|
190
|
+
'time.daysAgo': '{n} d ago',
|
|
191
|
+
'time.monthDay': '{month}/{day}',
|
|
169
192
|
|
|
170
193
|
'media.play': 'Play video',
|
|
171
194
|
|
|
@@ -332,75 +355,155 @@ window.__ModuleLoader__.load({
|
|
|
332
355
|
|
|
333
356
|
/** 「全部」视图里文档区的固定上限。 */
|
|
334
357
|
const ALL_DOC_CAP = 4
|
|
335
|
-
/** 滚动超过这个像素数就算「用户在读了」,进入阅读态(背景转纯阅读底色)。 */
|
|
336
|
-
const READING_SCROLL_PX = 4
|
|
337
358
|
/**
|
|
338
|
-
*
|
|
339
|
-
*
|
|
359
|
+
* 一屏基准:两行 × 4 列的观感(只在「媒体」这一档决定一屏铺几行时用)。
|
|
360
|
+
* **它不决定列数** —— 列数交给 CSS 的 `auto-fill`,见 mediaLayoutFor。
|
|
340
361
|
*/
|
|
341
362
|
const MEDIA_MAX_ITEMS = 8
|
|
342
363
|
/**
|
|
343
|
-
*
|
|
344
|
-
*
|
|
364
|
+
* 媒体格子的基准边长(CSS `minmax` 的下限)。
|
|
365
|
+
*
|
|
366
|
+
* **它与条目数完全无关** —— 这是 2026-09-20 第二版修正的核心。
|
|
367
|
+
* 第一版仍然按「条目数」反推格宽:条目 ≤8 个想要 4 列满宽、超过就缩到 64px 硬塞两行。
|
|
368
|
+
* 结果**列数被条目数锁死**:实测面板从 400px 拉到 1200px,列数一直卡在 **5 列**,
|
|
369
|
+
* 只有格子从 64px 被吹到 224px。用户的原话:「要我拉到一定的宽度以后,它才从 4 个变成更多」
|
|
370
|
+
* 「它不是真的响应式」。
|
|
371
|
+
*
|
|
372
|
+
* 现在只钉一个数:**格子基准 104px**(实际渲染约 104–155px),
|
|
373
|
+
* 列数 = 浏览器按可用宽度连续数出来的(`repeat(auto-fill, minmax(104px, 1fr))`)——
|
|
374
|
+
* 拖宽约 120px 就多一列,与 AIGC 资产中心的图片网格同一套机制
|
|
375
|
+
* (它的窄屏档就是 `minmax(104px,1fr)`)。
|
|
376
|
+
*/
|
|
377
|
+
const MEDIA_TRACK_PX = 104
|
|
378
|
+
/**
|
|
379
|
+
* 文档列表的响应式(2026-09-20 用户**三次**修正后的口径):
|
|
380
|
+
* **默认 1 列;宽了排 2 列;多列时卡片数据不变。**
|
|
381
|
+
*
|
|
382
|
+
* 三次修正的经过(每一版都是真机体验后被打回的):
|
|
383
|
+
* - 第一版「把完整卡直接压窄」→ 632px 面板 4 列时标题只剩 **9 个字**
|
|
384
|
+
* (真实标题中位数 18、最长 43),一屏还是 4 篇,只是把信息切碎了。
|
|
385
|
+
* - 第二版「多列只留标题 + 时间」→ 用户否掉:「两行保留一行一样的列表数据,
|
|
386
|
+
* 现在大于一行后只有标题与时间了」。**多列不等于可以砍数据。**
|
|
387
|
+
* - 第三版(当前)保留全部字段,但**上限从 4 列收到 3 列** —— 用户原话:
|
|
388
|
+
* 「大于三行体验上视觉跳动信息过载了」。即:4 列时一屏塞太密,
|
|
389
|
+
* 扫读时视线要反复跳跃,反而比 3 列更难用。
|
|
390
|
+
*
|
|
391
|
+
* 所以现在是:**每张卡片的字段与 1 列时完全一样**(标题 + 时间 + 摘要 + 路径),
|
|
392
|
+
* 只按格子宽度决定摘要是否还放得下 —— 与媒体卡「窄到 96px 以下让位给缩略图」
|
|
393
|
+
* 同一套渐进让位思路,而不是一多列就砍。
|
|
394
|
+
*
|
|
395
|
+
* ⚠️ **基准宽 205px 是「2–3 列时摘要还有意义」推出来的**:实测一行摘要每个汉字约 11.5px,
|
|
396
|
+
* 要摆下 16 个汉字以上才不算碎片。150px 那版会让 632px 直接排到 4 列(146px/格)、
|
|
397
|
+
* 标题只剩 10 字 —— 那又是第一版的坑。
|
|
398
|
+
*/
|
|
399
|
+
const DOC_GRID_MIN_COLS = 1
|
|
400
|
+
/**
|
|
401
|
+
* **上限 2 列。**
|
|
402
|
+
*
|
|
403
|
+
* 演进:4 列(标题只剩 9 字)→ 3 列(用户:「大于三行视觉跳动信息过载」)→ **2 列**。
|
|
404
|
+
* 收到 2 列的依据是交互评审的实测:3 列时摘要每行只剩 **16 个汉字**
|
|
405
|
+
* (2 列是 26、1 列是 56)—— 文档卡的关键任务是**读摘要判断哪篇有用**,
|
|
406
|
+
* 而读文字的成本由「每行字数 + 换行次数」决定,不由「一屏几个卡片」决定。
|
|
407
|
+
* 3 列换来的只是「多一篇」,代价是每一篇的摘要都碎成片段。
|
|
408
|
+
*
|
|
409
|
+
* ⚠️ **别再加回 3 列**:真要提升宽面板的信息利用率,该做的是让**单列更舒展**
|
|
410
|
+
* (时间/路径移到右侧同一基线、摘要可读宽度拉满),不是继续切栏。
|
|
345
411
|
*/
|
|
346
|
-
const
|
|
347
|
-
/**
|
|
348
|
-
const
|
|
349
|
-
/**
|
|
350
|
-
|
|
412
|
+
const DOC_GRID_MAX_COLS = 2
|
|
413
|
+
/** 文档格子宽度下限(CSS 里 minmax 的下限由它插入,改一处必须改另一处)。 */
|
|
414
|
+
const DOC_TRACK_PX = 205
|
|
415
|
+
/**
|
|
416
|
+
* 格子窄于这个宽度时摘要放不下有意义的内容(16 个汉字都摆不开)——
|
|
417
|
+
* 与其显示「本文件是 Agent 进」这种碎片,不如让摘要整块让位(**路径仍然保留**)。
|
|
418
|
+
*/
|
|
419
|
+
const DOC_SUMMARY_MIN_PX = 185
|
|
420
|
+
/**
|
|
421
|
+
* 实际格宽低于这个值才让卡片文字让位给缩略图。
|
|
422
|
+
*
|
|
423
|
+
* ⚠️ **正常情况下这个分支永远不触发**:格子基准 104px + `1fr` 只会把格子**撑宽**,
|
|
424
|
+
* 所以任何面板宽度下实际格宽都 ≥ 100px,文件名放得下。
|
|
425
|
+
* 旧版(按条目数把格子压到 64px 那套)才会频繁让位;这里保留判据只是兜底。
|
|
426
|
+
*/
|
|
427
|
+
const MEDIA_LABEL_MIN_PX = 96
|
|
351
428
|
const MEDIA_GAP_PX = 10
|
|
352
429
|
/** 网格左右内边距合计(.knit-media-grid 的 padding:0 12px / 8px 12px 16px)。 */
|
|
353
430
|
const MEDIA_GRID_PAD_X = 24
|
|
354
431
|
/** `.knit-list` 自己的左右内边距(padding:8px)—— 量到的是它,算格子要先扣掉。 */
|
|
355
432
|
const LIST_PAD_X = 16
|
|
433
|
+
/** 量不到宽度时的兜底:默认右侧栏的几何(旧实现里的默认值,别改)。 */
|
|
434
|
+
const MEDIA_FALLBACK_WIDTH = 632
|
|
356
435
|
|
|
357
436
|
/**
|
|
358
|
-
*
|
|
437
|
+
* 算媒体网格当前能排几列、单格实际多宽。
|
|
359
438
|
*
|
|
360
|
-
*
|
|
439
|
+
* 规则(2026-09-20 第三次修正后的口径):
|
|
361
440
|
*
|
|
362
|
-
* 1.
|
|
363
|
-
* 2.
|
|
364
|
-
*
|
|
365
|
-
* 3. 不超过 8 个时以 64px 为基准、4 列满宽为上限;宽度不够就先让出一行
|
|
366
|
-
* (列数降到 3)把格子撑回 64px。
|
|
441
|
+
* 1. **格子基准固定 104px,与条目数无关** —— 面板拖宽是**多出一列**,不是把格子吹大。
|
|
442
|
+
* 2. **列数连续增长** —— 宽约 120px 就多一列;不再像第一版那样卡在 5 列不动。
|
|
443
|
+
* 3. **纵向有多少行就铺多少行** —— 网格**不再设 maxHeight**。
|
|
367
444
|
*
|
|
368
|
-
*
|
|
445
|
+
* ⚠️ **第 3 条是 2026-09-20 第三次修正**:前两版都把高度封在「两行」,
|
|
446
|
+
* 让网格自己内部滚动。真机上第三行只能露出一点点,用户的原话是
|
|
447
|
+
* 「本来有三行,结果第三行只显示了一点点,应该纵向也完整显示」——
|
|
448
|
+
* 封顶高度是按「两行」算死的,跟面板实际有多高无关,必然截断。
|
|
449
|
+
* 现在整块交给 `.knit-list` 的滚动,与 AIGC 资产中心的做法一致。
|
|
450
|
+
*
|
|
451
|
+
* ⚠️ **这里的列数算术必须与 CSS 的 `auto-fill` 逐字同源**:CSS 那行是
|
|
452
|
+
* `repeat(auto-fill, minmax(104px, 1fr))`,所以列数是
|
|
453
|
+
* `floor((可用宽 + gap) / (104 + gap))`,**不是** `floor(可用宽 / 104)`;
|
|
454
|
+
* 少算 gap 会让 JS 与真机差一列(第一版实测踩过)。
|
|
369
455
|
*
|
|
370
456
|
* @param {number} width - 网格可用宽度(px,不含左右内边距)
|
|
371
|
-
* @
|
|
372
|
-
*
|
|
373
|
-
*
|
|
374
|
-
* 以及网格自身最大高度(null = 不限制,交给外层滚动)
|
|
457
|
+
* @returns {{min:number, columns:number, cell:number, scaled:boolean}}
|
|
458
|
+
* 格子基准宽(= CSS 的 minmax 下限)、当前宽度下能排几列、单格实际宽度、
|
|
459
|
+
* 是否让卡片文字让位
|
|
375
460
|
*/
|
|
376
|
-
function mediaLayoutFor(width
|
|
377
|
-
const n = Number.isFinite(count) && count > 0 ? Math.floor(count) : MEDIA_MAX_ITEMS
|
|
461
|
+
function mediaLayoutFor(width) {
|
|
378
462
|
const w = Number(width)
|
|
379
|
-
const usable = Number.isFinite(w) && w > 0 ? w :
|
|
463
|
+
const usable = Number.isFinite(w) && w > 0 ? w : MEDIA_FALLBACK_WIDTH
|
|
464
|
+
/** cols 列时每格实际能有多宽(含 gap 的同一套算术)。 */
|
|
380
465
|
const cellFor = (cols) => Math.floor((usable - (cols - 1) * MEDIA_GAP_PX) / cols)
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
466
|
+
// 与 CSS 的 auto-fill 同一套判定:minmax(104px, …) 下能排几条。
|
|
467
|
+
const columns = Math.max(1,
|
|
468
|
+
Math.floor((usable + MEDIA_GAP_PX) / (MEDIA_TRACK_PX + MEDIA_GAP_PX)))
|
|
469
|
+
const cell = cellFor(columns)
|
|
470
|
+
// 让位判据看的是**实际格宽**,不是基准宽:窄面板只出 2 列时格子反而宽到 135px,
|
|
471
|
+
// 那时文件名放得下,不该跟着一起让位。
|
|
472
|
+
return {
|
|
473
|
+
min: MEDIA_TRACK_PX,
|
|
474
|
+
columns,
|
|
475
|
+
cell,
|
|
476
|
+
scaled: cell < MEDIA_LABEL_MIN_PX,
|
|
388
477
|
}
|
|
478
|
+
}
|
|
389
479
|
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
480
|
+
/**
|
|
481
|
+
* 算文档列表能排几列、单格多宽、摘要放不放得下(见 `DOC_TRACK_PX` 上方的说明)。
|
|
482
|
+
*
|
|
483
|
+
* 与 `mediaLayoutFor` **同一套算术**(`floor((可用宽 + gap) / (基准宽 + gap))`),
|
|
484
|
+
* 只是基准宽与上限不同 —— 文档格子的下限是 205px(媒体是 104px),上限 4 列。
|
|
485
|
+
*
|
|
486
|
+
* @param {number} width - 列表可用宽度(px,不含列表左右内边距)
|
|
487
|
+
* @returns {{columns:number, cell:number, compact:boolean, summary:boolean}}
|
|
488
|
+
* 列数(1–4)、单格实际宽度、是否多列(多列时卡片改成网格里的样式)、
|
|
489
|
+
* 以及**摘要是否放得下**(放不下就整块让位,路径仍然保留)
|
|
490
|
+
*/
|
|
491
|
+
function docLayoutFor(width) {
|
|
492
|
+
const w = Number(width)
|
|
493
|
+
// ⚠️ **量不到宽度就按 1 列走,不能按「默认面板 632px」算** —— 用户要的默认形态是
|
|
494
|
+
// 「一个文档一行」,而 632px 会算出 2–3 列,等于把默认值改掉了;
|
|
495
|
+
// 另外默认 1 列也不会在真实宽度到达前先闪一下多列。
|
|
496
|
+
const usable = Number.isFinite(w) && w > 0 ? w : 0
|
|
497
|
+
const columns = Math.min(DOC_GRID_MAX_COLS, Math.max(DOC_GRID_MIN_COLS,
|
|
498
|
+
Math.floor((usable + MEDIA_GAP_PX) / (DOC_TRACK_PX + MEDIA_GAP_PX))))
|
|
499
|
+
const cell = Math.floor((usable - (columns - 1) * MEDIA_GAP_PX) / columns)
|
|
500
|
+
// 多列时的卡片样子:**字段一个不少**,只把放不下的摘要让位(见 DOC_SUMMARY_MIN_PX)。
|
|
501
|
+
return {
|
|
502
|
+
columns,
|
|
503
|
+
cell,
|
|
504
|
+
compact: columns > 1,
|
|
505
|
+
summary: columns === 1 || cell >= DOC_SUMMARY_MIN_PX,
|
|
397
506
|
}
|
|
398
|
-
|
|
399
|
-
// 超过一屏:加列 + 等比缩小,两行装下(上限 8 列)。此时格子允许小于 64px ——
|
|
400
|
-
// 「超过就等比缩小」是用户明确要的行为,宁可小也不多铺行。
|
|
401
|
-
const cols = Math.min(8, Math.max(MEDIA_MIN_COLS, Math.ceil(n / 2)))
|
|
402
|
-
const cell = cellFor(cols)
|
|
403
|
-
return { columns: cols, cell, scaled: true, maxHeight: cell * 2 + MEDIA_GAP_PX }
|
|
404
507
|
}
|
|
405
508
|
|
|
406
509
|
/* ── 样式:跟随 DSH 主题令牌,深浅色自适应 ───────────────── */
|
|
@@ -463,6 +566,14 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
463
566
|
用户的原话是「没有一个右侧的滑动条」。删掉即继承主题默认(l1),与侧栏列表一致。
|
|
464
567
|
⚠️ CSS 注释里不要出现反引号:这段是模板字符串,反引号会把它提前截断。 */
|
|
465
568
|
.knit-list{flex:1 1 auto;min-height:0;overflow-y:auto;padding:8px;display:flex;flex-direction:column;gap:6px;outline:none}
|
|
569
|
+
/* 文档多列:**只有 2 列这一档**,由 JS 算好后加类 ——
|
|
570
|
+
不写 auto-fit,否则「几列」会有两套算法(容器一个、卡片样式一个),必然对不上。
|
|
571
|
+
⚠️ **上限就是 2 列**,所以这里不该出现 cols-3 / cols-4(有守卫盯着)。
|
|
572
|
+
⚠️ 类加在 .knit-multicol 上而**不是** .knit-list 上:列表是那个唯一的滚动容器
|
|
573
|
+
(媒体档与「全部」都在它里面),把 grid 写上去会连带改掉那两个视图的排版。 */
|
|
574
|
+
.knit-multicol{display:flex;flex-direction:column;gap:6px}
|
|
575
|
+
.knit-multicol.cols-2{display:grid;gap:8px;align-items:stretch;
|
|
576
|
+
grid-template-columns:repeat(2,minmax(0,1fr))}
|
|
466
577
|
.knit-list:focus-visible{box-shadow:inset 0 0 0 1px var(--knit-accent)}
|
|
467
578
|
.knit-doc{padding:10px 11px;border-radius:10px;cursor:pointer;
|
|
468
579
|
border:.5px solid transparent;background:var(--dsw-alias-bg-layer-1,rgba(255,255,255,.03));
|
|
@@ -472,8 +583,14 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
472
583
|
/* 选中(正在预览)保留品牌色描边,与「键盘光标」的中性描边区分开 */
|
|
473
584
|
.knit-doc.active{border-color:var(--knit-accent);
|
|
474
585
|
background:var(--knit-active-bg,rgba(255,255,255,.085))}
|
|
475
|
-
/*
|
|
476
|
-
|
|
586
|
+
/* ⚠️ **但多列时必须给一个可见标记**(2026-09-20 补):网格里 :hover 的
|
|
587
|
+
translateX 被关掉了,光标若仍然不可见,键盘用户就完全没有「我在哪」的线索。
|
|
588
|
+
用与媒体卡光标同一套中性环(不是品牌色),与 .active 的品牌描边区分开。 */
|
|
589
|
+
.knit-multicol .knit-doc.cursor{
|
|
590
|
+
border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.22));
|
|
591
|
+
box-shadow:0 0 0 1.5px var(--dsw-alias-interactive-bg-active,rgba(255,255,255,.1))}
|
|
592
|
+
/* 单列时 .knit-doc.cursor 故意不设样式:键盘焦点靠「移动即预览」的预览面板表达,
|
|
593
|
+
再加描边会与 .active 的整块蓝色背景重复,显得突兀。 */
|
|
477
594
|
.knit-row1{display:flex;align-items:center;gap:8px;margin-bottom:5px}
|
|
478
595
|
.knit-title{flex:1;min-width:0;font-weight:600;font-size:12.5px;line-height:1.4;
|
|
479
596
|
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
|
@@ -483,6 +600,34 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
483
600
|
.knit-sum.empty{font-style:italic;color:var(--dsw-alias-label-caption,#80868b)}
|
|
484
601
|
.knit-meta{margin-top:6px;font-size:10px;color:var(--dsw-alias-label-caption,#80868b);
|
|
485
602
|
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
|
603
|
+
/* ── 2 列时的卡片 ─────────────────────────
|
|
604
|
+
⚠️ **字段一个不少**:标题 + 时间 + 摘要 + 路径,与 1 列时同一套数据。
|
|
605
|
+
第一版曾在这里「只留标题 + 时间」,被用户否掉:「两行保留一行一样的列表数据,
|
|
606
|
+
现在大于一行后只有标题与时间了」。**多列不等于可以砍数据。**
|
|
607
|
+
|
|
608
|
+
变的只有排版,因为格子窄了:
|
|
609
|
+
- 时间从「和标题挤一行」改成纵向排(挤一行会把标题压到十几个字)
|
|
610
|
+
- 标题从单行省略改成**折两行**(宽度不够,截断太浪费)
|
|
611
|
+
- 摘要按格子宽度决定去留:放不下 16 个汉字就整块让位(见 DOC_SUMMARY_MIN_PX)。
|
|
612
|
+
这是**渐进让位**(与媒体卡窄到 96px 以下让位给缩略图同一个思路),
|
|
613
|
+
不是「一多列就砍」—— 路径任何时候都保留。
|
|
614
|
+
|
|
615
|
+
⚠️ 这些规则必须排在 .knit-title / .knit-time / .knit-sum / .knit-meta **之后**:
|
|
616
|
+
选择器优先级一样,靠源码顺序取胜(和 .knit-media-card.cursor 那条同一个理)。 */
|
|
617
|
+
.knit-multicol.cols-2 .knit-doc{padding:9px 10px}
|
|
618
|
+
/* 标题折两行 */
|
|
619
|
+
.knit-multicol.cols-2 .knit-title{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;
|
|
620
|
+
white-space:normal;overflow:hidden;word-break:break-word}
|
|
621
|
+
/* 行一改成纵向:格子窄时时间与标题挤一行会把标题压成十几个字 */
|
|
622
|
+
.knit-multicol.cols-2 .knit-row1{display:block;margin-bottom:0}
|
|
623
|
+
.knit-multicol.cols-2 .knit-time{margin-top:4px}
|
|
624
|
+
/* 摘要挤不下时整块让位(JS 按格子宽决定加不加这个类)。路径不受影响。 */
|
|
625
|
+
.knit-multicol.no-sum .knit-sum{display:none}
|
|
626
|
+
/* 多列时的路径也折两行,别只给一行就切掉(真实路径中位数比标题还长) */
|
|
627
|
+
.knit-multicol.cols-2 .knit-meta{white-space:normal;display:-webkit-box;-webkit-line-clamp:2;
|
|
628
|
+
-webkit-box-orient:vertical;word-break:break-all}
|
|
629
|
+
/* 悬停不再左移:网格里位移会让整格抖动 */
|
|
630
|
+
.knit-multicol.cols-2 .knit-doc:hover, .knit-doc:hover{transform:none}
|
|
486
631
|
.knit-msg{padding:24px 16px;text-align:center;font-size:12px;
|
|
487
632
|
color:var(--dsw-alias-label-caption,#80868b);line-height:1.7}
|
|
488
633
|
.knit-notice{margin:6px 8px 0;padding:7px 10px;border-radius:7px;font-size:11px;line-height:1.5;
|
|
@@ -490,24 +635,23 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
490
635
|
.knit-badge{font-size:10px;margin-right:3px}
|
|
491
636
|
|
|
492
637
|
/* ── 列表下方的预览面板 ───────────────────────────────
|
|
493
|
-
|
|
494
|
-
①
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
638
|
+
要让人一眼看出「这是另一层,不是列表的续行」,靠**结构**而不是底色:
|
|
639
|
+
① 顶部圆角 + 更强的上边界;② 一层向上的柔影。
|
|
640
|
+
⚠️ 底色**不再**参与分层(2026-09-20 起一律是纯阅读底色),理由见下面那条注释。
|
|
641
|
+
⚠️ 也不要再拿 bg-layer-2 来做层级:浅色主题下 bg-layer-1/2/3 解析出来全是 #fff,
|
|
642
|
+
换过去等于没换(实测官方 theme 变量)。 */
|
|
643
|
+
/* 预览面板的底色:**一律用纯阅读底色**(浅 #fff / 深 #151517)。
|
|
644
|
+
曾经是「先分层灰、用户一滚正文才过渡到白」,用户 2026-09-20 否掉了:
|
|
645
|
+
「下拉出现详情时背景是灰的,这个交互比较差……把它改成整个都是白」。
|
|
646
|
+
分层不靠底色了 —— 靠上边界 + 顶部圆角 + 向上柔影(下面三件仍然都在)。
|
|
647
|
+
⚠️ 别只看浅色主题:这里必须走 bg-base,深色下它是 #151517;
|
|
648
|
+
写死 #fff 会在暗色主题里白得刺眼。 */
|
|
500
649
|
.knit-preview{position:relative;flex:none;display:flex;flex-direction:column;min-height:0;
|
|
501
650
|
border-top:.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.14));
|
|
502
651
|
border-top-left-radius:12px;border-top-right-radius:12px;
|
|
503
|
-
background:var(--dsw-alias-bg-
|
|
504
|
-
box-shadow:0 -8px 24px rgba(0,0,0,.06)
|
|
505
|
-
transition:background-color .28s ease}
|
|
652
|
+
background:var(--dsw-alias-bg-base,#fff);
|
|
653
|
+
box-shadow:0 -8px 24px rgba(0,0,0,.06)}
|
|
506
654
|
body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
507
|
-
/* 用户在滚正文 = 在认真读 → 背景过渡到**纯阅读底色**(浅 #fff / 深 #151517)。
|
|
508
|
-
灰底本来是为了分层,但读起来对比度弱;给个过渡就两者兼得。
|
|
509
|
-
注意:圆角与柔影保留,所以「这是另一层」仍然看得出来。 */
|
|
510
|
-
.knit-preview.reading{background:var(--dsw-alias-bg-base,#fff)}
|
|
511
655
|
/* 拖拽把手:**绝对定位、不占布局高度**。
|
|
512
656
|
它原来是一条 11px 的普通 flex 行,把 38px 的头整体往下推 —— 用户看到的就是
|
|
513
657
|
「文档名和那几个按钮偏下」。改成浮在头顶的窄条后,头里的内容才真正上下居中。
|
|
@@ -591,17 +735,34 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
591
735
|
color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
|
|
592
736
|
|
|
593
737
|
/* ── 图片与视频:方形缩略图网格 ─────────────────────
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
738
|
+
**列数由浏览器自己数**(用户 2026-09-20 点名的机制,取自 AIGC 资产中心的图片网格):
|
|
739
|
+
auto-fill + 固定下限 104px —— 面板拖宽约 120px 就多出一列,格子大小基本不变。
|
|
740
|
+
|
|
741
|
+
⚠️ **1fr 是有意写的,不要改成固定轨道**。第一版把上下限都写成 JS 算的「实际格宽」,
|
|
742
|
+
结果列数被**条目数**锁死(条目 >8 个就把格宽压到 64px):实测 400→1200px 全是 5 列,
|
|
743
|
+
只有格子从 64px 被吹到 224px —— 用户的原话是「它不是真的响应式」。
|
|
744
|
+
改成 minmax(104px, 1fr) 后列数只跟**可用宽度**有关,与有几个媒体无关。
|
|
745
|
+
|
|
746
|
+
⚠️ 但**下限也不能省**:只写 1fr 会让只有一个媒体时那张图撑满整个面板宽度。
|
|
747
|
+
|
|
748
|
+
⚠️ **网格不许设 maxHeight、也不自己滚动**。前两版把高度封在「两行」并给网格加
|
|
749
|
+
overflow-y:auto,真机上第三行只能露出一点点(用户原话:「本来有三行,结果第三行
|
|
750
|
+
只显示了一点点,应该纵向也完整显示」)—— 封顶高度是按「两行」算死的,与面板实际多高无关,
|
|
751
|
+
必然截断。现在有多少行就铺多少行,纵向滚动统一交给 .knit-list(与资产中心一致)。
|
|
752
|
+
|
|
753
|
+
fallback 那一行(3 列)是给不认 minmax(变量) 的旧内核用的,必须写在前面。
|
|
754
|
+
--knit-media-cell 由 JS 按当前列数下发,只用于 height 的方形兜底。
|
|
755
|
+
⚠️ 注释里不要出现反引号 —— 这段是模板字符串,反引号会把它提前截断(见 AGENTS §6.9)。 */
|
|
598
756
|
.knit-media-grid{display:grid;gap:${MEDIA_GAP_PX}px;
|
|
599
757
|
--knit-media-label:block;
|
|
758
|
+
--knit-media-track:${MEDIA_TRACK_PX}px;
|
|
759
|
+
--knit-media-cell:120px;
|
|
600
760
|
grid-template-columns:repeat(3,1fr);
|
|
601
|
-
grid-template-columns:repeat(var(--knit-media-
|
|
602
|
-
padding:8px 12px 16px;align-content:start;min-height:0
|
|
603
|
-
/*
|
|
604
|
-
|
|
761
|
+
grid-template-columns:repeat(auto-fill,minmax(var(--knit-media-track,104px),1fr));
|
|
762
|
+
padding:8px 12px 16px;align-content:start;min-height:0}
|
|
763
|
+
/* 分区里的网格:不留内边距。滚动一律交给 .knit-list,网格自己**不滚** ——
|
|
764
|
+
嵌套滚动会在「全部」里变成滚动陷阱,而且封顶高度必然截断最后一行。 */
|
|
765
|
+
.knit-media-grid.in-section{padding:0}
|
|
605
766
|
.knit-media-card{min-width:0;cursor:pointer;border-radius:10px}
|
|
606
767
|
.knit-media-thumbbox{position:relative;width:100%;height:var(--knit-media-cell,auto);aspect-ratio:1/1;
|
|
607
768
|
border-radius:9px;overflow:hidden;
|
|
@@ -617,7 +778,7 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
617
778
|
/* 正在预览 → 品牌色描边(排在 cursor 之后,确保同时命中时以「选中」为准) */
|
|
618
779
|
.knit-media-card.active .knit-media-thumbbox{
|
|
619
780
|
border-color:var(--knit-accent);box-shadow:0 0 0 1.5px var(--knit-accent)}
|
|
620
|
-
/*
|
|
781
|
+
/* 格子窄到 96px 以下时,文件名与时间会挤成一团 —— 整块让位给缩略图(mediaLayoutFor 的 scaled) */
|
|
621
782
|
.knit-media-meta{margin-top:5px;display:var(--knit-media-label,block)}
|
|
622
783
|
.knit-media-name{display:flex;align-items:center;gap:3px;font-size:11.5px;line-height:1.3;
|
|
623
784
|
color:var(--dsw-alias-label-primary,#e8eaed);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
|
|
@@ -881,22 +1042,27 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
881
1042
|
|
|
882
1043
|
/**
|
|
883
1044
|
* 人类可读的相对时间。
|
|
1045
|
+
*
|
|
1046
|
+
* ⚠️ **文案必须走 `t()`。** 这六条原先硬编码中文,英文界面下会漏出「3 分钟前」——
|
|
1047
|
+
* 2026-09-19 的真机截图把它抓出来了(`test/i18n.test.mjs` 有守卫:
|
|
1048
|
+
* 英文渲染出来的整棵树里不许出现汉字)。
|
|
1049
|
+
*
|
|
884
1050
|
* @param {number} ms - 文件 mtime(epoch ms)
|
|
885
1051
|
* @param {number} now - 当前时间
|
|
886
|
-
* @returns {string} 刚刚 / X分钟前 / X小时前 / 昨天 / X天前 /
|
|
1052
|
+
* @returns {string} 刚刚 / X分钟前 / X小时前 / 昨天 / X天前 / 月日(按当前语言)
|
|
887
1053
|
*/
|
|
888
1054
|
function relTime(ms, now) {
|
|
889
1055
|
const diff = Math.max(0, now - ms)
|
|
890
1056
|
const min = Math.floor(diff / 60000)
|
|
891
|
-
if (min < 1) return '
|
|
892
|
-
if (min < 60) return
|
|
1057
|
+
if (min < 1) return t('time.justNow')
|
|
1058
|
+
if (min < 60) return t('time.minutesAgo', { n: min })
|
|
893
1059
|
const hour = Math.floor(min / 60)
|
|
894
|
-
if (hour < 24) return
|
|
1060
|
+
if (hour < 24) return t('time.hoursAgo', { n: hour })
|
|
895
1061
|
const day = Math.floor(hour / 24)
|
|
896
|
-
if (day === 1) return '
|
|
897
|
-
if (day < 30) return
|
|
1062
|
+
if (day === 1) return t('time.yesterday')
|
|
1063
|
+
if (day < 30) return t('time.daysAgo', { n: day })
|
|
898
1064
|
const d = new Date(ms)
|
|
899
|
-
return
|
|
1065
|
+
return t('time.monthDay', { month: d.getMonth() + 1, day: d.getDate() })
|
|
900
1066
|
}
|
|
901
1067
|
|
|
902
1068
|
/**
|
|
@@ -943,11 +1109,77 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
943
1109
|
* @param {{doc:object,now:number,active:boolean,cursor:boolean,relevance:boolean,onSelect:Function,onOpenTab:Function}} props - 渲染入参
|
|
944
1110
|
* @returns {import('react').ReactElement} 元素
|
|
945
1111
|
*/
|
|
946
|
-
|
|
1112
|
+
/**
|
|
1113
|
+
* 键盘空间导航:算出「按这个方向键之后该到第几项」。
|
|
1114
|
+
*
|
|
1115
|
+
* 抽成纯函数是为了**可测**:真实宽度要靠 `ResizeObserver` 量,测试环境里量不到,
|
|
1116
|
+
* 列数永远是 1 —— 那多列的分支就永远跑不到(§6.12 说的「空转的绿灯」)。
|
|
1117
|
+
*
|
|
1118
|
+
* 语义:
|
|
1119
|
+
* - `ArrowDown` / `ArrowUp`:走**相邻项**(DOM 顺序 = 阅读顺序,多列时视觉上就是横向走)
|
|
1120
|
+
* - `ArrowLeft` / `ArrowRight`:**只在多列时**跨一整行(步长 = 列数);
|
|
1121
|
+
* 到行首再按左 / 到行尾再按右时**停在本行**,不回绕 —— 回绕会让「往左」
|
|
1122
|
+
* 突然跳到上一行末尾,方向感反而更差
|
|
1123
|
+
* - `Home` / `End`:首项 / 末项
|
|
1124
|
+
*
|
|
1125
|
+
* @param {number} index - 当前下标(<0 表示还没有光标,按第 0 项算)
|
|
1126
|
+
* @param {string} key - 键名
|
|
1127
|
+
* @param {number} count - 条目总数
|
|
1128
|
+
* @param {number} columns - 当前列数(1 = 单列,此时 ←→ 不参与)
|
|
1129
|
+
* @returns {number} 目标下标;不该处理这个键时返回 -1
|
|
1130
|
+
*/
|
|
1131
|
+
function nextIndexFor(index, key, count, columns) {
|
|
1132
|
+
if (!(count > 0)) return -1
|
|
1133
|
+
const here = index < 0 ? 0 : Math.min(index, count - 1)
|
|
1134
|
+
const last = count - 1
|
|
1135
|
+
if (key === 'ArrowDown') return Math.min(last, here + 1)
|
|
1136
|
+
if (key === 'ArrowUp') return Math.max(0, here - 1)
|
|
1137
|
+
if (key === 'Home') return 0
|
|
1138
|
+
if (key === 'End') return last
|
|
1139
|
+
const rowWidth = columns > 1 ? columns : 0
|
|
1140
|
+
if (rowWidth > 0 && (key === 'ArrowLeft' || key === 'ArrowRight')) {
|
|
1141
|
+
const rowStart = Math.floor(here / rowWidth) * rowWidth
|
|
1142
|
+
const rowEnd = Math.min(last, rowStart + rowWidth - 1)
|
|
1143
|
+
const step = key === 'ArrowRight' ? 1 : -1
|
|
1144
|
+
return Math.min(rowEnd, Math.max(rowStart, here + step))
|
|
1145
|
+
}
|
|
1146
|
+
return -1
|
|
1147
|
+
}
|
|
1148
|
+
|
|
1149
|
+
/**
|
|
1150
|
+
* 列表项在 DOM 里的稳定 id(供 `role="option"` + `aria-activedescendant` 使用)。
|
|
1151
|
+
*
|
|
1152
|
+
* ⚠️ 之前这里**只给容器加了 `role="listbox"`,选项却是裸 div** ——
|
|
1153
|
+
* 屏幕阅读器读到的是「一个叫『最近文档』的列表框,里面 8 个无语义元素」:
|
|
1154
|
+
* 既播报不出条目数,也播报不出当前选中项。这是多列改造之前就有的缺陷,
|
|
1155
|
+
* 但多列让「当前在哪一项」更难表达,所以一起补上。
|
|
1156
|
+
*
|
|
1157
|
+
* ⚠️ **id 必须由 rel 稳定推导,不能用计数器** —— `aria-activedescendant` 要指向
|
|
1158
|
+
* 真实存在的 id,而 id 在渲染期自增的话,同一篇文档在不同帧会拿到不同 id
|
|
1159
|
+
* (渲染顺序、过滤、轮询刷新都会变),指向就会漂。用哈希则同一篇永远同一个 id。
|
|
1160
|
+
* 前缀保留可读部分纯粹是为了调试时看得懂。
|
|
1161
|
+
*/
|
|
1162
|
+
function docOptionId(doc) {
|
|
1163
|
+
const rel = String(doc.rel || doc.path || '')
|
|
1164
|
+
const safe = rel.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 48)
|
|
1165
|
+
let hash = 2166136261
|
|
1166
|
+
for (let i = 0; i < rel.length; i += 1) {
|
|
1167
|
+
hash ^= rel.charCodeAt(i)
|
|
1168
|
+
hash = Math.imul(hash, 16777619)
|
|
1169
|
+
}
|
|
1170
|
+
return `knit-opt-${safe}-${(hash >>> 0).toString(36)}`
|
|
1171
|
+
}
|
|
1172
|
+
|
|
1173
|
+
function DocRow({ doc, now, active, cursor, relevance, onSelect, onOpenTab, optionId }) {
|
|
947
1174
|
const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
|
|
948
1175
|
|
|
949
1176
|
return h('div', {
|
|
950
1177
|
className: `knit-doc${active ? ' active' : ''}${cursor ? ' cursor' : ''}${fresh ? ' fresh' : ''}`,
|
|
1178
|
+
// listbox 的选项语义:有 role 才能被读成「N 项中的第 i 项」,
|
|
1179
|
+
// 有 aria-selected 才能播报「当前选中」。
|
|
1180
|
+
role: 'option',
|
|
1181
|
+
id: optionId,
|
|
1182
|
+
'aria-selected': active ? 'true' : 'false',
|
|
951
1183
|
'data-knit-rel': doc.rel,
|
|
952
1184
|
title: t('row.tooltip', { path: doc.rel }),
|
|
953
1185
|
onClick: () => onSelect(doc),
|
|
@@ -1012,10 +1244,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1012
1244
|
* @param {object} props - 与 DocRow 同构,外加 src
|
|
1013
1245
|
* @returns {import('react').ReactElement} 元素
|
|
1014
1246
|
*/
|
|
1015
|
-
function MediaCard({ doc, now, active, cursor, src, onSelect, onOpenTab }) {
|
|
1247
|
+
function MediaCard({ doc, now, active, cursor, src, onSelect, onOpenTab, optionId }) {
|
|
1016
1248
|
const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
|
|
1017
1249
|
return h('div', {
|
|
1018
1250
|
className: `knit-media-card${active ? ' active' : ''}${cursor ? ' cursor' : ''}${fresh ? ' fresh' : ''}`,
|
|
1251
|
+
// 与 DocRow 同一套 listbox 选项语义(媒体档与「全部」的媒体区都在同一个 listbox 里)
|
|
1252
|
+
role: 'option',
|
|
1253
|
+
id: optionId,
|
|
1254
|
+
'aria-selected': active ? 'true' : 'false',
|
|
1019
1255
|
'data-knit-rel': doc.rel,
|
|
1020
1256
|
title: t('row.tooltip', { path: doc.rel }),
|
|
1021
1257
|
onClick: () => onSelect(doc),
|
|
@@ -1034,7 +1270,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1034
1270
|
* @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenLocal:Function|null,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
|
|
1035
1271
|
* @returns {import('react').ReactElement} 元素
|
|
1036
1272
|
*/
|
|
1037
|
-
function PreviewPanel({ preview, pathImages, fullscreen, ratio,
|
|
1273
|
+
function PreviewPanel({ preview, pathImages, fullscreen, ratio, links, linksExpanded, onToggleLinks, onOpenLink, onClose, onOpenLocal, onToggleFullscreen, onResizeStart }) {
|
|
1038
1274
|
const isMedia = preview.kind === 'image' || preview.kind === 'video'
|
|
1039
1275
|
const previewPath = splitRelPath(preview.rel)
|
|
1040
1276
|
|
|
@@ -1134,7 +1370,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1134
1370
|
h('pre', { className: 'knit-raw' }, preview.text))
|
|
1135
1371
|
|
|
1136
1372
|
return h('div', {
|
|
1137
|
-
className:
|
|
1373
|
+
className: 'knit-preview',
|
|
1138
1374
|
style: fullscreen ? undefined : { maxHeight: `${Math.round(ratio * 100)}%` },
|
|
1139
1375
|
},
|
|
1140
1376
|
fullscreen ? null : h('div', { className: 'knit-resize', onPointerDown: onResizeStart, title: t('preview.resizeTitle') }),
|
|
@@ -1173,7 +1409,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1173
1409
|
linksBar,
|
|
1174
1410
|
h('div', {
|
|
1175
1411
|
className: `knit-preview-body${isMedia ? ' is-media' : ''}`,
|
|
1176
|
-
onScroll: onScrollBody,
|
|
1177
1412
|
},
|
|
1178
1413
|
!isMedia && preview.truncated ? h('div', { className: 'knit-preview-note' }, t('preview.truncated')) : null,
|
|
1179
1414
|
body))
|
|
@@ -1210,12 +1445,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1210
1445
|
// 放在 fullscreen 之后,保持前几个 hook 的顺序不变 —— 测试按顺序预置状态。
|
|
1211
1446
|
const [listWidth, setListWidth] = React.useState(0)
|
|
1212
1447
|
|
|
1213
|
-
// 阅读态:记「哪一篇被滚过」。真正的存储是**模块级**的 readingDocs(见其定义),
|
|
1214
|
-
// 组件里只留一个自增计数器用来触发重渲染 —— 这样即便宿主把 tab body
|
|
1215
|
-
// 重新挂载(用户反馈「鼠标移出去以后就没有了」,组件 state 会归零),
|
|
1216
|
-
// 阅读态也不会丢。放在最后,不动前面任何 hook 的槽位。
|
|
1217
|
-
const [readingTick, setReadingTick] = React.useState(0)
|
|
1218
|
-
|
|
1219
1448
|
// v0.12 引用关系。`null` = 还没请求;请求回来是 `{status, incoming, outgoing, …}`。
|
|
1220
1449
|
// **只跟着 previewRel 走**,绝不进列表轮询路径 —— 那份解析要读全库,
|
|
1221
1450
|
// 塞进「每 5 秒一次」会把面板拖垮(SDD §3.5)。
|
|
@@ -1288,28 +1517,43 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1288
1517
|
|
|
1289
1518
|
/* ── 「全部」:按类型分上下两区 ─────────────────────
|
|
1290
1519
|
文档区固定 4 条,多余的在分区标题给「查看全部」;
|
|
1291
|
-
媒体区**不截断** ——
|
|
1520
|
+
媒体区**不截断** —— 一屏两行以外交给媒体区内部滚动(不隐藏、也不压小格子)。 */
|
|
1292
1521
|
const docItems = kind === KIND_ALL ? visibleDocs.filter((doc) => !isMedia(doc)) : []
|
|
1293
1522
|
const mediaItems = kind === KIND_ALL ? visibleDocs.filter(isMedia) : []
|
|
1294
1523
|
const shownDocs = docItems.slice(0, ALL_DOC_CAP)
|
|
1295
1524
|
// ResizeObserver 量到的是 .knit-list(它自己也有左右内边距),
|
|
1296
|
-
// 网格的可用宽度 = 列表宽度 − 列表内边距 −
|
|
1297
|
-
|
|
1298
|
-
|
|
1299
|
-
|
|
1300
|
-
|
|
1301
|
-
|
|
1525
|
+
// 网格的可用宽度 = 列表宽度 − 列表内边距 − 网格内边距。
|
|
1526
|
+
// ⚠️ 这里**不传条目数** —— 列数只跟可用宽度有关(传了就会重演「按个数锁列数」那个 bug)。
|
|
1527
|
+
const mediaLayout = mediaLayoutFor(Math.max(0, listWidth - LIST_PAD_X - MEDIA_GRID_PAD_X))
|
|
1528
|
+
// 文档列表的列数:**只看列表可用宽度**(扣掉 `.knit-list` 自己的左右内边距)。
|
|
1529
|
+
// 1 列 = 完整卡,2–4 列 = 紧凑卡(样式由 `.knit-list.cols-N` 承担)。
|
|
1530
|
+
const docLayout = docLayoutFor(Math.max(0, listWidth - LIST_PAD_X))
|
|
1531
|
+
|
|
1532
|
+
/** 媒体网格:列数由 CSS 的 auto-fill 自己数;JS 只下发「一格多宽」用于正方形兜底。
|
|
1533
|
+
* **不设 maxHeight** —— 有多少行就铺多少行,纵向滚动统一交给 `.knit-list`。 */
|
|
1302
1534
|
const mediaGrid = (docs, inSection) => h('div', {
|
|
1303
1535
|
className: `knit-media-grid${inSection ? ' in-section' : ''}`,
|
|
1304
1536
|
role: 'group',
|
|
1305
1537
|
style: {
|
|
1306
|
-
'--knit-media-cols': String(mediaLayout.columns),
|
|
1307
1538
|
'--knit-media-cell': `${mediaLayout.cell}px`,
|
|
1308
1539
|
...(mediaLayout.scaled ? { '--knit-media-label': 'none' } : {}),
|
|
1309
|
-
...(mediaLayout.maxHeight ? { maxHeight: `${mediaLayout.maxHeight}px` } : {}),
|
|
1310
1540
|
},
|
|
1311
1541
|
}, docs.map(renderEntry))
|
|
1312
1542
|
|
|
1543
|
+
/**
|
|
1544
|
+
* 文档列表的容器:**1 列时原样返回(不多一层 DOM),2–4 列时才包一层网格**。
|
|
1545
|
+
* 单列不多包一层是有意的 —— 默认形态的 DOM 与列数改造之前**逐字一致**,
|
|
1546
|
+
* 既有测试与既有的滚动/键盘行为都不用跟着动。
|
|
1547
|
+
* `no-sum` 只在「格子窄到摘要放不下」时加(多列但格子够宽时摘要照常显示)。
|
|
1548
|
+
*/
|
|
1549
|
+
const docsGrid = (docs) => {
|
|
1550
|
+
if (docLayout.columns <= 1) return docs.map(renderEntry)
|
|
1551
|
+
const cls = `knit-multicol cols-${docLayout.columns}${docLayout.summary ? '' : ' no-sum'}`
|
|
1552
|
+
// ⚠️ 这层是**纯排版容器**,必须 role="presentation"(不是 group):
|
|
1553
|
+
// option 要是 listbox 的直接子级,辅助技术才会把选项算进那个集合。
|
|
1554
|
+
return h('div', { className: cls, role: 'presentation' }, docs.map(renderEntry))
|
|
1555
|
+
}
|
|
1556
|
+
|
|
1313
1557
|
/** 键盘与 cursor 真正能到达的条目:「全部」里文档只到上限,媒体全部可达。 */
|
|
1314
1558
|
const navDocs = kind === KIND_ALL ? shownDocs.concat(mediaItems) : visibleDocs
|
|
1315
1559
|
|
|
@@ -1369,17 +1613,27 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1369
1613
|
setFullscreen(false)
|
|
1370
1614
|
}, [])
|
|
1371
1615
|
|
|
1372
|
-
/**
|
|
1616
|
+
/**
|
|
1617
|
+
* 键盘导航:↑↓ 逐项移动即预览,多列时 ←→ 按**屏幕位置**横移,Enter 切换,Esc 收起。
|
|
1618
|
+
*
|
|
1619
|
+
* ⚠️ **多列必须支持 ←→,否则「视觉空间」和「键盘空间」对不上**:
|
|
1620
|
+
* 2 列网格里按 ↓ 视觉上是**往右**走(DOM 顺序即阅读顺序),
|
|
1621
|
+
* 而 ←→ 原先完全不响应 —— 用户看到的是两列,键盘却只有一条线。
|
|
1622
|
+
* 现在:↑↓ 走相邻项,←→ 跨一整行(rowWidth = 列数)。
|
|
1623
|
+
*
|
|
1624
|
+
* ⚠️ 左右键只在**多列**时生效:单列的纵向列表里 ←→ 没有空间含义,
|
|
1625
|
+
* 拦截它反而会挡掉宿主或输入框的正常行为。
|
|
1626
|
+
*/
|
|
1373
1627
|
const onListKeyDown = React.useCallback((event) => {
|
|
1374
1628
|
if (navDocs.length === 0) return
|
|
1375
1629
|
const index = navDocs.findIndex((doc) => doc.rel === cursor)
|
|
1630
|
+
const last = navDocs.length - 1
|
|
1376
1631
|
|
|
1377
|
-
|
|
1632
|
+
// 方向键与 Home/End 全部交给纯函数算(见 nextIndexFor 的注释)
|
|
1633
|
+
const target = nextIndexFor(index, event.key, navDocs.length, docLayout.columns)
|
|
1634
|
+
if (target >= 0) {
|
|
1378
1635
|
event.preventDefault()
|
|
1379
|
-
const
|
|
1380
|
-
? Math.min(navDocs.length - 1, index < 0 ? 0 : index + 1)
|
|
1381
|
-
: Math.max(0, index < 0 ? 0 : index - 1)
|
|
1382
|
-
const doc = navDocs[next]
|
|
1636
|
+
const doc = navDocs[target]
|
|
1383
1637
|
if (doc) { setCursor(doc.rel); openPreview(doc) }
|
|
1384
1638
|
return
|
|
1385
1639
|
}
|
|
@@ -1394,7 +1648,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1394
1648
|
if (fullscreen) setFullscreen(false)
|
|
1395
1649
|
else closePreview()
|
|
1396
1650
|
}
|
|
1397
|
-
}, [navDocs, cursor, fullscreen, openPreview, togglePreview, closePreview])
|
|
1651
|
+
}, [navDocs, cursor, fullscreen, docLayout.columns, openPreview, togglePreview, closePreview])
|
|
1398
1652
|
|
|
1399
1653
|
/** 拖拽预览面板上缘改变高度。 */
|
|
1400
1654
|
const onResizeStart = React.useCallback((event) => {
|
|
@@ -1448,20 +1702,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1448
1702
|
*/
|
|
1449
1703
|
const previewIsDoc = !preview || (preview.kind !== 'image' && preview.kind !== 'video')
|
|
1450
1704
|
|
|
1451
|
-
/** 阅读态 = 当前这一篇被滚过。换一篇自然为 false(派生,不用复位 effect)。 */
|
|
1452
|
-
const reading = Boolean(previewRel) && readingDocs.has(readingKey(sessionId, previewRel))
|
|
1453
|
-
|
|
1454
|
-
/** 一开始滚正文就进入阅读态(阈值 4px,避免 1px 抖动就触发);进了就不再退回。 */
|
|
1455
|
-
const onScrollBody = React.useCallback((event) => {
|
|
1456
|
-
const el = event && event.target
|
|
1457
|
-
if (!el || typeof el.scrollTop !== 'number' || el.scrollTop <= READING_SCROLL_PX) return
|
|
1458
|
-
const key = readingKey(sessionId, previewRel)
|
|
1459
|
-
if (readingDocs.has(key)) return
|
|
1460
|
-
readingDocs.add(key)
|
|
1461
|
-
setReadingTick((n) => n + 1) // 只是为了让这次写入反映到界面上
|
|
1462
|
-
}, [sessionId, previewRel])
|
|
1463
|
-
void readingTick
|
|
1464
|
-
|
|
1465
1705
|
/** 这篇文档在磁盘上的绝对路径:宿主给的 path 优先,拿不到就用 root + rel 拼。 */
|
|
1466
1706
|
const previewAbsPath = preview
|
|
1467
1707
|
? (preview.path || joinPath(state.root, preview.rel))
|
|
@@ -1534,13 +1774,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1534
1774
|
/** 展开 / 收起引用条。真相在模块级 `expandedLinks`,组件只留计数器(理由同阅读态)。 */
|
|
1535
1775
|
const toggleLinks = React.useCallback(() => {
|
|
1536
1776
|
if (!previewRel) return
|
|
1537
|
-
const key =
|
|
1777
|
+
const key = previewKey(sessionId, previewRel)
|
|
1538
1778
|
if (expandedLinks.has(key)) expandedLinks.delete(key)
|
|
1539
1779
|
else expandedLinks.add(key)
|
|
1540
1780
|
setLinksExpandedTick((n) => n + 1)
|
|
1541
1781
|
}, [previewRel, sessionId])
|
|
1542
1782
|
const linksExpanded = Boolean(previewRel)
|
|
1543
|
-
&& expandedLinks.has(
|
|
1783
|
+
&& expandedLinks.has(previewKey(sessionId, previewRel))
|
|
1544
1784
|
void linksExpandedTick
|
|
1545
1785
|
|
|
1546
1786
|
// 相对路径图片解析器:按当前文档所在目录解析。MarkdownText 按引用身份 memo,
|
|
@@ -1589,6 +1829,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1589
1829
|
now: tick,
|
|
1590
1830
|
active: Boolean(preview && preview.rel === doc.rel),
|
|
1591
1831
|
cursor: doc.rel === cursor,
|
|
1832
|
+
optionId: docOptionId(doc),
|
|
1592
1833
|
onSelect: togglePreview,
|
|
1593
1834
|
onOpenTab,
|
|
1594
1835
|
}
|
|
@@ -1615,7 +1856,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1615
1856
|
const allSections = [
|
|
1616
1857
|
docItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'docs' },
|
|
1617
1858
|
sectionHead('kind.doc', shownDocs.length, docItems.length, KIND_DOC),
|
|
1618
|
-
shownDocs
|
|
1859
|
+
docsGrid(shownDocs)),
|
|
1619
1860
|
mediaItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'media' },
|
|
1620
1861
|
// 媒体不截断,所以只给一个标题,不给「已显示 / 总数」和「查看全部」
|
|
1621
1862
|
h('div', { className: 'knit-section-head' },
|
|
@@ -1624,9 +1865,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1624
1865
|
mediaGrid(mediaItems, true)),
|
|
1625
1866
|
]
|
|
1626
1867
|
|
|
1627
|
-
//
|
|
1628
|
-
|
|
1629
|
-
|
|
1868
|
+
// 媒体视图:一格都不隐藏 —— 一屏两行以外的部分在媒体区**内部滚动**,
|
|
1869
|
+
// 既不让面板被整面媒体墙顶爆,也不会像旧版那样把剩下的条目直接切掉。
|
|
1630
1870
|
const emptyText = kind === KIND_MEDIA ? t('list.emptyMedia') : t('list.empty')
|
|
1631
1871
|
const body = state.status === 'loading' && state.docs.length === 0
|
|
1632
1872
|
? h('div', { className: 'knit-msg' }, t('list.scanning'))
|
|
@@ -1637,10 +1877,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1637
1877
|
: visibleDocs.length === 0
|
|
1638
1878
|
? h('div', { className: 'knit-msg' }, t('list.noMatch', { query: query.trim() }))
|
|
1639
1879
|
: kind === KIND_MEDIA
|
|
1640
|
-
? mediaGrid(visibleDocs
|
|
1880
|
+
? mediaGrid(visibleDocs, false)
|
|
1641
1881
|
: kind === KIND_ALL
|
|
1642
1882
|
? allSections
|
|
1643
|
-
: visibleDocs
|
|
1883
|
+
: docsGrid(visibleDocs)
|
|
1644
1884
|
|
|
1645
1885
|
const topicText = relevance
|
|
1646
1886
|
? (state.topic ? t('topic.relevance', { topic: state.topic }) : t('topic.relevancePlain'))
|
|
@@ -1714,15 +1954,19 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1714
1954
|
tabIndex: 0,
|
|
1715
1955
|
onKeyDown: onListKeyDown,
|
|
1716
1956
|
role: 'listbox',
|
|
1717
|
-
'aria-label': '
|
|
1957
|
+
'aria-label': t('list.aria'),
|
|
1958
|
+
// 焦点始终在容器上(roving 焦点会打断「移动即预览」),
|
|
1959
|
+
// 所以用 activedescendant 把「当前项」告诉辅助技术。
|
|
1960
|
+
// cursor 不在可见列表里时(被过滤/被上限截断)就不指向任何东西。
|
|
1961
|
+
'aria-activedescendant': navDocs.some((doc) => doc.rel === cursor)
|
|
1962
|
+
? docOptionId(navDocs.find((doc) => doc.rel === cursor))
|
|
1963
|
+
: undefined,
|
|
1718
1964
|
}, body),
|
|
1719
1965
|
preview ? h(PreviewPanel, {
|
|
1720
1966
|
preview,
|
|
1721
1967
|
pathImages,
|
|
1722
1968
|
fullscreen,
|
|
1723
1969
|
ratio,
|
|
1724
|
-
reading,
|
|
1725
|
-
onScrollBody,
|
|
1726
1970
|
// v0.12 引用条
|
|
1727
1971
|
links,
|
|
1728
1972
|
linksExpanded,
|
|
@@ -2091,21 +2335,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2091
2335
|
const previewSubscribers = new Set()
|
|
2092
2336
|
|
|
2093
2337
|
/**
|
|
2094
|
-
*
|
|
2095
|
-
*
|
|
2096
|
-
* **故意放在模块级而不是组件 state**:用户反馈「滚过之后背景变白,但鼠标移出去
|
|
2097
|
-
* 就没有了」—— 组件 state 会随宿主重挂载归零,本模块级集合不会。
|
|
2098
|
-
* 语义是「这一篇在这个会话里被读过」,所以重挂载、切 tab 回来都仍然算读过。
|
|
2099
|
-
*
|
|
2100
|
-
* @type {Set<string>}
|
|
2101
|
-
*/
|
|
2102
|
-
const readingDocs = new Set()
|
|
2103
|
-
|
|
2104
|
-
/**
|
|
2105
|
-
* 已经**展开过引用条**的文档,key 见 `readingKey`(同一个 key 约定)。
|
|
2338
|
+
* 已经**展开过引用条**的文档,key 见 `previewKey`。
|
|
2106
2339
|
*
|
|
2107
|
-
*
|
|
2108
|
-
*
|
|
2340
|
+
* **故意放在模块级而不是组件 state**:「用户做过的事」不能只放组件 state ——
|
|
2341
|
+
* 宿主重挂载会把它清零,用户就得再点一次(见 `AGENTS.md` §6.9)。
|
|
2109
2342
|
* 语义是「这一篇在这个会话里被展开过」。
|
|
2110
2343
|
*
|
|
2111
2344
|
* @type {Set<string>}
|
|
@@ -2113,12 +2346,12 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2113
2346
|
const expandedLinks = new Set()
|
|
2114
2347
|
|
|
2115
2348
|
/**
|
|
2116
|
-
*
|
|
2349
|
+
* 「用户对这篇做过某件事」的 key:同一会话里的同一篇文档算一个(引用条展开态在用)。
|
|
2117
2350
|
* @param {string} sessionId - 会话 id
|
|
2118
2351
|
* @param {string} rel - 工作区相对路径
|
|
2119
2352
|
* @returns {string} key
|
|
2120
2353
|
*/
|
|
2121
|
-
function
|
|
2354
|
+
function previewKey(sessionId, rel) {
|
|
2122
2355
|
return `${sessionId || ''}\u0000${rel || ''}`
|
|
2123
2356
|
}
|
|
2124
2357
|
|
|
@@ -2253,7 +2486,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2253
2486
|
|
|
2254
2487
|
bsCtx.effect(() => bs.registerTab({
|
|
2255
2488
|
id: BS_TAB_ID,
|
|
2256
|
-
title: () => '
|
|
2489
|
+
title: () => t('guide.title'),
|
|
2257
2490
|
icon: KnitGlyph,
|
|
2258
2491
|
order: 30,
|
|
2259
2492
|
single: true, // 同类型只开一个
|