dsh-knit 0.16.0 → 0.18.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.
@@ -9,6 +9,8 @@
9
9
  import test from 'node:test'
10
10
  import assert from 'node:assert/strict'
11
11
  import http from 'node:http'
12
+ import { utimesSync } from 'node:fs'
13
+ import { join } from 'node:path'
12
14
  import { fileURLToPath } from 'node:url'
13
15
  import { stat } from 'node:fs/promises'
14
16
 
@@ -393,10 +395,11 @@ test('HTTP 端到端:默认不记账,usage=1 开闸,读事件由 session/e
393
395
  assert.ok(!('usage' in body), '默认不该回传 usage(更不该偷偷记账)')
394
396
 
395
397
  // ② 打开:这一刻开始记。此刻还一次读事件都没发生 → 计数是 0。
396
- // v0.16 刻意**不回溯**订阅之前的事件:宁可少记,也不去猜一段没法按当时上下文归因的历史。
398
+ // 这个假会话没有 `snapshotEvents()`(= 没有可回填的历史),所以仍然是 0;
399
+ // 有历史的会话会在开闸这一刻回填一次 —— 见下面「面板开晚」那条用例。
397
400
  body = await (await fetch(`${base}/api/recent?sessionId=s1&sort=relevance&usage=1`)).json()
398
401
  assert.ok(body.usage, 'usage=1 应当回传使用情况')
399
- assert.equal(body.usage.stats.reads, 0, '订阅之前发生的事件不回溯')
402
+ assert.equal(body.usage.stats.reads, 0, '没有历史可回填时照旧从 0 开始')
400
403
  // ⚠️ `at` 是**上一份包**交出去的时间;第一次记账时还没有上一份,所以是 0。
401
404
  // 这不是缺陷,是顺序:usage 先算、快照后记(从下一次请求起才有「上一份」)。
402
405
  assert.equal(body.usage.at, 0)
@@ -525,3 +528,127 @@ test('HTTP 端到端:/api/context 也推进快照,但只在已记账的会
525
528
  await close()
526
529
  }
527
530
  })
