dsh-agent-board 1.7.8 → 1.7.9

package/test/core.test.mjs

@@ -2101,9 +2101,10 @@ test('Token 区统计范围接线：get-tasks 接 range 透传 + fetchTasks 带
   // host：get-tasks 把 args.range 透传给聚合（过滤在 host 做——run 级数据只在 host）
   assert.match(host, /aggregateUsageSummary\(d\.tasks, args && args\.range\)/)
   assert.match(host, /runs\[i\]\.usage/)                        // run 级留账（范围过滤的数据源，先于本次改动已在）
-  // client：轮询带上当前统计范围；空范围不传 field（老 host 调用形态逐字不变）
+  // client：轮询带上当前统计范围；空范围传 {} 占位（rpc 助手 args||{} 归一，host 只读 range 字段，
+  // 与老 host 调用形态等价；task-mv492for 起 {} 上再挂 ifHash 做条件请求）
   assert.match(cli, /var rgSend = activeRange\(\)/)
-  assert.match(cli, /var rpcArgs = \(rgSend\.from \|\| rgSend\.to\) \? \{ range: rgSend \} : undefined/)
+  assert.match(cli, /var rpcArgs = \(rgSend\.from \|\| rgSend\.to\) \? \{ range: rgSend \} : \{\}/)
   assert.match(cli, /rpc\('get-tasks', rpcArgs\)/)
   // 范围守卫：响应回来时范围已变则丢弃旧范围的聚合，不覆盖新范围的值
   assert.match(cli, /if \(rgKey === \(rgNow\.from \+ '~' \+ rgNow\.to\)\) state\.usageSummary = \(d && d\.usageSummary\) \|\| null/)
@@ -4226,6 +4227,49 @@ test('task_cancel GUI 按钮门禁：canCancel 三态 + 详情页按钮接线 +
   }
 })
 
