dsh-knit 0.18.0 → 0.19.1

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.
@@ -31,6 +31,8 @@ window.__ModuleLoader__.load({
31
31
 
32
32
  'count': '{n} 篇',
33
33
  'count.filtered': '{hit} / {total} 篇',
34
+ 'count.code': '{n} 个代码文件',
35
+ 'count.code.filtered': '{hit} / {total} 个代码文件',
34
36
  'count.media': '{n} 个媒体',
35
37
  'count.media.filtered': '{hit} / {total} 个媒体',
36
38
  'count.all': '{n} 项',
@@ -47,6 +49,10 @@ window.__ModuleLoader__.load({
47
49
 
48
50
  'kind.all': '全部',
49
51
  'kind.doc': '文档',
52
+ // v0.19:「代码」这一档。文案口径刻意保持朴素 —— 不写「代码知识库 / AI Code
53
+ // Intelligence / 智能代码分析」。Knit 只是把**当前任务真正需要的**代码文件
54
+ // 纳入同一份 Context Pack,它不是代码浏览器、不是 grep、不是 IDE(需求 §44)。
55
+ 'kind.code': '代码',
50
56
  // ⚠️ 2026-10-06 用户定:类型页签与「全部」分区标题都用**「媒体」**,不用「图片与视频」
51
57
  // (原话:「我想修改成 媒体 或者 多媒体,你觉得呢?」→ 随后确认「媒体」)。
52
58
  // 理由:① 这一档的计数本来就是「{n} 个媒体」(count.media),页签叫「图片与视频」
@@ -137,6 +143,12 @@ window.__ModuleLoader__.load({
137
143
  // 读起来像调试信息。现在它是**标签 + 值**,词之间用「 · 」分隔。
138
144
  'why.direct': '直接命中:{term}',
139
145
  'why.titleMatch': '标题命中:{term}',
146
+ // v0.19:代码占的是 `title` / `summary` 两个槽位(文件名、所在目录),
147
+ // 但**不能**对 `.ts` 文件说「标题命中」—— 判据一样,称谓必须分开。
148
+ // 这两个码由宿主直接给出(`context.js` 的 `explainContext()`),
149
+ // 客户端不做 kind → key 的重映射:宿主给什么码就翻什么码。
150
+ 'why.filenameMatch': '文件名命中:{term}',
151
+ 'why.pathMatch': '路径命中:{term}',
140
152
  'why.summaryMatch': '摘要命中:{term}',
141
153
  'why.bodyMatch': '正文命中:{term}',
142
154
  'why.bodyMatchPlain': '正文命中',
@@ -151,6 +163,7 @@ window.__ModuleLoader__.load({
151
163
  'list.failed': '读取失败:{error}',
152
164
  'list.failedHint': '确认插件宿主半边已加载。',
153
165
  'list.empty': '这个工作区里还没有 Markdown 文档。',
166
+ 'list.emptyCode': '这个工作区里还没有可纳入上下文的代码文件。',
154
167
  'list.emptyMedia': '这个工作区里还没有图片或视频。',
155
168
  'list.noMatch': '没有匹配「{query}」的文档。',
156
169
  // 文档列表这个 listbox 的无障碍名字(原先硬编码在 JSX 里,英文界面下会漏出中文)
@@ -177,9 +190,31 @@ window.__ModuleLoader__.load({
177
190
  'preview.exitFullscreen': '退出全屏',
178
191
  'preview.fullscreenTitle': '全屏阅读',
179
192
  'preview.exitFullscreenTitle': '退出全屏(Esc)',
193
+ // v0.19 追加:HTML 的「网页预览」入口。
194
+ // 就地预览给的是**源码**,这个按钮开的是**官方文档预览标签页** ——
195
+ // 那一侧有 DSH 自带的 HTML 渲染器(`extensions:['html','htm']`,默认走静态档:
196
+ // 清洗过的完整文档 + 不给任何 sandbox 权限的 iframe + 摆在 `<head>` 最前的 CSP,
197
+ // 挡脚本 / 外部资源 / 表单 / 嵌套框架,内联 `<style>` 与 `data:` 图片保留)。
198
+ // 两者**不重复**,所以它不是把 v0.10 撤掉的那个「新标签页」按钮原样搬回来。
199
+ 'preview.openWeb': '网页预览',
200
+ 'preview.openWebTitle': '{path}\n在官方文档预览里按网页渲染',
180
201
  'preview.openLocal': '{path}\n用系统默认应用打开这篇文档',
181
202
  'preview.openLocalBtn': '本地打开',
203
+ // 面包屑那条路径点开的是**文件管理器里这个文件所在的位置**(并把文件选中),
204
+ // 不是「打开文件」—— 那是页脚「本地打开」的事,所以文案也得说清。
205
+ 'preview.reveal': '{path}\n在文件管理器中显示并选中这个文件',
182
206
  'preview.close': '收起预览',
207
+ // v0.19:同名 source map 的入口。**它是低权重动作,不是文件列表条目** ——
208
+ // `.map` 不参与检索、不进上下文、不进代码列表(需求 §6 §28),
209
+ // 只有用户在这个 .js 的预览里主动点它才会打开,且以纯文本/JSON 呈现。
210
+ 'preview.sourceMap': 'Source map',
211
+ 'preview.sourceMapTitle': '查看同名 source map(不进入上下文检索)',
212
+ // v0.19:代码预览的两条边界提示。
213
+ // `codeTruncated` —— 渲染侧的行数上限(与宿主 512 KB 字节上限是两道不同的闸门)。
214
+ // `copyFailed` —— 剪贴板两条路都失败时才出现。**不能静默**:点了没反应,
215
+ // 用户会以为是按钮坏了,而不是「浏览器不给权限」。
216
+ 'preview.codeTruncated': '(文件较大,仅显示前 {n} 行)',
217
+ 'preview.copyFailed': '复制失败,请手动选择文本',
183
218
  'preview.resizeTitle': '拖动调整高度',
184
219
  // v0.12 引用条。⚠️ 不放任何表情符号(test/i18n.test.mjs 有守卫)。
185
220
  'links.summary': '被引用 {in} · 引用了 {out}',
@@ -204,7 +239,9 @@ window.__ModuleLoader__.load({
204
239
  'error.bsEditorDisabled': 'better-sidebar 的「编辑器」标签页被禁用了(设置 → 侧边卡片)',
205
240
 
206
241
  'host.outsideWorkspace': '路径越出工作区',
207
- 'host.markdownOnly': '只支持 Markdown',
242
+ // v0.19:从 `host.markdownOnly`(「只支持 Markdown」)改名。能力已经不止
243
+ // Markdown 了,文案必须跟着说清**真正的**边界:这个类型不支持在面板里预览。
244
+ 'host.notPreviewable': '这个类型不支持在面板里预览',
208
245
  'host.notFound': '文件不存在',
209
246
  'host.notAFile': '不是普通文件',
210
247
  'host.imageOnly': '只允许图片类型',
@@ -225,6 +262,8 @@ window.__ModuleLoader__.load({
225
262
 
226
263
  'count': '{n} docs',
227
264
  'count.filtered': '{hit} / {total} docs',
265
+ 'count.code': '{n} code files',
266
+ 'count.code.filtered': '{hit} / {total} code files',
228
267
  'count.media': '{n} media',
229
268
  'count.media.filtered': '{hit} / {total} media',
230
269
  'count.all': '{n} items',
@@ -241,6 +280,7 @@ window.__ModuleLoader__.load({
241
280
 
242
281
  'kind.all': 'All',
243
282
  'kind.doc': 'Docs',
283
+ 'kind.code': 'Code',
244
284
  // 2026-10-06: user picked 「媒体」 for the tab + the "All" section title, so English
245
285
  // follows the same word as count.media ("{n} media"): the tab says Media, and the
246
286
  // explicit "images and videos" wording stays in the empty state / README prose.
@@ -320,6 +360,8 @@ window.__ModuleLoader__.load({
320
360
  // ⚠️ Flattened on 2026-09-29: "direct topic match: …" read like debug output.
321
361
  'why.direct': 'direct match: {term}',
322
362
  'why.titleMatch': 'title match: {term}',
363
+ 'why.filenameMatch': 'filename match: {term}',
364
+ 'why.pathMatch': 'path match: {term}',
323
365
  'why.summaryMatch': 'summary match: {term}',
324
366
  'why.bodyMatch': 'body match: {term}',
325
367
  'why.bodyMatchPlain': 'body match',
@@ -334,6 +376,7 @@ window.__ModuleLoader__.load({
334
376
  'list.failed': 'Failed to read: {error}',
335
377
  'list.failedHint': 'Make sure the plugin’s host half is loaded.',
336
378
  'list.empty': 'No Markdown documents in this workspace yet.',
379
+ 'list.emptyCode': 'No code files eligible for context in this workspace yet.',
337
380
  'list.emptyMedia': 'No images or videos in this workspace yet.',
338
381
  'list.noMatch': 'No documents match “{query}”.',
339
382
  // Accessible name of the document listbox (was hardcoded in JSX before)
@@ -361,9 +404,16 @@ window.__ModuleLoader__.load({
361
404
  'preview.exitFullscreen': 'Exit fullscreen',
362
405
  'preview.fullscreenTitle': 'Read fullscreen',
363
406
  'preview.exitFullscreenTitle': 'Exit fullscreen (Esc)',
407
+ 'preview.openWeb': 'Web preview',
408
+ 'preview.openWebTitle': '{path}\nRender as a web page in the official document preview',
364
409
  'preview.openLocal': '{path}\nOpen this document in your default app',
365
410
  'preview.openLocalBtn': 'Open locally',
411
+ 'preview.reveal': '{path}\nShow this file in your file manager (and select it)',
366
412
  'preview.close': 'Close preview',
413
+ 'preview.sourceMap': 'Source map',
414
+ 'preview.sourceMapTitle': 'View the sibling source map (not part of context retrieval)',
415
+ 'preview.codeTruncated': '(large file — showing the first {n} lines)',
416
+ 'preview.copyFailed': 'Copy failed — select the text manually',
367
417
  'preview.resizeTitle': 'Drag to resize',
368
418
  'links.summary': 'Referenced by {in} · links to {out}',
369
419
  'links.incoming': 'Referenced by',
@@ -387,7 +437,7 @@ window.__ModuleLoader__.load({
387
437
  'error.bsEditorDisabled': 'better-sidebar’s Editor tab is disabled (Settings → Side card)',
388
438
 
389
439
  'host.outsideWorkspace': 'Path escapes the workspace',
390
- 'host.markdownOnly': 'Markdown only',
440
+ 'host.notPreviewable': 'This type cannot be previewed here',
391
441
  'host.notFound': 'File not found',
392
442
  'host.notAFile': 'Not a regular file',
393
443
  'host.imageOnly': 'Images only',
@@ -426,7 +476,7 @@ window.__ModuleLoader__.load({
426
476
  */
427
477
  const HOST_ERROR_KEY = {
428
478
  'knit/outside-workspace': 'host.outsideWorkspace',
429
- 'knit/markdown-only': 'host.markdownOnly',
479
+ 'knit/not-previewable': 'host.notPreviewable',
430
480
  'knit/not-found': 'host.notFound',
431
481
  'knit/not-a-file': 'host.notAFile',
432
482
  'knit/image-only': 'host.imageOnly',
@@ -507,11 +557,37 @@ window.__ModuleLoader__.load({
507
557
  */
508
558
  const USAGE_KEY = 'dsh-knit:usage'
509
559
 
510
- /** 列表类型:仅文档 / 仅图片视频 / 全部混排。默认 doc,与旧版体验一致。 */
560
+ /** 列表类型:仅文档 / 仅代码 / 仅图片视频 / 全部混排。默认 doc,与旧版体验一致。 */
511
561
  const KIND_DOC = 'doc'
562
+ /**
563
+ * v0.19:代码档。**它是同一份 Context Retrieval 结果的另一个切片,不是代码工具页。**
564
+ * 这一档里显示的仍然是「按当前任务排出来的代码候选」,不是仓库的代码文件树
565
+ * (需求 §24:任务「修改 Skill loader 使它支持新的 frontmatter」时,
566
+ * 应该看到 skill-loader.ts / frontmatter.ts,而不是 src/ 下的全部 .ts)。
567
+ */
568
+ const KIND_CODE = 'code'
512
569
  const KIND_MEDIA = 'media'
513
570
  const KIND_ALL = 'all'
514
571
 
572
+ /**
573
+ * v0.19:分类层给的「生成产物」档(`.map` / `*.min.js` / `package-lock.json` …)。
574
+ *
575
+ * **它不出现在任何列表里**(`contextual:false`、`searchable:false`,宿主根本不会
576
+ * 把它放进候选),但它**可以预览** —— 用户主动点「Source map」时才走到这里。
577
+ * 「能不能进上下文」与「能不能看」是两件事(需求 §29:Context eligibility ≠
578
+ * File system visibility)。
579
+ */
580
+ const KIND_GENERATED = 'generated'
581
+
582
+ /* ── 产物 kind(宿主 `classification.js` 的取值)─────────────────────
583
+ ⚠️ **不要把它和上面的页签常量 `KIND_DOC` 混起来**:`KIND_DOC` 是**页签值**
584
+ (`'doc'`,只活在 URL 参数与 localStorage 里),而宿主下发的 `doc.kind` 是
585
+ **分类层的产物类型**(Markdown 是 `'md'`)。两者字面量不同、语义也不同,
586
+ 写成 `doc.kind === KIND_DOC` 会恒为假 —— 那正是「代码区永远空白」这类
587
+ 看起来像没数据、其实是比较写错的问题。 */
588
+ const ARTIFACT_DOC = 'md'
589
+ const ARTIFACT_CODE = 'code'
590
+
515
591
  /** 预览面板高度的上下限:任何一端都不把对方挤没。 */
516
592
  const MIN_RATIO = 0.2
517
593
  const MAX_RATIO = 0.8
@@ -529,6 +605,8 @@ window.__ModuleLoader__.load({
529
605
 
530
606
  /** 「全部」视图里文档区的固定上限。 */
531
607
  const ALL_DOC_CAP = 4
608
+ /** 「全部」视图里代码区的固定上限(与文档区同量级 —— 代码不该在这一档里压过文档)。 */
609
+ const ALL_CODE_CAP = 4
532
610
  /**
533
611
  * 一屏基准:两行 × 4 列的观感(只在「媒体」这一档决定一屏铺几行时用)。
534
612
  * **它不决定列数** —— 列数交给 CSS 的 `auto-fill`,见 mediaLayoutFor。
@@ -671,6 +749,13 @@ body[data-ds-dark-theme] .knit-root{
671
749
  color:var(--dsw-alias-label-primary,#e8eaed)}
672
750
  .knit-btn.active{background:var(--knit-active-bg,rgba(255,255,255,.085));
673
751
  color:var(--dsw-alias-label-primary,#e8eaed);border-color:var(--dsw-alias-border-l4,rgba(255,255,255,.22))}
752
+ /* v0.19「低权重动作」:Source map。
753
+ 它**不是**主要操作 —— .map 不参与检索,只是一个「顺手看一眼」的旁路。
754
+ 所以去掉边框、压到 caption 色,让「复制 / 全屏 / 本地打开」保持主次分明。
755
+ ⚠️ 不要在这里加 accent 色(类型页签那条守卫也是这个道理)。
756
+ ⚠️ 这段注释在模板串里:**任何反引号都会截断样式表**(AGENTS.md 的老坑)。 */
757
+ .knit-btn-quiet{border-color:transparent;color:var(--dsw-alias-label-caption,#80868b);font-size:11px;padding:0 8px}
758
+ .knit-btn-quiet:hover{color:var(--dsw-alias-label-secondary,#9aa0a6)}
674
759
  /* 排序切换与搜索框:v0.18 UI 迭代(md §四~§六)把这两个控件**按输入控件的尺度重做** ——
675
760
  圆角 10px / 字号 13px。原来那套 22px 迷你胶囊读起来像「标签」而不是控件,
676
761
  与 14px 的页签、15px 的 Usage 标题差了两档,是「审美欠缺」最直观的一处。
@@ -1087,6 +1172,27 @@ body[data-ds-dark-theme] .knit-preview{box-shadow:0 -8px 24px rgba(0,0,0,.38)}
1087
1172
  color:var(--dsw-alias-label-secondary,#9aa0a6);font-family:ui-monospace,SFMono-Regular,Menlo,monospace}
1088
1173
  .knit-preview-note{font-size:11px;color:var(--dsw-alias-label-caption,#80868b);padding:2px 0 8px}
1089
1174
 
1175
+ /* v0.19:代码行的语言徽章(TS / JS / PY …)。
1176
+ 刻意**不是**一个胶囊:没有底色、没有边框、没有圆角 —— 它是一条弱注释,
1177
+ 不是标签墙。字号比标题小两档,颜色用 caption,永远不抢标题。
1178
+ 窄侧边栏里它 flex:none,压缩的是标题(.knit-title 会省略号收尾)而不是它。 */
1179
+ .knit-lang{flex:none;margin-left:6px;font-size:10px;letter-spacing:.04em;
1180
+ text-transform:uppercase;color:var(--dsw-alias-label-caption,#80868b)}
1181
+
1182
+ /* ── 代码预览(v0.19)────────────────────────────────────
1183
+ 轻量:行号栏 + 代码正文。**不做语法高亮、不做折叠、不做 minimap**,
1184
+ 也没引入 Monaco / CodeMirror —— Knit 不是编辑器(需求 §8 §25)。
1185
+ 横向滚动只发生在正文那一格(overflow-x:auto + min-width:0),
1186
+ 行号栏 flex:none 留在左边;纵向滚动仍由外面的 .knit-preview-body 负责,
1187
+ 所以这里**不开第二个纵向滚动容器**(两个纵向滚动条会互相打架)。 */
1188
+ .knit-codepane{display:flex;align-items:stretch;min-height:100%;
1189
+ font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11.5px;line-height:1.6}
1190
+ .knit-code-gutter{flex:none;white-space:pre;text-align:right;user-select:none;
1191
+ padding:0 8px 0 2px;color:var(--dsw-alias-label-caption,#80868b);
1192
+ border-right:1px solid var(--dsw-alias-border-l3,rgba(255,255,255,.08))}
1193
+ .knit-code-src{flex:1 1 auto;min-width:0;margin:0;padding:0 0 0 10px;
1194
+ white-space:pre;overflow-x:auto;color:var(--dsw-alias-label-primary,#e8eaed)}
1195
+
1090
1196
  /* ── 引用条(v0.12)────────────────────────────────────
1091
1197
  夹在预览头与正文之间的一层。全用中性令牌:它是「信息」,不是「操作」。
1092
1198
  ⚠️ 2026-09-30 用户裁决:它自己那条 border-l2 底边**删掉** —— 与预览头的底边
@@ -1250,6 +1356,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1250
1356
  .knit-root.fullscreen .knit-bar,
1251
1357
  .knit-root.fullscreen .knit-types,
1252
1358
  .knit-root.fullscreen .knit-list{display:none}
1359
+ /* v0.19 修补(2026-10-07 用户反馈):**使用情况也是列表上方的观察层**,全屏时同样让位。
1360
+ 这条规则漏了它 ⇒ 开着「使用情况」再点全屏,Lens 仍占掉面板上方约三分之一,
1361
+ 预览被挤在下面 —— 看起来就像「全屏没生效」。它是 flex:none 的自然高度,
1362
+ 不是浮层,所以必须显式 display:none,光靠预览 flex:1 抢不回来。 */
1363
+ .knit-root.fullscreen .knit-usage{display:none}
1253
1364
  /* 全屏时预览铺满整个面板:圆角与向上柔影是「浮在列表上」的隐喻,这里没有列表,去掉 */
1254
1365
  .knit-root.fullscreen .knit-preview{flex:1 1 auto;max-height:none;
1255
1366
  border-top:none;border-radius:0;box-shadow:none}
@@ -1307,7 +1418,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1307
1418
  */
1308
1419
  function readKindPref() {
1309
1420
  const v = readPref(KIND_KEY)
1310
- return v === KIND_MEDIA || v === KIND_ALL ? v : KIND_DOC
1421
+ return v === KIND_MEDIA || v === KIND_ALL || v === KIND_CODE ? v : KIND_DOC
1311
1422
  }
1312
1423
 
1313
1424
  /**
@@ -1738,6 +1849,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1738
1849
  /** 幽灵行所在的「区」:分层视图用层名,平铺与「全部」各一个 —— 幽灵要插回原位。 */
1739
1850
  const MOTION_TIER_FLAT = 'flat'
1740
1851
  const MOTION_TIER_ALL_DOCS = 'all-docs'
1852
+ /** v0.19:「全部」档里的代码区自己的区名 —— 幽灵行要插回**它原来那一区**,共用会插错位置。 */
1853
+ const MOTION_TIER_ALL_CODE = 'all-code'
1741
1854
  /** 幸存行位移(换层 / 重排)的 FLIP 时长:比进入略长,它要真的「走」完一段距离。 */
1742
1855
  const MOTION_MOVE_MS = 340
1743
1856
  /** 位移小于这个像素数(含亚像素抖动)就当没动过,不排补间。 */
@@ -1928,6 +2041,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
1928
2041
  glyph, onGlyph, onSelect, onOpenTab, optionId, entering, leaving }) {
1929
2042
  const fresh = now - doc.mtimeMs < NEW_WINDOW_MS
1930
2043
  const rowRef = React.useRef(null)
2044
+ /* v0.19:只有**代码行**带语言徽章。
2045
+ 文档列表整列都是 Markdown,给每一行都挂一个「MD」是纯噪声 —— 信息量为零,
2046
+ 还多占横向空间(§47 要求窄侧边栏不许溢出)。代码行混在文档里时才需要
2047
+ 「这是 TS 还是 PY」这一眼。 */
2048
+ const lang = doc.kind === ARTIFACT_CODE ? langBadge(doc.name || doc.rel) : ''
1931
2049
 
1932
2050
  /* 进 / 出两段补间都跑在 **layout effect** 里:放到 paint 之后会先闪一帧完整高度的
1933
2051
  行,那正是用户抱怨的那一下。没有 DOM 时 `motionAllowed()` 直接挡掉。 */
@@ -2034,7 +2152,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2034
2152
  }, glyph.status === 'reread_after_update' ? glyph.char : null)) : null,
2035
2153
  h('div', { className: 'knit-title' },
2036
2154
  fresh ? h('span', { className: 'knit-badge' }, '🆕') : null,
2037
- doc.title || doc.name),
2155
+ doc.title || doc.name,
2156
+ lang ? h('span', { className: 'knit-lang' }, lang) : null),
2038
2157
  // v0.17:生命周期状态(文案已算好;没有证据时是 null,一个节点都不加)。
2039
2158
  // 插在**标题与时间之间**:`.knit-title` 是 flex:1 1 auto,会把状态与时间一起推到
2040
2159
  // 行尾,状态在时间左侧、行尾仍然是时间。
@@ -2134,13 +2253,149 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2134
2253
 
2135
2254
  /**
2136
2255
  * 列表下方的预览面板。
2137
- * @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenLocal:Function|null,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
2256
+ * @param {{preview:object,pathImages:object|null,fullscreen:boolean,onClose:Function,onOpenLocal:Function|null,onReveal:Function|null,onToggleFullscreen:Function,onResizeStart:Function}} props - 渲染入参
2138
2257
  * @returns {import('react').ReactElement} 元素
2139
2258
  */
2140
- function PreviewPanel({ preview, pathImages, fullscreen, ratio, links, linksExpanded, onToggleLinks, onOpenLink, onClose, onOpenLocal, onToggleFullscreen, onResizeStart }) {
2259
+ /**
2260
+ * 复制一段文本。
2261
+ *
2262
+ * 优先 `navigator.clipboard`(异步;非 secure context 里可能根本没有);
2263
+ * 拿不到就退回 `document.execCommand('copy')` + 一个离屏 textarea。
2264
+ * 两条路都失败返回 `false` —— **由调用方决定怎么告诉用户**(静默失败比报错更糟)。
2265
+ *
2266
+ * @param {string} text - 要复制的文本
2267
+ * @returns {Promise<boolean>} 是否成功
2268
+ */
2269
+ function copyText(text) {
2270
+ const value = String(text == null ? '' : text)
2271
+ const legacy = () => {
2272
+ try {
2273
+ const area = document.createElement('textarea')
2274
+ area.value = value
2275
+ area.setAttribute('readonly', 'readonly')
2276
+ area.style.position = 'fixed'
2277
+ area.style.top = '-1000px'
2278
+ document.body.appendChild(area)
2279
+ area.select()
2280
+ const ok = document.execCommand('copy')
2281
+ document.body.removeChild(area)
2282
+ return ok
2283
+ } catch (error) {
2284
+ return false
2285
+ }
2286
+ }
2287
+ if (navigator.clipboard && navigator.clipboard.writeText) {
2288
+ return navigator.clipboard.writeText(value).then(() => true, legacy)
2289
+ }
2290
+ return Promise.resolve(legacy())
2291
+ }
2292
+
2293
+ /**
2294
+ * 语言徽章:文件后缀 → 短标签(TS / JS / PY / JSON / MD …)。
2295
+ *
2296
+ * **纯展示,不是判据。** 「这是什么类型、能不能进上下文、能不能预览」的权威
2297
+ * 一律是宿主的分类层(`src/host/classification.js`);这里只是把后缀压成一个
2298
+ * 窄标签给列表行和预览头用。认不出的后缀返回空串 —— **不猜**,宁可不显示。
2299
+ *
2300
+ * ⚠️ 这份表**不决定**任何文件是否被接纳:加一个后缀进这张表不会让 `.go` 变成
2301
+ * 上下文候选(宿主那边它是 `ignored`)。反过来也一样。
2302
+ */
2303
+ const LANG_BADGE = {
2304
+ js: 'JS', mjs: 'JS', cjs: 'JS', ts: 'TS', tsx: 'TSX', jsx: 'JSX', py: 'PY',
2305
+ json: 'JSON', html: 'HTML', htm: 'HTML', css: 'CSS', scss: 'SCSS',
2306
+ yaml: 'YAML', yml: 'YAML', sh: 'SH', bash: 'SH', zsh: 'SH',
2307
+ md: 'MD', map: 'MAP',
2308
+ }
2309
+
2310
+ /**
2311
+ * @param {string} name - 文件名(带后缀)
2312
+ * @returns {string} 徽章文本,认不出时为空串
2313
+ */
2314
+ function langBadge(name) {
2315
+ const m = /\.([a-z0-9]+)$/i.exec(String(name || ''))
2316
+ return m ? (LANG_BADGE[m[1].toLowerCase()] || '') : ''
2317
+ }
2318
+
2319
+ /**
2320
+ * 代码预览里最多渲染多少行。
2321
+ *
2322
+ * 一次最多这么多行号 —— 长文件不会把 DOM 撑爆(`readDocument` 那边已经按
2323
+ * `DOC_MAX_BYTES` 截过字节,这里是第二道、面向渲染的边界)。
2324
+ * 超出的部分明说「只显示前 N 行」,不静默砍掉。
2325
+ */
2326
+ const CODE_LINES_MAX = 4000
2327
+
2328
+ /**
2329
+ * 轻量代码预览:行号栏 + 代码正文。
2330
+ *
2331
+ * 刻意的取舍(需求 §8 §25 §26):
2332
+ * - **不做语法高亮、不做折叠、不做 minimap、不做 AST / symbol outline**,
2333
+ * 不引入 Monaco / CodeMirror。Knit 不是编辑器。
2334
+ * - 行号与正文**各是一个文本节点**(靠 `white-space: pre` 换行),不是每行一个
2335
+ * 元素 —— 4000 行代码因此只有两个节点,横向滚动交给 CSS 的 `overflow-x:auto`。
2336
+ * - 字体、配色全部走既有 `--knit-*` / `--dsw-alias-*` 变量,随 light/dark 主题走。
2337
+ *
2338
+ * @param {{text: string}} props - `preview.text` 原文
2339
+ * @returns {import('react').ReactElement} 元素
2340
+ */
2341
+ function CodePane({ text }) {
2342
+ const lines = String(text == null ? '' : text).split('\n')
2343
+ // 末尾换行会切出一个空尾行 —— 显示它会让行数比编辑器里多一行。
2344
+ if (lines.length > 1 && lines[lines.length - 1] === '') lines.pop()
2345
+ const clipped = lines.length > CODE_LINES_MAX
2346
+ const shown = clipped ? lines.slice(0, CODE_LINES_MAX) : lines
2347
+ let gutter = ''
2348
+ for (let i = 1; i <= shown.length; i += 1) gutter += (i === 1 ? '' : '\n') + i
2349
+ return h('div', { className: 'knit-codepane' },
2350
+ h('div', { className: 'knit-code-gutter', 'aria-hidden': 'true' }, gutter),
2351
+ h('pre', { className: 'knit-code-src' }, shown.join('\n')),
2352
+ clipped
2353
+ ? h('div', { className: 'knit-preview-note' },
2354
+ t('preview.codeTruncated', { n: CODE_LINES_MAX }))
2355
+ : null)
2356
+ }
2357
+
2358
+ function PreviewPanel({ preview, pathImages, fullscreen, ratio, links, linksExpanded, onToggleLinks, onOpenLink, onClose, onOpenLocal, onReveal, onOpenMap, onOpenWeb, onToggleFullscreen, onResizeStart }) {
2141
2359
  const isMedia = preview.kind === 'image' || preview.kind === 'video'
2142
2360
  const previewPath = splitRelPath(preview.rel)
2143
2361
 
2362
+ /* ── v0.19:复制整篇 + Source map ──────────────────────
2363
+ * 「复制」只给代码 —— Markdown 那边 MarkdownText 自带每个代码块的复制按钮,
2364
+ * 再给一个「复制整篇」会和它挤在一起,而且很少用。
2365
+ * `copied` 只活在这个组件里(1.6s 后自己复位),不落盘、不进任何 store。 */
2366
+ const isCodeView = preview.kind === ARTIFACT_CODE || preview.kind === KIND_GENERATED
2367
+ /* v0.19 追加:**网页预览**只给 HTML。
2368
+ 判据优先用宿主给的 `language` —— 那是分类层(`src/host/classification.js`)
2369
+ 的结论,v0.19 起客户端不再自己看扩展名。正文还没到手时 `language` 是空的,
2370
+ 退回列表徽章那张表(`LANG_BADGE`)兜一下:它**只决定这个按钮出不出场**,
2371
+ 不改变任何文件的接纳结论 —— 该表自己的注释也是这么写的。 */
2372
+ const isWebPage = isCodeView && (preview.language === 'html'
2373
+ || (!preview.language && langBadge(preview.title || preview.rel) === 'HTML'))
2374
+ const [copied, setCopied] = React.useState(false)
2375
+ const [copyFailed, setCopyFailed] = React.useState(false)
2376
+ // 两个提示都自己复位(1.6s / 2.4s)—— 它们只活在组件里,不落盘、不进 store。
2377
+ React.useEffect(() => {
2378
+ if (!copied) return undefined
2379
+ const id = setTimeout(() => setCopied(false), 1600)
2380
+ return () => clearTimeout(id)
2381
+ }, [copied])
2382
+ React.useEffect(() => {
2383
+ if (!copyFailed) return undefined
2384
+ const id = setTimeout(() => setCopyFailed(false), 2400)
2385
+ return () => clearTimeout(id)
2386
+ }, [copyFailed])
2387
+ // 换一篇就复位 —— 否则「已复制」会跟着下一篇继续亮着,说的是上一篇的事。
2388
+ React.useEffect(() => {
2389
+ setCopied(false)
2390
+ setCopyFailed(false)
2391
+ }, [preview.rel])
2392
+ const onCopySource = React.useCallback(() => {
2393
+ copyText(preview.text).then((ok) => {
2394
+ if (ok) setCopied(true)
2395
+ else setCopyFailed(true)
2396
+ })
2397
+ }, [preview.text])
2398
+
2144
2399
  /* ── v0.12 引用条 ────────────────────────────────────
2145
2400
  * 位置:预览头**下面**、正文**上面** —— 一条可折叠的窄条。
2146
2401
  *
@@ -2208,6 +2463,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2208
2463
  })()
2209
2464
 
2210
2465
  // 图片/视频不读正文,直接用同源字节地址渲染;Markdown 才走加载 / MarkdownText / 降级。
2466
+ // v0.19:代码(含 `.map` 这类生成产物)走轻量 CodePane —— **绝不能落到
2467
+ // MarkdownText 那支**,否则 `#` 开头的注释会变成标题、`*` 会变成列表。
2468
+ const isCode = preview.kind === ARTIFACT_CODE || preview.kind === KIND_GENERATED
2211
2469
  const body = preview.status === 'loading'
2212
2470
  ? h('div', { className: 'knit-preview-note' }, t('preview.loading'))
2213
2471
  : preview.status === 'error'
@@ -2224,7 +2482,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2224
2482
  playsInline: true,
2225
2483
  'aria-label': t('media.play'),
2226
2484
  })
2227
- : MarkdownText
2485
+ : isCode
2486
+ ? h(CodePane, { text: preview.text })
2487
+ : MarkdownText
2228
2488
  ? h(MarkdownText, {
2229
2489
  text: preview.text,
2230
2490
  labels: { code: { copyLabel: t('code.copy'), copiedLabel: t('code.copied') }, footnotes: '' },
@@ -2250,30 +2510,68 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2250
2510
  },
2251
2511
  fullscreen ? null : h('div', { className: 'knit-resize', onPointerDown: onResizeStart, title: t('preview.resizeTitle') }),
2252
2512
  h('div', { className: 'knit-preview-head' },
2253
- // 路径,**可点**:用系统默认应用打开这篇本地文档 —— 阅读时多一个
2254
- // 「跳到本地」的入口。不放标题:正文 H1 已经写了,重复会让
2255
- // 「列表行 / 预览头 / 正文」出现三遍同一个词,反而分不清哪块是详情。
2513
+ // 路径,**可点**:在文件管理器里打开它所在的文件夹**并选中这个文件**
2514
+ // (`action: 'reveal'` → macOS `open -R` / Windows `explorer /select,`)。
2515
+ // 与面板顶部那行工作区路径是同一套 remote(`openWorkspacePath`),
2516
+ // 差别只在多带一个 `action` —— 那行是「打开目录」,这条是「定位到文件」。
2517
+ // **打开文件本身**是页脚那个「本地打开」按钮的事,两者刻意分开。
2518
+ // 不放标题:正文 H1 已经写了,重复会让「列表行 / 预览头 / 正文」出现三遍
2519
+ // 同一个词,反而分不清哪块是详情。
2256
2520
  // 目录收敛成 `…/`(2026-10-01 用户要求),完整相对路径在 title 里。
2257
2521
  h('button', {
2258
2522
  type: 'button',
2259
2523
  className: 'knit-preview-path',
2260
- title: onOpenLocal ? t('preview.openLocal', { path: preview.rel }) : preview.rel,
2261
- disabled: !onOpenLocal,
2262
- onClick: () => { if (onOpenLocal) onOpenLocal() },
2524
+ title: onReveal ? t('preview.reveal', { path: preview.rel }) : preview.rel,
2525
+ disabled: !onReveal,
2526
+ onClick: () => { if (onReveal) onReveal() },
2263
2527
  },
2264
2528
  previewPath.dir
2265
2529
  ? h('span', { className: 'knit-preview-dir' }, '…/')
2266
2530
  : null,
2267
2531
  h('span', { className: 'knit-preview-name' }, previewPath.name)),
2532
+ // 复制整篇(只给代码;MarkdownText 自己带代码块复制)
2533
+ isCodeView
2534
+ ? h('button', {
2535
+ className: 'knit-btn',
2536
+ onClick: onCopySource,
2537
+ title: copyFailed ? t('preview.copyFailed') : t('code.copy'),
2538
+ }, copied ? t('code.copied') : t('code.copy'))
2539
+ : null,
2540
+ // Source map:**低权重**入口 —— 只在同名 `<file>.map` 真的存在时出现,
2541
+ // 且 `.map` 本身不参与检索(需求 §6 §28)。点开仍是这个面板,纯文本。
2542
+ isCodeView && preview.mapRel
2543
+ ? h('button', {
2544
+ className: 'knit-btn knit-btn-quiet',
2545
+ onClick: () => { if (onOpenMap) onOpenMap(preview.mapRel) },
2546
+ title: t('preview.sourceMapTitle'),
2547
+ }, t('preview.sourceMap'))
2548
+ : null,
2268
2549
  h('button', {
2269
2550
  className: 'knit-btn',
2270
2551
  onClick: onToggleFullscreen,
2271
2552
  title: fullscreen ? t('preview.exitFullscreenTitle') : t('preview.fullscreenTitle'),
2272
2553
  }, fullscreen ? t('preview.exitFullscreen') : t('preview.fullscreen')),
2554
+ // v0.19 追加:**网页预览** —— 只给 HTML。
2555
+ // 它开的是官方文档预览标签页(`actions.openResource`,与双击列表行**同一条**路),
2556
+ // 那一侧有 DSH 自带的 HTML 渲染器,出来的是**网页**而不是源码。
2557
+ // ⚠️ 这不是把 v0.10 撤掉的那个「新标签页」按钮原样搬回来:当时撤的理由是
2558
+ // 「面板里已经有就地预览,重复度高、用得少」—— 那个判断对 Markdown / 图片 /
2559
+ // 视频成立,对 HTML **不成立**(就地给源码,那边给页面)。所以这里按类型放它出来,
2560
+ // 其余类型仍然只靠双击开新标签页。
2561
+ isWebPage
2562
+ ? h('button', {
2563
+ className: 'knit-btn',
2564
+ onClick: () => { if (onOpenWeb) onOpenWeb() },
2565
+ disabled: !onOpenWeb,
2566
+ title: onOpenWeb ? t('preview.openWebTitle', { path: preview.rel }) : preview.rel,
2567
+ }, t('preview.openWeb'))
2568
+ : null,
2273
2569
  // 「本地打开」= 之前那个「新标签页」的位置(v0.10)。
2274
2570
  // 「新标签页」开的是官方文档预览,但面板里已经有就地预览,重复度高、用得少;
2275
2571
  // 而「用默认应用打开这篇文档」原本只藏在路径的悬停提示里 ——
2276
2572
  // 把值钱的那个放到显眼处,把鸡肋的那个让位(双击列表行仍能开新标签页)。
2573
+ // v0.19 例外:HTML 那边就地预览给不了网页,所以「网页预览」按钮又回来了
2574
+ // (见上面那条);这条注释描述的取舍对其余类型仍然成立。
2277
2575
  h('button', {
2278
2576
  className: 'knit-btn',
2279
2577
  onClick: () => { if (onOpenLocal) onOpenLocal() },
@@ -2388,6 +2686,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2388
2686
  status: 'ready',
2389
2687
  docs: data.docs || [],
2390
2688
  root: data.root || '',
2689
+ // v0.19 修订:`hostRoot` 是同一个工作区、但符号链接已展开的那份路径。
2690
+ // 界面**显示**仍用 `root`(用户看到的是自己选的那条路径),凡是**交给宿主
2691
+ // 去打开 / 定位**的路径一律用 `hostRoot` —— DSH 的 `openWorkspacePath` 只认
2692
+ // realpath,含未展开链接的路径会被它判成 `Path has no verified Host path`。
2693
+ hostRoot: data.hostRoot || data.root || '',
2391
2694
  total: data.total || 0,
2392
2695
  error: '',
2393
2696
  mode: data.mode || 'time',
@@ -2430,12 +2733,16 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2430
2733
  || String(doc.rel || '').toLowerCase().includes(q))
2431
2734
  }, [state.docs, query])
2432
2735
 
2433
- /* ── 「全部」:按类型分上下两区 ─────────────────────
2434
- 文档区固定 4 条,多余的在分区标题给「查看全部」;
2435
- 媒体区**不截断** —— 一屏两行以外交给媒体区内部滚动(不隐藏、也不压小格子)。 */
2436
- const docItems = kind === KIND_ALL ? visibleDocs.filter((doc) => !isMedia(doc)) : []
2736
+ /* ── 「全部」:按类型分三区 ─────────────────────
2737
+ 文档区与代码区各固定 4 条,多余的在分区标题给「查看全部」;
2738
+ 媒体区**不截断** —— 一屏两行以外交给媒体区内部滚动(不隐藏、也不压小格子)。
2739
+ v0.19 新增代码区,**顺序放在文档之后**:这不是排序(各区的条目顺序都来自
2740
+ 同一套任务检索),只是混排时的展示次序 —— Markdown 仍然是这个面板的主角。 */
2741
+ const docItems = kind === KIND_ALL ? visibleDocs.filter((doc) => doc.kind === ARTIFACT_DOC) : []
2742
+ const codeItems = kind === KIND_ALL ? visibleDocs.filter((doc) => doc.kind === ARTIFACT_CODE) : []
2437
2743
  const mediaItems = kind === KIND_ALL ? visibleDocs.filter(isMedia) : []
2438
2744
  const shownDocs = docItems.slice(0, ALL_DOC_CAP)
2745
+ const shownCode = codeItems.slice(0, ALL_CODE_CAP)
2439
2746
  // ResizeObserver 量到的是 .knit-list(它自己也有左右内边距),
2440
2747
  // 网格的可用宽度 = 列表宽度 − 列表内边距 − 网格内边距。
2441
2748
  // 文档列表**没有列数可算**:永远一个文档一行(见 `DOC_GRID` 那段说明)。
@@ -2520,8 +2827,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2520
2827
  /**
2521
2828
  * v0.14:当前任务上下文的分层视图。
2522
2829
  *
2523
- * **只在「文档档 + 相关序 + 宿主给了 context」时成立**;否则返回 null,
2524
- * 下面的渲染退回与 v0.13 逐字一致的平铺列表。
2830
+ * **只在「文档档 / 代码档 + 相关序 + 宿主给了 context」时成立**;否则返回 null,
2831
+ * 下面的渲染退回平铺列表。
2832
+ *
2833
+ * v0.19:多认一档 `KIND_CODE` —— 代码和文档走的是**同一个 Context Pack**
2834
+ * (同一份 Primary / Supporting / Related),只是列表按 `kind` 切了一刀。
2835
+ * 宿主在 `code` 档下同样给 `context`(见 `index.js` 的 `contextPayload()`),
2836
+ * 「全部」档不给 —— 混排视图的分区已经是它自己的结构了。
2525
2837
  *
2526
2838
  * 这一层是**纯投影**:分组、顺序、理由都来自宿主(同一个 Context Model),
2527
2839
  * 客户端不重算任何东西 —— 面板与 `knit_docs` 用的是同一份结果。
@@ -2531,7 +2843,7 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2531
2843
  */
2532
2844
  const contextView = React.useMemo(() => {
2533
2845
  const pack = state.context
2534
- if (!relevance || kind !== KIND_DOC || !pack) return null
2846
+ if (!relevance || (kind !== KIND_DOC && kind !== KIND_CODE) || !pack) return null
2535
2847
  const tiers = [
2536
2848
  ['primary', 'context.primary', 'context.primaryHint'],
2537
2849
  ['supporting', 'context.supporting', 'context.supportingHint'],
@@ -2616,14 +2928,19 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2616
2928
 
2617
2929
  /**
2618
2930
  * 为一个条目造预览状态:图片/视频直接 ready(字节地址交给 <img>/<video>),
2619
- * Markdown 才进 loading 去拉正文。
2931
+ * 其余(Markdown / 代码)进 loading 去拉正文。
2932
+ *
2933
+ * v0.19:`kind` 必须**原样透传**。这里以前无条件写 `KIND_DOC`,代码接进来之后
2934
+ * 那个写法会让 `.ts` 文件走 MarkdownText 渲染 —— 一行行代码会被当成 Markdown
2935
+ * 排版(`#` 变标题、`*` 变列表、缩进被吃掉)。宿主已经在 `/api/doc` 的响应里
2936
+ * 给了分类结论,客户端照抄即可,不再自己看扩展名。
2620
2937
  */
2621
2938
  const previewFor = React.useCallback((doc) => {
2622
2939
  const base = { rel: doc.rel, title: doc.title || doc.name, path: doc.path || '', text: '', truncated: false }
2623
2940
  if (isMedia(doc)) {
2624
2941
  return { ...base, kind: doc.kind, src: mediaUrl(sessionId, doc.rel), status: 'ready' }
2625
2942
  }
2626
- return { ...base, kind: KIND_DOC, status: 'loading' }
2943
+ return { ...base, kind: doc.kind || ARTIFACT_DOC, status: 'loading' }
2627
2944
  }, [sessionId])
2628
2945
 
2629
2946
  /** 打开(不切换)某篇的预览。 */
@@ -2723,8 +3040,17 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2723
3040
  */
2724
3041
  const apply = (target) => {
2725
3042
  setNotice('')
2726
- // 悬停浮层只列 Markdown,这里固定按文档走 loading→拉正文。
2727
- setPreview({ rel: target.rel, title: target.title, path: target.path || '', kind: KIND_DOC, status: 'loading', text: '', truncated: false })
3043
+ // 悬停浮层由宿主下发 `kind`(v0.19 起浮层也可能列代码)—— 拿不到就当文档,
3044
+ // 走 loading→拉正文。**不要在这里写死**,否则代码会进 MarkdownText。
3045
+ setPreview({
3046
+ rel: target.rel,
3047
+ title: target.title,
3048
+ path: target.path || '',
3049
+ kind: target.kind || ARTIFACT_DOC,
3050
+ status: 'loading',
3051
+ text: '',
3052
+ truncated: false,
3053
+ })
2728
3054
  }
2729
3055
  if (pendingPreview) {
2730
3056
  const queued = pendingPreview
@@ -2742,14 +3068,32 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2742
3068
  * 必然拿到 `knit/not-found`,面板会把它显示成「读取失败」。
2743
3069
  * **与其显示一个假的失败,不如压根不请求、也不显示这一条。**
2744
3070
  */
2745
- const previewIsDoc = !preview || (preview.kind !== 'image' && preview.kind !== 'video')
3071
+ const previewIsDoc = !preview || preview.kind === ARTIFACT_DOC
2746
3072
 
2747
- /** 这篇文档在磁盘上的绝对路径:宿主给的 path 优先,拿不到就用 root + rel 拼。 */
3073
+ /**
3074
+ * 这篇文档在磁盘上的绝对路径,优先级:
3075
+ * ① 宿主 `/api/doc` 给的 `path`(它已经展开过符号链接);
3076
+ * ② `hostRoot + rel`(同一个工作区根,也是 canonical 的);
3077
+ * ③ `root + rel`(老宿主,可能含符号链接 —— 点了会被 DSH 拒)。
3078
+ * 「打开 / 定位」要的是**宿主验证得过的路径**,不是看起来对的那条。
3079
+ */
2748
3080
  const previewAbsPath = preview
2749
- ? (preview.path || joinPath(state.root, preview.rel))
3081
+ ? (preview.path || joinPath(state.hostRoot || state.root, preview.rel))
2750
3082
  : ''
2751
3083
 
2752
- /** 点预览头那行路径 → 用系统默认应用打开本地文档。 */
3084
+ /**
3085
+ * 点预览头那条面包屑 → 在文件管理器里**打开它所在的文件夹并选中这个文件**
3086
+ * (`action: 'reveal'`,macOS 上是 `open -R`)。用户不必在文件夹里自己找。
3087
+ *
3088
+ * 与页脚「本地打开」的分工:那个用默认应用**打开文件**,这个只**定位文件**。
3089
+ * reveal 要的是**文件本身的绝对路径**(不是所在目录)—— 传目录过去会变成
3090
+ * 「在上级目录里选中这个文件夹」,不是我们要的。
3091
+ */
3092
+ const openPreviewReveal = React.useCallback(async () => {
3093
+ setNotice((await openLocalPath(previewAbsPath, { reveal: true })) || '')
3094
+ }, [previewAbsPath])
3095
+
3096
+ /** 页脚「本地打开」→ 用系统默认应用打开这篇文档本身。 */
2753
3097
  const openPreviewLocal = React.useCallback(async () => {
2754
3098
  setNotice((await openLocalPath(previewAbsPath)) || '')
2755
3099
  }, [previewAbsPath])
@@ -2765,9 +3109,24 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
2765
3109
  if (!alive) return
2766
3110
  setPreview((cur) => {
2767
3111
  if (!cur || cur.rel !== previewRel) return cur
2768
- return data && data.ok
2769
- ? { ...cur, status: 'ready', text: data.text || '', truncated: Boolean(data.truncated) }
2770
- : { ...cur, status: 'error', error: hostMessage(data) }
3112
+ if (!data || !data.ok) return { ...cur, status: 'error', error: hostMessage(data) }
3113
+ return {
3114
+ ...cur,
3115
+ status: 'ready',
3116
+ text: data.text || '',
3117
+ truncated: Boolean(data.truncated),
3118
+ /* v0.19:分类结论以宿主响应为准 —— 本地点开时已经带上了,但
3119
+ 「悬停浮层点的」「引用条点的」这些入口未必知道,正文到手后
3120
+ 就地校正一次,渲染分支(CodePane vs MarkdownText)才不会选错。
3121
+ `mapRel` 是宿主那次有界 stat 的结果:有同名 `.map` 才给入口。 */
3122
+ kind: data.kind || cur.kind,
3123
+ language: data.language || cur.language,
3124
+ mapRel: data.mapRel || '',
3125
+ /* v0.19 修订:正文到手后把「打开用」的绝对路径也校正过来 ——
3126
+ 自己用 root + rel 拼的那份在符号链接工作区里会被 DSH 判成
3127
+ `Path has no verified Host path`(见宿主 `hostPathOf()`)。 */
3128
+ path: data.path || cur.path,
3129
+ }
2771
3130
  })
2772
3131
  } catch (error) {
2773
3132
  if (!alive) return
@@ -3006,9 +3365,13 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3006
3365
  if (state.status === 'error' || state.docs.length === 0 || visibleDocs.length === 0) return []
3007
3366
  if (kind === KIND_MEDIA) return [] // 媒体格子不参与:网格里收起高度没有意义
3008
3367
  if (kind === KIND_ALL) {
3009
- if (docItems.length === 0) return []
3010
- return shownDocs.map((doc, index) => (
3011
- { rel: doc.rel, tierKey: MOTION_TIER_ALL_DOCS, index, doc }))
3368
+ if (docItems.length === 0 && codeItems.length === 0) return []
3369
+ return [
3370
+ ...shownDocs.map((doc, index) => (
3371
+ { rel: doc.rel, tierKey: MOTION_TIER_ALL_DOCS, index, doc })),
3372
+ ...shownCode.map((doc, index) => (
3373
+ { rel: doc.rel, tierKey: MOTION_TIER_ALL_CODE, index, doc })),
3374
+ ]
3012
3375
  }
3013
3376
  if (contextView) {
3014
3377
  const rows = []
@@ -3150,6 +3513,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3150
3513
  docItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'docs' },
3151
3514
  sectionHead('kind.doc', shownDocs.length, docItems.length, KIND_DOC),
3152
3515
  docsGrid(withGhosts(MOTION_TIER_ALL_DOCS, shownDocs))),
3516
+ codeItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'code' },
3517
+ sectionHead('kind.code', shownCode.length, codeItems.length, KIND_CODE),
3518
+ docsGrid(withGhosts(MOTION_TIER_ALL_CODE, shownCode))),
3153
3519
  mediaItems.length === 0 ? null : h('div', { className: 'knit-section', key: 'media' },
3154
3520
  // 媒体不截断,所以只给一个标题,不给「已显示 / 总数」和「查看全部」
3155
3521
  h('div', { className: 'knit-section-head' },
@@ -3160,7 +3526,11 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3160
3526
 
3161
3527
  // 媒体视图:一格都不隐藏 —— 一屏两行以外的部分在媒体区**内部滚动**,
3162
3528
  // 既不让面板被整面媒体墙顶爆,也不会像旧版那样把剩下的条目直接切掉。
3163
- const emptyText = kind === KIND_MEDIA ? t('list.emptyMedia') : t('list.empty')
3529
+ const emptyText = kind === KIND_MEDIA
3530
+ ? t('list.emptyMedia')
3531
+ : kind === KIND_CODE
3532
+ ? t('list.emptyCode')
3533
+ : t('list.empty')
3164
3534
  const body = state.status === 'loading' && state.docs.length === 0
3165
3535
  ? h('div', { className: 'knit-msg' }, t('list.scanning'))
3166
3536
  : state.status === 'error'
@@ -3422,12 +3792,14 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3422
3792
  lensOpen ? h('div', { className: 'knit-lens-body' },
3423
3793
  coverageNode, recentNode, outsideNode, deltaNode) : null)
3424
3794
 
3425
- // 不同类型用不同量词:文档「篇」、媒体「个」、混排「项」。
3795
+ // 不同类型用不同量词:文档「篇」、代码「个」、媒体「个」、混排「项」。
3426
3796
  const countKey = kind === KIND_MEDIA
3427
3797
  ? (filtering ? 'count.media.filtered' : 'count.media')
3428
- : kind === KIND_ALL
3429
- ? (filtering ? 'count.all.filtered' : 'count.all')
3430
- : (filtering ? 'count.filtered' : 'count')
3798
+ : kind === KIND_CODE
3799
+ ? (filtering ? 'count.code.filtered' : 'count.code')
3800
+ : kind === KIND_ALL
3801
+ ? (filtering ? 'count.all.filtered' : 'count.all')
3802
+ : (filtering ? 'count.filtered' : 'count')
3431
3803
  const countText = filtering
3432
3804
  ? t(countKey, { hit: visibleDocs.length, total: state.total })
3433
3805
  : t(countKey, { n: state.total })
@@ -3444,7 +3816,8 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3444
3816
  title: state.root ? t('path.openTitle') : '',
3445
3817
  disabled: !state.root,
3446
3818
  onClick: async () => {
3447
- setNotice((await openLocalPath(state.root)) || '')
3819
+ // 打开文件夹同样要走 canonical 路径 —— 目录也会被同一条 `verifyDesktopPath` 拒。
3820
+ setNotice((await openLocalPath(state.hostRoot || state.root)) || '')
3448
3821
  },
3449
3822
  }, state.root || '—'),
3450
3823
  h('div', { className: 'knit-count' }, countText),
@@ -3480,7 +3853,9 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3480
3853
  },
3481
3854
  })),
3482
3855
  h('div', { className: 'knit-types', role: 'tablist', 'aria-label': t('kind.title') },
3483
- [[KIND_DOC, 'kind.doc'], [KIND_MEDIA, 'kind.media'], [KIND_ALL, 'kind.all']].map(([value, labelKey]) =>
3856
+ // v0.19:四档「文档 / 代码 / 媒体 / 全部」。**没有第二层分类** ——
3857
+ // 代码里不再按语言(JS / TS / Python…)分组(需求 §46:不给代码加视觉层级压迫)。
3858
+ [[KIND_DOC, 'kind.doc'], [KIND_CODE, 'kind.code'], [KIND_MEDIA, 'kind.media'], [KIND_ALL, 'kind.all']].map(([value, labelKey]) =>
3484
3859
  h('button', {
3485
3860
  type: 'button',
3486
3861
  key: value,
@@ -3540,6 +3915,18 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3540
3915
  onOpenLink: (item) => requestPreview(item),
3541
3916
  // 拿不到绝对路径就不给点(而不是点了没反应)
3542
3917
  onOpenLocal: previewAbsPath ? openPreviewLocal : null,
3918
+ onReveal: previewAbsPath ? openPreviewReveal : null,
3919
+ /* v0.19 Source map:仍走 `requestPreview` 这条既有通道,不新开一条打开路径。
3920
+ `.map` 是宿主分类层判定的 `generated`(previewable 但 contextual:false)——
3921
+ 面板能看它,列表与检索永远见不到它(需求 §6 §28 §29)。 */
3922
+ onOpenMap: (rel) => requestPreview({
3923
+ rel,
3924
+ title: rel.split('/').pop(),
3925
+ kind: KIND_GENERATED,
3926
+ }),
3927
+ /* v0.19 追加:HTML 的「网页预览」走**同一条**官方标签页通道(`onOpenTab`),
3928
+ 不新开第二条打开路径。宿主没提供这条能力时按钮置灰,而不是点了没反应。 */
3929
+ onOpenWeb: typeof openInTab === 'function' ? () => onOpenTab(preview) : null,
3543
3930
  onClose: closePreview,
3544
3931
  onToggleFullscreen: () => setFullscreen((v) => !v),
3545
3932
  onResizeStart,
@@ -3940,12 +4327,19 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3940
4327
 
3941
4328
  /**
3942
4329
  * 请求在面板里打开某一篇。面板挂着就立刻生效,没挂就留一份挂起。
3943
- * @param {{rel:string, title?:string, name?:string}} doc - 目标文档
4330
+ * @param {{rel:string, title?:string, name?:string, path?:string, kind?:string}} doc - 目标文档
3944
4331
  * @returns {void}
3945
4332
  */
3946
4333
  function requestPreview(doc) {
3947
4334
  if (!doc || !doc.rel) return
3948
4335
  const target = { rel: doc.rel, title: doc.title || doc.name || doc.rel }
4336
+ /* v0.19:把 `path` / `kind` 一起带过去。
4337
+ 以前这里只传 `rel` + `title`,于是接收端只能自己猜类型(猜的结果就是
4338
+ 「一律当 Markdown」)。分类结论在宿主,这一路上不该被丢掉。
4339
+ ⚠️ 两个字段都**只在有值时**写入:调用方常传 `{rel, title}`,别把
4340
+ `kind: undefined` 传下去,那会覆盖掉接收端的兜底默认值。 */
4341
+ if (doc.path) target.path = doc.path
4342
+ if (doc.kind) target.kind = doc.kind
3949
4343
  if (previewSubscribers.size === 0) {
3950
4344
  pendingPreview = target
3951
4345
  return
@@ -3970,17 +4364,27 @@ body[data-ds-dark-theme] .knit-icon{color:#fff}
3970
4364
  * 它把业务值折进一个信封(`{ ok: true, value } | { ok: false, error }`),
3971
4365
  * 所以这里要拆信封而不是直接 await 出结果。
3972
4366
  *
3973
- * @param {string} path - 绝对路径
4367
+ * `options.reveal` 走的是**同一个** remote 的同一个方法,只是多带一个
4368
+ * `action: 'reveal'`(DSH 的 `SessionOpenWorkspacePathRequest.action`)。
4369
+ * 主机侧落在 `revealNativePath` 上:macOS 是 `open -R`、Windows 是
4370
+ * `explorer /select,`,也就是**打开所在文件夹并选中这个文件** ——
4371
+ * 用户不必再在文件夹里自己找(Chrome「在文件夹中显示」是同一件事)。
4372
+ * ⚠️ Linux 的 xdg-open 没有「选中」这个概念,那边只有打开目录,
4373
+ * 这是平台差异,不是我们少做了一步。
4374
+ *
4375
+ * @param {string} path - 绝对路径(reveal 要的是**文件本身**,不是它所在的目录)
4376
+ * @param {{reveal?:boolean}} [options] - `reveal` 为真则在文件管理器里选中它
3974
4377
  * @returns {Promise<string>} 空串表示成功,否则是失败原因
3975
4378
  */
3976
- async function openLocalPath(path) {
4379
+ async function openLocalPath(path, options = {}) {
3977
4380
  if (!path) return t('error.hostFailed')
3978
4381
  const services = rootCtx && typeof rootCtx.get === 'function' ? rootCtx.get('remote.session') : null
3979
4382
  if (!services || typeof services.openWorkspacePath !== 'function') {
3980
4383
  return t('error.noHostTab')
3981
4384
  }
4385
+ const request = options.reveal ? { path, action: 'reveal' } : { path }
3982
4386
  try {
3983
- const result = await services.openWorkspacePath({ path })
4387
+ const result = await services.openWorkspacePath(request)
3984
4388
  if (result && result.ok === false) {
3985
4389
  const detail = result.error && (result.error.message || result.error.code)
3986
4390
  return t('error.openFailed', { error: String(detail || 'unknown') })