531
+
532
+ /* ── v0.17 文档生命周期(端到端)────────────────────────────────────
533
+ v0.16 的 15 个 stats 键一个都不许动;生命周期是**新的事实投影**:
534
+ 宿主每次请求重新 scan → 拿到真实 `mtimeMs` → 与「最后一次成功 read 时
535
+ 记下的 mtimeMs」比对。所以这两条用例必须真的改磁盘上的文件时间
536
+ (`utimesSync`),否则测的只是替身。 */
537
+
538
+ /** v0.16 就有的 15 个 stats 键 —— v0.17 只在**顶层**加新字段,不许挤进 stats。 */
539
+ const STATS_KEYS = [
540
+ 'byTier', 'churn', 'continuedReadsAfterExit', 'distinct', 'firstReadAt',
541
+ 'firstReadEpoch', 'firstReadRel', 'firstReadTier', 'outside', 'outsideReads',
542
+ 'primaryFollowThrough', 'primaryRel', 'reEntries', 'reads', 'supportingCoverage',
543
+ ]
544
+
545
+ test('HTTP 端到端:usage 顶层多出生命周期 / 最近读取 / 包外明细,stats 形状不变', async () => {
546
+ const { base, close, emit } = await startKnitServer(
547
+ sessionWithEvents([userMessage(1, 'hub 这份文档')]), 's6',
548
+ )
549
+ try {
550
+ // ① 交第一份包(开闸)
551
+ await fetch(`${base}/api/recent?sessionId=s6&sort=relevance&usage=1`)
552
+ // ② 读一篇包内文档,再读一篇**不在文档包里的**文件(图片:扫描器只收 md)
553
+ emit(readCall(2, 'docs/hub.md'))
554
+ emit(toolResult(3, 'c2'))
555
+ emit(readCall(4, 'docs/screenshot.png'))
556
+ emit(toolResult(5, 'c4'))
557
+
558
+ const body = await (await fetch(`${base}/api/recent?sessionId=s6&sort=relevance`)).json()
559
+ assert.deepEqual(Object.keys(body.usage.stats).sort(), STATS_KEYS, 'stats 形状是 v0.16 的,一个键都不许加')
560
+
561
+ // 每篇文档的状态只留三个字段:状态、次数、最后一次读的时间(线上载荷要瘦)
562
+ assert.deepEqual(body.usage.lifecycle['docs/hub.md'], {
563
+ status: 'read', count: 1, lastReadAt: 1003,
564
+ })
565
+ assert.equal(body.usage.lifecycle['docs/screenshot.png'].status, 'read')
566
+
567
+ // 最近读取 = 最近一次成功 read 的文件(按 seq,不是按墙钟猜)
568
+ assert.deepEqual(body.usage.recentRead, {
569
+ rel: 'docs/screenshot.png', at: 1005, seq: 5, epochId: 1, tier: null, rank: null, inside: false,
570
+ })
571
+ // 包外明细:不在当前包里、但真的成功读过
572
+ assert.deepEqual(body.usage.outsideDocs, [
573
+ { rel: 'docs/screenshot.png', count: 1, lastReadAt: 1005, seq: 5 },
574
+ ])
575
+ // 同一份包连交两次不算「上下文变化」→ 没有最近一次 Delta
576
+ assert.equal(body.usage.latestDelta, null)
577
+ // 新字段同样只有相对路径
578
+ assert.ok(!JSON.stringify(body.usage).includes(PROJECT_ROOT), 'usage 里不许出现绝对路径')
579
+ } finally {
580
+ await close()
581
+ }
582
+ })
583
+
584
+ test('HTTP 端到端:真实改动文件 → 读后已更新;再读一次 → 修改后已重新读取', async () => {
585
+ const { base, close, emit } = await startKnitServer(
586
+ sessionWithEvents([userMessage(1, 'hub 这份文档')]), 's7',
587
+ )
588
+ try {
589
+ await fetch(`${base}/api/recent?sessionId=s7&sort=relevance&usage=1`)
590
+ emit(readCall(2, 'docs/hub.md'))
591
+ emit(toolResult(3, 'c2'))
592
+
593
+ let body = await (await fetch(`${base}/api/recent?sessionId=s7&sort=relevance`)).json()
594
+ assert.equal(body.usage.lifecycle['docs/hub.md'].status, 'read', '刚读完就是「已读」')
595
+
596
+ // 真的把文件时间往后推 —— 宿主这一轮 scan 会拿到新的 mtimeMs
597
+ const abs = join(PROJECT_ROOT, 'docs/hub.md')
598
+ const later = Date.now() / 1000 + 30
599
+ utimesSync(abs, later, later)
600
+
601
+ body = await (await fetch(`${base}/api/recent?sessionId=s7&sort=relevance`)).json()
602
+ assert.equal(
603
+ body.usage.lifecycle['docs/hub.md'].status, 'updated_after_read',
604
+ '上次成功 read 之后文件变过 —— 这只是「变过」,不是「Agent 用的是旧版」',
605
+ )
606
+ assert.equal(body.usage.lifecycle['docs/hub.md'].count, 1, '变化本身不是一次读')
607
+
608
+ // 变化之后又成功读了一次 → 事实升级为「修改后已重新读取」
609
+ emit(readCall(4, 'docs/hub.md'))
610
+ emit(toolResult(5, 'c4'))
611
+ body = await (await fetch(`${base}/api/recent?sessionId=s7&sort=relevance`)).json()
612
+ assert.equal(body.usage.lifecycle['docs/hub.md'].status, 'reread_after_update')
613
+ assert.equal(body.usage.lifecycle['docs/hub.md'].count, 2)
614
+ assert.equal(body.usage.stats.reads, 2, '两次成功 read 都算数')
615
+ } finally {
616
+ await close()
617
+ }
618
+ })
619
+
620
+ test('v0.17 修订:面板开晚了也能补记 —— 开闸那一刻回填会话已有的事件', async () => {
621
+ // 真机形状:用户在面板打开**之前**就已经让 agent 读过一篇包内文档。
622
+ const { base, close } = await startKnitServer(
623
+ sessionWithEvents([
624
+ userMessage(1, 'hub 这份文档'),
625
+ readCall(2, 'docs/hub.md'),
626
+ toolResult(3, 'c2'),
627
+ ]),
628
+ 's8',
629
+ )
630
+ try {
631
+ // ① 面板从没打开过:闸门关着,一个字节都不记(usage 根本不出现)
632
+ let body = await (await fetch(`${base}/api/recent?sessionId=s8&sort=relevance`)).json()
633
+ assert.ok(!('usage' in body), '默认关:连 usage 键都不该有')
634
+
635
+ // ② 用户读完了才打开开关:这一个请求把历史补进来
636
+ body = await (await fetch(`${base}/api/recent?sessionId=s8&sort=relevance&usage=1`)).json()
637
+ assert.equal(body.usage.stats.reads, 1, '开闸时回填会话已有的事件')
638
+ assert.equal(body.usage.lifecycle['docs/hub.md'].status, 'read')
639
+ assert.equal(body.usage.lifecycle['docs/hub.md'].count, 1)
640
+ // ⚠️ 补记的读按「我们已知最早的那份包」归因 —— 说它当时在包外,是我们不知道的事
641
+ assert.equal(body.usage.stats.firstReadTier, 'primary')
642
+ assert.equal(body.usage.stats.firstReadEpoch, 1)
643
+ assert.equal(body.usage.stats.outside, 0, '不许把包内文档说成包外')
644
+ assert.deepEqual(body.usage.outsideDocs, [])
645
+ assert.equal(body.usage.recentRead.rel, 'docs/hub.md')
646
+ assert.equal(body.usage.recentRead.inside, true)
647
+
648
+ // ③ 同一个会话不再回填第二次:再来一次请求,计数不动
649
+ body = await (await fetch(`${base}/api/recent?sessionId=s8&sort=relevance&usage=1`)).json()
650
+ assert.equal(body.usage.stats.reads, 1, '一个会话只回填一次')
651
+ } finally {
652
+ await close()
653
+ }
654
+ })
@@ -6,7 +6,7 @@
6
6
  import test from 'node:test'