+// ===== 详情面板「取消」消歧（task-mv493xjs，巡检实证 n-mv2turadjv63 误触 task_cancel）=====
+test('详情面板消歧：「取消」改名「取消任务」+ 危险操作区视觉分层 + ✕ 关闭钮（源码+产物双锁）', () => {
+  const tdsrc = readFileSync(new URL('../lib/client/task-detail.js', import.meta.url), 'utf8')
+  const built = readFileSync(new URL('../lib/client.js', import.meta.url), 'utf8')
+  // ① 新文案源码锁定：按钮标签为「取消任务」，不再出现裸「取消」按钮标签（ic('ban', 10), '取消'）
+  assert.ok(tdsrc.indexOf("ic('ban', 10), '取消任务'") >= 0, 'task-detail.js 缺「取消任务」新文案')
+  assert.ok(tdsrc.indexOf("ic('ban', 10), '取消')") < 0, 'task-detail.js 仍残留裸「取消」按钮标签')
+  // ② 视觉分层：破坏性按钮独立成区（虚线分隔 + 「危险操作」前缀 + aria-label），与表单按钮组拉开
+  assert.ok(tdsrc.indexOf("'aria-label': '危险操作'") >= 0, 'task-detail.js 缺危险操作区分组')
+  assert.ok(tdsrc.indexOf("borderTop: '1px dashed ' + C.err") >= 0, 'task-detail.js 缺危险区顶部分隔线')
+  assert.ok(tdsrc.indexOf('危险操作') >= 0, 'task-detail.js 缺「危险操作」前缀标签')
+  // ④ ✕ 关闭钮：详情头部右上显性关闭（与「← 返回看板」同行走 state.detailId = null）
+  assert.ok(tdsrc.indexOf("title: '关闭详情面板（返回看板）'") >= 0, 'task-detail.js 缺 ✕ 关闭钮')
+  // ③ 产物重组装：新文案/分层/关闭钮全部进 lib/client.js
+  for (const m of ["ic('ban', 10), '取消任务'", '危险操作', "title: '关闭详情面板（返回看板）'"]) {
+    assert.ok(built.indexOf(m) >= 0, 'client.js 缺标记：' + m)
+  }
+})
+
+// ===== GUI RPC 操作者回退（task-mv493xjs，巡检次生观察①：流转轨迹 actor 显示 unknown）=====
+// 面板 HTTP RPC 无 agent 调用栈 → getActorId() 落 'unknown'；rpcActor 回退 args 自带 sessionId。
+test('GUI RPC actor 回退：getActorId=unknown 时流转历史 actor 落会话身份（不再 unknown）', async () => {
+  const t = mkTask({ id: 'g1', status: 'pending' })
+  const board = mkBoard([t])
+  const h = mkRpcHandlers(board, { getActorId: () => 'unknown' })
+  const r = await h['cancel-task']({ taskId: 'g1', reason: 'GUI 误建' })
+  assert.equal(r.ok, true)
+  // actor 不再是 unknown，而是 rpcSessionId(args) 归一出的会话 id（测试桩=FULL_SID）
+  assert.ok(t.history.some(function (x) { return x.to === 'cancelled' && x.actor === FULL_SID }), 'history actor 未回退到会话 id')
+  assert.ok(!t.history.some(function (x) { return x.actor === 'unknown' }), 'history 仍出现 unknown actor')
+  // 正对照：有真实 initiator 时不回退（保持 actor 原值）
+  const t2 = mkTask({ id: 'g2', status: 'pending' })
+  const h2 = mkRpcHandlers(mkBoard([t2]))
+  await h2['cancel-task']({ taskId: 'g2' })
+  assert.ok(t2.history.some(function (x) { return x.to === 'cancelled' && x.actor === 'tester' }), '有 initiator 时 actor 被意外改写')
+  // 归档通道同口径（GUI 高频操作）
+  const t3 = mkTask({ id: 'g3', status: 'resolved' })
+  const h3 = mkRpcHandlers(mkBoard([t3]), { getActorId: () => 'unknown' })
+  const r3 = await h3['archive-task']({ taskId: 'g3' })
+  assert.equal(r3.ok, true)
+  assert.ok(t3.history.some(function (x) { return x.to === 'archived' && x.actor === FULL_SID }), '归档 history actor 未回退到会话 id')
+})
+
 // ===== 反馈修复（task-mux3uvx3，反馈 n-muw706h1uymy）：归档路径触发父卡收口 + task_resolve 守卫对齐 =====
 test('归档双通道触发父卡自动收口：archive-task RPC 与 task_archive 工具同一 archiveApply 口径', async () => {
   // RPC 通道：归档末子卡 → 父卡 in-progress → verifying
@@ -4304,9 +4348,10 @@ test('反馈修复接线断言：index.mjs 注入 hasActiveRun + get-tasks 附 t
   const rpcSrc = readFileSync(new URL('../lib/rpc.mjs', import.meta.url), 'utf8')
   assert.equal((rpcSrc.match(/archiveErr\(sid, t\)/g) || []).length, 3)
   // kernel：hash 短路分支存在（hash 相同跳过 tasks 赋值 + notify；老 host 无 hash 恒视为变化）
+  // task-mv492for：tasksChanged 叠加 unchanged 闸门（host 条件响应不含 tasks 时绝不清空列表）
   const ksrc = readFileSync(new URL('../lib/client/kernel.js', import.meta.url), 'utf8')
   assert.match(ksrc, /var newHash = \(d && d\.tasksHash\) \|\| ''/)
-  assert.match(ksrc, /var tasksChanged = !newHash \|\| newHash !== state\.tasksHash/)
+  assert.match(ksrc, /var tasksChanged = !unchanged && \(!newHash \|\| newHash !== state\.tasksHash\)/)
   assert.match(ksrc, /if \(tasksChanged\) \{[\s\S]*?notify\(\)/)
 })
 
@@ -4488,13 +4533,37 @@ test('isRoot 持久语义：host 侧改读 parentSession（根=无父），防
   const rpcSrc = readFileSync(new URL('../lib/rpc.mjs', import.meta.url), 'utf8')
   // isRoot 持久判定入口：根会话=无父，不再读活跃 roots() 集
   assert.match(rpcSrc, /async function isRootPersistent\(sid\)/)
-  assert.match(rpcSrc, /snap\.header\) return !snap\.header\.parentSession/)
+  // task-mv59nn9m：判据改用 delegationDepth——无父=根，或 parentSession 有值但 delegationDepth===0（fork/seed 会话）也认根
+  assert.match(rpcSrc, /return !hh\.parentSession \|\| \(typeof hh\.delegationDepth === 'number' && hh\.delegationDepth === 0\)/)
   assert.match(rpcSrc, /d\.isRoot = await isRootPersistent\(sid\)/)
   // 指针注释：防抖仍在客户端 kernel.js applyIsRoot，曾确认 true 需连续 3 次 false 才收
   assert.match(rpcSrc, /防抖仍在客户端：kernel\.js applyIsRoot/)
   assert.match(rpcSrc, /曾确认 true 的会话需连续 3 次/)
 })
 
