dsh-knit 0.5.1 → 0.11.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.
@@ -54,8 +54,8 @@ window.__ModuleLoader__.load({
54
54
  'filter.placeholder': '过滤标题 / 摘要 / 路径',
55
55
  'filter.aria': '过滤文档',
56
56
 
57
- 'topic.relevance': '🤖 按「{topic}」排序',
58
- 'topic.relevancePlain': '🤖 相关性排序',
57
+ 'topic.relevance': '按「{topic}」排序',
58
+ 'topic.relevancePlain': '相关性排序',
59
59
  'topic.needsConversation': '对话内容还不足,暂按最新排序',
60
60
  'topic.time': '按修改时间倒序',
61
61
 
@@ -81,8 +81,8 @@ window.__ModuleLoader__.load({
81
81
  'preview.exitFullscreen': '退出全屏',
82
82
  'preview.fullscreenTitle': '全屏阅读',
83
83
  'preview.exitFullscreenTitle': '退出全屏(Esc)',
84
- 'preview.newTab': '新标签页',
85
- 'preview.newTabTitle': '在新标签页打开',
84
+ 'preview.openLocal': '{path}\n用系统默认应用打开这篇文档',
85
+ 'preview.openLocalBtn': '在本地打开',
86
86
  'preview.close': '收起预览',
87
87
  'preview.resizeTitle': '拖动调整高度',
88
88
  'preview.rawFallback': '原生 Markdown 渲染不可用,下面是纯文本。请看控制台的 [knit] 日志。',
@@ -143,8 +143,8 @@ window.__ModuleLoader__.load({
143
143
  'filter.placeholder': 'Filter title / summary / path',
144
144
  'filter.aria': 'Filter documents',
145
145
 
146
- 'topic.relevance': '🤖 Sorted by “{topic}”',
147
- 'topic.relevancePlain': '🤖 Sorted by relevance',
146
+ 'topic.relevance': 'Sorted by “{topic}”',
147
+ 'topic.relevancePlain': 'Sorted by relevance',
148
148
  'topic.needsConversation': 'Not enough conversation yet — sorted by time',
149
149
  'topic.time': 'Sorted by modified time',
150
150
 
@@ -170,8 +170,8 @@ window.__ModuleLoader__.load({
170
170
  'preview.exitFullscreen': 'Exit fullscreen',
171
171
  'preview.fullscreenTitle': 'Read fullscreen',
172
172
  'preview.exitFullscreenTitle': 'Exit fullscreen (Esc)',
173
- 'preview.newTab': 'New tab',
174
- 'preview.newTabTitle': 'Open in a new tab',
173
+ 'preview.openLocal': '{path}\nOpen this document in your default app',
174
+ 'preview.openLocalBtn': 'Open locally',
175
175
  'preview.close': 'Close preview',
176
176
  'preview.resizeTitle': 'Drag to resize',
177
177
  'preview.rawFallback': 'Native Markdown rendering is unavailable — showing plain text. Check the [knit] logs in the console.',
@@ -312,6 +312,8 @@ window.__ModuleLoader__.load({
312
312
 
313
313
  /** 「全部」视图里文档区的固定上限。 */
314
314
  const ALL_DOC_CAP = 4
315
+ /** 滚动超过这个像素数就算「用户在读了」,进入阅读态(背景转纯阅读底色)。 */
316
+ const READING_SCROLL_PX = 4
315
317
  /**
316
318
  * 媒体网格一屏最多摆几个(4 列 × 2 行)。
317
319
  * 超出不再隐藏,而是整块等比缩小 —— 见 mediaLayoutFor 的 scaled 分支。
@@ -390,10 +392,19 @@ window.__ModuleLoader__.load({
390
392
  填充改用 DSH 选中态的半透明令牌,不自己混色 —— color-mix 在旧内核上
391
393
  会让整条声明失效(invalid at computed-value time),不是渐进增强。 */
392
394
  --knit-accent:var(--dsw-alias-brand-primary-new-colorprimary-new-color,#4176e6);
393
- /* 选中态的灰底一律直接用 DSH 的中性令牌(列表行、类型切换、排序切换共用一套),
394
- 所以这里不再需要自备一个 accent 填充令牌。 */
395
+ /* 悬停 / 选中的灰底:在 DSH 两个令牌的**透明度上各降一档**
396
+ (悬停 −60% → 保留 40%;选中 −40% → 保留 60%)。
397
+ 起因是用户觉得默认那档「太灰了」,读文档时对比度被吃掉。
398
+ 两个主题各给一套显式值,所以这不违反「不要硬编码不跟主题」这条:
399
+ 浅色是 rgba(38,49,72,α)(即 DSH 的 #263148),暗色是白色低透明度。 */
400
+ --knit-hover-bg:rgba(38,49,72,.024); /* DSH .0588 × 0.4 */
401
+ --knit-active-bg:rgba(38,49,72,.061); /* DSH .1020 × 0.6 */
395
402
  display:flex;flex-direction:column;height:100%;min-height:0;
396
403
  color:var(--dsw-alias-label-primary,#e8eaed);font-size:13px}
404
+ body[data-ds-dark-theme] .knit-root{
405
+ --knit-hover-bg:rgba(255,255,255,.031); /* DSH .0784 × 0.4 */
406
+ --knit-active-bg:rgba(255,255,255,.085); /* DSH .1412 × 0.6 */
407
+ }
397
408
  .knit-head{display:flex;align-items:center;gap:8px;padding:10px 12px 8px;flex:none}
398
409
  .knit-head .knit-root-path{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;
399
410
  white-space:nowrap;font-size:11px;color:var(--dsw-alias-label-caption,#80868b);
@@ -407,15 +418,15 @@ window.__ModuleLoader__.load({
407
418
  height:24px;padding:0 9px;border-radius:6px;cursor:pointer;
408
419
  background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6);
409
420
  border:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.08));font-size:11px}
410
- .knit-btn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.06));
421
+ .knit-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
411
422
  color:var(--dsw-alias-label-primary,#e8eaed)}
412
423
  .knit-bar{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none}
413
424
  .knit-seg{display:inline-flex;flex:none;border-radius:7px;overflow:hidden;
414
425
  border:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.1))}
415
426
  .knit-seg-btn{height:22px;padding:0 10px;cursor:pointer;font-size:11px;border:none;
416
427
  background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6)}
417
- .knit-seg-btn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.06))}
418
- .knit-seg-btn.active{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.1));
428
+ .knit-seg-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
429
+ .knit-seg-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
419
430
  color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
420
431
  .knit-filter{flex:1;min-width:0;height:24px;padding:0 9px;border-radius:7px;font-size:11px;
421
432
  background:transparent;color:var(--dsw-alias-label-primary,#e8eaed);
@@ -426,17 +437,21 @@ window.__ModuleLoader__.load({
426
437
  color:var(--dsw-alias-label-caption,#80868b);
427
438
  border-bottom:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.08));
428
439
  overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
440
+ /* 滚动条**不要自己画**:DSH 主题里已有全局样式
441
+ (::-webkit-scrollbar 宽 8px + --dsh-scrollbar-thumb,见 dsh-client-ui-theme)。
442
+ 曾经在这里写死 6px 宽 + rgba(255,255,255,.14) 的滑块 —— 白色 14% 在白底上完全隐形,
443
+ 用户的原话是「没有一个右侧的滑动条」。删掉即继承主题默认(l1),与侧栏列表一致。
444
+ ⚠️ CSS 注释里不要出现反引号:这段是模板字符串,反引号会把它提前截断。 */
429
445
  .knit-list{flex:1 1 auto;min-height:0;overflow-y:auto;padding:8px;display:flex;flex-direction:column;gap:6px;outline:none}
430
446
  .knit-list:focus-visible{box-shadow:inset 0 0 0 1px var(--knit-accent)}
431
- .knit-list::-webkit-scrollbar{width:6px}
432
- .knit-list::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:3px}
433
447
  .knit-doc{padding:10px 11px;border-radius:10px;cursor:pointer;
434
448
  border:.5px solid transparent;background:var(--dsw-alias-bg-layer-1,rgba(255,255,255,.03));
435
449
  transition:background .18s,border-color .18s,transform .18s,opacity .18s}
436
- .knit-doc:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.06));
450
+ .knit-doc:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
437
451
  border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.1));transform:translateX(-2px)}
452
+ /* 选中(正在预览)保留品牌色描边,与「键盘光标」的中性描边区分开 */
438
453
  .knit-doc.active{border-color:var(--knit-accent);
439
- background:var(--dsw-alias-interactive-bg-active,rgba(255,255,255,.1))}
454
+ background:var(--knit-active-bg,rgba(255,255,255,.085))}
440
455
  /* .knit-doc.cursor 故意不设样式:键盘焦点靠「移动即预览」的预览面板表达,
441
456
  再加描边会与 .active 的整块蓝色背景重复,显得突兀 */
