dsh-knit 0.14.0 → 0.16.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 +279 -0
- package/README.en.md +81 -23
- package/README.md +71 -20
- package/package.json +3 -2
- package/src/client/client.js +237 -98
- package/src/host/feedback.js +858 -0
- package/src/host/index.js +171 -7
- package/src/host/tool.js +63 -3
- package/test/client.test.mjs +279 -31
- package/test/context-delta.test.mjs +322 -0
- package/test/context-effectiveness.test.mjs +309 -0
- package/test/context-feedback-eval.test.mjs +220 -0
- package/test/feedback.test.mjs +247 -0
- package/test/host-http.test.mjs +249 -3
- package/test/i18n.test.mjs +22 -23
- package/test/path.test.mjs +6 -6
- package/test/peek.test.mjs +80 -26
- package/test/tool.test.mjs +132 -5
- package/tools/context-feedback-eval.mjs +362 -0
package/src/client/client.js
CHANGED
|
@@ -37,7 +37,6 @@ window.__ModuleLoader__.load({
|
|
|
37
37
|
'count.all.filtered': '{hit} / {total} 项',
|
|
38
38
|
'action.refresh': '刷新',
|
|
39
39
|
'path.openTitle': '在文件管理器中打开',
|
|
40
|
-
'peek.openPanel': '点击打开面板',
|
|
41
40
|
'peek.empty': '这个工作区里还没有 Markdown 文档。',
|
|
42
41
|
'action.refreshNow': '立即刷新',
|
|
43
42
|
|
|
@@ -51,15 +50,20 @@ window.__ModuleLoader__.load({
|
|
|
51
50
|
'kind.media': '图片与视频',
|
|
52
51
|
'kind.title': '切换要列出的产物类型',
|
|
53
52
|
|
|
54
|
-
'filter.placeholder': '
|
|
53
|
+
'filter.placeholder': '过滤文档',
|
|
55
54
|
'filter.aria': '过滤文档',
|
|
56
55
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
'
|
|
60
|
-
'
|
|
61
|
-
'
|
|
62
|
-
'
|
|
56
|
+
'usage.toggle': '使用情况',
|
|
57
|
+
'usage.toggleTitle': '打开后开始统计这个会话:先看的那篇有没有被读、有多少次读落在包外、上下文换过几回。只记事实,不给分数。',
|
|
58
|
+
'usage.none': '还没有记录',
|
|
59
|
+
'usage.epoch': '当前上下文 · Epoch {n}',
|
|
60
|
+
'usage.primaryRead': '先看的「{rel}」已读',
|
|
61
|
+
'usage.primaryUnread': '先看的「{rel}」还没读',
|
|
62
|
+
'usage.supporting': '辅助 {read}/{total}',
|
|
63
|
+
'usage.reads': '读了 {n} 次',
|
|
64
|
+
'usage.outside': '包外 {n} 篇',
|
|
65
|
+
'usage.changes': '上下文换过 {n} 次',
|
|
66
|
+
'usage.note': '只统计本会话 · 数据在内核内存里,重启 DSH 就没了',
|
|
63
67
|
|
|
64
68
|
// ── v0.14 当前任务上下文(Context Pack)──────────────────────
|
|
65
69
|
// ⚠️ 文案纪律:不出现「AI / 智能 / 推荐 / 置信度 / 百分比」。
|
|
@@ -126,7 +130,7 @@ window.__ModuleLoader__.load({
|
|
|
126
130
|
'preview.fullscreenTitle': '全屏阅读',
|
|
127
131
|
'preview.exitFullscreenTitle': '退出全屏(Esc)',
|
|
128
132
|
'preview.openLocal': '{path}\n用系统默认应用打开这篇文档',
|
|
129
|
-
'preview.openLocalBtn': '
|
|
133
|
+
'preview.openLocalBtn': '本地打开',
|
|
130
134
|
'preview.close': '收起预览',
|
|
131
135
|
'preview.resizeTitle': '拖动调整高度',
|
|
132
136
|
// v0.12 引用条。⚠️ 不放任何表情符号(test/i18n.test.mjs 有守卫)。
|
|
@@ -179,7 +183,6 @@ window.__ModuleLoader__.load({
|
|
|
179
183
|
'count.all.filtered': '{hit} / {total} items',
|
|
180
184
|
'action.refresh': 'Refresh',
|
|
181
185
|
'path.openTitle': 'Open in file manager',
|
|
182
|
-
'peek.openPanel': 'Click to open the panel',
|
|
183
186
|
'peek.empty': 'No Markdown documents in this workspace yet.',
|
|
184
187
|
'action.refreshNow': 'Refresh now',
|
|
185
188
|
|
|
@@ -193,15 +196,20 @@ window.__ModuleLoader__.load({
|
|
|
193
196
|
'kind.media': 'Images & video',
|
|
194
197
|
'kind.title': 'Switch which artifacts are listed',
|
|
195
198
|
|
|
196
|
-
'filter.placeholder': 'Filter
|
|
199
|
+
'filter.placeholder': 'Filter docs',
|
|
197
200
|
'filter.aria': 'Filter documents',
|
|
198
201
|
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
'
|
|
202
|
-
'
|
|
203
|
-
'
|
|
204
|
-
'
|
|
202
|
+
'usage.toggle': 'Usage',
|
|
203
|
+
'usage.toggleTitle': 'Measure this session: whether the primary doc was read, how many reads fell outside the pack, how often the context changed. Facts only — no score.',
|
|
204
|
+
'usage.none': 'Nothing recorded yet',
|
|
205
|
+
'usage.epoch': 'Context · Epoch {n}',
|
|
206
|
+
'usage.primaryRead': 'primary read ({rel})',
|
|
207
|
+
'usage.primaryUnread': 'primary not read yet ({rel})',
|
|
208
|
+
'usage.supporting': 'supporting {read}/{total}',
|
|
209
|
+
'usage.reads': '{n} reads',
|
|
210
|
+
'usage.outside': '{n} outside the pack',
|
|
211
|
+
'usage.changes': 'context changed {n}×',
|
|
212
|
+
'usage.note': 'This session only · kept in kernel memory, gone after a DSH restart',
|
|
205
213
|
|
|
206
214
|
// ── v0.14 current-task context (Context Pack) ──────────────
|
|
207
215
|
// ⚠️ Never say "AI", "smart", "recommended", "confidence" or show percentages:
|
|
@@ -405,6 +413,11 @@ window.__ModuleLoader__.load({
|
|
|
405
413
|
const SORT_KEY = 'dsh-knit:sort'
|
|
406
414
|
const RATIO_KEY = 'dsh-knit:preview-ratio'
|
|
407
415
|
const KIND_KEY = 'dsh-knit:kind'
|
|
416
|
+
/**
|
|
417
|
+
* v0.15「使用情况」的开闸键。**默认关** —— 记账意味着每次轮询都要读一遍会话事件,
|
|
418
|
+
* 用户没要看这个之前,不该有人替他付出这个代价(也不该悄悄攒数据)。
|
|
419
|
+
*/
|
|
420
|
+
const USAGE_KEY = 'dsh-knit:usage'
|
|
408
421
|
|
|
409
422
|
/** 列表类型:仅文档 / 仅图片视频 / 全部混排。默认 doc,与旧版体验一致。 */
|
|
410
423
|
const KIND_DOC = 'doc'
|
|
@@ -567,6 +580,8 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
567
580
|
border:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.08));font-size:11px}
|
|
568
581
|
.knit-btn:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
|
|
569
582
|
color:var(--dsw-alias-label-primary,#e8eaed)}
|
|
583
|
+
.knit-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
|
|
584
|
+
color:var(--dsw-alias-label-primary,#e8eaed);border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.22))}
|
|
570
585
|
.knit-bar{display:flex;align-items:center;gap:8px;padding:0 12px 8px;flex:none}
|
|
571
586
|
.knit-seg{display:inline-flex;flex:none;border-radius:7px;overflow:hidden;
|
|
572
587
|
border:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.1))}
|
|
@@ -580,12 +595,15 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
580
595
|
border:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.1));outline:none}
|
|
581
596
|
.knit-filter:focus{border-color:var(--knit-accent)}
|
|
582
597
|
.knit-filter::placeholder{color:var(--dsw-alias-label-caption,#80868b)}
|
|
583
|
-
|
|
598
|
+
/* v0.15「使用情况」:**一行事实**,不画卡片、不画进度条、不用品牌色。
|
|
599
|
+
它占的就是原来「相关性排序」那一行的位置 —— 2026-09-30 用户裁决那一行
|
|
600
|
+
整个删掉(排序方式由「相关 / 最新」那个切换按钮自己表达,再说一遍是重复),
|
|
601
|
+
所以它现在是头部下面唯一的一行弱化文字,不是一块新面板。
|
|
602
|
+
⚠️ 全宽横线一律不画:2026-09-29 用户要求**减少全宽分割线** ——
|
|
603
|
+
「页面上横线一多,读起来就像文件管理表格」。层级由空间与字号建立。 */
|
|
604
|
+
.knit-usage{flex:none;padding:0 12px 9px;font-size:10.5px;line-height:1.45;
|
|
584
605
|
color:var(--dsw-alias-label-caption,#80868b);
|
|
585
606
|
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
|
586
|
-
/* ⚠️ 这里以前有一条 border-bottom(全宽横线)。2026-09-29 用户要求**减少全宽分割线**
|
|
587
|
-
——「页面上横线一多,读起来就像文件管理表格」。层级改由空间与字号建立:
|
|
588
|
-
这一行只用 bottom padding 与列表拉开距离,不画线。 */
|
|
589
607
|
|
|
590
608
|
|
|
591
609
|
/* ── v0.14 右栏(Context Pack 面板)已整体删除(2026-09-29)────────
|
|
@@ -638,7 +656,9 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
638
656
|
其他数据放在右边」)。第一列=序号那条竖直的轴(.knit-num),第二列=其余全部数据
|
|
639
657
|
(.knit-body)。用 grid 而不是「有号才插一个元素」,是因为没有号的条目(时间序 /
|
|
640
658
|
筛选结果 /「其他相关文档」)也要和有的条目**左边缘对齐** —— 轨道一直在,
|
|
641
|
-
正文就永远不会因为少一个序号而左移。
|
|
659
|
+
正文就永远不会因为少一个序号而左移。
|
|
660
|
+
2026-10-01 补:光对齐还不够 —— **混着**才刺眼(整屏没号时没人觉得缺东西)。所以
|
|
661
|
+
这一屏里有号时,没号的行在同一列渲染一个 .knit-gapmark(·)把格子顶住。 */
|
|
642
662
|
/* 行的**静止态没有底色**(2026-09-29 用户反馈:「深色模式下,文档列表没有选中,鼠标没有悬停,
|
|
643
663
|
不需要有背景。或者是说,跟深色模式的最底下的背景一样」)。
|
|
644
664
|
⚠️ 这里以前写的是 bg-layer-1 —— 浅色主题下它和面板底色都是 #fff(根本看不出来),
|
|
@@ -646,20 +666,24 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
646
666
|
现在静止态直接 transparent,露出宿主侧边栏的底色(.knit-root / .knit-list 都不画底色);
|
|
647
667
|
⚠️ 右栏删除后这段注释里提到的 .knit-pack 已经不存在了(2026-09-29),
|
|
648
668
|
hover 与 .active 各有自己的令牌,
|
|
649
|
-
两者都**不该**跟着改成 transparent(那样一屏灰里就认不出选中态了)。
|
|
669
|
+
两者都**不该**跟着改成 transparent(那样一屏灰里就认不出选中态了)。
|
|
670
|
+
⚠️ 2026-09-30 用户反馈:「悬停跟选中,最外层那个描边,我觉得也不需要了,还是有点影响」
|
|
671
|
+
⇒ 原来那圈 .5px solid transparent(悬停 / 选中时才上色)**整条删掉**。
|
|
672
|
+
padding 各加 .5px 补回那条边框占掉的宽度,行的几何尺寸与改前逐像素一致
|
|
673
|
+
(所以下面这两条 padding 数字是有来历的,不是随手写的小数)。 */
|
|
650
674
|
.knit-doc{display:grid;grid-template-columns:22px minmax(0,1fr);column-gap:8px;align-items:start;
|
|
651
|
-
padding:
|
|
652
|
-
|
|
653
|
-
transition:background .18s,
|
|
654
|
-
.knit-doc:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
675
|
+
padding:10.5px 11.5px;border-radius:10px;cursor:pointer;
|
|
676
|
+
background:transparent;
|
|
677
|
+
transition:background .18s,transform .18s,opacity .18s}
|
|
678
|
+
.knit-doc:hover{background:var(--knit-hover-bg,rgba(255,255,255,.03));transform:translateX(-2px)}
|
|
679
|
+
/* 选中(正在预览)=**只有灰底**(2026-09-30 用户裁决)。
|
|
680
|
+
⚠️ 这条的上一版是「中性描边 + 灰底」(2026-09-29 裁决,用来取代更早的品牌色描边)。
|
|
681
|
+
用户这次的原话是「文档列表悬停跟选中,最外层那个描边,我觉得也不需要了」⇒
|
|
682
|
+
描边整条删掉,**选中态只剩灰底**。
|
|
683
|
+
⚠️ 灰底是选中唯一的分层信号,**不许**跟着改成 transparent(一屏灰里就认不出选中了)。
|
|
684
|
+
⚠️ hover 与选中的区别现在**只**是底色深浅(--knit-hover-bg / --knit-active-bg),
|
|
685
|
+
不再有任何一圈线。 */
|
|
686
|
+
.knit-doc.active{background:var(--knit-active-bg,rgba(255,255,255,.085))}
|
|
663
687
|
/* .knit-doc.cursor **故意不设样式**:键盘焦点靠「移动即预览」的预览面板表达,
|
|
664
688
|
再加描边会与 .active 的整块背景重复,显得突兀。
|
|
665
689
|
(曾经有一条 「.knit-multicol .knit-doc.cursor」 的中性环,是为多列网格补的 ——
|
|
@@ -683,8 +707,14 @@ body[data-ds-dark-theme] .knit-root{
|
|
|
683
707
|
它=.knit-title 的 14px × 1.4。格的 align-items:start 让这一列从卡片顶边
|
|
684
708
|
开始排,所以只要这个行盒与标题行盒等高,两个字号不同的文本就自然居中。
|
|
685
709
|
**改 .knit-title 的字号或行高时,这里必须同步改**,否则序号会与标题错开。 */
|
|
686
|
-
.knit-num{grid-column:1;font-size:10.5px;line-height:19.6px;font-variant-numeric:tabular-nums;
|
|
710
|
+
.knit-num,.knit-gapmark{grid-column:1;font-size:10.5px;line-height:19.6px;font-variant-numeric:tabular-nums;
|
|
687
711
|
color:var(--dsw-alias-label-caption,#80868b)}
|
|
712
|
+
/* 中性占位标记(2026-10-01 用户反馈):「其他相关文档」那一节没有序号,空着的那一格
|
|
713
|
+
被读成「漏了一个号」(原话:「没有序号以后左边就空了,视觉上比较割裂,就觉得是个 bug 一样」)。
|
|
714
|
+
没号的行就在同一列放一个最轻的 · —— 不冒充序号,也不让轨道断掉。
|
|
715
|
+
⚠️ 只有**这一屏里有号**时才渲染(时间序 / 平铺列表整屏都没号 ⇒ 一个标记都没有:
|
|
716
|
+
一屏里要么都有、要么都没有;混着才是刺眼的原因)。
|
|
717
|
+
⚠️ 几何与 .knit-num 共用同一条选择器 —— 这就是「改一处必须改另一处」的执行方式。 */
|
|
688
718
|
/* 右边这一列=其余全部数据(标题行 / 摘要 / 理由)。
|
|
689
719
|
⚠️ min-width:0 不能省:轨道是 minmax(0,1fr),但**单元格本身**默认也是按
|
|
690
720
|
min-content 撑的,不写它标题的省略号和摘要的两行截断就不生效(会把行撑宽)。 */
|
|
@@ -757,21 +787,25 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
757
787
|
.knit-resize::after{content:'';width:44px;height:3px;border-radius:2px;
|
|
758
788
|
background:var(--dsw-alias-border-l3,rgba(255,255,255,.2));transition:background .15s,width .15s}
|
|
759
789
|
.knit-resize:hover::after{background:var(--knit-accent);width:64px}
|
|
760
|
-
/* 头对齐官方文档预览面板(.dhJKeW_header):38px
|
|
761
|
-
里面放路径面包屑而不是标题 —— 正文 H1 已经写了标题,重复只添乱。
|
|
790
|
+
/* 头对齐官方文档预览面板(.dhJKeW_header):38px 高,
|
|
791
|
+
里面放路径面包屑而不是标题 —— 正文 H1 已经写了标题,重复只添乱。
|
|
792
|
+
⚠️ 2026-09-30 用户裁决:官方那条 border-l3 底边**不要** ——
|
|
793
|
+
「查看文档详情被引用,上下那两条横线,细细的横线,我觉得也不需要的」。
|
|
794
|
+
头部与引用条 / 正文之间现在只靠留白分层(配合 .knit-links 同时去掉的那条)。 */
|
|
762
795
|
.knit-preview-head{box-sizing:border-box;display:flex;align-items:center;gap:4px;
|
|
763
|
-
height:38px;padding:0 6px 0 12px;flex:none
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
796
|
+
height:38px;padding:0 6px 0 12px;flex:none}
|
|
797
|
+
/* 路径:**可点** —— 用系统默认应用打开这篇本地文档(阅读时多一个入口)。
|
|
798
|
+
目录一律不展开,只留一个「…/」占位(2026-10-01 用户要求:「前面那一串都用三个点点点表示」,
|
|
799
|
+
头部宽度让给文件名);文件名不收缩。**完整相对路径不丢** —— 在 .knit-preview-path 的悬停提示里。
|
|
800
|
+
⚠️ 本段在 CSS 那一个大模板串里:注释里**不能出现反引号**(写 .knit-preview-path 这种
|
|
801
|
+
带反引号的类名会把模板提前截断,客户端半边整个加载失败 —— 2026-10-01 又踩一次)。 */
|
|
767
802
|
.knit-preview-path{flex:1 1 auto;min-width:0;display:flex;align-items:center;
|
|
768
803
|
margin-right:6px;font-size:12px;white-space:nowrap;overflow:hidden;
|
|
769
804
|
background:transparent;border:none;padding:0;font-family:inherit;text-align:left;
|
|
770
805
|
color:inherit;cursor:pointer}
|
|
771
806
|
.knit-preview-path:disabled{cursor:default}
|
|
772
807
|
.knit-preview-path:hover:not(:disabled) .knit-preview-name{text-decoration:underline}
|
|
773
|
-
.knit-preview-dir{flex:0
|
|
774
|
-
color:var(--dsw-alias-label-tertiary,rgba(255,255,255,.4))}
|
|
808
|
+
.knit-preview-dir{flex:0 0 auto;color:var(--dsw-alias-label-tertiary,rgba(255,255,255,.4))}
|
|
775
809
|
.knit-preview-name{flex:0 0 auto;color:var(--dsw-alias-label-primary,#e8eaed)}
|
|
776
810
|
/* 正文区把滚动条提到 l2 —— 与官方文档预览面板同一档(那边的 .body 也覆盖这两个变量)。
|
|
777
811
|
不重写 ::-webkit-scrollbar,只覆盖变量,所以宽度/圆角/悬停都跟 DSH 完全一致。 */
|
|
@@ -789,9 +823,11 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
789
823
|
|
|
790
824
|
/* ── 引用条(v0.12)────────────────────────────────────
|
|
791
825
|
夹在预览头与正文之间的一层。全用中性令牌:它是「信息」,不是「操作」。
|
|
826
|
+
⚠️ 2026-09-30 用户裁决:它自己那条 border-l2 底边**删掉** —— 与预览头的底边
|
|
827
|
+
一上一下两条细线把这一小块夹成了独立一截,用户的原话是「有点割裂」。
|
|
828
|
+
现在这一层不画任何横线,收紧的 padding 就是它的边界。
|
|
792
829
|
注意 CSS 里不要写反引号 —— 这段样式是模板字符串,一个反引号就会把它截断。 */
|
|
793
|
-
.knit-links{flex:none;
|
|
794
|
-
font-size:11px;color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
830
|
+
.knit-links{flex:none;font-size:11px;color:var(--dsw-alias-label-secondary,#9aa0a6)}
|
|
795
831
|
.knit-links-state{padding:5px 12px;color:var(--dsw-alias-label-caption,#80868b)}
|
|
796
832
|
.knit-links-head{box-sizing:border-box;display:flex;align-items:center;gap:6px;width:100%;
|
|
797
833
|
padding:5px 12px;background:transparent;border:none;cursor:pointer;text-align:left;
|
|
@@ -815,14 +851,16 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
|
|
|
815
851
|
|
|
816
852
|
/* ── 类型切换(文档 / 图片与视频 / 全部)────────────── */
|
|
817
853
|
/* v0.14(Design §20):**不再是三个并排的灰底按钮**,改成下划线式页签 ——
|
|
818
|
-
|
|
854
|
+
选中的那个用「深色文字 + 2px 深色下划线」表达。
|
|
819
855
|
⚠️ 2026-09-29 用户裁决:这条**覆盖**了早先那条「选中填充背景灰就可以」。
|
|
820
856
|
当时用户的原话是「选中的时候不用加绿色、蓝色的描边,就跟下面列表一样」——
|
|
821
857
|
诉求是「别用品牌色描边」;现在连灰底也不要了,层级交给下划线,
|
|
822
858
|
依然不许出现 --knit-accent / --knit-accent-fill(Design §8:灰阶分层)。
|
|
859
|
+
⚠️ 2026-09-30 用户反馈:页签条底下原本还有一条全宽 hairline(border-l1)——
|
|
860
|
+
「最细最淡那条横线」与下面的列表割裂,**删掉**。层级现在只由选中项自己那条
|
|
861
|
+
2px 下划线表达,页签条本身不画线(也不是「下划线悬空」:它画在自己的文字下面)。
|
|
823
862
|
⚠️ 排序切换(.knit-seg-btn,Design §18)是**另一个控件**,它保持灰底不变。 */
|
|
824
|
-
.knit-types{display:flex;gap:14px;padding:0 12px;flex:none
|
|
825
|
-
border-bottom:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.06))}
|
|
863
|
+
.knit-types{display:flex;gap:14px;padding:0 12px;flex:none}
|
|
826
864
|
.knit-type-btn{flex:none;height:28px;padding:0;cursor:pointer;
|
|
827
865
|
border:none;border-bottom:2px solid transparent;background:transparent;
|
|
828
866
|
color:var(--dsw-alias-label-secondary,#9aa0a6);font-family:inherit;font-size:11.5px;
|
|
@@ -933,8 +971,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
933
971
|
.knit-peek-time{flex:none;font-size:10.5px;color:var(--dsw-alias-label-caption,#80868b)}
|
|
934
972
|
.knit-peek .knit-peek-hint{padding:7px;font-size:10.5px;
|
|
935
973
|
color:var(--dsw-alias-label-caption,#80868b)}
|
|
936
|
-
.knit-peek-list + .knit-peek-hint{margin-top:4px;padding-top:8px;
|
|
937
|
-
border-top:.5px solid var(--dsw-alias-border-l4,rgba(255,255,255,.08))}
|
|
938
974
|
|
|
939
975
|
.knit-entry{display:inline-flex;align-items:center;justify-content:center;flex:none;
|
|
940
976
|
width:28px;height:28px;padding:0;border:none;border-radius:8px;cursor:pointer;
|
|
@@ -947,7 +983,6 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
947
983
|
.knit-root.fullscreen .knit-head,
|
|
948
984
|
.knit-root.fullscreen .knit-bar,
|
|
949
985
|
.knit-root.fullscreen .knit-types,
|
|
950
|
-
.knit-root.fullscreen .knit-topic,
|
|
951
986
|
.knit-root.fullscreen .knit-list{display:none}
|
|
952
987
|
/* 全屏时预览铺满整个面板:圆角与向上柔影是「浮在列表上」的隐喻,这里没有列表,去掉 */
|
|
953
988
|
.knit-root.fullscreen .knit-preview{flex:1 1 auto;max-height:none;
|
|
@@ -1009,6 +1044,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1009
1044
|
return v === KIND_MEDIA || v === KIND_ALL ? v : KIND_DOC
|
|
1010
1045
|
}
|
|
1011
1046
|
|
|
1047
|
+
/**
|
|
1048
|
+
* 读上次是否打开了「使用情况」。**默认关**(没写过就是关)。
|
|
1049
|
+
* @returns {boolean} 是否记账
|
|
1050
|
+
*/
|
|
1051
|
+
function readUsagePref() {
|
|
1052
|
+
return readPref(USAGE_KEY) === '1'
|
|
1053
|
+
}
|
|
1054
|
+
|
|
1012
1055
|
/**
|
|
1013
1056
|
* 把预览高度比例夹到合法区间。
|
|
1014
1057
|
* @param {number} value - 原始比例
|
|
@@ -1304,7 +1347,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1304
1347
|
return `knit-opt-${safe}-${(hash >>> 0).toString(36)}`
|
|
1305
1348
|
}
|
|
1306
1349
|
|
|
1307
|
-
function DocRow({ doc, now, active, cursor, relevance, why, num, primary, onSelect, onOpenTab, optionId }) {
|
|
1350
|
+
function DocRow({ doc, now, active, cursor, relevance, why, num, mark, primary, onSelect, onOpenTab, optionId }) {
|
|
1308
1351
|
const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
|
|
1309
1352
|
|
|
1310
1353
|
return h('div', {
|
|
@@ -1323,9 +1366,12 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1323
1366
|
// 用户原话:「文档列表序号放在独立最左边,其他数据放在右边」。所以序号从行一里
|
|
1324
1367
|
// 搬了出来,成为 .knit-doc 这条两列 grid 的第一列,其余数据全在右边堆叠。
|
|
1325
1368
|
// v0.14(Design §11):只有 Context Pack 前三层的条目有号;「其他相关文档」里的
|
|
1326
|
-
// 没有 ——
|
|
1327
|
-
//
|
|
1328
|
-
|
|
1369
|
+
// 没有 —— 那些不属于这个包,编号会把它们谎报成包的一部分。
|
|
1370
|
+
// 2026-10-01:**不再「没有号就整个节点不渲染」**。这一屏里有号时(`mark`,由
|
|
1371
|
+
// `docsGrid` 下发),这一列放一个中性占位标记,否则空着的那一格会被读成漏了一个号。
|
|
1372
|
+
// 整屏没号(时间序 / 平铺列表)时 `mark` 为假 —— 一个标记都不渲染。
|
|
1373
|
+
num ? h('span', { className: 'knit-num' }, String(num).padStart(2, '0'))
|
|
1374
|
+
: (mark ? h('span', { className: 'knit-gapmark', 'aria-hidden': 'true' }, '·') : null),
|
|
1329
1375
|
// 右边这一列=其余全部数据。列位置由 .knit-body 的 grid-column 定死 ——
|
|
1330
1376
|
// 靠自动排布的话,没有序号时正文会掉进第一列。
|
|
1331
1377
|
h('div', { className: 'knit-body' },
|
|
@@ -1346,8 +1392,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1346
1392
|
: h('div', { className: 'knit-sum empty' }, t('summary.empty')),
|
|
1347
1393
|
// ⚠️ **列表行里不再有路径**(2026-09-29 用户要求):「文档列表中的文档路径,我觉得
|
|
1348
1394
|
// 不需要出现了,因为点开查看文档详情的时候已经有了,所以这里是重复的,隐藏掉」。
|
|
1349
|
-
// ——
|
|
1350
|
-
// (`.knit-preview-path
|
|
1395
|
+
// —— 这是**重复信息**,不是「多列砍字段」那种静默降级:预览头
|
|
1396
|
+
// (`.knit-preview-path`:目录收敛成 `…/` + 文件名亮,还可点)已经能定位到是哪一篇,
|
|
1397
|
+
// 完整相对路径在它的悬停提示里。
|
|
1351
1398
|
// 所以删掉的是 `.knit-meta` 这一个节点,**摘要仍然任何情况下都不许 display:none**。
|
|
1352
1399
|
// 行的定位不走可见路径:`data-knit-rel` 仍在(键盘 / 预览映射靠它)。
|
|
1353
1400
|
// v0.14:为什么这一篇在这个层里。只有 Context Pack 的条目才有 ——
|
|
@@ -1538,9 +1585,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1538
1585
|
},
|
|
1539
1586
|
fullscreen ? null : h('div', { className: 'knit-resize', onPointerDown: onResizeStart, title: t('preview.resizeTitle') }),
|
|
1540
1587
|
h('div', { className: 'knit-preview-head' },
|
|
1541
|
-
//
|
|
1588
|
+
// 路径,**可点**:用系统默认应用打开这篇本地文档 —— 阅读时多一个
|
|
1542
1589
|
// 「跳到本地」的入口。不放标题:正文 H1 已经写了,重复会让
|
|
1543
1590
|
// 「列表行 / 预览头 / 正文」出现三遍同一个词,反而分不清哪块是详情。
|
|
1591
|
+
// 目录收敛成 `…/`(2026-10-01 用户要求),完整相对路径在 title 里。
|
|
1544
1592
|
h('button', {
|
|
1545
1593
|
type: 'button',
|
|
1546
1594
|
className: 'knit-preview-path',
|
|
@@ -1549,7 +1597,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1549
1597
|
onClick: () => { if (onOpenLocal) onOpenLocal() },
|
|
1550
1598
|
},
|
|
1551
1599
|
previewPath.dir
|
|
1552
|
-
? h('span', { className: 'knit-preview-dir' },
|
|
1600
|
+
? h('span', { className: 'knit-preview-dir' }, '…/')
|
|
1553
1601
|
: null,
|
|
1554
1602
|
h('span', { className: 'knit-preview-name' }, previewPath.name)),
|
|
1555
1603
|
h('button', {
|
|
@@ -1557,9 +1605,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1557
1605
|
onClick: onToggleFullscreen,
|
|
1558
1606
|
title: fullscreen ? t('preview.exitFullscreenTitle') : t('preview.fullscreenTitle'),
|
|
1559
1607
|
}, fullscreen ? t('preview.exitFullscreen') : t('preview.fullscreen')),
|
|
1560
|
-
//
|
|
1608
|
+
// 「本地打开」= 之前那个「新标签页」的位置(v0.10)。
|
|
1561
1609
|
// 「新标签页」开的是官方文档预览,但面板里已经有就地预览,重复度高、用得少;
|
|
1562
|
-
//
|
|
1610
|
+
// 而「用默认应用打开这篇文档」原本只藏在路径的悬停提示里 ——
|
|
1563
1611
|
// 把值钱的那个放到显眼处,把鸡肋的那个让位(双击列表行仍能开新标签页)。
|
|
1564
1612
|
h('button', {
|
|
1565
1613
|
className: 'knit-btn',
|
|
@@ -1580,11 +1628,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1580
1628
|
/**
|
|
1581
1629
|
* 面板主体。两个宿主共用。
|
|
1582
1630
|
*
|
|
1583
|
-
* @param {{sessionId?:string, openInTab?:Function}} props - 渲染入参。
|
|
1631
|
+
* @param {{sessionId?:string, openInTab?:Function, visible?:boolean}} props - 渲染入参。
|
|
1584
1632
|
* `openInTab(doc)` 返回空串表示成功,返回文案表示失败原因。
|
|
1633
|
+
* `visible === false` 表示宿主那边这块面板**看不见**(官方右侧栏收起 / 不是当前标签)——
|
|
1634
|
+
* 那时一次都不取数、也不落状态(见下)。
|
|
1585
1635
|
* @returns {import('react').ReactElement} 元素
|
|
1586
1636
|
*/
|
|
1587
|
-
function KnitBody({ sessionId, openInTab }) {
|
|
1637
|
+
function KnitBody({ sessionId, openInTab, visible }) {
|
|
1588
1638
|
ensureStyle()
|
|
1589
1639
|
|
|
1590
1640
|
const [notice, setNotice] = React.useState('')
|
|
@@ -1592,10 +1642,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1592
1642
|
// 紧跟 sort:测试按 hook 顺序预置前两位(notice/sort),kind 放第三位不影响老用例。
|
|
1593
1643
|
const [kind, setKind] = React.useState(readKindPref)
|
|
1594
1644
|
const [state, setState] = React.useState({
|
|
1595
|
-
status: 'loading', docs: [], root: '', total: 0, error: '', mode: 'time',
|
|
1645
|
+
status: 'loading', docs: [], root: '', total: 0, error: '', mode: 'time',
|
|
1596
1646
|
// v0.14:当前任务上下文(Context Pack)。宿主只在「文档档 + 相关序 + 有命中」时给,
|
|
1597
1647
|
// 其余情形是 null —— 那时面板退回它一直在用的平铺列表(行为与 v0.13 逐字一致)。
|
|
1598
1648
|
context: null,
|
|
1649
|
+
// v0.15:这个会话的使用情况(只统计**事实**:读了几次、落在哪一层、上下文换过几次)。
|
|
1650
|
+
// 宿主只在用户显式打开「使用情况」之后才回传它。
|
|
1651
|
+
usage: null,
|
|
1599
1652
|
})
|
|
1600
1653
|
const [preview, setPreview] = React.useState(null)
|
|
1601
1654
|
const [tick, setTick] = React.useState(() => Date.now())
|
|
@@ -1617,6 +1670,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1617
1670
|
const [links, setLinks] = React.useState(null)
|
|
1618
1671
|
const [linksExpandedTick, setLinksExpandedTick] = React.useState(0)
|
|
1619
1672
|
|
|
1673
|
+
// v0.15「使用情况」的开闸状态(默认关,见 `USAGE_KEY`)。放在最后 —— 前几个 hook
|
|
1674
|
+
// 的顺序被测试按位预置,别插队。
|
|
1675
|
+
const [usageOn, setUsageOn] = React.useState(readUsagePref)
|
|
1676
|
+
|
|
1620
1677
|
/* ── 曾经在这里的三个状态 + 一个 ref:右栏的形态 ──────────
|
|
1621
1678
|
`packWidth`(310) / `packFloat`(null) / `packSnap`(false) / `packColRef`。
|
|
1622
1679
|
**2026-09-29 随右栏一起删除**。当时它们**只存在内存里**(刷新回默认值),
|
|
@@ -1636,15 +1693,25 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1636
1693
|
return () => observer.disconnect()
|
|
1637
1694
|
}, [])
|
|
1638
1695
|
|
|
1639
|
-
|
|
1696
|
+
/* 官方右侧栏收起之后,标签身体**仍然挂着**(dockkit 的 `keepMounted`),v0.16 之前
|
|
1697
|
+
这里照旧每 5 秒敲一次 `/knit/api/recent` 并 `setState`:白烧一次全工作区扫描,
|
|
1698
|
+
还往宿主正在收起的那层 DOM 里插一帧重渲染。现在取数先问一句「还看得见吗」,看不见
|
|
1699
|
+
**连请求都不发**;请求在途时被折叠的那一次,回来也不落状态(`alive` 由轮询的
|
|
1700
|
+
cleanup 翻假)。重新可见时那个 effect 会重跑 ⇒ 立刻补一次,不必等下一个 5 秒。 */
|
|
1701
|
+
const load = React.useCallback(async (alive) => {
|
|
1702
|
+
const live = () => typeof alive !== 'function' || alive()
|
|
1703
|
+
if (!live()) return
|
|
1640
1704
|
if (!sessionId) {
|
|
1641
|
-
setState({ status: 'error', docs: [], root: '', total: 0, error: t('error.noSession'), mode: 'time',
|
|
1705
|
+
setState({ status: 'error', docs: [], root: '', total: 0, error: t('error.noSession'), mode: 'time', context: null })
|
|
1642
1706
|
return
|
|
1643
1707
|
}
|
|
1644
1708
|
try {
|
|
1645
|
-
|
|
1709
|
+
// `usage=1` 是**开闸**(不是「顺便取一下」):宿主只有看到它才会开始给这个会话记账。
|
|
1710
|
+
// 没打开「使用情况」的会话,宿主侧一个事件都不读。
|
|
1711
|
+
const url = `${LIST_API}?sessionId=${encodeURIComponent(sessionId)}&limit=40&sort=${sort}&kind=${kind}${usageOn ? '&usage=1' : ''}`
|
|
1646
1712
|
const res = await fetch(url, { headers: { accept: 'application/json' }, cache: 'no-store' })
|
|
1647
1713
|
const data = await res.json()
|
|
1714
|
+
if (!live()) return
|
|
1648
1715
|
if (data && data.ok) {
|
|
1649
1716
|
setState({
|
|
1650
1717
|
status: 'ready',
|
|
@@ -1653,29 +1720,33 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1653
1720
|
total: data.total || 0,
|
|
1654
1721
|
error: '',
|
|
1655
1722
|
mode: data.mode || 'time',
|
|
1656
|
-
topic: data.topic || '',
|
|
1657
1723
|
context: data.context || null,
|
|
1724
|
+
usage: data.usage || null,
|
|
1658
1725
|
})
|
|
1659
1726
|
|
|
1660
1727
|
} else {
|
|
1661
|
-
setState({ status: 'error', docs: [], root: '', total: 0, error: hostMessage(data), mode: 'time',
|
|
1728
|
+
setState({ status: 'error', docs: [], root: '', total: 0, error: hostMessage(data), mode: 'time', context: null, usage: null })
|
|
1662
1729
|
}
|
|
1663
1730
|
} catch (error) {
|
|
1664
|
-
|
|
1731
|
+
if (!live()) return
|
|
1732
|
+
setState({ status: 'error', docs: [], root: '', total: 0, error: String((error && error.message) || error), mode: 'time', context: null, usage: null })
|
|
1665
1733
|
}
|
|
1666
1734
|
setTick(Date.now())
|
|
1667
|
-
}, [sessionId, sort, kind])
|
|
1735
|
+
}, [sessionId, sort, kind, usageOn])
|
|
1668
1736
|
|
|
1669
1737
|
React.useEffect(() => {
|
|
1738
|
+
// 看不见就一个定时器都不挂:`visible` 变回 true 时本 effect 重跑,立刻 load 一次。
|
|
1739
|
+
if (visible === false) return undefined
|
|
1670
1740
|
let alive = true
|
|
1671
1741
|
let timer = null
|
|
1742
|
+
const isAlive = () => alive
|
|
1672
1743
|
const run = async () => {
|
|
1673
|
-
await load()
|
|
1744
|
+
await load(isAlive)
|
|
1674
1745
|
if (alive) timer = setTimeout(run, POLL_MS)
|
|
1675
1746
|
}
|
|
1676
1747
|
run()
|
|
1677
1748
|
return () => { alive = false; if (timer) clearTimeout(timer) }
|
|
1678
|
-
}, [load])
|
|
1749
|
+
}, [load, visible])
|
|
1679
1750
|
|
|
1680
1751
|
/* ── 过滤:纯客户端,不重新请求宿主 ─────────────── */
|
|
1681
1752
|
const visibleDocs = React.useMemo(() => {
|
|
@@ -1719,10 +1790,16 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1719
1790
|
* 把「这一组的条目」映射成带序号 / Primary 标记的 `DocRow`。
|
|
1720
1791
|
*
|
|
1721
1792
|
* ⚠️ `num` 只有 Context Pack 前三层才有(见 `renderEntry` 的说明):
|
|
1722
|
-
*
|
|
1793
|
+
* 时间序、筛选结果、「其他相关文档」都不编号 —— 但**这一屏里有号时**,没号的行会在
|
|
1794
|
+
* 同一列拿到 `mark`(渲染 `.knit-gapmark` 占位),算法见下面。
|
|
1723
1795
|
*/
|
|
1724
|
-
const docsGrid = (docs, numbers, primary) =>
|
|
1725
|
-
|
|
1796
|
+
const docsGrid = (docs, numbers, primary) => {
|
|
1797
|
+
// 一屏里「要么都有号、要么都没有」(2026-10-01):只要这个视图里存在序号,
|
|
1798
|
+
// 没号的那些行(「其他相关文档」)就在同一列渲染占位标记;整屏没号时不渲染。
|
|
1799
|
+
const mark = Boolean(numbers && numbers.size > 0)
|
|
1800
|
+
return docs.map((doc) =>
|
|
1801
|
+
renderEntry(doc, numbers ? numbers.get(doc.rel) || 0 : 0, Boolean(primary), mark))
|
|
1802
|
+
}
|
|
1726
1803
|
|
|
1727
1804
|
const relevance = state.mode === 'relevance'
|
|
1728
1805
|
const filtering = query.trim().length > 0
|
|
@@ -1848,6 +1925,10 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
1848
1925
|
// 预览高度:拖完就记住
|
|
1849
1926
|
React.useEffect(() => { writePref(RATIO_KEY, String(ratio)) }, [ratio])
|
|
1850
1927
|
|
|
1928
|
+
// 「使用情况」开关:开了就记住(只记开关本身,**记账数据一律活在内核内存里**,
|
|
1929
|
+
// 面板不落盘 —— 与「界面几何状态不落盘」是同一条纪律)。
|
|
1930
|
+
React.useEffect(() => { writePref(USAGE_KEY, usageOn ? '1' : '0') }, [usageOn])
|
|
1931
|
+
|
|
1851
1932
|
/**
|
|
1852
1933
|
* 为一个条目造预览状态:图片/视频直接 ready(字节地址交给 <img>/<video>),
|
|
1853
1934
|
* Markdown 才进 loading 去拉正文。
|
|
@@ -2097,7 +2178,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2097
2178
|
|
|
2098
2179
|
|
|
2099
2180
|
/** 渲染一个条目:媒体一律出方形卡片(媒体视图与「全部」的媒体区共用),其余出文档行。 */
|
|
2100
|
-
const renderEntry = (doc, num, primary) => {
|
|
2181
|
+
const renderEntry = (doc, num, primary, mark) => {
|
|
2101
2182
|
const common = {
|
|
2102
2183
|
key: doc.path || doc.rel,
|
|
2103
2184
|
doc,
|
|
@@ -2112,7 +2193,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2112
2193
|
// `whyText` 只认 Context Pack 条目上挂的 `reason` —— 平铺列表里没有这个字段,
|
|
2113
2194
|
// 于是返回空串,那一行不渲染。
|
|
2114
2195
|
// `num` / `primary` 只有分层视图会传(Design §11 / §13);平铺列表照旧无序号。
|
|
2115
|
-
|
|
2196
|
+
// `mark`=没号时同列的占位标记,只在「这一屏里有号」时为真。
|
|
2197
|
+
return h(DocRow, { ...common, relevance, why: whyText(doc.reason), num, mark, primary })
|
|
2116
2198
|
}
|
|
2117
2199
|
|
|
2118
2200
|
/** 「全部」的分区标题:类型名 + 「已显示 / 总数」+ 被截断时的「查看全部」。 */
|
|
@@ -2162,16 +2244,37 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2162
2244
|
? contextBody(contextView)
|
|
2163
2245
|
: docsGrid(visibleDocs)
|
|
2164
2246
|
|
|
2165
|
-
//
|
|
2166
|
-
//
|
|
2167
|
-
//
|
|
2168
|
-
//
|
|
2169
|
-
|
|
2170
|
-
|
|
2171
|
-
|
|
2172
|
-
|
|
2173
|
-
|
|
2174
|
-
|
|
2247
|
+
// 排序说明那一行(.knit-topic)**2026-09-30 已整体删除**:排序方式由头部那个
|
|
2248
|
+
// 「相关 / 最新」切换按钮自己表达(按钮上就写着当前选的是哪个),再补一句
|
|
2249
|
+
// 「相关性排序」是重复。命中的关键词**跟着一起消失** —— 它当时只在这行的
|
|
2250
|
+
// title 里(可见文本本来就不许出现关键词,test/i18n.test.mjs 有守卫)。
|
|
2251
|
+
// ⚠️ i18n 里那四个 topic.* 键已同时删除,不要为了「以后可能用」留着。
|
|
2252
|
+
|
|
2253
|
+
/* v0.15「使用情况」:只把**事实**读出来 —— 先看的那篇读没读、辅助读了几篇、
|
|
2254
|
+
一共读了几次、几次落在包外、上下文换过几回。
|
|
2255
|
+
⚠️ 不许出现分数 / 百分比 / 评分条 / 置信度 / 「AI 判断」这类词:用户要知道的是
|
|
2256
|
+
「这份上下文有没有被用上」,不是「它好不好用」。**没有任何一行是估算出来的。** */
|
|
2257
|
+
const usageText = (() => {
|
|
2258
|
+
if (!usageOn) return ''
|
|
2259
|
+
const u = state.usage
|
|
2260
|
+
if (!u || !u.stats) return t('usage.none')
|
|
2261
|
+
const s = u.stats
|
|
2262
|
+
const parts = []
|
|
2263
|
+
// SDD §20:只多一句「当前上下文 · Epoch N」—— `epochId` 是**累计编号**(换一次 +1),
|
|
2264
|
+
// 不是「第几份包」;一份包都没交过时是 null,整句不显示。
|
|
2265
|
+
if (Number.isInteger(u.epochId)) parts.push(t('usage.epoch', { n: u.epochId }))
|
|
2266
|
+
if (s.primaryRel) {
|
|
2267
|
+
parts.push(s.primaryFollowThrough
|
|
2268
|
+
? t('usage.primaryRead', { rel: s.primaryRel })
|
|
2269
|
+
: t('usage.primaryUnread', { rel: s.primaryRel }))
|
|
2270
|
+
}
|
|
2271
|
+
const sup = (s.byTier && s.byTier.supporting) || { read: 0, total: 0 }
|
|
2272
|
+
if (sup.total > 0) parts.push(t('usage.supporting', { read: sup.read, total: sup.total }))
|
|
2273
|
+
if (s.reads) parts.push(t('usage.reads', { n: s.reads }))
|
|
2274
|
+
if (s.outside) parts.push(t('usage.outside', { n: s.outside }))
|
|
2275
|
+
if (s.churn && s.churn.snapshots) parts.push(t('usage.changes', { n: s.churn.snapshots }))
|
|
2276
|
+
return parts.join(' · ')
|
|
2277
|
+
})()
|
|
2175
2278
|
|
|
2176
2279
|
// 不同类型用不同量词:文档「篇」、媒体「个」、混排「项」。
|
|
2177
2280
|
const countKey = kind === KIND_MEDIA
|
|
@@ -2199,6 +2302,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2199
2302
|
},
|
|
2200
2303
|
}, state.root || '—'),
|
|
2201
2304
|
h('div', { className: 'knit-count' }, countText),
|
|
2305
|
+
// v0.15:默认关的自查开关。开着才有 `&usage=1` —— 宿主也只在那一刻开始记账。
|
|
2306
|
+
h('button', {
|
|
2307
|
+
type: 'button',
|
|
2308
|
+
className: `knit-btn${usageOn ? ' active' : ''}`,
|
|
2309
|
+
'aria-pressed': usageOn,
|
|
2310
|
+
title: t('usage.toggleTitle'),
|
|
2311
|
+
onClick: () => setUsageOn((value) => !value),
|
|
2312
|
+
}, t('usage.toggle')),
|
|
2202
2313
|
h('button', { className: 'knit-btn', onClick: load, title: t('action.refreshNow') }, t('action.refresh'))),
|
|
2203
2314
|
h('div', { className: 'knit-bar' },
|
|
2204
2315
|
h('div', { className: 'knit-seg' },
|
|
@@ -2233,7 +2344,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2233
2344
|
title: t('kind.title'),
|
|
2234
2345
|
onClick: () => pickKind(value),
|
|
2235
2346
|
}, t(labelKey)))),
|
|
2236
|
-
|
|
2347
|
+
// v0.15:开了才显示。一行事实,没有卡片、没有分数条。
|
|
2348
|
+
usageOn ? h('div', { className: 'knit-usage', title: t('usage.note') }, usageText || t('usage.none')) : null,
|
|
2237
2349
|
notice ? h('div', { className: 'knit-notice' }, notice) : null,
|
|
2238
2350
|
// 列表节点**直接挂上去**(2026-09-29 起永远单栏;曾经它要交给一个 IIFE
|
|
2239
2351
|
// 决定塞进单栏还是双栏的左列)。**输出与 v0.13 逐字一致** ——
|
|
@@ -2335,10 +2447,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2335
2447
|
* @returns {Function} 组件
|
|
2336
2448
|
*/
|
|
2337
2449
|
/**
|
|
2338
|
-
*
|
|
2450
|
+
* 旧内核的兜底读法:从 `sessions` 列表快照里读「当前会话」。
|
|
2339
2451
|
*
|
|
2340
|
-
*
|
|
2341
|
-
* sessions
|
|
2452
|
+
* ⚠️ **这不是主路径**。2026-09-30 实测当前内核的契约:
|
|
2453
|
+
* `ctx.sessions.list` 的快照是 `SessionListState`
|
|
2454
|
+
* `{ ids, byId, phase, projectionsBySession }` —— **没有 `current` 字段**
|
|
2455
|
+
* (契约注释写着「navigation belongs to view owners」,当前会话归视图所有)。
|
|
2456
|
+
* 所以这个函数在现代内核上恒返回空串;悬停浮层的主路径是座位 props 里的
|
|
2457
|
+
* `sessionId`(见 `makeEntryButton`)。保留它只是让更老的内核上不至于全空。
|
|
2342
2458
|
*
|
|
2343
2459
|
* @returns {string} 会话 id,取不到为空串
|
|
2344
2460
|
*/
|
|
@@ -2392,8 +2508,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2392
2508
|
h('div', { className: 'knit-peek-head' },
|
|
2393
2509
|
h(KnitGlyph, { size: 13 }),
|
|
2394
2510
|
h('span', null, t('count', { n: total }))),
|
|
2395
|
-
h('div', { className: 'knit-peek-list' }, body)
|
|
2396
|
-
h('div', { className: 'knit-peek-hint' }, t('peek.openPanel')))
|
|
2511
|
+
h('div', { className: 'knit-peek-list' }, body))
|
|
2397
2512
|
}
|
|
2398
2513
|
|
|
2399
2514
|
/**
|
|
@@ -2409,12 +2524,24 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2409
2524
|
* @returns {Function} 组件
|
|
2410
2525
|
*/
|
|
2411
2526
|
function makeEntryButton(onOpen) {
|
|
2412
|
-
return function KnitEntryButton() {
|
|
2527
|
+
return function KnitEntryButton(props) {
|
|
2413
2528
|
const [peek, setPeek] = React.useState(null)
|
|
2414
2529
|
const btnRef = React.useRef(null)
|
|
2415
2530
|
const showTimer = React.useRef(null)
|
|
2416
2531
|
const hideTimer = React.useRef(null)
|
|
2417
2532
|
|
|
2533
|
+
// 当前会话 id:这个座位是 **session 作用域**
|
|
2534
|
+
// (`conversation.session.header.utilities`),框架通过标准 props
|
|
2535
|
+
// 直接把当前会话 id 递进来(`SessionStandardProps.sessionId`,
|
|
2536
|
+
// 由 `dsh-client-ui-session` 声明、座位契约注释也写明
|
|
2537
|
+
// 「Header actions derive their state from standard Session props」)。
|
|
2538
|
+
// 这是唯一可靠的来源 —— 老写法读 `sessions` 列表快照的 `current`,
|
|
2539
|
+
// 而那个字段在现行契约里不存在(见 `currentSessionId` 的注释)。
|
|
2540
|
+
// 属性留在 ref 里给定时器回调用,每次渲染刷新。
|
|
2541
|
+
const seatSessionId = (props && props.sessionId) || ''
|
|
2542
|
+
const sidRef = React.useRef(seatSessionId)
|
|
2543
|
+
sidRef.current = seatSessionId || currentSessionId()
|
|
2544
|
+
|
|
2418
2545
|
/** 清掉两个定时器。 */
|
|
2419
2546
|
const clearTimers = () => {
|
|
2420
2547
|
if (showTimer.current) { clearTimeout(showTimer.current); showTimer.current = null }
|
|
@@ -2423,7 +2550,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2423
2550
|
|
|
2424
2551
|
/** 拉浮层要显示的那几篇。 */
|
|
2425
2552
|
const loadPeek = async () => {
|
|
2426
|
-
const sessionId =
|
|
2553
|
+
const sessionId = sidRef.current
|
|
2427
2554
|
if (!sessionId) {
|
|
2428
2555
|
setPeek((cur) => (cur ? { ...cur, status: 'ready', docs: [], total: 0 } : cur))
|
|
2429
2556
|
return
|
|
@@ -2515,6 +2642,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2515
2642
|
const tabInfo = typeof useTabInfo === 'function' ? useTabInfo() : null
|
|
2516
2643
|
const actions = tabInfo && tabInfo.tab ? tabInfo.tab.actions : null
|
|
2517
2644
|
|
|
2645
|
+
// 座位契约里的 `tab.visible`:右栏收起、或本标签不是当前那个时是 `false`
|
|
2646
|
+
// (`SidebarRightTabInfo.tab.visible`,「Docked bodies require expansion and selection」)。
|
|
2647
|
+
// **折叠期间 dockkit 不卸载 tag 身体**,所以要自己停下来 —— 见 KnitBody 轮询那段。
|
|
2648
|
+
const visible = !tabInfo || !tabInfo.tab || tabInfo.tab.visible !== false
|
|
2649
|
+
|
|
2518
2650
|
const openInTab = React.useCallback((doc) => {
|
|
2519
2651
|
if (!actions || typeof actions.openResource !== 'function') {
|
|
2520
2652
|
return t('error.noOpenResource')
|
|
@@ -2527,7 +2659,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2527
2659
|
}
|
|
2528
2660
|
}, [actions, sessionId])
|
|
2529
2661
|
|
|
2530
|
-
return h(KnitBody, { sessionId, openInTab })
|
|
2662
|
+
return h(KnitBody, { sessionId, openInTab, visible })
|
|
2531
2663
|
}
|
|
2532
2664
|
|
|
2533
2665
|
/**
|
|
@@ -2788,12 +2920,19 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
|
|
|
2788
2920
|
return
|
|
2789
2921
|
}
|
|
2790
2922
|
|
|
2923
|
+
// hidden: true 是给 better-sidebar v0.24.1+ 的「原生表面」用的:那一版起它把
|
|
2924
|
+
// 每个 descriptor 镜像成官方右侧栏的一个类型(id `dsh-better-sidebar:<id>`、
|
|
2925
|
+
// kind 取这里的 id),并在 descriptor 没写 hidden 时**连带注册一条 guide 条目**。
|
|
2926
|
+
// 于是「开始」页上出现两行一模一样的「Knit 最近文档」:① 的 kind 'knit' 与镜像的
|
|
2927
|
+
// kind 'knit:recent'。hidden 只掐掉镜像那条 guide 条目(+ 菜单项),类型、座位与
|
|
2928
|
+
// ctx.betterSidebar.openTab 都还在 —— 入口保留 ① 那条(不看宿主装没装都在)。
|
|
2791
2929
|
bsCtx.effect(() => bs.registerTab({
|
|
2792
2930
|
id: BS_TAB_ID,
|
|
2793
2931
|
title: () => t('guide.title'),
|
|
2794
2932
|
icon: KnitGlyph,
|
|
2795
2933
|
order: 30,
|
|
2796
2934
|
single: true, // 同类型只开一个
|
|
2935
|
+
hidden: true, // 别让镜像在官方 guide 里再挂一行(见上)
|
|
2797
2936
|
component: (props) => h(BetterSidebarTabBody, props),
|
|
2798
2937
|
}), 'dsh-knit: better-sidebar tab')
|
|
2799
2938
|
|