+// ===== fork 会话认根（task-mv59nn9m，用户报障：ontology_ai「本体数据平台开发」fork 会话看板不可见）=====
+// 根因：isRootPersistent stat 主源旧判据 `!header.parentSession` 把 fork/seed 会话
+//（v3→v4 迁移产物：parentSession 有值 + delegationDepth:0 + isSeeded:true）误判非根 → isRoot:false → 看板入口消失。
+// 修法：判据改 `!h.parentSession || (typeof h.delegationDepth==='number' && h.delegationDepth===0)`；
+// delegationDepth 缺省（v3 时代老会话无此字段）且有 parentSession 时维持非根保守判定（兼容 v3 时代子代理）。
+test('isRootPersistent 判据 delegationDepth（行为级）：fork 认根 / 子代理非根 / 老形态保守 / 真根不变', async () => {
+  function mkPersistCtx(header) {
+    return { get: function (name) { if (name === 'sessionPersistence') return { stat: async function () { return { header: header } } }; return undefined } }
+  }
+  // ① fork/seed 头（parentSession 有 + delegationDepth 0）→ 根（本卡修复目标）
+  const h1 = mkRpcHandlers(mkBoard([]), null, mkPersistCtx({ parentSession: 'session-parent', delegationDepth: 0 }))
+  assert.equal((await h1['get-tasks']({})).isRoot, true)
+  // ② 真子代理头（parentSession 有 + delegationDepth 1）→ 非根
+  const h2 = mkRpcHandlers(mkBoard([]), null, mkPersistCtx({ parentSession: 'session-parent', delegationDepth: 1 }))
+  assert.equal((await h2['get-tasks']({})).isRoot, false)
+  // ③ 老形态头（parentSession 有 + delegationDepth 缺省，v3 时代会话）→ 非根（保守判定不放行）
+  const h3 = mkRpcHandlers(mkBoard([]), null, mkPersistCtx({ parentSession: 'session-parent' }))
+  assert.equal((await h3['get-tasks']({})).isRoot, false)
+  // ④ 真根（无 parentSession）→ 根
+  const h4 = mkRpcHandlers(mkBoard([]), null, mkPersistCtx({}))
+  assert.equal((await h4['get-tasks']({})).isRoot, true)
+})
+
 // ===== 史诗 hooks UI（task-muuw56yf）：卡片相位徽章 + 详情页 hooks 编辑区 =====
 // 依赖卡 task-muuw4ov7 落地的真实字段契约（本文件上方 hooks 测试段即其口径）：
 //   epic.hooks = { pre: { enabled, prompt, state, runId, pending? }, post: 同构 }；state ∈ idle|running|done|failed；
@@ -5092,6 +5161,82 @@ test('卡3②③：重启 reconcile——存活的续跑 Worker 被找回重挂
   assert.equal(h.runs['k1'], before)
 })
 