442
457
  .knit-row1{display:flex;align-items:center;gap:8px;margin-bottom:5px}
@@ -454,25 +469,61 @@ window.__ModuleLoader__.load({
454
469
  background:rgba(255,120,120,.12);border:.5px solid rgba(255,120,120,.3);color:#ffb4b4}
455
470
  .knit-badge{font-size:10px;margin-right:3px}
456
471
 
457
- /* ── 列表下方的预览面板 ─────────────────────────────── */
458
- .knit-preview{flex:none;display:flex;flex-direction:column;min-height:0;
459
- border-top:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.1));
460
- background:var(--dsw-alias-bg-layer-1,rgba(255,255,255,.02))}
461
- .knit-resize{flex:none;height:7px;cursor:ns-resize;background:transparent;position:relative}
462
- .knit-resize::after{content:'';position:absolute;left:50%;top:2px;transform:translateX(-50%);
463
- width:34px;height:3px;border-radius:2px;background:var(--dsw-alias-border-l4,rgba(255,255,255,.14))}
464
- .knit-resize:hover::after{background:var(--knit-accent)}
465
- .knit-preview-head{display:flex;align-items:center;gap:8px;padding:6px 12px 8px;flex:none;
466
- border-bottom:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.06))}
467
- .knit-preview-title{flex:1;min-width:0;font-size:12px;font-weight:600;
468
- overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
469
- .knit-preview-body{flex:1;min-height:0;overflow-y:auto;padding:10px 14px 16px;font-size:12.5px}
470
- .knit-preview-body::-webkit-scrollbar{width:6px}
471
- .knit-preview-body::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:3px}
472
+ /* ── 列表下方的预览面板 ───────────────────────────────
473
+ 要让人一眼看出「这是另一层,不是列表的续行」,靠三件事:
474
+ ① 换一个**明暗主题下都不同**的表面令牌;
475
+ ② 顶部圆角 + 更强的上边界;
476
+ ③ 一层向上的柔影。
477
+ ⚠️ 不要用 bg-layer-2 来做层级:浅色主题下 bg-layer-1/2/3 解析出来全是 #fff,
478
+ 换过去等于没换(实测官方 theme 变量)。bg-module-platform 才两边都有差
479
+ (浅 #f5f6f7 / 深 #353638)。 */
480
+ .knit-preview{position:relative;flex:none;display:flex;flex-direction:column;min-height:0;
481
+ border-top:.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.14));
482
+ border-top-left-radius:12px;border-top-right-radius:12px;
483
+ background:var(--dsw-alias-bg-module-platform,rgba(255,255,255,.03));
484
+ box-shadow:0 -8px 24px rgba(0,0,0,.06);
485
+ transition:background-color .28s ease}
486
+ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
487
+ /* 用户在滚正文 = 在认真读 → 背景过渡到**纯阅读底色**(浅 #fff / 深 #151517)。
488
+ 灰底本来是为了分层,但读起来对比度弱;给个过渡就两者兼得。
489
+ 注意:圆角与柔影保留,所以「这是另一层」仍然看得出来。 */
490
+ .knit-preview.reading{background:var(--dsw-alias-bg-base,#fff)}
491
+ /* 拖拽把手:**绝对定位、不占布局高度**。
492
+ 它原来是一条 11px 的普通 flex 行,把 38px 的头整体往下推 —— 用户看到的就是
493
+ 「文档名和那几个按钮偏下」。改成浮在头顶的窄条后,头里的内容才真正上下居中。
494
+ 高度取 6px:头里的按钮高 24px、在 37.5px 内容区里居中 → 顶边在 6.75px,
495
+ 所以 6px 的把手**不会盖住按钮**(盖住会吃掉点击)。 */
496
+ .knit-resize{position:absolute;top:0;left:0;right:0;height:6px;z-index:2;
497
+ cursor:ns-resize;background:transparent;
498
+ display:flex;align-items:center;justify-content:center}
499
+ .knit-resize::after{content:'';width:44px;height:3px;border-radius:2px;
500
+ background:var(--dsw-alias-border-l3,rgba(255,255,255,.2));transition:background .15s,width .15s}
501
+ .knit-resize:hover::after{background:var(--knit-accent);width:64px}
502
+ /* 头对齐官方文档预览面板(.dhJKeW_header):38px 高 + border-l3,
503
+ 里面放路径面包屑而不是标题 —— 正文 H1 已经写了标题,重复只添乱。 */
504
+ .knit-preview-head{box-sizing:border-box;display:flex;align-items:center;gap:4px;
505
+ height:38px;padding:0 6px 0 12px;flex:none;
506
+ border-bottom:.5px solid var(--dsw-alias-border-l3,rgba(255,255,255,.14))}
507
+ /* 路径面包屑:**可点** —— 用系统默认应用打开这篇本地文档(阅读时多一个入口)。
508
+ 目录可收缩并出省略号,文件名不收缩,所以长路径下仍然看得见是哪个文件。 */
509
+ .knit-preview-path{flex:1 1 auto;min-width:0;display:flex;align-items:center;
510
+ margin-right:6px;font-size:12px;white-space:nowrap;overflow:hidden;
511
+ background:transparent;border:none;padding:0;font-family:inherit;text-align:left;
512
+ color:inherit;cursor:pointer}
513
+ .knit-preview-path:disabled{cursor:default}
514
+ .knit-preview-path:hover:not(:disabled) .knit-preview-name{text-decoration:underline}
515
+ .knit-preview-dir{flex:0 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;
516
+ color:var(--dsw-alias-label-tertiary,rgba(255,255,255,.4))}
517
+ .knit-preview-name{flex:0 0 auto;color:var(--dsw-alias-label-primary,#e8eaed)}
518
+ /* 正文区把滚动条提到 l2 —— 与官方文档预览面板同一档(那边的 .body 也覆盖这两个变量)。
519
+ 不重写 ::-webkit-scrollbar,只覆盖变量,所以宽度/圆角/悬停都跟 DSH 完全一致。 */
520
+ .knit-preview-body{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);
521
+ --dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);
522
+ flex:1;min-height:0;overflow-y:auto;padding:10px 14px 16px;font-size:12.5px}
472
523
  .knit-preview-close{flex:none;width:24px;height:24px;border-radius:6px;cursor:pointer;
473
524
  display:inline-flex;align-items:center;justify-content:center;font-size:13px;
474
525
  background:transparent;border:none;color:var(--dsw-alias-label-secondary,#9aa0a6)}
475
- .knit-preview-close:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08));
526
+ .knit-preview-close:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
476
527
  color:var(--dsw-alias-label-primary,#e8eaed)}
477
528
  .knit-raw{margin:0;white-space:pre-wrap;word-break:break-word;font-size:11.5px;line-height:1.6;
478
529
  color:var(--dsw-alias-label-secondary,#9aa0a6);font-family:ui-monospace,SFMono-Regular,Menlo,monospace}
@@ -488,9 +539,9 @@ window.__ModuleLoader__.load({
488
539
  color:var(--dsw-alias-label-secondary,#9aa0a6);font-family:inherit;font-size:11px;
489
540
  white-space:nowrap;overflow:hidden;text-overflow:ellipsis;
490
541
  transition:background .15s,color .15s}
491
- .knit-type-btn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08));
542
+ .knit-type-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
492
543
  color:var(--dsw-alias-label-primary,#e8eaed)}
493
- .knit-type-btn.active{background:var(--dsw-alias-interactive-bg-active,rgba(255,255,255,.1));
544
+ .knit-type-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
494
545
  color:var(--dsw-alias-label-primary,#e8eaed);font-weight:600}
495
546
 
496
547
  /* ── 图片与视频:方形缩略图网格 ─────────────────────
@@ -512,12 +563,14 @@ window.__ModuleLoader__.load({
512
563
  border:.5px solid var(--dsw-alias-border-l2,rgba(255,255,255,.1));
513
564
  transition:border-color .15s,box-shadow .15s}
514
565
  .knit-media-card:hover .knit-media-thumbbox{border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.22))}
515
- /* 正在预览 → 品牌色描边;键盘移动 → 只有中性描边,别让它看起来像「选中了」 */
516
- .knit-media-card.active .knit-media-thumbbox{
517
- border-color:var(--knit-accent);box-shadow:0 0 0 1.5px var(--knit-accent)}
566
+ /* 键盘移动 → 只有中性描边。必须排在 .active 之前:键盘光标默认常驻第一项,
567
+ 若排在后面会把「正在预览」的品牌色描边盖成灰色,点第一张图就看不到选中态。 */
518
568
  .knit-media-card.cursor .knit-media-thumbbox{
519
569
  border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.22));
520
570
  box-shadow:0 0 0 1.5px var(--dsw-alias-interactive-bg-active,rgba(255,255,255,.1))}
571
+ /* 正在预览 → 品牌色描边(排在 cursor 之后,确保同时命中时以「选中」为准) */
572
+ .knit-media-card.active .knit-media-thumbbox{
573
+ border-color:var(--knit-accent);box-shadow:0 0 0 1.5px var(--knit-accent)}
521
574
  /* 等比缩小态(一屏硬塞 8 个以上)下格子太小,文件名与时间会挤成一团 —— 整块让位给缩略图 */
522
575
  .knit-media-meta{margin-top:5px;display:var(--knit-media-label,block)}
523
576
  .knit-media-name{display:flex;align-items:center;gap:3px;font-size:11.5px;line-height:1.3;
@@ -582,7 +635,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
582
635
  width:28px;height:28px;padding:0;border:none;border-radius:8px;cursor:pointer;
583
636
  background:transparent;color:var(--dsw-alias-label-secondary,#9aa0a6);
584
637
  transition:background .15s}
585
- .knit-entry:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08))}
638
+ .knit-entry:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03))}
586
639
  .knit-entry:active{transform:scale(.94)}
587
640
 
588
641
  /* 全屏阅读:藏掉头部与列表,只留预览 */
@@ -591,7 +644,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
591
644
  .knit-root.fullscreen .knit-types,
592
645
  .knit-root.fullscreen .knit-topic,
593
646
  .knit-root.fullscreen .knit-list{display:none}
594
- .knit-root.fullscreen .knit-preview{flex:1 1 auto;max-height:none}
647
+ /* 全屏时预览铺满整个面板:圆角与向上柔影是「浮在列表上」的隐喻,这里没有列表,去掉 */
648
+ .knit-root.fullscreen .knit-preview{flex:1 1 auto;max-height:none;
649
+ border-top:none;border-radius:0;box-shadow:none}
595
650
  `
596
651
 
597
652
  /**
@@ -724,6 +779,39 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
724
779
  return out.join('/')
725
780
  }
726
781
 
782
+ /**
783
+ * 把工作区相对路径拆成「目录 / 文件名」,给预览头做面包屑。
784
+ *
785
+ * 官方文档预览面板就是这么做的(路径靠右、目录用 tertiary、文件名用 primary),
786
+ * 好处是**文件名永远可见**、长目录靠左被裁掉 —— 而预览头如果直接重复正文的 H1,
787
+ * 用户会看到「列表行标题 / 预览头标题 / 正文标题」三遍同一个词,
788
+ * 反而分不清哪块是列表、哪块是详情。
789
+ *
790
+ * @param {string} rel - 工作区相对路径,如 `a/b/c.md`
791
+ * @returns {{dir: string, name: string}} 目录(含结尾斜杠)与文件名
792
+ */
793
+ function splitRelPath(rel) {
794
+ const path = String(rel == null ? '' : rel)
795
+ const cut = path.lastIndexOf('/')
796
+ if (cut < 0) return { dir: '', name: path }
797
+ return { dir: path.slice(0, cut + 1), name: path.slice(cut + 1) }
798
+ }
799
+
800
+ /**
801
+ * 把工作区根与相对路径拼成绝对路径(拿不到宿主给的 path 时的兜底)。
802
+ *
803
+ * @param {string} root - 工作区根(宿主返回的绝对路径)
804
+ * @param {string} rel - 工作区相对路径
805
+ * @returns {string} 绝对路径;拼不出来就返回空串
806
+ */
807
+ function joinPath(root, rel) {
808
+ const base = String(root == null ? '' : root).replace(/\/+$/, '')
809
+ const tail = String(rel == null ? '' : rel).replace(/^\/+/, '')
810
+ if (!base) return ''
811
+ if (!tail) return base
812
+ return `${base}/${tail}`
813
+ }
814
+
727
815
  /**
728
816
  * 给 MarkdownText 的相对路径图片解析器。
729
817
  *
@@ -897,11 +985,12 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
897
985
 
898
986
  /**
899
987
  * 列表下方的预览面板。
900
- * @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenTab:Function,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
988
+ * @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenLocal:Function|null,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
901
989
  * @returns {import('react').ReactElement} 元素
902
990
  */
903
- function PreviewPanel({ preview, pathImages, fullscreen, ratio, onClose, onOpenTab, onToggleFullscreen, onResizeStart }) {
991
+ function PreviewPanel({ preview, pathImages, fullscreen, ratio, reading, onClose, onOpenLocal, onToggleFullscreen, onResizeStart, onScrollBody }) {
904
992
  const isMedia = preview.kind === 'image' || preview.kind === 'video'
993
+ const previewPath = splitRelPath(preview.rel)
905
994
 
906
995
  // 图片/视频不读正文,直接用同源字节地址渲染;Markdown 才走加载 / MarkdownText / 降级。
907
996
  const body = preview.status === 'loading'
@@ -933,20 +1022,45 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
933
1022
  h('pre', { className: 'knit-raw' }, preview.text))
934
1023
 
935
1024
  return h('div', {
936
- className: 'knit-preview',
1025
+ className: `knit-preview${reading ? ' reading' : ''}`,
937
1026
  style: fullscreen ? undefined : { maxHeight: `${Math.round(ratio * 100)}%` },
938
1027
  },
939
1028
  fullscreen ? null : h('div', { className: 'knit-resize', onPointerDown: onResizeStart, title: t('preview.resizeTitle') }),
940
1029
  h('div', { className: 'knit-preview-head' },
941
- h('div', { className: 'knit-preview-title', title: preview.rel }, preview.title || preview.rel),
1030
+ // 路径面包屑,**可点**:用系统默认应用打开这篇本地文档 —— 阅读时多一个
1031
+ // 「跳到本地」的入口。不放标题:正文 H1 已经写了,重复会让
1032
+ // 「列表行 / 预览头 / 正文」出现三遍同一个词,反而分不清哪块是详情。
1033
+ h('button', {
1034
+ type: 'button',
1035
+ className: 'knit-preview-path',
1036
+ title: onOpenLocal ? t('preview.openLocal', { path: preview.rel }) : preview.rel,
1037
+ disabled: !onOpenLocal,
1038
+ onClick: () => { if (onOpenLocal) onOpenLocal() },
1039
+ },
1040
+ previewPath.dir
1041
+ ? h('span', { className: 'knit-preview-dir' }, previewPath.dir)
1042
+ : null,
1043
+ h('span', { className: 'knit-preview-name' }, previewPath.name)),
942
1044
  h('button', {
943
1045
  className: 'knit-btn',
944
1046
  onClick: onToggleFullscreen,
945
1047
  title: fullscreen ? t('preview.exitFullscreenTitle') : t('preview.fullscreenTitle'),
946
1048
  }, fullscreen ? t('preview.exitFullscreen') : t('preview.fullscreen')),
947
- h('button', { className: 'knit-btn', onClick: onOpenTab, title: t('preview.newTabTitle') }, t('preview.newTab')),
1049
+ // 「在本地打开」= 之前那个「新标签页」的位置(v0.10)。
1050
+ // 「新标签页」开的是官方文档预览,但面板里已经有就地预览,重复度高、用得少;
1051
+ // 而「用默认应用打开这篇文档」原本只藏在路径面包屑的悬停提示里 ——
1052
+ // 把值钱的那个放到显眼处,把鸡肋的那个让位(双击列表行仍能开新标签页)。
1053
+ h('button', {
1054
+ className: 'knit-btn',
1055
+ onClick: () => { if (onOpenLocal) onOpenLocal() },
1056
+ disabled: !onOpenLocal,
1057
+ title: onOpenLocal ? t('preview.openLocal', { path: preview.rel }) : preview.rel,
1058
+ }, t('preview.openLocalBtn')),
948
1059
  h('button', { className: 'knit-preview-close', onClick: onClose, title: t('preview.close') }, '✕')),
949
- h('div', { className: `knit-preview-body${isMedia ? ' is-media' : ''}` },
1060
+ h('div', {
1061
+ className: `knit-preview-body${isMedia ? ' is-media' : ''}`,
1062
+ onScroll: onScrollBody,
1063
+ },
950
1064
  !isMedia && preview.truncated ? h('div', { className: 'knit-preview-note' }, t('preview.truncated')) : null,
951
1065
  body))
952
1066
  }
@@ -982,6 +1096,12 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
982
1096
  // 放在 fullscreen 之后,保持前几个 hook 的顺序不变 —— 测试按顺序预置状态。
983
1097
  const [listWidth, setListWidth] = React.useState(0)
984
1098
 
1099
+ // 阅读态:记「哪一篇被滚过」。真正的存储是**模块级**的 readingDocs(见其定义),
1100
+ // 组件里只留一个自增计数器用来触发重渲染 —— 这样即便宿主把 tab body
1101
+ // 重新挂载(用户反馈「鼠标移出去以后就没有了」,组件 state 会归零),
1102
+ // 阅读态也不会丢。放在最后,不动前面任何 hook 的槽位。
1103
+ const [readingTick, setReadingTick] = React.useState(0)
1104
+
985
1105
  React.useEffect(() => {
986
1106
  const host = listRef.current
987
1107
  if (!host || typeof ResizeObserver === 'undefined') return undefined
@@ -1100,7 +1220,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1100
1220
  * Markdown 才进 loading 去拉正文。
1101
1221
  */
1102
1222
  const previewFor = React.useCallback((doc) => {
1103
- const base = { rel: doc.rel, title: doc.title || doc.name, text: '', truncated: false }
1223
+ const base = { rel: doc.rel, title: doc.title || doc.name, path: doc.path || '', text: '', truncated: false }
1104
1224
  if (isMedia(doc)) {
1105
1225
  return { ...base, kind: doc.kind, src: mediaUrl(sessionId, doc.rel), status: 'ready' }
1106
1226
  }
@@ -1188,7 +1308,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1188
1308
  const apply = (target) => {
1189
1309
  setNotice('')
1190
1310
  // 悬停浮层只列 Markdown,这里固定按文档走 loading→拉正文。
1191
- setPreview({ rel: target.rel, title: target.title, kind: KIND_DOC, status: 'loading', text: '', truncated: false })
1311
+ setPreview({ rel: target.rel, title: target.title, path: target.path || '', kind: KIND_DOC, status: 'loading', text: '', truncated: false })
1192
1312
  }
1193
1313
  if (pendingPreview) {
1194
1314
  const queued = pendingPreview
@@ -1201,6 +1321,31 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1201
1321
  // 预览进入 loading 时去宿主取正文
1202
1322
  const previewRel = preview && preview.rel
1203
1323
  const previewStatus = preview && preview.status
1324
+
1325
+ /** 阅读态 = 当前这一篇被滚过。换一篇自然为 false(派生,不用复位 effect)。 */
1326
+ const reading = Boolean(previewRel) && readingDocs.has(readingKey(sessionId, previewRel))
1327
+
1328
+ /** 一开始滚正文就进入阅读态(阈值 4px,避免 1px 抖动就触发);进了就不再退回。 */
1329
+ const onScrollBody = React.useCallback((event) => {
1330
+ const el = event && event.target
1331
+ if (!el || typeof el.scrollTop !== 'number' || el.scrollTop <= READING_SCROLL_PX) return
1332
+ const key = readingKey(sessionId, previewRel)
1333
+ if (readingDocs.has(key)) return
1334
+ readingDocs.add(key)
1335
+ setReadingTick((n) => n + 1) // 只是为了让这次写入反映到界面上
1336
+ }, [sessionId, previewRel])
1337
+ void readingTick
1338
+
1339
+ /** 这篇文档在磁盘上的绝对路径:宿主给的 path 优先,拿不到就用 root + rel 拼。 */
1340
+ const previewAbsPath = preview
1341
+ ? (preview.path || joinPath(state.root, preview.rel))
1342
+ : ''
1343
+
1344
+ /** 点预览头那行路径 → 用系统默认应用打开本地文档。 */
1345
+ const openPreviewLocal = React.useCallback(async () => {
1346
+ setNotice((await openLocalPath(previewAbsPath)) || '')
1347
+ }, [previewAbsPath])
1348
+
1204
1349
  React.useEffect(() => {
1205
1350
  if (!previewRel || previewStatus !== 'loading') return undefined
1206
1351
  let alive = true
@@ -1405,8 +1550,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1405
1550
  pathImages,
1406
1551
  fullscreen,
1407
1552
  ratio,
1553
+ reading,
1554
+ onScrollBody,
1555
+ // 拿不到绝对路径就不给点(而不是点了没反应)
1556
+ onOpenLocal: previewAbsPath ? openPreviewLocal : null,
1408
1557
  onClose: closePreview,
1409
- onOpenTab: () => onOpenTab(null),
1410
1558
  onToggleFullscreen: () => setFullscreen((v) => !v),
1411
1559
  onResizeStart,
1412
1560
  }) : null)
@@ -1763,6 +1911,27 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1763
1911
  /** @type {Set<Function>} */
1764
1912
  const previewSubscribers = new Set()
1765
1913
 
1914
+ /**
1915
+ * 已经进入过「阅读态」的文档,key 见 `readingKey`。
1916
+ *
1917
+ * **故意放在模块级而不是组件 state**:用户反馈「滚过之后背景变白,但鼠标移出去
1918
+ * 就没有了」—— 组件 state 会随宿主重挂载归零,本模块级集合不会。
1919
+ * 语义是「这一篇在这个会话里被读过」,所以重挂载、切 tab 回来都仍然算读过。
1920
+ *
1921
+ * @type {Set<string>}
1922
+ */
1923
+ const readingDocs = new Set()
1924
+
1925
+ /**
1926
+ * 阅读态的 key:同一会话里的同一篇文档算一个。
1927
+ * @param {string} sessionId - 会话 id
1928
+ * @param {string} rel - 工作区相对路径
1929
+ * @returns {string} key
1930
+ */
1931
+ function readingKey(sessionId, rel) {
1932
+ return `${sessionId || ''}\u0000${rel || ''}`
1933
+ }
1934
+
1766
1935
  /**
1767
1936
  * 请求在面板里打开某一篇。面板挂着就立刻生效,没挂就留一份挂起。
1768
1937
  * @param {{rel:string, title?:string, name?:string}} doc - 目标文档
package/src/host/index.js CHANGED
@@ -18,6 +18,7 @@ import { createReadStream } from 'node:fs'
18
18
  import { join, relative, resolve, sep } from 'node:path'
19
19
  import { homedir } from 'node:os'
20
20
  import { extractKeywords, rankByRelevance, topicLabel } from './relevance.js'
21
+ import { registerKnitDocsTool } from './tool.js'
21
22
 
22
23
  export const name = 'dsh-knit'
23
24
 
@@ -490,8 +491,10 @@ function publicDoc(doc) {
490
491
  *
491
492
  * @param {string} root - 工作区根
492
493
  * @param {number} limit - 最多返回多少条
493
- * @param {{session?: object, sessionId?: string, sort?: string, kind?: string}} options -
494
- * 排序上下文;`kind` 为 `doc`(默认,仅 Markdown)、`media`(仅图片/视频)或 `all`
494
+ * @param {{session?: object, sessionId?: string, sort?: string, kind?: string, query?: string}} options -
495
+ * 排序上下文;`kind` 为 `doc`(默认,仅 Markdown)、`media`(仅图片/视频)或 `all`;
496
+ * `query` 非空时**用它排序,而不是用当前对话**(v0.7 的 agent 工具走这条路);
497
+ * HTTP 路由不传 `query`,所以 `/knit/api/recent` 的行为逐字不变
495
498
  * @returns {Promise<object>} 给浏览器的载荷
496
499
  */
497
500
  export async function scan(root, limit, options = {}) {
@@ -516,16 +519,34 @@ export async function scan(root, limit, options = {}) {
516
519
  const sessionId = options.sessionId || ''
517
520
  let keywords = NO_KEYWORDS
518
521
  let mode = 'time'
522
+ let matched = []
519
523
 
520
524
  if (wantRelevance) {
521
- keywords = keywordsFor(options.session, sessionId)
525
+ // 调用方给了明确的 query(v0.7 的 agent 工具走这条路):把它当成**一条最新的消息**,
526
+ // 于是走的是完全相同的抽取与门槛规则,不引入第二条抽取路径。
527
+ // 不进 convCache —— 那个缓存按 session seq 键控,塞 query 进去会互相污染。
528
+ const explicitQuery = typeof options.query === 'string' ? options.query.trim() : ''
529
+ keywords = explicitQuery
530
+ ? extractKeywords([explicitQuery], 30)
531
+ : keywordsFor(options.session, sessionId)
522
532
  // 没有对话可依据时老实退回时间序,而不是假装排了个序
523
533
  mode = keywords.length > 0 ? 'relevance' : 'time'
524
534
  }
525
535
 
526
- const ordered = mode === 'relevance'
527
- ? rankByRelevance(pool, keywords, Date.now()).docs
528
- : pool.map((doc) => ({ ...doc, score: null }))
536
+ let ordered
537
+ let topic = ''
538
+ if (mode === 'relevance') {
539
+ const ranked = rankByRelevance(pool, keywords, Date.now())
540
+ ordered = ranked.docs
541
+ // 话题标签用 `label`(把命中词的**原文区间合并**后的可读结果),不是 `matched`。
542
+ // 后者是「语料里真实存在的词」,但仍可能是一堆碎片:
543
+ // 「项目文档」的候选是 `项目文` / `目文档`,直接显示就成了「按「目文档、项目文」排序」。
544
+ // `keywords` 字段保持语义不变,仍然是那批真实存在的词。
545
+ topic = topicLabel(ranked.label)
546
+ matched = ranked.matched
547
+ } else {
548
+ ordered = pool.map((doc) => ({ ...doc, score: null }))
549
+ }
529
550
 
530
551
  return {
531
552
  ok: true,
@@ -535,8 +556,8 @@ export async function scan(root, limit, options = {}) {
535
556
  truncated,
536
557
  sessionId,
537
558
  mode,
538
- topic: mode === 'relevance' ? topicLabel(keywords) : '',
539
- keywords: mode === 'relevance' ? keywords.slice(0, 8).map((k) => k.term) : [],
559
+ topic,
560
+ keywords: mode === 'relevance' ? matched.slice(0, 8) : [],
540
561
  docs: ordered.slice(0, limit).map(publicDoc),
541
562
  }
542
563
  }
@@ -835,4 +856,17 @@ export function apply(ctx) {
835
856
  return () => unregister()
836
857
  }, 'dsh-knit: host route')
837
858
  })
859
+
860
+ // ── v0.7:把同一个排序结果也交给模型 ──────────────────────────────
861
+ //
862
+ // 独立的一次 `ctx.inject`,**不是**把 'tools' 加进上面那个数组。
863
+ // 加进去的话 `tools` 缺席时整个回调都不跑 —— 连面板路由都起不来。
864
+ // 两条路互不依赖:没有 tools 服务时,浏览器那半边照常工作。
865
+ ctx.inject(['tools'], (toolCtx) => {
866
+ toolCtx.effect(
867
+ () => registerKnitDocsTool(toolCtx, scan, readDocument),
868
+ 'dsh-knit: knit_docs tool',
869
+ )
870
+ console.log(`[${name}] agent tool ready: knit_docs`)
871
+ })
838
872
  }