dsh-knit 0.12.1 → 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 +230 -0
- package/README.md +4 -2
- package/package.json +1 -1
- package/src/client/client.js +343 -138
- package/test/client.test.mjs +267 -93
- package/test/harness.mjs +4 -2
- package/test/tier1.test.mjs +97 -0
package/src/client/client.js
CHANGED
|
@@ -355,75 +355,155 @@ window.__ModuleLoader__.load({
|
|
|
355
355
|
|
|
356
356
|
/** 「全部」视图里文档区的固定上限。 */
|
|
357
357
|
const ALL_DOC_CAP = 4
|
|
358
|
-
/** 滚动超过这个像素数就算「用户在读了」,进入阅读态(背景转纯阅读底色)。 */
|
|
359
|
-
const READING_SCROLL_PX = 4
|
|
360
358
|
/**
|
|
361
|
-
*
|
|
362
|
-
*
|
|
359
|
+
* 一屏基准:两行 × 4 列的观感(只在「媒体」这一档决定一屏铺几行时用)。
|
|
360
|
+
* **它不决定列数** —— 列数交给 CSS 的 `auto-fill`,见 mediaLayoutFor。
|
|
363
361
|
*/
|
|
364
362
|
const MEDIA_MAX_ITEMS = 8
|
|
365
363
|
/**
|
|
366
|
-
*
|
|
367
|
-
*
|
|
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)`)。
|
|
368
376
|
*/
|
|
369
|
-
const
|
|
370
|
-
/**
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
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
|
+
* (时间/路径移到右侧同一基线、摘要可读宽度拉满),不是继续切栏。
|
|
411
|
+
*/
|
|
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
|
|
374
428
|
const MEDIA_GAP_PX = 10
|
|
375
429
|
/** 网格左右内边距合计(.knit-media-grid 的 padding:0 12px / 8px 12px 16px)。 */
|
|
376
430
|
const MEDIA_GRID_PAD_X = 24
|
|
377
431
|
/** `.knit-list` 自己的左右内边距(padding:8px)—— 量到的是它,算格子要先扣掉。 */
|
|
378
432
|
const LIST_PAD_X = 16
|
|
433
|
+
/** 量不到宽度时的兜底:默认右侧栏的几何(旧实现里的默认值,别改)。 */
|
|
434
|
+
const MEDIA_FALLBACK_WIDTH = 632
|
|
379
435
|
|
|
380
436
|
/**
|
|
381
|
-
*
|
|
437
|
+
* 算媒体网格当前能排几列、单格实际多宽。
|
|
438
|
+
*
|
|
439
|
+
* 规则(2026-09-20 第三次修正后的口径):
|
|
382
440
|
*
|
|
383
|
-
*
|
|
441
|
+
* 1. **格子基准固定 104px,与条目数无关** —— 面板拖宽是**多出一列**,不是把格子吹大。
|
|
442
|
+
* 2. **列数连续增长** —— 宽约 120px 就多一列;不再像第一版那样卡在 5 列不动。
|
|
443
|
+
* 3. **纵向有多少行就铺多少行** —— 网格**不再设 maxHeight**。
|
|
384
444
|
*
|
|
385
|
-
*
|
|
386
|
-
*
|
|
387
|
-
*
|
|
388
|
-
*
|
|
389
|
-
*
|
|
445
|
+
* ⚠️ **第 3 条是 2026-09-20 第三次修正**:前两版都把高度封在「两行」,
|
|
446
|
+
* 让网格自己内部滚动。真机上第三行只能露出一点点,用户的原话是
|
|
447
|
+
* 「本来有三行,结果第三行只显示了一点点,应该纵向也完整显示」——
|
|
448
|
+
* 封顶高度是按「两行」算死的,跟面板实际有多高无关,必然截断。
|
|
449
|
+
* 现在整块交给 `.knit-list` 的滚动,与 AIGC 资产中心的做法一致。
|
|
390
450
|
*
|
|
391
|
-
*
|
|
451
|
+
* ⚠️ **这里的列数算术必须与 CSS 的 `auto-fill` 逐字同源**:CSS 那行是
|
|
452
|
+
* `repeat(auto-fill, minmax(104px, 1fr))`,所以列数是
|
|
453
|
+
* `floor((可用宽 + gap) / (104 + gap))`,**不是** `floor(可用宽 / 104)`;
|
|
454
|
+
* 少算 gap 会让 JS 与真机差一列(第一版实测踩过)。
|
|
392
455
|
*
|
|
393
456
|
* @param {number} width - 网格可用宽度(px,不含左右内边距)
|
|
394
|
-
* @
|
|
395
|
-
*
|
|
396
|
-
*
|
|
397
|
-
* 以及网格自身最大高度(null = 不限制,交给外层滚动)
|
|
457
|
+
* @returns {{min:number, columns:number, cell:number, scaled:boolean}}
|
|
458
|
+
* 格子基准宽(= CSS 的 minmax 下限)、当前宽度下能排几列、单格实际宽度、
|
|
459
|
+
* 是否让卡片文字让位
|
|
398
460
|
*/
|
|
399
|
-
function mediaLayoutFor(width
|
|
400
|
-
const n = Number.isFinite(count) && count > 0 ? Math.floor(count) : MEDIA_MAX_ITEMS
|
|
461
|
+
function mediaLayoutFor(width) {
|
|
401
462
|
const w = Number(width)
|
|
402
|
-
const usable = Number.isFinite(w) && w > 0 ? w :
|
|
463
|
+
const usable = Number.isFinite(w) && w > 0 ? w : MEDIA_FALLBACK_WIDTH
|
|
464
|
+
/** cols 列时每格实际能有多宽(含 gap 的同一套算术)。 */
|
|
403
465
|
const cellFor = (cols) => Math.floor((usable - (cols - 1) * MEDIA_GAP_PX) / cols)
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
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,
|
|
411
477
|
}
|
|
478
|
+
}
|
|
412
479
|
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
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,
|
|
420
506
|
}
|
|
421
|
-
|
|
422
|
-
// 超过一屏:加列 + 等比缩小,两行装下(上限 8 列)。此时格子允许小于 64px ——
|
|
423
|
-
// 「超过就等比缩小」是用户明确要的行为,宁可小也不多铺行。
|
|
424
|
-
const cols = Math.min(8, Math.max(MEDIA_MIN_COLS, Math.ceil(n / 2)))
|
|
425
|
-
const cell = cellFor(cols)
|
|
426
|
-
return { columns: cols, cell, scaled: true, maxHeight: cell * 2 + MEDIA_GAP_PX }
|
|
427
507
|
}
|
|
428
508
|
|
|
429
509
|
/* ── 样式:跟随 DSH 主题令牌,深浅色自适应 ───────────────── */
|
|
@@ -486,6 +566,14 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
486
566
|
用户的原话是「没有一个右侧的滑动条」。删掉即继承主题默认(l1),与侧栏列表一致。
|
|
487
567
|
⚠️ CSS 注释里不要出现反引号:这段是模板字符串,反引号会把它提前截断。 */
|
|
488
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))}
|
|
489
577
|
.knit-list:focus-visible{box-shadow:inset 0 0 0 1px var(--knit-accent)}
|
|
490
578
|
.knit-doc{padding:10px 11px;border-radius:10px;cursor:pointer;
|
|
491
579
|
border:.5px solid transparent;background:var(--dsw-alias-bg-layer-1,rgba(255,255,255,.03));
|
|
@@ -495,8 +583,14 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
495
583
|
/* 选中(正在预览)保留品牌色描边,与「键盘光标」的中性描边区分开 */
|
|
496
584
|
.knit-doc.active{border-color:var(--knit-accent);
|
|
497
585
|
background:var(--knit-active-bg,rgba(255,255,255,.085))}
|
|
498
|
-
/*
|
|
499
|
-
|
|
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 的整块蓝色背景重复,显得突兀。 */
|
|
500
594
|
.knit-row1{display:flex;align-items:center;gap:8px;margin-bottom:5px}
|
|
501
595
|
.knit-title{flex:1;min-width:0;font-weight:600;font-size:12.5px;line-height:1.4;
|
|
502
596
|
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
|
@@ -506,6 +600,34 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
506
600
|
.knit-sum.empty{font-style:italic;color:var(--dsw-alias-label-caption,#80868b)}
|
|
507
601
|
.knit-meta{margin-top:6px;font-size:10px;color:var(--dsw-alias-label-caption,#80868b);
|
|
508
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}
|
|
509
631
|
.knit-msg{padding:24px 16px;text-align:center;font-size:12px;
|
|
510
632
|
color:var(--dsw-alias-label-caption,#80868b);line-height:1.7}
|
|
511
633
|
.knit-notice{margin:6px 8px 0;padding:7px 10px;border-radius:7px;font-size:11px;line-height:1.5;
|
|
@@ -513,24 +635,23 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
513
635
|
.knit-badge{font-size:10px;margin-right:3px}
|
|
514
636
|
|
|
515
637
|
/* ── 列表下方的预览面板 ───────────────────────────────
|
|
516
|
-
|
|
517
|
-
①
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
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 会在暗色主题里白得刺眼。 */
|
|
523
649
|
.knit-preview{position:relative;flex:none;display:flex;flex-direction:column;min-height:0;
|
|
524
650
|
border-top:.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.14));
|
|
525
651
|
border-top-left-radius:12px;border-top-right-radius:12px;
|
|
526
|
-
background:var(--dsw-alias-bg-
|
|
527
|
-
box-shadow:0 -8px 24px rgba(0,0,0,.06)
|
|
528
|
-
transition:background-color .28s ease}
|
|
652
|
+
background:var(--dsw-alias-bg-base,#fff);
|
|
653
|
+
box-shadow:0 -8px 24px rgba(0,0,0,.06)}
|
|
529
654
|
body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
530
|
-
/* 用户在滚正文 = 在认真读 → 背景过渡到**纯阅读底色**(浅 #fff / 深 #151517)。
|
|
531
|
-
灰底本来是为了分层,但读起来对比度弱;给个过渡就两者兼得。
|
|
532
|
-
注意:圆角与柔影保留,所以「这是另一层」仍然看得出来。 */
|
|
533
|
-
.knit-preview.reading{background:var(--dsw-alias-bg-base,#fff)}
|
|
534
655
|
/* 拖拽把手:**绝对定位、不占布局高度**。
|
|
535
656
|
它原来是一条 11px 的普通 flex 行,把 38px 的头整体往下推 —— 用户看到的就是
|
|
536
657
|
「文档名和那几个按钮偏下」。改成浮在头顶的窄条后,头里的内容才真正上下居中。
|
|
@@ -614,17 +735,34 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
614
735
|
color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
|
|
615
736
|
|
|
616
737
|
/* ── 图片与视频:方形缩略图网格 ─────────────────────
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
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)。 */
|
|
621
756
|
.knit-media-grid{display:grid;gap:${MEDIA_GAP_PX}px;
|
|
622
757
|
--knit-media-label:block;
|
|
758
|
+
--knit-media-track:${MEDIA_TRACK_PX}px;
|
|
759
|
+
--knit-media-cell:120px;
|
|
623
760
|
grid-template-columns:repeat(3,1fr);
|
|
624
|
-
grid-template-columns:repeat(var(--knit-media-
|
|
625
|
-
padding:8px 12px 16px;align-content:start;min-height:0
|
|
626
|
-
/*
|
|
627
|
-
|
|
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}
|
|
628
766
|
.knit-media-card{min-width:0;cursor:pointer;border-radius:10px}
|
|
629
767
|
.knit-media-thumbbox{position:relative;width:100%;height:var(--knit-media-cell,auto);aspect-ratio:1/1;
|
|
630
768
|
border-radius:9px;overflow:hidden;
|
|
@@ -640,7 +778,7 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
640
778
|
/* 正在预览 → 品牌色描边(排在 cursor 之后,确保同时命中时以「选中」为准) */
|
|
641
779
|
.knit-media-card.active .knit-media-thumbbox{
|
|
642
780
|
border-color:var(--knit-accent);box-shadow:0 0 0 1.5px var(--knit-accent)}
|
|
643
|
-
/*
|
|
781
|
+
/* 格子窄到 96px 以下时,文件名与时间会挤成一团 —— 整块让位给缩略图(mediaLayoutFor 的 scaled) */
|
|
644
782
|
.knit-media-meta{margin-top:5px;display:var(--knit-media-label,block)}
|
|
645
783
|
.knit-media-name{display:flex;align-items:center;gap:3px;font-size:11.5px;line-height:1.3;
|
|
646
784
|
color:var(--dsw-alias-label-primary,#e8eaed);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
|
|
@@ -971,11 +1109,77 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
971
1109
|
* @param {{doc:object,now:number,active:boolean,cursor:boolean,relevance:boolean,onSelect:Function,onOpenTab:Function}} props - 渲染入参
|
|
972
1110
|
* @returns {import('react').ReactElement} 元素
|
|
973
1111
|
*/
|
|
974
|
-
|
|
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 }) {
|
|
975
1174
|
const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
|
|
976
1175
|
|
|
977
1176
|
return h('div', {
|
|
978
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',
|
|
979
1183
|
'data-knit-rel': doc.rel,
|
|
980
1184
|
title: t('row.tooltip', { path: doc.rel }),
|
|
981
1185
|
onClick: () => onSelect(doc),
|
|
@@ -1040,10 +1244,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1040
1244
|
* @param {object} props - 与 DocRow 同构,外加 src
|
|
1041
1245
|
* @returns {import('react').ReactElement} 元素
|
|
1042
1246
|
*/
|
|
1043
|
-
function MediaCard({ doc, now, active, cursor, src, onSelect, onOpenTab }) {
|
|
1247
|
+
function MediaCard({ doc, now, active, cursor, src, onSelect, onOpenTab, optionId }) {
|
|
1044
1248
|
const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
|
|
1045
1249
|
return h('div', {
|
|
1046
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',
|
|
1047
1255
|
'data-knit-rel': doc.rel,
|
|
1048
1256
|
title: t('row.tooltip', { path: doc.rel }),
|
|
1049
1257
|
onClick: () => onSelect(doc),
|
|
@@ -1062,7 +1270,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1062
1270
|
* @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenLocal:Function|null,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
|
|
1063
1271
|
* @returns {import('react').ReactElement} 元素
|
|
1064
1272
|
*/
|
|
1065
|
-
function PreviewPanel({ preview, pathImages, fullscreen, ratio,
|
|
1273
|
+
function PreviewPanel({ preview, pathImages, fullscreen, ratio, links, linksExpanded, onToggleLinks, onOpenLink, onClose, onOpenLocal, onToggleFullscreen, onResizeStart }) {
|
|
1066
1274
|
const isMedia = preview.kind === 'image' || preview.kind === 'video'
|
|
1067
1275
|
const previewPath = splitRelPath(preview.rel)
|
|
1068
1276
|
|
|
@@ -1162,7 +1370,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1162
1370
|
h('pre', { className: 'knit-raw' }, preview.text))
|
|
1163
1371
|
|
|
1164
1372
|
return h('div', {
|
|
1165
|
-
className:
|
|
1373
|
+
className: 'knit-preview',
|
|
1166
1374
|
style: fullscreen ? undefined : { maxHeight: `${Math.round(ratio * 100)}%` },
|
|
1167
1375
|
},
|
|
1168
1376
|
fullscreen ? null : h('div', { className: 'knit-resize', onPointerDown: onResizeStart, title: t('preview.resizeTitle') }),
|
|
@@ -1201,7 +1409,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1201
1409
|
linksBar,
|
|
1202
1410
|
h('div', {
|
|
1203
1411
|
className: `knit-preview-body${isMedia ? ' is-media' : ''}`,
|
|
1204
|
-
onScroll: onScrollBody,
|
|
1205
1412
|
},
|
|
1206
1413
|
!isMedia && preview.truncated ? h('div', { className: 'knit-preview-note' }, t('preview.truncated')) : null,
|
|
1207
1414
|
body))
|
|
@@ -1238,12 +1445,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1238
1445
|
// 放在 fullscreen 之后,保持前几个 hook 的顺序不变 —— 测试按顺序预置状态。
|
|
1239
1446
|
const [listWidth, setListWidth] = React.useState(0)
|
|
1240
1447
|
|
|
1241
|
-
// 阅读态:记「哪一篇被滚过」。真正的存储是**模块级**的 readingDocs(见其定义),
|
|
1242
|
-
// 组件里只留一个自增计数器用来触发重渲染 —— 这样即便宿主把 tab body
|
|
1243
|
-
// 重新挂载(用户反馈「鼠标移出去以后就没有了」,组件 state 会归零),
|
|
1244
|
-
// 阅读态也不会丢。放在最后,不动前面任何 hook 的槽位。
|
|
1245
|
-
const [readingTick, setReadingTick] = React.useState(0)
|
|
1246
|
-
|
|
1247
1448
|
// v0.12 引用关系。`null` = 还没请求;请求回来是 `{status, incoming, outgoing, …}`。
|
|
1248
1449
|
// **只跟着 previewRel 走**,绝不进列表轮询路径 —— 那份解析要读全库,
|
|
1249
1450
|
// 塞进「每 5 秒一次」会把面板拖垮(SDD §3.5)。
|
|
@@ -1316,28 +1517,43 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1316
1517
|
|
|
1317
1518
|
/* ── 「全部」:按类型分上下两区 ─────────────────────
|
|
1318
1519
|
文档区固定 4 条,多余的在分区标题给「查看全部」;
|
|
1319
|
-
媒体区**不截断** ——
|
|
1520
|
+
媒体区**不截断** —— 一屏两行以外交给媒体区内部滚动(不隐藏、也不压小格子)。 */
|
|
1320
1521
|
const docItems = kind === KIND_ALL ? visibleDocs.filter((doc) => !isMedia(doc)) : []
|
|
1321
1522
|
const mediaItems = kind === KIND_ALL ? visibleDocs.filter(isMedia) : []
|
|
1322
1523
|
const shownDocs = docItems.slice(0, ALL_DOC_CAP)
|
|
1323
1524
|
// ResizeObserver 量到的是 .knit-list(它自己也有左右内边距),
|
|
1324
|
-
// 网格的可用宽度 = 列表宽度 − 列表内边距 −
|
|
1325
|
-
|
|
1326
|
-
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
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`。 */
|
|
1330
1534
|
const mediaGrid = (docs, inSection) => h('div', {
|
|
1331
1535
|
className: `knit-media-grid${inSection ? ' in-section' : ''}`,
|
|
1332
1536
|
role: 'group',
|
|
1333
1537
|
style: {
|
|
1334
|
-
'--knit-media-cols': String(mediaLayout.columns),
|
|
1335
1538
|
'--knit-media-cell': `${mediaLayout.cell}px`,
|
|
1336
1539
|
...(mediaLayout.scaled ? { '--knit-media-label': 'none' } : {}),
|
|
1337
|
-
...(mediaLayout.maxHeight ? { maxHeight: `${mediaLayout.maxHeight}px` } : {}),
|
|
1338
1540
|
},
|
|
1339
1541
|
}, docs.map(renderEntry))
|
|
1340
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
|
+
|
|
1341
1557
|
/** 键盘与 cursor 真正能到达的条目:「全部」里文档只到上限,媒体全部可达。 */
|
|
1342
1558
|
const navDocs = kind === KIND_ALL ? shownDocs.concat(mediaItems) : visibleDocs
|
|
1343
1559
|
|
|
@@ -1397,17 +1613,27 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1397
1613
|
setFullscreen(false)
|
|
1398
1614
|
}, [])
|
|
1399
1615
|
|
|
1400
|
-
/**
|
|
1616
|
+
/**
|
|
1617
|
+
* 键盘导航:↑↓ 逐项移动即预览,多列时 ←→ 按**屏幕位置**横移,Enter 切换,Esc 收起。
|
|
1618
|
+
*
|
|
1619
|
+
* ⚠️ **多列必须支持 ←→,否则「视觉空间」和「键盘空间」对不上**:
|
|
1620
|
+
* 2 列网格里按 ↓ 视觉上是**往右**走(DOM 顺序即阅读顺序),
|
|
1621
|
+
* 而 ←→ 原先完全不响应 —— 用户看到的是两列,键盘却只有一条线。
|
|
1622
|
+
* 现在:↑↓ 走相邻项,←→ 跨一整行(rowWidth = 列数)。
|
|
1623
|
+
*
|
|
1624
|
+
* ⚠️ 左右键只在**多列**时生效:单列的纵向列表里 ←→ 没有空间含义,
|
|
1625
|
+
* 拦截它反而会挡掉宿主或输入框的正常行为。
|
|
1626
|
+
*/
|
|
1401
1627
|
const onListKeyDown = React.useCallback((event) => {
|
|
1402
1628
|
if (navDocs.length === 0) return
|
|
1403
1629
|
const index = navDocs.findIndex((doc) => doc.rel === cursor)
|
|
1630
|
+
const last = navDocs.length - 1
|
|
1404
1631
|
|
|
1405
|
-
|
|
1632
|
+
// 方向键与 Home/End 全部交给纯函数算(见 nextIndexFor 的注释)
|
|
1633
|
+
const target = nextIndexFor(index, event.key, navDocs.length, docLayout.columns)
|
|
1634
|
+
if (target >= 0) {
|
|
1406
1635
|
event.preventDefault()
|
|
1407
|
-
const
|
|
1408
|
-
? Math.min(navDocs.length - 1, index < 0 ? 0 : index + 1)
|
|
1409
|
-
: Math.max(0, index < 0 ? 0 : index - 1)
|
|
1410
|
-
const doc = navDocs[next]
|
|
1636
|
+
const doc = navDocs[target]
|
|
1411
1637
|
if (doc) { setCursor(doc.rel); openPreview(doc) }
|
|
1412
1638
|
return
|
|
1413
1639
|
}
|
|
@@ -1422,7 +1648,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1422
1648
|
if (fullscreen) setFullscreen(false)
|
|
1423
1649
|
else closePreview()
|
|
1424
1650
|
}
|
|
1425
|
-
}, [navDocs, cursor, fullscreen, openPreview, togglePreview, closePreview])
|
|
1651
|
+
}, [navDocs, cursor, fullscreen, docLayout.columns, openPreview, togglePreview, closePreview])
|
|
1426
1652
|
|
|
1427
1653
|
/** 拖拽预览面板上缘改变高度。 */
|
|
1428
1654
|
const onResizeStart = React.useCallback((event) => {
|
|
@@ -1476,20 +1702,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1476
1702
|
*/
|
|
1477
1703
|
const previewIsDoc = !preview || (preview.kind !== 'image' && preview.kind !== 'video')
|
|
1478
1704
|
|
|
1479
|
-
/** 阅读态 = 当前这一篇被滚过。换一篇自然为 false(派生,不用复位 effect)。 */
|
|
1480
|
-
const reading = Boolean(previewRel) && readingDocs.has(readingKey(sessionId, previewRel))
|
|
1481
|
-
|
|
1482
|
-
/** 一开始滚正文就进入阅读态(阈值 4px,避免 1px 抖动就触发);进了就不再退回。 */
|
|
1483
|
-
const onScrollBody = React.useCallback((event) => {
|
|
1484
|
-
const el = event && event.target
|
|
1485
|
-
if (!el || typeof el.scrollTop !== 'number' || el.scrollTop <= READING_SCROLL_PX) return
|
|
1486
|
-
const key = readingKey(sessionId, previewRel)
|
|
1487
|
-
if (readingDocs.has(key)) return
|
|
1488
|
-
readingDocs.add(key)
|
|
1489
|
-
setReadingTick((n) => n + 1) // 只是为了让这次写入反映到界面上
|
|
1490
|
-
}, [sessionId, previewRel])
|
|
1491
|
-
void readingTick
|
|
1492
|
-
|
|
1493
1705
|
/** 这篇文档在磁盘上的绝对路径:宿主给的 path 优先,拿不到就用 root + rel 拼。 */
|
|
1494
1706
|
const previewAbsPath = preview
|
|
1495
1707
|
? (preview.path || joinPath(state.root, preview.rel))
|
|
@@ -1562,13 +1774,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1562
1774
|
/** 展开 / 收起引用条。真相在模块级 `expandedLinks`,组件只留计数器(理由同阅读态)。 */
|
|
1563
1775
|
const toggleLinks = React.useCallback(() => {
|
|
1564
1776
|
if (!previewRel) return
|
|
1565
|
-
const key =
|
|
1777
|
+
const key = previewKey(sessionId, previewRel)
|
|
1566
1778
|
if (expandedLinks.has(key)) expandedLinks.delete(key)
|
|
1567
1779
|
else expandedLinks.add(key)
|
|
1568
1780
|
setLinksExpandedTick((n) => n + 1)
|
|
1569
1781
|
}, [previewRel, sessionId])
|
|
1570
1782
|
const linksExpanded = Boolean(previewRel)
|
|
1571
|
-
&& expandedLinks.has(
|
|
1783
|
+
&& expandedLinks.has(previewKey(sessionId, previewRel))
|
|
1572
1784
|
void linksExpandedTick
|
|
1573
1785
|
|
|
1574
1786
|
// 相对路径图片解析器:按当前文档所在目录解析。MarkdownText 按引用身份 memo,
|
|
@@ -1617,6 +1829,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1617
1829
|
now: tick,
|
|
1618
1830
|
active: Boolean(preview && preview.rel === doc.rel),
|
|
1619
1831
|
cursor: doc.rel === cursor,
|
|
1832
|
+
optionId: docOptionId(doc),
|
|
1620
1833
|
onSelect: togglePreview,
|
|
1621
1834
|
onOpenTab,
|
|
1622
1835
|
}
|
|
@@ -1643,7 +1856,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1643
1856
|
const allSections = [
|
|
1644
1857
|
docItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'docs' },
|
|
1645
1858
|
sectionHead('kind.doc', shownDocs.length, docItems.length, KIND_DOC),
|
|
1646
|
-
shownDocs
|
|
1859
|
+
docsGrid(shownDocs)),
|
|
1647
1860
|
mediaItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'media' },
|
|
1648
1861
|
// 媒体不截断,所以只给一个标题,不给「已显示 / 总数」和「查看全部」
|
|
1649
1862
|
h('div', { className: 'knit-section-head' },
|
|
@@ -1652,9 +1865,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1652
1865
|
mediaGrid(mediaItems, true)),
|
|
1653
1866
|
]
|
|
1654
1867
|
|
|
1655
|
-
//
|
|
1656
|
-
|
|
1657
|
-
|
|
1868
|
+
// 媒体视图:一格都不隐藏 —— 一屏两行以外的部分在媒体区**内部滚动**,
|
|
1869
|
+
// 既不让面板被整面媒体墙顶爆,也不会像旧版那样把剩下的条目直接切掉。
|
|
1658
1870
|
const emptyText = kind === KIND_MEDIA ? t('list.emptyMedia') : t('list.empty')
|
|
1659
1871
|
const body = state.status === 'loading' && state.docs.length === 0
|
|
1660
1872
|
? h('div', { className: 'knit-msg' }, t('list.scanning'))
|
|
@@ -1665,10 +1877,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1665
1877
|
: visibleDocs.length === 0
|
|
1666
1878
|
? h('div', { className: 'knit-msg' }, t('list.noMatch', { query: query.trim() }))
|
|
1667
1879
|
: kind === KIND_MEDIA
|
|
1668
|
-
? mediaGrid(visibleDocs
|
|
1880
|
+
? mediaGrid(visibleDocs, false)
|
|
1669
1881
|
: kind === KIND_ALL
|
|
1670
1882
|
? allSections
|
|
1671
|
-
: visibleDocs
|
|
1883
|
+
: docsGrid(visibleDocs)
|
|
1672
1884
|
|
|
1673
1885
|
const topicText = relevance
|
|
1674
1886
|
? (state.topic ? t('topic.relevance', { topic: state.topic }) : t('topic.relevancePlain'))
|
|
@@ -1743,14 +1955,18 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1743
1955
|
onKeyDown: onListKeyDown,
|
|
1744
1956
|
role: 'listbox',
|
|
1745
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,
|
|
1746
1964
|
}, body),
|
|
1747
1965
|
preview ? h(PreviewPanel, {
|
|
1748
1966
|
preview,
|
|
1749
1967
|
pathImages,
|
|
1750
1968
|
fullscreen,
|
|
1751
1969
|
ratio,
|
|
1752
|
-
reading,
|
|
1753
|
-
onScrollBody,
|
|
1754
1970
|
// v0.12 引用条
|
|
1755
1971
|
links,
|
|
1756
1972
|
linksExpanded,
|
|
@@ -2119,21 +2335,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2119
2335
|
const previewSubscribers = new Set()
|
|
2120
2336
|
|
|
2121
2337
|
/**
|
|
2122
|
-
*
|
|
2123
|
-
*
|
|
2124
|
-
* **故意放在模块级而不是组件 state**:用户反馈「滚过之后背景变白,但鼠标移出去
|
|
2125
|
-
* 就没有了」—— 组件 state 会随宿主重挂载归零,本模块级集合不会。
|
|
2126
|
-
* 语义是「这一篇在这个会话里被读过」,所以重挂载、切 tab 回来都仍然算读过。
|
|
2127
|
-
*
|
|
2128
|
-
* @type {Set<string>}
|
|
2129
|
-
*/
|
|
2130
|
-
const readingDocs = new Set()
|
|
2131
|
-
|
|
2132
|
-
/**
|
|
2133
|
-
* 已经**展开过引用条**的文档,key 见 `readingKey`(同一个 key 约定)。
|
|
2338
|
+
* 已经**展开过引用条**的文档,key 见 `previewKey`。
|
|
2134
2339
|
*
|
|
2135
|
-
*
|
|
2136
|
-
*
|
|
2340
|
+
* **故意放在模块级而不是组件 state**:「用户做过的事」不能只放组件 state ——
|
|
2341
|
+
* 宿主重挂载会把它清零,用户就得再点一次(见 `AGENTS.md` §6.9)。
|
|
2137
2342
|
* 语义是「这一篇在这个会话里被展开过」。
|
|
2138
2343
|
*
|
|
2139
2344
|
* @type {Set<string>}
|
|
@@ -2141,12 +2346,12 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2141
2346
|
const expandedLinks = new Set()
|
|
2142
2347
|
|
|
2143
2348
|
/**
|
|
2144
|
-
*
|
|
2349
|
+
* 「用户对这篇做过某件事」的 key:同一会话里的同一篇文档算一个(引用条展开态在用)。
|
|
2145
2350
|
* @param {string} sessionId - 会话 id
|
|
2146
2351
|
* @param {string} rel - 工作区相对路径
|
|
2147
2352
|
* @returns {string} key
|
|
2148
2353
|
*/
|
|
2149
|
-
function
|
|
2354
|
+
function previewKey(sessionId, rel) {
|
|
2150
2355
|
return `${sessionId || ''}\u0000${rel || ''}`
|
|
2151
2356
|
}
|
|
2152
2357
|
|