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.
- package/README.en.md +115 -18
- package/README.md +105 -17
- package/SECURITY.md +51 -0
- package/package.json +7 -4
- package/src/client/client.js +218 -49
- package/src/host/index.js +42 -8
- package/src/host/relevance.js +463 -67
- package/src/host/tool.js +424 -0
- package/test/client.test.mjs +191 -2
- package/test/eval/fixture.mjs +439 -0
- package/test/eval/legacy.mjs +115 -0
- package/test/eval.test.mjs +80 -0
- package/test/harness.mjs +1 -1
- package/test/host-http.test.mjs +21 -8
- package/test/host.test.mjs +117 -3
- package/test/i18n.test.mjs +21 -2
- package/test/label.test.mjs +149 -0
- package/test/path.test.mjs +150 -1
- package/test/peek.test.mjs +3 -1
- package/test/security.test.mjs +148 -0
- package/test/tool.test.mjs +472 -0
package/src/client/client.js
CHANGED
|
@@ -54,8 +54,8 @@ window.__ModuleLoader__.load({
|
|
|
54
54
|
'filter.placeholder': '过滤标题 / 摘要 / 路径',
|
|
55
55
|
'filter.aria': '过滤文档',
|
|
56
56
|
|
|
57
|
-
'topic.relevance': '
|
|
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.
|
|
85
|
-
'preview.
|
|
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': '
|
|
147
|
-
'topic.relevancePlain': '
|
|
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.
|
|
174
|
-
'preview.
|
|
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
|
-
/*
|
|
394
|
-
|
|
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(--
|
|
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(--
|
|
418
|
-
.knit-seg-btn.active{background:var(--
|
|
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(--
|
|
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(--
|
|
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
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
.knit-preview
|
|
466
|
-
border-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
.
|
|
471
|
-
.knit-preview-
|
|
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(--
|
|
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(--
|
|
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(--
|
|
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
|
-
|
|
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(--
|
|
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
|
-
|
|
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,
|
|
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,
|
|
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:
|
|
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
|
-
|
|
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
|
-
|
|
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', {
|
|
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
|
-
|
|
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
|
-
|
|
527
|
-
|
|
528
|
-
|
|
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
|
|
539
|
-
keywords: mode === 'relevance' ?
|
|
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
|
}
|