7
7
  import assert from 'node:assert/strict'
8
8
 
9
- import { loadClientModule, createHarness, byClass, textOf, makeLocale } from './harness.mjs'
9
+ import { loadClientModule, createHarness, byClass, byExactClass, textOf, makeLocale } from './harness.mjs'
10
10
 
11
11
  const harness = createHarness()
12
12
  const React = globalThis.__knitReact
@@ -435,6 +435,169 @@ test('守卫:英文环境下无障碍与提示属性里也没有汉字', async
435
435
  assert.deepEqual(bad, [], `英文环境的属性里混进了中文:${bad.join(' / ')}`)
436
436
  })
437
437
 
438
+ /* ── v0.18 Usage Lens:英文渲染里也不许有汉字 ───────────────
439
+ ⚠️ 上面那两条守卫用的是 `timePayload()` —— **它没有 usage**,所以 Lens 整块
440
+ 一个节点都没渲染。也就是说 v0.18 新增的几十条 Lens 文案(含挂在 `title` /
441
+ `aria-label` 上的)**不在那两条守卫的覆盖里**:JSX 里如果漏了 `t()`,
442
+ 它们照样全绿。下面这两条把 Lens 真的打开再查一遍。 */
443
+
444
+ /**
445
+ * v0.18 Usage Lens 的**英文语料**(全部 ASCII)。
446
+ *
447
+ * ⚠️ 与 `timePayload` 同一条规矩:标题 / 主题 / 摘要都是**数据**,
448
+ * 混进中文会被守卫误报成「文案漏了 t()」。
449
+ * 覆盖面:三块内容全在 —— Coverage 三层、最近读取、包外 12 篇(→「还有 2 篇」)、
450
+ * 变化 6 条(→「还有 3 条」,且 `taskChanged` 为真);生命周期四态齐全。
451
+ *
452
+ * @returns {object} 载荷
453
+ */
454
+ function lensPayload() {
455
+ const at = Date.now()
456
+ const item = (rel, title) => ({
457
+ rel, path: `/p/${rel}`, name: rel.split('/').pop(), title,
458
+ summary: 's', mtimeMs: at, kind: 'md', source: 'doc',
459
+ reason: { code: 'titleMatch', terms: ['bm25'], fields: 1 },
460
+ })
461
+ const delta = {
462
+ appeared: [{ rel: 'docs/new-a.md', tier: 'primary', rank: 2 },
463
+ { rel: 'docs/new-b.md', tier: 'related', rank: 3 }],
464
+ disappeared: [{ rel: 'docs/gone-a.md', tier: 'related', rank: 4 },
465
+ { rel: 'docs/gone-b.md', tier: 'related', rank: 5 }],
466
+ moved: [{ rel: 'docs/moved.md', from: 'supporting', to: 'related' }],
467
+ taskChanged: true,
468
+ }
469
+ return {
470
+ ok: true, root: '/p', total: 4, mode: 'relevance', topic: 'bm25 ranking', keywords: ['bm25'],
471
+ docs: [item('docs/algo.md', 'Algo'), item('docs/eval.md', 'Eval'),
472
+ item('CHANGELOG.md', 'Changelog'), item('README.md', 'Knit')],
473
+ context: {
474
+ mode: 'relevance', topic: 'bm25 ranking', task: '',
475
+ primary: [item('docs/algo.md', 'Algo')],
476
+ supporting: [item('docs/eval.md', 'Eval'), item('CHANGELOG.md', 'Changelog')],
477
+ related: [item('README.md', 'Knit'), item('out/doc-0.md', 'Out')],
478
+ },
479
+ usage: {
480
+ at, epochId: 4,
481
+ stats: {
482
+ reads: 7, distinct: 3, outside: 12, outsideReads: [],
483
+ firstReadTier: 'primary', firstReadRel: 'docs/algo.md', firstReadAt: 1,
484
+ primaryRel: 'docs/algo.md', primaryFollowThrough: true,
485
+ byTier: {
486
+ primary: { total: 1, read: 1 },
487
+ supporting: { total: 2, read: 1 },
488
+ related: { total: 2, read: 0 },
489
+ },
490
+ supportingCoverage: 0.5,
491
+ churn: { snapshots: 5, deltas: 4, retained: 4, appeared: 2, disappeared: 2, moved: 1, taskChanged: 1 },
492
+ },
493
+ delta, latestDelta: delta,
494
+ recentRead: { rel: 'docs/eval.md', at, seq: 42, epochId: 4, tier: 'supporting', rank: 2, inside: true },
495
+ outsideDocs: Array.from({ length: 12 }, (_, i) => ({
496
+ rel: `out/doc-${i}.md`, count: 12 - i, lastReadAt: i, seq: i,
497
+ })),
498
+ lifecycle: {
499
+ 'docs/algo.md': { status: 'read', count: 3, lastReadAt: 1 },
500
+ 'docs/eval.md': { status: 'reread_after_update', count: 2, lastReadAt: 2 },
501
+ 'CHANGELOG.md': { status: 'updated_after_read', count: 1, lastReadAt: 3 },
502
+ 'README.md': { status: 'unread', count: 0, lastReadAt: 0 },
503
+ // ⚠️ 包外那 12 篇在真实载荷里**每一篇都有 read 记录**(左右两栏同源)。
504
+ // 只给第一篇的话,守卫语料会自相矛盾:左边写 `×11`、右边写 `Unread`。
505
+ ...Object.fromEntries(Array.from({ length: 12 }, (_, i) => [
506
+ `out/doc-${i}.md`, { status: 'read', count: 12 - i, lastReadAt: i },
507
+ ])),
508
+ },
509
+ },
510
+ }
511
+ }
512
+
513
+ /**
514
+ * 把 Usage Lens **打开**(数据到位后再点,与真实用法一致),返回渲染出的节点。
515
+ * @param {string} locale - 活动语言
516
+ * @param {object} payload - 宿主载荷
517
+ * @returns {Promise<{nodes: object[], render: Function}>} 节点与重渲染
518
+ */
519
+ async function mountLens(locale, payload) {
520
+ installFetch(() => payload)
521
+ const { exports } = boot(locale)
522
+ const { KnitBody } = exports.__test
523
+ harness.reset()
524
+ const render = () => harness.render(h(KnitBody, { sessionId: 's1' }))
525
+ render()
526
+ await harness.flush()
527
+ render()
528
+ await harness.flush()
529
+ const toggle = byExactClass(render(), 'knit-btn').find((n) => textOf(n) === 'Usage')
530
+ assert.ok(toggle, '英文头部必须有 Usage 按钮')
531
+ toggle.props.onClick()
532
+ await harness.flush()
533
+ render()
534
+ await harness.flush()
535
+ return { nodes: render(), render }
536
+ }
537
+
538
+ /**
539
+ * 收集一棵树里所有 `title` / `aria-label` 之类的**文案属性**。
540
+ * @param {object[]} nodes - 扁平节点
541
+ * @returns {string[]} 属性值
542
+ */
543
+ function attrTexts(nodes) {
544
+ const attrs = ['aria-label', 'title', 'placeholder', 'alt']
545
+ const out = []
546
+ for (const n of nodes) {
547
+ for (const a of attrs) {
548
+ const v = n.props[a]
549
+ if (typeof v === 'string' && v) out.push(`${a}="${v}"`)
550
+ }
551
+ }
552
+ return out
553
+ }
554
+
555
+ test('守卫:英文环境下打开的 Usage Lens 里也没有汉字(文字 + title / aria-label)', async () => {
556
+ const { nodes: closed, render } = await mountLens('en', lensPayload())
557
+
558
+ // 折叠态先查一遍:`+3 more`(`usage.deltaMore`)只在折叠时出现(展开=明细全列,不再有尾巴)
559
+ const closedText = ownTexts(closed).join(' | ')
560
+ assert.ok(closedText.includes('+3 more'), `折叠态少了「+3 more」:${closedText}`)
561
+ assert.deepEqual(cjkIn(ownTexts(closed)), [], '英文折叠态 Lens 的文字里混进了中文')
562
+ assert.deepEqual(cjkIn(attrTexts(closed)), [], '英文折叠态 Lens 的属性里混进了中文')
563
+
564
+ // 两块集合默认折叠 —— 先把它们点开,否则那几条文案根本没进渲染树
565
+ for (const btn of byExactClass(closed, 'knit-more-btn')) btn.props.onClick()
566
+ const nodes = render()
567
+ const text = ownTexts(nodes).join(' | ')
568
+
569
+ // ⚠️ 先证明 Lens **真的渲染了**:找不到锚点就意味着下面是「空转绿灯」
570
+ for (const anchor of ['Usage', 'Epoch 4', 'Current context', 'Recent read',
571
+ 'Reads outside context', 'Context changes', 'Entered', 'Left', 'Moved tier',
572
+ 'Task context updated', '2 more']) {
573
+ assert.ok(text.includes(anchor), `英文 Lens 少了「${anchor}」:${text}`)
574
+ }
575
+
576
+ assert.deepEqual(cjkIn(ownTexts(nodes)), [], '英文 Usage Lens 的文字里混进了中文')
577
+ const bad = cjkIn(attrTexts(nodes))
578
+ assert.deepEqual(bad, [], `英文 Usage Lens 的属性里混进了中文:${bad.join(' / ')}`)
579
+ })
580
+
581
+ test('守卫:英文环境下**空**的 Usage Lens 里也没有汉字', async () => {
582
+ const payload = lensPayload()
583
+ const u = payload.usage
584
+ u.stats.reads = 0
585
+ u.stats.outside = 0
586
+ u.stats.churn.snapshots = 0
587
+ u.delta = null
588
+ u.latestDelta = null
589
+ u.recentRead = null
590
+ u.outsideDocs = []
591
+ u.lifecycle = {}
592
+
593
+ const { nodes } = await mountLens('en', payload)
594
+ const text = ownTexts(nodes).join(' | ')
595
+ assert.ok(text.includes('Nothing yet'), `空态少了「Nothing yet」:${text}`)
596
+ assert.ok(text.includes('0 reads'), `空态也要报事实(0 reads):${text}`)
597
+ assert.deepEqual(cjkIn(ownTexts(nodes)), [], '英文空 Lens 的文字里混进了中文')
598
+ assert.deepEqual(cjkIn(attrTexts(nodes)), [], '英文空 Lens 的属性里混进了中文')
599
+ })
600
+
438
601
  test('守卫:相对时间的六个分支都随语言(原来是硬编码中文)', async () => {
439
602
  const en = await renderPanel('en', () => timePayload())
440
603
  const enTimes = byClass(en.nodes, 'knit-time').map(textOf)
@@ -523,3 +686,62 @@ test('i18n: 宿主的每个 Context Pack 理由码都有中英译文', async ()
523
686
  assert.ok(used.has(key), `ZH 里的 why.${key} 已经没有一个宿主理由码在用它`)
524
687
  }
525
688
  })
