agentworkshop 0.7.66 → 0.7.71

package/scripts/eda-demo-report-patch.mjs

@@ -0,0 +1,47 @@
+/**
+ * 演示报告数字同步器:从最终 demo-evidence.json 回写报告的易变数字
+ * (脚本每次重跑数字都会变;手抄必然漂移 —— 审查员第三轮意见)。
+ * 运行:node scripts/eda-demo-report-patch.mjs
+ */
+import { readFileSync, writeFileSync } from 'node:fs'
+import { join, resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const EVID = join(REPO, 'docs', 'audit', 'evidence', '2026-10-21-eda-demo', 'demo-evidence.json')
+const REPORT = join(REPO, 'docs', 'audit', '2026-10-21-eda-demo-report.md')
+
+const ev = JSON.parse(readFileSync(EVID, 'utf8'))
+const g = id => ev.results.find(r => r.id === id) ?? {}
+const num = (id, re, fallback = '-') => String(g(id).detail?.match(re)?.[1] ?? fallback)
+
+const pts21 = num('D2.1', /pts=([\d,]+)/)
+const pts23 = num('D2.3', /pts=(\d+)/)
+const band24 = num('D2.4', /band=(\d+)/)
+const rows31 = num('D3.1', /rows=(\d+)/)
+const spcN = num('D4.4', /n=(\d+)/)
+const goldenBins = num('D4.5', /bins=(\d+)/)
+const d11 = num('D1.1', /points=(\d+)/)
+const samples41 = num('D4.1', /samples=(\d+)/)
+
+let md = readFileSync(REPORT, 'utf8')
+// §3 复合查询表:①两序列点数 ③配方过滤点数 ④包络桶数(容许多次替换遗留的双空格/反引号差异)
+md = md.replace(/(\| ① [^|]+\|\s*`[^`]+`\s*\| )\s*2 序列 [\d,/]+ 点 ✓ \|/, `$1 2 序列 ${pts21.split(',').join('/')} 点 ✓ |`)
+md = md.replace(/(\| ③ \+配方打标\s*\| `\+ recipe_id`\s*\| )\s*\d+ 点 ✓ \|/, `$1 ${pts23} 点 ✓ |`)
+md = md.replace(/(\| ④ \+min\/max 包络\s*\| `\+ include_band=1`\s*\| )\s*band \d+ ✓ \|/, `$1 band ${band24} ✓ |`)
+// §1 采集活性
+md = md.replace(/停\/开线后标量镜像采样活性探针 \d+ 点/, `停/开线后标量镜像采样活性探针 ${d11} 点`)
+// §4 导出行数(不含表头);反引号在早前替换中可能已丢失,两种形态都匹配
+md = md.replace(/`?ready`?，\d+ 行（不含表头）/, `ready，${rows31} 行（不含表头）`)
+// §5 SPC n + 关账批样本数
+md = md.replace(/SPC 控制图注册 \+ 重算（n=\d+，/, `SPC 控制图注册 + 重算（n=${spcN}，`)
+md = md.replace(/关账批（\d+ 样本）/, `关账批（${samples41} 样本）`)
+// §7 断言明细
+md = md.replace(/D4\.1 台账回填\(\d+\)/, `D4.1 台账回填(${samples41})`)
+md = md.replace(/D4\.4 SPC 重算\(n=\d+\)/, `D4.4 SPC 重算(n=${spcN})`)
+md = md.replace(/D4\.5 golden \d+ 桶/, `D4.5 golden ${goldenBins} 桶`)
+// §8 边界:SPC 冷启动数字从 spcN 注入(消除手抄遗留)
+md = md.replace(/SPC 处于冷启动（n=\d+ < 25，/, `SPC 处于冷启动（n=${spcN} < 25，`)
+
+writeFileSync(REPORT, md)
+console.log(`报告已同步最终证据数字: pts=${pts21} recipe=${pts23} band=${band24} rows=${rows31} spcN=${spcN} golden=${goldenBins}`)

package/scripts/eda-live-demo.mjs

@@ -0,0 +1,398 @@
+/**
+ * EDA 数据层全功能实机演示(US-101~105):
+ *  ① 节点连接与镜像采集:五协议 running;scalar/vector/image 三形态;外部 ingest 推送
+ *     48 点数组帧 + base64 图像帧入库;帧数随时间增长(实时镜像活性)。
+ *  ② 多字段复合查询 ×4:线+节点+窗+桶+agg / +run_id / +recipe_id / min-max 包络。
+ *  ③ 导出:REST merge 宽表 + daq_export 工具帧导出(向量长表 CSV + 图像原文件);run 打标抽样核验。
+ *  ④ EDA 分析:关账→特征仓库;SPC 注册+重算;golden 生成;分析报告(S7 由 setup 覆盖)。
+ *  ⑤ UI 截图:/data、/daq 标量实时、/daq 数组帧、/daq 图像帧、/studio、/studio/board。
+ *
+ * 运行:node scripts/eda-live-demo.mjs <scenario-context.json>
+ * 产物:docs/audit/evidence/2026-10-21-eda-demo/(PNG + demo-evidence.json)
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs'
+import { join, resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const CTX = process.argv[2]
+if (!CTX) {
+  console.error('用法: node scripts/eda-live-demo.mjs <scenario-context.json>')
+  process.exit(1)
+}
+const c = JSON.parse(readFileSync(CTX, 'utf8'))
+const EVID = join(REPO, 'docs', 'audit', 'evidence', '2026-10-21-eda-demo')
+mkdirSync(EVID, { recursive: true })
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const results = []
+function ok(id, name, cond, detail = '') {
+  results.push({ id, name, pass: Boolean(cond), detail: String(detail).slice(0, 400) })
+  console.log(`${cond ? '✔' : '✖'} [${id}] ${name}${detail ? ` — ${String(detail).slice(0, 180)}` : ''}`)
+}
+async function api(method, path, body, token = c.adminToken) {
+  const r = await fetch(c.base + path, {
+    method,
+    headers: { ...(body !== undefined ? { 'content-type': 'application/json' } : {}), ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(120_000),
+  })
+  return { status: r.status, data: (await r.json().catch(() => ({})))?.data }
+}
+async function invoke(agent, tool, args, timeoutMs = 240_000) {
+  const r = await fetch(c.base + '/api/workshop/agent-tools/invoke', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', 'x-aw-agent-token': agent.token },
+    body: JSON.stringify({ agentId: agent.id, tool, args }),
+    signal: AbortSignal.timeout(timeoutMs),
+  })
+  const j = await r.json().catch(() => null)
+  return { status: r.status, isError: Boolean(j?.data?.result?.isError), text: String(j?.data?.result?.text ?? '') }
+}
+
+async function main() {
+  console.log(`━━━ EDA 数据层实机演示 @ ${c.base} line=${c.lineId} ━━━`)
+  const daq = (await api('GET', '/api/workshop/daq'))?.data
+  const nodes = daq?.nodes ?? []
+  const scalarNodes = nodes.filter(n => n.enabled && !/profile|image|scan|ccd/i.test(n.name))
+  const scalarNode = scalarNodes[0]
+  const scalarNode2 = scalarNodes[1] ?? scalarNode
+
+  // ── ⓪ 异构帧节点(外部推送型):膜厚断面(thickness-scan 向量)+ CCD 图像 ──
+  // 注塑线原生节点为标量模板;数组/图像数据按设计由外部系统经 ingest 推送入库(mes-agent G6 同款)
+  const tag = Date.now().toString(36).slice(-4)
+  const mk = async body => (await api('POST', '/api/workshop/daq', body)).data?.node
+  const vectorNode = await mk({ name: `EDA演示-膜厚断面-${tag}`, templateRef: 'thickness-scan', driver: 'mock', lineId: c.lineId, intervalMs: 60000, enabled: true })
+  const imageNode = await mk({ name: `EDA演示-CCD图像-${tag}`, templateRef: 'ccd-image', driver: 'mock', lineId: c.lineId, intervalMs: 60000, enabled: true })
+  ok('D0.1', '三形态节点在位(scalar/vector/image)', Boolean(scalarNode && vectorNode && imageNode),
+    `scalar=${scalarNode?.id} vector=${vectorNode?.id}(${vectorNode?.name}) image=${imageNode?.id}(${imageNode?.name})`)
+
+  // ── ① 节点连接与镜像采集 ──
+  await api('POST', `/api/workshop/dcw/lines/${c.lineId}/stop`)
+  await sleep(1200)
+  const st = await api('POST', `/api/workshop/dcw/lines/${c.lineId}/start`, { recipeId: c.recipeId })
+  let liveSamples = 0
+  if (st.status === 200) {
+    for (let i = 0; i < 15; i++) {
+      await sleep(2000)
+      const s = await api('GET', `/api/workshop/daq/${scalarNode.id}/samples?from=${Date.now() - 60_000}&to=${Date.now()}&bucketMs=1000&limit=50`)
+      liveSamples = (s.data?.points ?? []).length
+      if (liveSamples >= 3) break
+    }
+  }
+  ok('D1.1', '开线后标量镜像采集活性(≥3 点)', liveSamples >= 3, `points=${liveSamples}`)
+
+  // 帧实时镜像活性:外部系统按节拍推送(膜厚断面 48 点/CCD 帧),入库即广播
+  const pushVec = async marker => api('POST', `/api/workshop/daq/${vectorNode.id}/ingest`, {
+    points: Array.from({ length: 48 }, (_, i) => Number((30 + Math.sin(i / 6) * 1.5).toFixed(3))),
+    metrics: { source: 'external-demo', marker },
+  })
+  const pushImg = async marker => api('POST', `/api/workshop/daq/${imageNode.id}/ingest`, {
+    image: { base64: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==', mime: 'image/png', width: 1, height: 1 },
+    metrics: { source: 'external-demo', marker },
+  })
+  const framesOf = async (nodeId) => {
+    const r = await api('GET', `/api/workshop/daq/${nodeId}/frames?from=${Date.now() - 600_000}&to=${Date.now()}&limit=200`)
+    return (r.data?.frames ?? []).length
+  }
+  const ing1 = await pushVec('p1')
+  const ing2 = await pushImg('p1')
+  let v1 = await framesOf(vectorNode.id)
+  let i1 = await framesOf(imageNode.id)
+  await sleep(4000)
+  await pushVec('p2')
+  await pushImg('p2')
+  await sleep(2500)
+  const v2 = await framesOf(vectorNode.id)
+  const i2 = await framesOf(imageNode.id)
+  ok('D1.2', '数组帧实时镜像活性(推送驱动的持续入库)', ing1.status === 200 && v2 > v1, `${v1}→${v2}`)
+  ok('D1.3', '图像帧实时镜像活性(推送驱动的持续入库)', ing2.status === 200 && i2 > i1, `${i1}→${i2}`)
+
+  // 外部异构推送入库:48 点数组(膜厚断面)+ base64 图像
+  ok('D1.4', '外部推送 48 点数组帧入库', ing1.status === 200, JSON.stringify(ing1.data ?? ing1).slice(0, 120))
+  ok('D1.5', '外部推送图像帧入库', ing2.status === 200, JSON.stringify(ing2.data ?? ing2).slice(0, 120))
+  await sleep(2500)
+  const vFrames = (await api('GET', `/api/workshop/daq/${vectorNode.id}/frames?from=${Date.now() - 600_000}&to=${Date.now()}&limit=200`)).data?.frames ?? []
+  // 外部推送帧识别:48 点断面(mock 采样器自发帧为 64 点);ingest 会以派生统计覆写自定义 metrics
+  const pushed = vFrames.find(f => Array.isArray(f.points) && f.points.length === 48)
+  ok('D1.6', '推送的 48 点数组可查回(与 64 点自发帧可区分)', Boolean(pushed),
+    pushed ? `points=48 at=${pushed.at} totalFrames=${vFrames.length}` : `frames=${vFrames.length}`)
+
+  // ── ② 多字段复合查询 ×4(标量序列;数组/图像走帧面) ──
+  const run = (await api('GET', `/api/workshop/eda/runs?line_id=${c.lineId}`)).data?.runs?.find(r => r.outcome === 'open')
+  const now = Date.now()
+  const q1 = await api('GET', `/api/workshop/daq/query?line_id=${c.lineId}&node_ids=${scalarNode.id},${scalarNode2.id}&from=${now - 300_000}&to=${now}&bucket_ms=2000&agg=avg`)
+  ok('D2.1', '复合①线+节点+窗+桶+agg', q1.status === 200 && q1.data?.series?.length === 2 && q1.data.series.every(s => s.points.length > 0),
+    `series=${q1.data?.series?.length} pts=${q1.data?.series?.map(s => s.points.length).join(',')}`)
+  const q2 = run ? await api('GET', `/api/workshop/daq/query?node_ids=${scalarNode.id}&from=${now - 600_000}&to=${now}&bucket_ms=2000&run_id=${run.id}`) : { status: 404 }
+  ok('D2.2', `复合②+run_id 打标过滤(${run?.id?.slice(0, 10) ?? '-'})`, run ? q2.status === 200 : true, `pts=${q2.data?.series?.[0]?.points?.length ?? 0}`)
+  const q3 = await api('GET', `/api/workshop/daq/query?node_ids=${scalarNode.id}&from=${now - 600_000}&to=${now}&bucket_ms=2000&recipe_id=${c.recipeId}`)
+  ok('D2.3', `复合③+recipe_id 过滤`, q3.status === 200, `pts=${q3.data?.series?.[0]?.points?.length ?? 0}`)
+  const q4 = await api('GET', `/api/workshop/daq/query?node_ids=${scalarNode.id}&from=${now - 300_000}&to=${now}&bucket_ms=2000&agg=avg&include_band=1`)
+  ok('D2.4', '复合④min/max 包络(include_band)', q4.status === 200 && Array.isArray(q4.data?.series?.[0]?.band) && q4.data.series[0].band.length > 0,
+    `band=${q4.data?.series?.[0]?.band?.length}`)
+
+  // ── ③ 导出 ──
+  const ex = await api('POST', '/api/workshop/daq/export', {
+    node_ids: [scalarNode.id, vectorNode.id], last_minutes: 10, merge: true, title: 'EDA 演示导出',
+  })
+  let job = null
+  for (let i = 0; i < 60 && job?.status !== 'ready' && job?.status !== 'failed'; i++) {
+    await sleep(2000)
+    job = (await api('GET', `/api/workshop/daq/export/${ex.data?.job?.id}`)).data?.job
+  }
+  ok('D3.1', 'REST merge 导出 ready 且 manifest/nodes 落盘', job?.status === 'ready' && (job?.result?.totalRows ?? 0) > 0,
+    `rows=${job?.result?.totalRows} files=${job?.result?.files?.length} merged=${Boolean(job?.result?.mergedFile)}`)
+
+  // 帧导出(daq_export 工具:向量长表 CSV + 图像原文件)
+  const analyst = c.agents?.analyst
+  if (analyst?.token) {
+    for (const nodeId of [vectorNode.id, imageNode.id]) {
+      await api('POST', '/api/workshop/agent-tools/bindings', { agentId: analyst.id, nodeId, kind: 'daq', mode: 'auto' })
+    }
+    const fex = await invoke(analyst, 'daq_export', { node_ids: [vectorNode.id, imageNode.id], last_minutes: 15, title: 'EDA 演示帧导出' })
+    const dir = fex.text.match(/目录: (.+)/)?.[1]?.trim()
+    const vectorCsv = dir ? existsSync(join(dir, 'frames', `${vectorNode.id}.csv`)) : false
+    const imageDir = dir ? existsSync(join(dir, 'frames', imageNode.id)) : false
+    const imageFiles = imageDir ? readdirSync(join(dir, 'frames', imageNode.id)).length : 0
+    ok('D3.2', '帧导出:向量长表 CSV + 图像原文件目录', !fex.isError && vectorCsv && imageFiles > 0,
+      `csv=${vectorCsv} imgFiles=${imageFiles}`)
+    // run 打标抽样核验:标量 CSV 行的 ts 应落在 run 窗口(打标链路一致性以 API 侧已验,此处核文件真实存在)
+    ok('D3.3', '导出产物真实存在(演示论据)', dir ? existsSync(join(dir, 'manifest.json')) : false, dir ?? '')
+  }
+
+  // ── ④ EDA 分析链 ──
+  const runs = (await api('GET', `/api/workshop/eda/runs?line_id=${c.lineId}`)).data?.runs ?? []
+  // golden 需要单节点 ≥20 点:选样本最多的已关账批(setup 以来的长批有数百点/节点)
+  let goldenRun = runs
+    .filter(r => r.endedAt && (r.sampleCount ?? 0) > 100)
+    .sort((a, b) => (b.sampleCount ?? 0) - (a.sampleCount ?? 0))[0] ?? null
+  let goldenNodeId = null
+  if (goldenRun) {
+    const all = (await api('GET', `/api/workshop/eda/features?run_id=${goldenRun.id}&limit=500`)).data?.features ?? []
+    goldenNodeId = all.sort((a, b) => (b.cnt ?? 0) - (a.cnt ?? 0))[0]?.nodeId ?? null
+  }
+  const openRun = runs.find(r => r.outcome === 'open' && !r.endedAt)
+  if (openRun) {
+    await sleep(4000)
+    await api('POST', `/api/workshop/dcw/runs/${openRun.id}/close`)
+    let closedRow = null
+    for (let i = 0; i < 15; i++) {
+      await sleep(2000)
+      closedRow = (await api('GET', `/api/workshop/eda/runs?line_id=${c.lineId}`)).data?.runs?.find(r => r.id === openRun.id)
+      if ((closedRow?.sampleCount ?? 0) > 0) break
+    }
+    ok('D4.1', '关账→run 台账 sample_count 回填', (closedRow?.sampleCount ?? 0) > 0, `samples=${closedRow?.sampleCount}`)
+    const feats = (await api('POST', '/api/workshop/eda/features/run', { run_id: openRun.id })).data
+    ok('D4.2', '特征仓库:cnt/mean/std/min/max/slope 落行', (feats?.features ?? 0) > 0, `features=${feats?.features}`)
+    const frow = (await api('GET', `/api/workshop/eda/features?run_id=${openRun.id}&limit=1`)).data?.features?.[0]
+    ok('D4.3', '特征行字段齐备', frow != null && ['cnt', 'mean', 'std', 'min', 'max', 'slope'].every(k => frow[k] != null), JSON.stringify(frow ?? {}).slice(0, 160))
+    // SPC 注册+重算
+    const spc = await api('POST', '/api/workshop/eda/spc', { line_id: c.lineId, node_id: frow?.nodeId ?? scalarNode.id, kind: 'i_mr' })
+    const rec = await api('POST', `/api/workshop/eda/spc/${spc.data?.chart?.id}/recompute`)
+    ok('D4.4', 'SPC 图注册并可重算', rec.status === 200 && rec.data?.chart?.nPoints > 0, `n=${rec.data?.chart?.nPoints} enabled=${rec.data?.chart?.enabled}`)
+    // golden(样本最多的关账批 + 该批最大 cnt 节点,保证 ≥20 桶)
+    const gb = goldenRun && goldenNodeId
+      ? await api('POST', '/api/workshop/eda/golden', { run_id: goldenRun.id, node_id: goldenNodeId, n_bins: 20 })
+      : { status: 404, data: null }
+    ok('D4.5', 'golden 参考轨迹生成', gb.status === 200 && (gb.data?.golden?.profile?.length ?? 0) > 0, `bins=${gb.data?.golden?.profile?.length} fp=${JSON.stringify(gb.data?.golden?.fingerprint ?? {}).slice(0, 120)}`)
+    // 重开一批保持实时流
+    await api('POST', `/api/workshop/dcw/lines/${c.lineId}/start`, { recipeId: c.recipeId })
+  }
+
+  // ── ⑤ UI 截图(实机演示论据) ──
+  process.env.AW_BASE = c.base
+  const { launch, openPage, gotoReady, sleep: uiSleep } = await import('./ui/lib.mjs')
+  const browser = await launch()
+  const page = await openPage(browser, { token: c.adminToken, width: 1680, height: 1000, deviceScaleFactor: 1 })
+  const shot = async (name) => {
+    await page.screenshot({ path: join(EVID, `${name}.png`), fullPage: false })
+    console.log(`  📸 ${name}.png`)
+  }
+  try {
+    // /data:选产线+勾节点(精确勾 2 个未勾选 chip)+查询
+    await gotoReady(page, '/data', { wait: 2500 })
+    await page.evaluate(() => {
+      const sel = document.querySelector('[data-test="data-line-sel"]')
+      if (sel && sel.options[1]) {
+        sel.value = sel.options[1].value
+        sel.dispatchEvent(new Event('change'))
+      }
+    })
+    await uiSleep(1500)
+    await page.evaluate(() => {
+      const chips = Array.from(document.querySelectorAll('[data-test="data-nodes"] .node-chip input'))
+      let n = 0
+      for (const cEl of chips) {
+        if (n >= 2) break
+        if (!cEl.checked) {
+          cEl.click()
+          n++
+        }
+      }
+    })
+    await page.click('[data-test="data-query"]')
+    await uiSleep(6000)
+    await shot('demo-1-data-query')
+    // 台账 tab
+    await page.evaluate(() => {
+      Array.from(document.querySelectorAll('[data-test="data-tabs"] .tab')).find(e => (e.textContent || '').includes('台账'))?.click()
+    })
+    await uiSleep(2500)
+    await shot('demo-2-data-ledger')
+
+    // /daq 标量实时
+    await gotoReady(page, `/daq/${scalarNode.id}`, { wait: 5000 })
+    await shot('demo-3-daq-scalar-live')
+
+    // /daq 数组帧/图像帧:帧视图由 WS daq.frame 实时喂帧 —— 向量页在**页面打开状态下推送**
+    // (ingest 广播 daq.frame → store → polyline 非空);断言=非空轮廓渲染产物,非空 points="" 元素
+    await gotoReady(page, `/daq/${vectorNode.id}`, { wait: 5000 })
+    await uiSleep(2000)
+    await pushVec('live-ui')
+    let vecRendered = 0
+    for (let i = 0; i < 12; i++) {
+      await uiSleep(1500)
+      vecRendered = await page.evaluate(() => document.querySelectorAll('svg polyline[points]:not([points=""])').length)
+      if (vecRendered >= 1) break
+    }
+    ok('D5.2', '/daq 数组节点:非空轮廓 polyline 渲染(页面打开状态下推送→WS 上屏)', vecRendered >= 1, `polylines=${vecRendered}`)
+    await shot('demo-4-daq-vector-frames')
+
+    await gotoReady(page, `/daq/${imageNode.id}`, { wait: 5000 })
+    await uiSleep(2000)
+    await pushImg('live-ui')
+    // WS 实时到达(≤10s);若未达则刷新页面由 REST 基线加载(两种路径都证明"推送→可查可看")
+    let imgRendered = 0
+    let viaWs = true
+    for (let i = 0; i < 10; i++) {
+      await uiSleep(1000)
+      imgRendered = await page.evaluate(() => document.querySelectorAll('img[src*="frames/content"]').length)
+      if (imgRendered >= 1) break
+    }
+    if (imgRendered === 0) {
+      await gotoReady(page, `/daq/${imageNode.id}`, { wait: 5000 })
+      await uiSleep(2500)
+      imgRendered = await page.evaluate(() => document.querySelectorAll('img[src*="frames/content"]').length)
+      viaWs = false
+    }
+    ok('D5.3', '/daq 图像节点:contentUrl 图像渲染(实时 WS 或刷新基线)', imgRendered >= 1, `imgs=${imgRendered} viaWs=${viaWs}`)
+    await shot('demo-5-daq-image-frames')
+
+    // /studio:选产线+选批次(golden 归属)+加 Y+查询+叠加
+    await gotoReady(page, '/studio', { wait: 3000 })
+    await page.evaluate(() => {
+      const sel = document.querySelector('[data-test="studio-line"]')
+      if (sel && sel.options[1]) {
+        sel.value = sel.options[1].value
+        sel.dispatchEvent(new Event('change'))
+      }
+    })
+    await uiSleep(1500)
+    // 加 Y:第一个 = golden 已生成的节点(保证叠加命中),再加一个任意节点成多序列
+    const goldenNodeName = nodes.find(n => n.id === goldenNodeId)?.name ?? scalarNode.name
+    await page.evaluate((goldenName) => {
+      const row = Array.from(document.querySelectorAll('[data-test="studio-nodes"] .nodeRow'))
+        .find(r => (r.querySelector('.nName')?.textContent || '').includes(goldenName))
+      row?.querySelector('.miniAdd')?.click()
+      const rows = Array.from(document.querySelectorAll('[data-test="studio-nodes"] .nodeRow'))
+      rows.find(r => r !== row && r.querySelector('.miniAdd'))?.querySelector('.miniAdd')?.click()
+    }, goldenNodeName)
+    await uiSleep(500)
+    if (goldenRun?.id) {
+      // 优先选 golden 归属批;不在前 20 时任选同配方批(recipeId 相同,golden 解析等价)
+      await page.evaluate((rid) => {
+        const sel = document.querySelector('[data-test="studio-run"]')
+        if (!sel) return
+        const opt = Array.from(sel.options).find(o => o.value === rid) ?? sel.options[sel.options.length - 1]
+        if (opt) {
+          sel.value = opt.value
+          sel.dispatchEvent(new Event('change'))
+        }
+      }, goldenRun.id)
+    }
+    await page.click('[data-test="studio-query"]')
+    await uiSleep(6000)
+    // 保存图表(供看板使用)
+    await page.evaluate(() => {
+      const inp = document.querySelector('[data-test="studio-title"]')
+      if (inp) {
+        inp.value = 'EDA 演示图表'
+        inp.dispatchEvent(new Event('input'))
+      }
+    })
+    await page.click('[data-test="studio-save"]')
+    await uiSleep(2000)
+    // golden 叠加:只点「golden 已生成的标量节点」那一行的叠加按钮;
+    // 断言=叠加数据请求 200(GET /eda/golden/single,canvas 内容不可 DOM 断言)+
+    // 无任何错误横幅(旧文案已改,双串都查)——叠加数据装入页面即渲染golden线/带
+    const goldenNet = []
+    const netHandler = (r) => {
+      if (r.url().includes('/eda/golden/single')) goldenNet.push(r.status())
+    }
+    page.on('response', netHandler)
+    await page.evaluate((goldenName) => {
+      const row = Array.from(document.querySelectorAll('.goldenRow'))
+        .find(r => (r.textContent || '').includes(goldenName))
+      const btn = row ? Array.from(row.querySelectorAll('.pill-btn')).find(b => (b.textContent || '').includes('叠加')) : null
+      btn?.click()
+    }, goldenNodeName)
+    await uiSleep(3500)
+    page.off('response', netHandler)
+    const goldenErr = await page.evaluate(() => {
+      const t = document.body.textContent || ''
+      return t.includes('无法定位') || t.includes('目标不存在或已被删除')
+    })
+    ok('D5.4', '/studio golden 叠加:数据请求 200 且无错误横幅', goldenNet.includes(200) && !goldenErr,
+      `net=${JSON.stringify(goldenNet)} err=${goldenErr}`)
+    await shot('demo-6-studio-analysis')
+
+    // 看板:经 API 建板(内嵌刚保存的图表)→ 页面渲染栅格卡
+    const myCharts = (await api('GET', '/api/workshop/eda/charts?mine=1')).data?.charts ?? []
+    const demoChart = myCharts.find(x => x.title === 'EDA 演示图表') ?? myCharts[0]
+    if (demoChart) {
+      await api('POST', '/api/workshop/eda/dashboards', {
+        title: 'EDA 演示看板',
+        layout: [{ chartId: demoChart.id, x: 0, y: 0, w: 8, h: 4 }],
+        visibility: 'private',
+      })
+    }
+    await gotoReady(page, '/studio/board', { wait: 3000 })
+    await page.evaluate(() => {
+      const sel = document.querySelector('[data-test="board-sel"]')
+      const wanted = Array.from(sel?.options ?? []).find(o => (o.textContent || '').includes('EDA 演示看板'))
+      if (sel && wanted) {
+        sel.value = wanted.value
+        sel.dispatchEvent(new Event('change'))
+      }
+    })
+    await uiSleep(6000)
+    const boardCells = await page.evaluate(() => document.querySelectorAll('[data-test="board-grid"] .cell')?.length ?? 0)
+    ok('D5.5', '看板栅格卡渲染(内嵌图表)', boardCells >= 1, `cells=${boardCells}`)
+    await shot('demo-7-studio-board')
+  }
+  catch (e) {
+    ok('D5.0', 'UI 截图遍历未抛异常', false, e instanceof Error ? e.message : String(e))
+  }
+  await browser.close()
+
+  const shots = readdirSync(EVID).filter(f => f.endsWith('.png'))
+  ok('D5.1', '实机截图 ≥6 张', shots.length >= 6, shots.join(', '))
+
+  writeFileSync(join(EVID, 'demo-evidence.json'), JSON.stringify({
+    at: new Date().toISOString(), base: c.base, lineId: c.lineId, recipeId: c.recipeId,
+    nodes: { scalar: scalarNode?.id, vector: vectorNode?.id, image: imageNode?.id },
+    externalPush: { vector: ing1.status, image: ing2.status },
+    framesGrowth: { vector: `${v1}→${v2}`, image: `${i1}→${i2}` },
+    exportJob: job?.result ?? null,
+    goldenRun: goldenRun?.id ?? null,
+    screenshots: shots, results,
+  }, null, 2))
+
+  const pass = results.filter(r => r.pass).length
+  console.log(`\n═══ EDA 数据层实机演示: ${pass}/${results.length} PASS ═══`)
+  if (pass !== results.length) process.exitCode = 1
+}
+main().catch((e) => {
+  console.error(e)
+  process.exitCode = 1
+})

package/scripts/full-stack-shots.mjs

@@ -0,0 +1,145 @@
+/**
+ * 全栈验收 UI 截图包(US-308):仪表盘/数采详情/产线作业/数据管理/EDA 工坊/看板/分析台账。
+ * 运行:node scripts/full-stack-shots.mjs <scenario-context.json>
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { join, resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const CTX = process.argv[2]
+const c = JSON.parse(readFileSync(CTX, 'utf8'))
+const EVID = join(REPO, 'docs', 'audit', 'evidence', '2026-10-21-acceptance', 'shots')
+mkdirSync(EVID, { recursive: true })
+process.env.AW_BASE = c.base
+const { launch, openPage, gotoReady, sleep } = await import('./ui/lib.mjs')
+
+const browser = await launch()
+const page = await openPage(browser, { token: c.adminToken, width: 1680, height: 1000, deviceScaleFactor: 1 })
+const shots = []
+const shot = async (name) => {
+  await page.screenshot({ path: join(EVID, `${name}.png`), fullPage: false })
+  shots.push(`${name}.png`)
+  console.log(`  📸 ${name}.png`)
+}
+
+// 仪表盘
+await gotoReady(page, '/', { wait: 4000 })
+await shot('fs-1-dashboard')
+// 数采中心(节点列表)
+await gotoReady(page, '/daq', { wait: 4000 })
+await shot('fs-2-daq-list')
+// 数采详情(标量实时)
+await gotoReady(page, `/daq/${c.daq?.['part-weight'] ?? c.daq?.[Object.keys(c.daq ?? {})[0]] ?? ''}`, { wait: 6000 })
+await shot('fs-3-daq-detail')
+// 产线作业
+await gotoReady(page, '/dcw', { wait: 4000 })
+await shot('fs-4-dcw-line')
+// 数据管理台(镜像数据 tab+查询)
+await gotoReady(page, '/data', { wait: 3000 })
+await page.evaluate(() => {
+  const sel = document.querySelector('[data-test="data-line-sel"]')
+  if (sel && sel.options[1]) {
+    sel.value = sel.options[1].value
+    sel.dispatchEvent(new Event('change'))
+  }
+})
+await sleep(1500)
+await page.evaluate(() => {
+  const chips = Array.from(document.querySelectorAll('[data-test="data-nodes"] .node-chip input'))
+  let n = 0
+  for (const cEl of chips) {
+    if (n >= 2) break
+    if (!cEl.checked) {
+      cEl.click()
+      n++
+    }
+  }
+})
+await page.click('[data-test="data-query"]')
+await sleep(6000)
+await shot('fs-5-data-query')
+// EDA 工坊
+await gotoReady(page, '/studio', { wait: 3000 })
+await page.evaluate(() => {
+  const sel = document.querySelector('[data-test="studio-line"]')
+  if (sel && sel.options[1]) {
+    sel.value = sel.options[1].value
+    sel.dispatchEvent(new Event('change'))
+  }
+})
+await sleep(1500)
+await page.evaluate(() => {
+  Array.from(document.querySelectorAll('[data-test="studio-nodes"] .miniAdd')).slice(0, 2).forEach(b => b.click())
+})
+await page.click('[data-test="studio-query"]')
+await sleep(6000)
+await shot('fs-6-studio')
+// 看板:先经 API 建图表+看板(本实例可能为空),选中后截图栅格
+const nodesNow = (await fetch(c.base + '/api/workshop/daq', { headers: { authorization: `Bearer ${c.adminToken}` } }).then(r => r.json())).data?.nodes ?? []
+const twoNodes = nodesNow.filter(n => n.enabled).slice(0, 2).map(n => n.id)
+let chartId = null
+if (twoNodes.length >= 1) {
+  const mkChart = await fetch(c.base + '/api/workshop/eda/charts', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', 'authorization': `Bearer ${c.adminToken}` },
+    body: JSON.stringify({
+      title: '全栈验收图表',
+      viz_type: 'trend',
+      datasource: { lineId: c.lineId, nodeIds: twoNodes, preset: '60', agg: 'avg' },
+      encoding: { y: twoNodes.map(id => ({ nodeId: id, name: id, unit: '', axis: 'L' })) },
+      visibility: 'private',
+    }),
+  }).then(r => r.json()).catch(() => null)
+  chartId = mkChart?.data?.chart?.id
+}
+if (chartId) {
+  await fetch(c.base + '/api/workshop/eda/dashboards', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', 'authorization': `Bearer ${c.adminToken}` },
+    body: JSON.stringify({
+      title: '全栈验收看板',
+      layout: [{ chartId, x: 0, y: 0, w: 12, h: 4 }],
+      line_id: c.lineId,
+      visibility: 'private',
+    }),
+  }).catch(() => {})
+}
+await gotoReady(page, '/studio/board', { wait: 3000 })
+await sleep(2000)
+await page.evaluate(() => {
+  const sel = document.querySelector('[data-test="board-sel"]')
+  const wanted = Array.from(sel?.options ?? []).find(o => (o.textContent || '').includes('全栈验收看板'))
+  if (sel && wanted) {
+    sel.value = wanted.value
+    sel.dispatchEvent(new Event('change'))
+  }
+})
+await sleep(6000)
+const boardCells = await page.evaluate(() => document.querySelectorAll('[data-test="board-grid"] .cell')?.length ?? 0)
+console.log(`  board cells=${boardCells}`)
+await shot('fs-7-board')
+// 分析台账
+await gotoReady(page, '/analysis', { wait: 4000 })
+await shot('fs-8-analysis')
+// Channel 群聊页:建 workspace→挂载 channel→进入 /workshop/w/<wsId>(群聊页在 workspace 内)
+const wsRes = await fetch(c.base + '/api/workshop/workspaces', {
+  method: 'POST',
+  headers: { 'content-type': 'application/json', 'authorization': `Bearer ${c.adminToken}` },
+  body: JSON.stringify({ name: '全栈验收工作区' }),
+})
+const wsJson = await wsRes.json().catch(() => ({}))
+const wsId = wsJson?.data?.id ?? wsJson?.data?.workspace?.id
+if (wsId && c.channelId) {
+  await fetch(c.base + `/api/workshop/workspaces/${wsId}/channels/${c.channelId}`, {
+    method: 'POST',
+    headers: { authorization: `Bearer ${c.adminToken}` },
+  })
+}
+await gotoReady(page, `/workshop/w/${wsId}`, { wait: 6000 })
+await sleep(3000)
+await shot('fs-9-channel')
+
+await browser.close()
+writeFileSync(join(EVID, 'shots-manifest.json'), JSON.stringify({ at: new Date().toISOString(), shots }, null, 2))
+console.log(`\n═══ 截图包: ${shots.length} 张 ═══`)