+// ===== 僵尸 run 留档清扫（task-mv22z61v）：落定卡 running 无 endedAt 留档关账 + 清卡面认领位 =====
+test('僵尸 run 留档清扫：落定卡 running 无 endedAt 留档被关账+清位；在飞卡/活跃 rec 不扫；二次运行零改动', async () => {
+  const nowIso = new Date().toISOString()
+  // ① 僵尸 verifier 留档：resolved 卡 + verifierRun 残留指向死会话 + runs[] 里 verifier:running 无 endedAt
+  const zv = mkTask({ id: 'zv', title: '僵尸 verifier 卡', status: 'resolved', verifierRun: 'v-dead', verifierRunAt: '2026-01-01T00:00:00Z',
+    runs: [{ role: 'verifier', id: 'v-dead', at: '2026-01-01T00:00:00Z', model: '', outcome: 'running' }] })
+  // ② 僵尸 worker 留档：cancelled 卡 + claimedBy 残留指向死会话
+  const zw = mkTask({ id: 'zw', title: '僵尸 worker 卡', status: 'cancelled', claimedBy: 'w-dead', claimedAt: '2026-01-01T00:00:00Z',
+    runs: [{ role: 'worker', id: 'w-dead', at: '2026-01-01T00:00:00Z', model: '', outcome: 'running' }] })
+  // ③ 已关账留档：outcome 已落定 + endedAt，非 running 条目不该被碰（不误扫非 running 留档）
+  const zc = mkTask({ id: 'zc', title: '已关账卡', status: 'resolved',
+    runs: [{ role: 'worker', id: 'w-ok', at: '2026-01-01T00:00:00Z', model: '', outcome: 'completed', endedAt: '2026-01-01T00:05:00Z' }] })
+  // ④ 在飞卡（in-progress）：running 留档是 reconcile/结算通道辖区，绝不误扫（断言②）
+  const inflight = mkTask({ id: 'fly', title: '在飞卡', status: 'in-progress', claimedBy: 'w-alive', claimedAt: nowIso,
+    runs: [{ role: 'worker', id: 'w-alive', at: nowIso, model: '', outcome: 'running', continuable: true }] })
+  // ⑤ 在飞卡（verifying）+ 活跃 rec：双重护栏——status 非落定 + 内存活跃表里还活着，都该跳过（断言② + 无活跃 rec 才扫）
+  const vfy = mkTask({ id: 'vfy', title: '验收中卡', status: 'verifying', verifierRun: 'v-alive', verifierRunAt: nowIso,
+    runs: [{ role: 'verifier', id: 'v-alive', at: nowIso, model: '', outcome: 'running' }] })
+  const board = mkBoard([zv, zw, zc, inflight, vfy])
+  const h = mkUsageDispatch(board)
+  h.runs['vfy'] = { id: 'v-alive', role: 'verifier', taskId: 'vfy', startedAt: Date.now(), model: '', settled: false }
+  await h.dispatch.poolCycle(FULL_SID)
+  // ① 僵尸 verifier 留档：关账（stale-closed + endedAt + note）+ 清 verifierRun 位 + 留一行 history
+  assert.equal(zv.runs[0].outcome, 'stale-closed')
+  assert.ok(zv.runs[0].endedAt, '僵尸 verifier 留档要带 endedAt')
+  assert.equal(zv.runs[0].note, 'host 重启僵尸留档清扫')
+  assert.equal(zv.verifierRun, null)
+  assert.equal('verifierRunAt' in zv, false)
+  assert.equal(zv.history.filter(function (x) { return /僵尸 run 留档已关账/.test(x.note || '') }).length, 1)
+  // ② 僵尸 worker 留档：关账 + 清 claimedBy 位
+  assert.equal(zw.runs[0].outcome, 'stale-closed')
+  assert.ok(zw.runs[0].endedAt)
+  assert.equal(zw.runs[0].note, 'host 重启僵尸留档清扫')
+  assert.equal(zw.claimedBy, null)
+  assert.equal(zw.claimedAt, null)
+  // ③ 已关账留档零改动
+  assert.equal(zc.runs[0].outcome, 'completed')
+  assert.equal(zc.runs[0].endedAt, '2026-01-01T00:05:00Z')
+  assert.equal(zc.runs[0].note, undefined)
+  // ④⑤ 在飞卡 running 留档零改动（断言②：in-progress/verifying 都不扫）
+  assert.equal(inflight.runs[0].outcome, 'running')
+  assert.equal(inflight.runs[0].endedAt, undefined)
+  assert.equal(inflight.claimedBy, 'w-alive')
+  assert.equal(vfy.runs[0].outcome, 'running')
+  assert.equal(vfy.runs[0].endedAt, undefined)
+  assert.equal(vfy.verifierRun, 'v-alive')
+  // ⑤ 幂等：二次运行零改动（关账后 outcome!=running，不再新增 history 行 / 不再刷新 endedAt）
+  const zvEndedAt = zv.runs[0].endedAt
+  const zwEndedAt = zw.runs[0].endedAt
+  const zvHistoryLen = zv.history.length
+  const zwHistoryLen = zw.history.length
+  await h.dispatch.poolCycle(FULL_SID)
+  assert.equal(zv.runs[0].outcome, 'stale-closed')
+  assert.equal(zv.runs[0].endedAt, zvEndedAt)
+  assert.equal(zv.history.length, zvHistoryLen)
+  assert.equal(zw.runs[0].outcome, 'stale-closed')
+  assert.equal(zw.runs[0].endedAt, zwEndedAt)
+  assert.equal(zw.history.length, zwHistoryLen)
+})
+
+test('僵尸 run 留档清扫接线（源码级）：sweepZombieRuns 定义 + poolCycle 挂点 + 只清扫落定卡门禁', () => {
+  const dsp = readFileSync(new URL('../lib/dispatch.mjs', import.meta.url), 'utf8')
+  // ① 清扫函数定义（含「只对落定卡做」状态门禁与「无活跃 rec 才扫」护栏）
+  assert.match(dsp, /async function sweepZombieRuns\(sid, snap\) \{/)
+  assert.match(dsp, /if \(t\.status !== 'resolved' && t\.status !== 'cancelled' && t\.status !== 'archived'\) return/)
+  assert.match(dsp, /if \(rec && !rec\.settled && String\(rec\.id\) === rid\) return/)
+  assert.match(dsp, /r\.outcome = 'stale-closed'/)
+  assert.match(dsp, /r\.endedAt = new Date\(\)\.toISOString\(\)/)
+  assert.match(dsp, /r\.note = 'host 重启僵尸留档清扫'/)
+  assert.match(dsp, /if \(t\.verifierRun === rid\) \{ t\.verifierRun = null; delete t\.verifierRunAt \}/)
+  assert.match(dsp, /if \(t\.claimedBy === rid\) \{ t\.claimedBy = null; t\.claimedAt = null \}/)
+  assert.match(dsp, /return any \? d : null/) // 无改动不写盘（安静板不因清扫产生心跳写盘）
+  // ② poolCycle 挂点：reconcile 之后、幽灵回收之前（落定卡僵尸留档 reconcile/reap 都管不到，须在空闲快进前兜到）
+  assert.match(dsp, /try \{ await sweepZombieRuns\(sid, snap\) \} catch \(e\) \{ console\.error\('\[task-board\] 僵尸留档清扫失败:/)
+})
+
 test('卡2/卡3 接线（源码级）：usage 水位线落卡 + reconcile 一次性 + 详情页 ↻ 续跑标注 + 文档收尾', () => {
   const dsp = readFileSync(new URL('../lib/dispatch.mjs', import.meta.url), 'utf8')
   const usageSrc = readFileSync(new URL('../lib/usage.mjs', import.meta.url), 'utf8')
@@ -5250,8 +5395,9 @@ test('fetchTasks 设置开关权威纠偏：hash 不变时配置变化补 notify
   const iNotify = src.indexOf('if (cfgDelta || usageDelta) notify()')
   const iEsc = src.indexOf('if (tasksChanged) {\n          var newEsc')
   assert.ok(iDelta < iNotify && iEsc > iNotify, '补 notify 必须在配置赋值之后、escalation 分支之前')
-  // ④ 既有渲染节约（tasksHash 短路）逐字保持——本次只加不删
-  assert.match(src, /var tasksChanged = !newHash \|\| newHash !== state\.tasksHash/)
+  // ④ 既有渲染节约（tasksHash 短路）结构保持——task-mv492for 起 tasksChanged 叠加 unchanged 闸门
+  // （host 条件响应 unchanged:true 不含 tasks 全量时保留 state.tasks），hash 比对短路语义不变
+  assert.match(src, /var tasksChanged = !unchanged && \(!newHash \|\| newHash !== state\.tasksHash\)/)
   assert.match(src, /if \(tasksChanged\) \{\s*\n\s*state\.tasksHash = newHash\s*\n\s*state\.tasks = \(d && d\.tasks\) \|\| \[\]\s*\n\s*\}/)
   // ⑤ 产物接线：client.js 为拼装产物，真源改动必须已重建（产物与源一致由 build-client --check 兜底）
   const cli = readFileSync(new URL('../lib/client.js', import.meta.url), 'utf8')

package/test/helpers/mock-ctx.mjs

@@ -10,7 +10,8 @@
 //   · subagents.startContinuable({...})         → { childId, messageId }（持久子会话，turn 结算走 emitStatus）
 //   · subagents.sendMessage / interrupt / listChildren → 记录器 + 可剧本化
 //   · agents.currentInitiator()/roots()/list()/get()/isOwnedBy() → 按测试剧本返回（缺省单 root，actor=root；env.setRoots 可清空模拟休眠）
-//   · ctx.get('sessionPersistence')             → 持久会话表 stat(id)（env.persistedHeaders 可写 parentSession 模拟子会话/根会话）
+//   · ctx.get('sessionPersistence')             → 持久会话表 stat(id)（env.persistedHeaders 可写 parentSession 模拟子会话/根会话；
+//                                                 env.persistedSizes[id]=N 可让快照带 sizeBytes——cleanup 体积主源断言用）
 //   · tools.register / webServer.register       → 捕获工具表与 RPC 路由（env.rpc 走真 readBody/handler 路径）
 //   · ctx.get('systemPrompt'|'llm')             → 记录器（注册了什么段/查了什么模型都留痕）
 //   · ctx.effect / ctx.on('agent/status')       → 真实执行 + disposer 收口 / 事件捕获与重放
@@ -51,6 +52,7 @@ import { Readable } from 'node:stream'
  * @property {string} actor          currentInitiator 返回值（缺省=root sid；测试可改写模拟子代理身份）
  * @property {(list:Object[])=>void} setRoots  改写活跃 root 集（传 [] 模拟休眠根会话/重建窗口）
  * @property {Object} persistedHeaders  持久会话表 sid → { id, parentSession }（写 parentSession 模拟子会话；缺省根会话 parentSession=undefined）
+ * @property {Object} persistedSizes    快照体积表 sid → sizeBytes 数字（cleanup 体积主源断言用；缺省=快照无 sizeBytes → 目录遍历回退）
  * @property {()=>Object} board      读当前看板文件 JSON（不存在返回 null）
  * @property {(id:string)=>Object|undefined} task  看板里按 id 取任务
  * @property {(fn:Function, label?:string, timeoutMs?:number)=>Promise<any>} waitFor  真实时间轮询直到条件为真（默认 5s 上限）
@@ -194,6 +196,7 @@ export function createMockCtx(opts) {
   var rootsList = [root] // 活跃 root 集（测试可 env.setRoots([]) 清空模拟「休眠根会话」）
   var persistedHeaders = {} // 持久会话表 sid → SessionHeader（测试可写 parentSession 模拟子会话/根会话）
   persistedHeaders[sid] = { id: sid, parentSession: undefined }
+  var persistedSizes = {} // 快照体积表 sid → sizeBytes（task-mv39ag1e：cleanup 体积主源断言用；缺省=快照无 sizeBytes，走目录遍历回退）
   var agents = {
     currentInitiator: function () { return { id: env.actor } },
     roots: function () { return rootsList },
@@ -237,7 +240,8 @@ export function createMockCtx(opts) {
       }
       if (name === 'sessionPersistence') {
         return {
-          stat: async function (id) { var h = persistedHeaders[id]; return h ? { header: h } : undefined },
+          // 快照形态对齐官方 SessionPersistenceSnapshot：sizeBytes 仅当后端能廉价提供时才带（未登记=缺省字段）
+          stat: async function (id) { var h = persistedHeaders[id]; if (!h) return undefined; var snap = { header: h }; if (typeof persistedSizes[id] === 'number') snap.sizeBytes = persistedSizes[id]; return snap },
         }
       }
       return undefined
@@ -274,6 +278,7 @@ export function createMockCtx(opts) {
     actor: sid,
     setRoots: function (list) { rootsList = list || [] }, // 清空/改写活跃 root 集（模拟休眠/重建窗口）
     persistedHeaders: persistedHeaders, // 持久会话表（sid → { id, parentSession }）；写 parentSession 模拟子会话
+    persistedSizes: persistedSizes, // 快照体积表（sid → sizeBytes 数字）；cleanup 体积主源断言用
 
     // 以真 RPC 语义调用捕获的 webServer 路由（POST /dsh-agent-board → readBody → handlers[method]）
     rpc: async function (method, args) {

package/test/ui-zoom-client.test.mjs

@@ -0,0 +1,76 @@
+// dsh-agent-board — 界面缩放档位 client 侧单测（test/ui-zoom-client.test.mjs，task-mv58e01j）
+// 背景：用户 2026-10-12 反馈「字体整体偏小」；面板 ~317 处内联 fontSize px 写死，逐处改不值 →
+// 定稿方案=面板根容器 CSS zoom 等比缩放（Chromium 支持，字体/图标/间距一并放大，只影响本面板）。
+// client 无渲染 harness（react 不在包依赖，渲染由 dsh web 客户端运行时注入）——与历卡同一纪律：
+// 全部走源码级断言（kernel.js / dashboard.js 模块源 + client.js 重组装产物 + README 双份同步）。
+//   ① 状态与持久化——state.uiZoom（localStorage 键 dsh-agent-board-ui-zoom，白名单五档，脏值/异常回退 1）
+//   ② 根容器接线——TopPanel 顶层 div style 挂 zoom: uiZoom（订阅值，notify 即时生效）
+//   ③ 设置弹层档位——⚙ 弹层「界面」小节 ZoomCfg 下拉：90/100/110/125/150%，选中即 setItem+state+notify
+//   ④ 弹层坐标补偿——zoom 子树内 fixed 弹层 top/right/maxH 除以档位还原 CSS px（仍贴按钮、不溢出视口）
+//   ⑤ README 双份——根/包逐字一致 + 看板 UI 区补「界面缩放」说明行
+//   ⑥ 产物重组装——关键标记逐一出现在 lib/client.js（需 npm run build-client）
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+
+const kernel = readFileSync(new URL('../lib/client/kernel.js', import.meta.url), 'utf8')
+const dash = readFileSync(new URL('../lib/client/dashboard.js', import.meta.url), 'utf8')
+const built = readFileSync(new URL('../lib/client.js', import.meta.url), 'utf8')
+
+// ===== ① 状态与持久化（kernel state + localStorage 读取，缺省 1，白名单校验）=====
+test('①状态：UI_ZOOM_KEY/UI_ZOOM_LEVELS 常量 + readUiZoom 白名单回退 + state.uiZoom 初始化', () => {
+  assert.ok(kernel.indexOf("var UI_ZOOM_KEY = 'dsh-agent-board-ui-zoom'") >= 0, '缺 localStorage 键常量')
+  assert.match(kernel, /var UI_ZOOM_LEVELS = \[0\.9, 1, 1\.1, 1\.25, 1\.5\]/, '缺五档白名单（90/100/110/125/150%）')
+  // 读取：parseFloat + 白名单命中才采纳，脏值/异常一律回退 1
+  assert.match(kernel, /function readUiZoom\(\) \{ try \{ var v = parseFloat\(localStorage\.getItem\(UI_ZOOM_KEY\)\); return UI_ZOOM_LEVELS\.indexOf\(v\) >= 0 \? v : 1 \} catch \(_\) \{ return 1 \} \}/)
+  // state 字段初始化（读 localStorage，不开口在 host）
+  assert.match(kernel, /verifyUserGuide: true, uiZoom: readUiZoom\(\)/)
+})
+
+// ===== ② 根容器接线（TopPanel 顶层 div style.zoom + 订阅链）=====
+test('②接线：TopPanel 订阅 uiZoom（useState + update 链）+ 根容器 style 挂 zoom', () => {
+  // 订阅：useState 初值读 state.uiZoom，update 链里 setUiZoom(state.uiZoom)（notify 即时生效的渲染通路）
+  assert.match(kernel, /useState\(state\.uiZoom\), uiZoom = _uzm\[0\], setUiZoom = _uzm\[1\]/)
+  assert.match(kernel, /setCrd\(state\.cleanupRetentionDays\); setUiZoom\(state\.uiZoom\)/)
+  // 根容器（面板顶层 fixed div）style 挂 zoom——只此一行接管全面板缩放，不动任何既有 fontSize
+  assert.match(kernel, /zIndex: 900, zoom: uiZoom, background: C\.bg/)
+})
+
+// ===== ③ 设置弹层档位（⚙ 弹层「界面」小节 ZoomCfg 下拉，选中即持久化+生效）=====
+test('③档位：ZoomCfg 下拉五档 + 选中即 localStorage.setItem + state.uiZoom + notify + 弹层「界面」小节挂载', () => {
+  assert.match(dash, /function ZoomCfg\(\)/, '缺 ZoomCfg 组件')
+  // 五档选项由白名单渲染，默认档标注
+  assert.match(dash, /UI_ZOOM_LEVELS\.map\(function \(z\) \{ return React\.createElement\('option', \{ key: String\(z\), value: String\(z\) \}, Math\.round\(z \* 100\) \+ '%' \+ \(z === 1 \? '（默认）' : ''\)\) \}/)
+  // 选中口径：非法档位不采纳 → 写 state → localStorage 持久化 → notify 即时生效
+  assert.match(dash, /if \(UI_ZOOM_LEVELS\.indexOf\(n\) < 0\) return/)
+  assert.match(dash, /state\.uiZoom = n/)
+  assert.match(dash, /localStorage\.setItem\(UI_ZOOM_KEY, String\(n\)\)/)
+  // 弹层「界面」小节挂载 ZoomCfg（存储清理之后、弹层收尾之前）
+  assert.match(dash, /'界面'\),\s*React\.createElement\('div', \{ style: \{ display: 'flex', gap: 8, alignItems: 'center' \} \},\s*React\.createElement\(ZoomCfg, null\)/)
+  assert.ok(dash.indexOf('界面缩放') >= 0, '弹层缺「界面缩放」标签')
+})
+
+// ===== ④ 弹层坐标补偿（zoom 子树内 fixed 弹层的 top/right/maxH 还原）=====
+test('④补偿：⚙ 弹层定位除以缩放档位（getBoundingClientRect 可视坐标 → CSS px），zoom=1 时与旧行为一致', () => {
+  assert.match(dash, /var z = state\.uiZoom \|\| 1/)
+  assert.match(dash, /setPos\(\{ top: \(r\.bottom \+ 4\) \/ z, right: Math\.max\(8, window\.innerWidth - r\.right\) \/ z, maxH: Math\.max\(140, \(window\.innerHeight - r\.bottom - 16\) \/ z\) \}\)/)
+  // maxHeight 改读补偿后的 pos.maxH（不再用未补偿的 calc(100vh - ...)）
+  assert.match(dash, /maxHeight: \(pos\.maxH \|\| 300\) \+ 'px'/)
+})
+
+// ===== ⑤ README 双份 =====
+test('⑤README 双份：根/包逐字一致 + 看板 UI 区补「界面缩放」说明行（档位/键名/即时生效）', () => {
+  const r1 = readFileSync(new URL('../../../README.md', import.meta.url), 'utf8')
+  const r2 = readFileSync(new URL('../README.md', import.meta.url), 'utf8')
+  assert.equal(r1, r2, 'README 双份必须逐字一致（npm run sync-readme）')
+  assert.ok(r1.indexOf('界面缩放') >= 0, 'README 缺「界面缩放」说明行')
+  assert.ok(r1.indexOf('dsh-agent-board-ui-zoom') >= 0, 'README 说明行缺 localStorage 键名')
+  assert.ok(r1.indexOf('90% / 100%（默认）/ 110% / 125% / 150%') >= 0, 'README 说明行缺五档清单')
+})
+
+// ===== ⑥ 产物重组装 =====
+test('⑥产物：模块源关键标记逐一出现在 lib/client.js（需 npm run build-client 重组装）', () => {
+  for (const m of ['dsh-agent-board-ui-zoom', 'UI_ZOOM_LEVELS', 'readUiZoom', 'zoom: uiZoom', 'ZoomCfg', '界面缩放']) {
+    assert.ok(built.indexOf(m) >= 0, 'client.js 缺标记：' + m + '（需 npm run build-client 重组装）')
+  }
+})