689
+
690
+ /* ── v0.17 文档生命周期:数据层英文,界面按语言映射 ─────────────────── */
691
+
692
+ test('词典:v0.18 的 Usage Lens / 生命周期文案中英都对得上', () => {
693
+ const { registered } = boot('zh')
694
+ const { zh, en } = registered.knit
695
+
696
+ // 状态值本身在数据层是英文(unread / read / ...),中文只活在词典里(SDD §15.4)
697
+ const expected = {
698
+ 'usage.deltaEnter': ['进入', 'Entered'],
699
+ 'usage.deltaLeave': ['离开', 'Left'],
700
+ 'usage.deltaMove': ['换层', 'Moved tier'],
701
+ 'usage.deltaTask': ['任务上下文已更新', 'Task context updated'],
702
+ 'usage.deltaMore': ['还有 {n} 条', '+{n} more'],
703
+ // v0.18 Usage Lens:标题 / 摘要行 / 三块内容
704
+ 'lens.title': ['使用情况', 'Usage'],
705
+ 'lens.expand': ['展开使用情况', 'Expand usage'],
706
+ 'lens.collapse': ['收起使用情况', 'Collapse usage'],
707
+ 'lens.epoch': ['Epoch {n}', 'Epoch {n}'],
708
+ 'lens.reads': ['{n} 次读取', '{n} reads'],
709
+ 'lens.outside': ['{n} 篇包外', '{n} outside the pack'],
710
+ 'lens.changes': ['上下文变化 {n} 次', 'context changed {n}×'],
711
+ 'lens.currentContext': ['当前上下文', 'Current context'],
712
+ 'lens.recentRead': ['最近读取', 'Recent read'],
713
+ 'lens.recentNone': ['暂无记录', 'Nothing yet'],
714
+ 'lens.outsideDocs': ['上下文外读取', 'Reads outside context'],
715
+ 'lens.more': ['还有 {n} 篇', '{n} more'],
716
+ 'lens.openDoc': ['打开 {rel}', 'Open {rel}'],
717
+ 'lens.delta': ['上下文变化', 'Context changes'],
718
+ 'lens.locate': ['定位到{tier}上下文', 'Locate {tier} context'],
719
+ // v0.18 UI 迭代新增:读屏专用的一句(视觉上不显示)+ 变化行右侧的「最近一次」
720
+ 'lens.coverageAria': ['{tier}上下文:{read} / {total} 篇已读', '{tier} context: {read} / {total} read'],
721
+ 'lens.deltaLatest': ['最近一次', 'Latest'],
722
+ // 类型页签 +「全部」分区标题(2026-10-06 用户定:原「图片与视频」→「媒体」;英文随
723
+ // count.media 走成 Media)。钉住它是因为这一个键同时管页签与分区标题,改一处就两处变。
724
+ 'kind.media': ['媒体', 'Media'],
725
+ 'lifecycle.unread': ['未读', 'Unread'],
726
+ 'lifecycle.read': ['已读', 'Read'],
727
+ 'lifecycle.readCount': ['已读 ×{n}', 'Read ×{n}'],
728
+ 'lifecycle.readCountShort': ['×{n}', '×{n}'],
729
+ 'lifecycle.updatedAfterRead': ['读后已更新', 'Updated after read'],
730
+ 'lifecycle.rereadAfterUpdate': ['修改后已重新读取', 'Re-read after update'],
731
+ 'tierName.primary': ['主要', 'Primary'],
732
+ 'tierName.supporting': ['辅助', 'Supporting'],
733
+ 'tierName.related': ['相关', 'Related'],
734
+ }
735
+
736
+ for (const [key, [zhText, enText]] of Object.entries(expected)) {
737
+ assert.equal(zh[key], zhText, `ZH ${key}`)
738
+ assert.equal(en[key], enText, `EN ${key}`)
739
+ assert.ok(!/[\u4e00-\u9fff]/.test(en[key]), `EN ${key} 里不许出现汉字`)
740
+ }
741
+ // 四档事实状态只陈述事实:不许写成「Agent 还不知道最新版」这类推断
742
+ const stateWords = ['lifecycle.unread', 'lifecycle.read', 'lifecycle.updatedAfterRead', 'lifecycle.rereadAfterUpdate']
743
+ for (const key of stateWords) {
744
+ assert.ok(!/Agent|还不知道|旧版|没看到|忽略了/.test(zh[key]), `ZH ${key} 不许写推断`)
745
+ assert.ok(!/Agent|outdated|stale version|missed|ignored/i.test(en[key]), `EN ${key} 不许写推断`)
746
+ }
747
+ })
@@ -173,7 +173,7 @@ test('clampRatio:夹在 20%–80%,非法值回落默认', () => {
173
173
  assert.equal(clampRatio(NaN), 0.46)
174
174
  })
175
175
 
176
- test('渲染:预览高度接到 maxHeight 上,且拖拽条存在', async () => {
176
+ test('渲染:预览高度是**固定高度**(不是最高高度),且拖拽条存在', async () => {
177
177
  installFetch((url) => (url.includes('/api/doc')
178
178
  ? { ok: true, rel: '技术方案.md', title: '技术方案', text: '# T', truncated: false }
179
179
  : listPayload()))
@@ -186,7 +186,9 @@ test('渲染:预览高度接到 maxHeight 上,且拖拽条存在', async ()
186
186
 
187
187
  const panel = panelOf(after)[0]
188
188
  assert.ok(panel, '应有预览面板')
189
- assert.equal(panel.props.style.maxHeight, '46%', '默认高度应接到 maxHeight')
189
+ assert.equal(panel.props.style.height, '46%', '打开期间高度固定:加载中 / 换篇都不许再动列表的高度')
190
+ assert.equal(panel.props.style.maxHeight, undefined,
191
+ '不许走 maxHeight —— 那样高度由内容决定,正文一到列表就跟着伸缩(2026-10-04 交互审:「我一点它就跳,闪得很快」)')
190
192
  assert.equal(byClass(after, 'knit-resize').length, 1, '应有拖拽条')
191
193
  })
192
194