agentworkshop 0.2.1

package/scripts/_dbg-line-live-e2e.mjs

@@ -0,0 +1,144 @@
+/**
+ * 一次性 E2E:开跑产线 → 数控/数采/数字孪生三链路活体验证。
+ * ①REST 开跑(配方参数节点级绑定)→ 控制节点设定值=配方目标(写 ACK/写历史带批次);
+ * ②数采由配方门控启动:produced 增长、节点实时值随采样变化;
+ * ③数字孪生面板(/town):callout 数据卡展示实时值,8s 内值变化(WS→townBus→callout 全链);
+ * ④停线:数采节点 offline、produced 冻结、孪生值收敛 '--'。结束还原环境。
+ */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = process.env.DAQ_TOKEN ?? 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+// ===== 选目标产线:同时具备 数采节点 + 控制节点 + 参数级绑定配方 =====
+const d = (await j('/api/workshop/dcw')).data
+const daqAll = (await j('/api/workshop/daq')).data
+const cand = d.lines.map((l) => {
+  const recipe = d.recipes.find(r => r.lineId === l.id && r.params.length > 0 && r.params.every(p => p.nodeId))
+  const dcwNodes = d.nodes.filter(n => n.lineId === l.id)
+  const daqNodes = daqAll.nodes.filter(n => n.lineId === l.id)
+  return { line: l, recipe, dcwNodes, daqNodes }
+}).find(x => x.recipe && x.dcwNodes.length > 0 && x.daqNodes.length > 0)
+if (!cand) { console.error('FAIL: 无同时具备 数采/数控/配方 的产线'); process.exit(1) }
+const { line, recipe, dcwNodes, daqNodes } = cand
+console.log('target:', line.name, '| recipe:', recipe.name, `| dcw×${dcwNodes.length} daq×${daqNodes.length}`)
+
+// ===== 0. 前置停线 + 基线 =====
+await j(`/api/workshop/dcw/lines/${line.id}/stop`, 'POST').catch(() => {})
+await sleep(1200)
+const produced0 = (await j('/api/workshop/daq')).data.meta.produced
+console.log('baseline produced:', produced0, '| daq node:', daqNodes[0].value, daqNodes[0].state)
+
+// ===== 1. 开跑:配方参数随开跑下发(数控链路) =====
+const st = await j(`/api/workshop/dcw/lines/${line.id}/start`, 'POST', { recipeId: recipe.id })
+if (!st.data?.line?.active) { console.error('FAIL: line start:', JSON.stringify(st).slice(0, 200)); process.exit(1) }
+console.log('line started, run:', st.data.line.runId?.slice(0, 8))
+// 控制节点设定值 = 配方目标值(节点级绑定;mock 回读 = 指令值)
+let dcwOk = 0
+for (const p of recipe.params) {
+  const node = (await j('/api/workshop/dcw')).data.nodes.find(n => n.id === p.nodeId)
+  const hit = node && Math.abs((node.value ?? NaN) - p.value) < 0.01 && node.state === 'ok'
+  if (hit) dcwOk++
+  else fail(`dcw node ${p.nodeId} value=${node?.value} (expect ${p.value}) state=${node?.state}`)
+}
+if (dcwOk === recipe.params.length) console.log(`PASS 数控下发: ${dcwOk}/${recipe.params.length} 参数 ACK 且设定值=配方目标`)
+const hist = (await j('/api/workshop/dcw')).data.history.filter(h => h.recipeRunId === st.data.line.runId)
+if (hist.length >= recipe.params.length && hist.every(h => h.ok)) console.log('PASS 写历史:', hist.length, '条带批次 runId 全 ACK')
+else fail(`write history wrong: ${hist.length}`)
+
+// ===== 2. 数采门控启动:produced 增长 + 实时值变化 =====
+await sleep(4000)
+const mid = (await j('/api/workshop/daq')).data
+const midNode = mid.nodes.find(n => n.id === daqNodes[0].id)
+if (mid.meta.produced > produced0) console.log(`PASS 数采门控启动: produced ${produced0} → ${mid.meta.produced}`)
+else fail(`produced not growing: ${produced0} → ${mid.meta.produced}`)
+await sleep(4000)
+const mid2 = (await j('/api/workshop/daq')).data
+const mid2Node = mid2.nodes.find(n => n.id === daqNodes[0].id)
+if (mid2.meta.produced > mid.meta.produced) console.log(`PASS 采样持续: produced → ${mid2.meta.produced}`)
+else fail('produced stalled while line active')
+if (mid2Node.value != null && mid2Node.value !== midNode.value) console.log(`PASS 节点实时值变化: ${midNode.value} → ${mid2Node.value} ${mid2Node.unit} (${mid2Node.state})`)
+else fail(`daq value not updating: ${midNode.value} → ${mid2Node.value}`)
+
+// ===== 3. 数字孪生面板:callout 实时值展示且随采样刷新 =====
+const login = await fetch(`${ROOT}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(20000) // 3D 场景装配
+// 断言面 = 右轨「关键设备监控」面板(不受相机距离门限制):
+// .daq-item = 数采实时值,.dcw-set = 智控设定值(.dcw-src=配方 来源标签)
+const panelDaqVals = () => page.evaluate(() =>
+  [...document.querySelectorAll('.twin-daq .daq-item b')].map(e => e.textContent.replace(/\s+/g, '')))
+const panelDcwRows = () => page.evaluate(() =>
+  [...document.querySelectorAll('.twin-dcw .dcw-item')].map(e => ({
+    ch: e.querySelector('.dcw-head em')?.textContent.replace(/\s+/g, ''),
+    set: e.querySelector('.dcw-set')?.textContent.replace(/\s+/g, ''),
+    src: e.querySelector('.dcw-src')?.textContent ?? '',
+  })))
+const daq1 = await panelDaqVals()
+const dcwRows = await panelDcwRows()
+console.log('town panel: daq rows', daq1.length, '| dcw rows', JSON.stringify(dcwRows))
+if (daq1.length === 0) fail('panel has no daq rows (town 未出数据)')
+// 智控:配方参数节点若绑定在面板展示的设备上 → 行应显示 配方目标+来源「配方」;
+// 未绑定的参数节点不在设备面板展示(下发正确性已由 §1 的 ACK+回读断言权威覆盖)
+let panelChecked = 0
+for (const p of recipe.params) {
+  const node = d.nodes.find(n => n.id === p.nodeId)
+  const hit = dcwRows.some(r => (r.set ?? '').includes(String(p.value)) && r.src === '配方')
+  if (hit) {
+    panelChecked++
+    console.log(`PASS 孪生面板智控设定展示: ${node?.name} = ${p.value} (来源标签「配方」)`)
+  }
+}
+if (panelChecked === 0) console.log('INFO 配方参数节点均未绑定面板设备 —— 面板断言跳过(下发链路由 §1 ACK+回读权威覆盖)')
+await page.screenshot({ path: 'docs/audit/screenshots/town-live-t0.png' })
+// 数采:8s 内面板实时值变化(仅运行产线的节点在采样,变化即证明 WS→townBus→面板全链)
+await sleep(8000)
+const daq2 = await panelDaqVals()
+await page.screenshot({ path: 'docs/audit/screenshots/town-live-t8.png' })
+const changedCount = daq2.filter((v, i) => v !== daq1[i]).length
+if (changedCount > 0) console.log(`PASS 孪生面板数采实时刷新: ${changedCount}/${daq1.length} 通道 8s 内值变化`)
+else fail(`panel daq values static: ${JSON.stringify(daq1.slice(0, 4))}`)
+
+// ===== 4. 停线:数采停摆 + 孪生值收敛 =====
+// 注:produced 是全局计数(所有活跃产线),多产线并发时不能用作本线停线判据;
+// 本线语义看两点 —— ①本线打标样本(taggedSamples)停涨;②本线数采节点 offline
+await j(`/api/workshop/dcw/lines/${line.id}/stop`, 'POST')
+await sleep(3000)
+const after = (await j('/api/workshop/daq')).data
+const afterLine = (await j('/api/workshop/dcw')).data.lineStates.find(s => s.lineId === line.id)
+const afterNode = after.nodes.find(n => n.id === daqNodes[0].id)
+await sleep(3000)
+const afterLine2 = (await j('/api/workshop/dcw')).data.lineStates.find(s => s.lineId === line.id)
+if (afterLine2.taggedSamples === afterLine.taggedSamples) console.log(`PASS 停线冻结: 本线打标样本停在 ${afterLine2.taggedSamples}`)
+else fail(`本线打标样本仍在增长: ${afterLine.taggedSamples} → ${afterLine2.taggedSamples}`)
+if (afterNode.state === 'offline') console.log('PASS 停线联动: 数采节点 offline')
+else fail(`daq node state after stop: ${afterNode.state}`)
+// 孪生面板收敛:停线后先前变化的数采通道冻结(不再产生新值)
+await page.reload({ waitUntil: 'domcontentloaded' })
+await sleep(18000)
+const frozen1 = await panelDaqVals()
+await sleep(6000)
+const frozen2 = await panelDaqVals()
+const stillChanging = frozen2.filter((v, i) => v !== frozen1[i]).length
+if (stillChanging === 0) console.log('PASS 孪生面板停线收敛: 数采通道值冻结(无新样本)')
+else fail(`panel still changing after stop: ${stillChanging} rows`)
+await page.screenshot({ path: 'docs/audit/screenshots/town-live-stopped.png' })
+await browser.close()
+
+console.log(process.exitCode ? '\n=== E2E FAILED ===' : '\n=== E2E ALL PASS ===')

package/scripts/_dbg-line-scenario-e2e.mjs

@@ -0,0 +1,256 @@
+/** 真实场景端到端审计:双产线建节点/采集/写入/配方数采窗口越限报警/孪生渲染/UI 交互 */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jpatch = (u, b) => fetch(ROOT + u, { method: 'PATCH', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jdel = (u) => fetch(ROOT + u, { method: 'DELETE', headers: H }).then(r => r.json())
+const jget = (u) => fetch(ROOT + u, { headers: H }).then(r => r.json())
+
+const daqNodes = () => jget('/api/workshop/daq').then(d => d.data.nodes)
+const dcwNodes = () => jget('/api/workshop/dcw').then(d => d.data.nodes)
+
+// ============ 1. 建两条产线 ============
+const mkLine = async (name) => (await jpost('/api/workshop/dcw/lines', { name })).data.line
+const lineA = await mkLine('场景-1号产线')
+const lineB = await mkLine('场景-2号产线')
+if (!lineA || !lineB) { console.error('FAIL: create lines'); process.exit(1) }
+console.log('lines:', lineA.name, lineA.color, '|', lineB.name, lineB.color)
+
+// ============ 2. 每线建数采 + 数控节点(mock 驱动;绑定同一设备便于孪生联动) ============
+const twins = (await jget('/api/workshop/device-twins')).data.twins.filter(t => t.kind !== 'daq')
+const dev = twins.find(t => t.name.includes('控制台')) ?? twins[0]
+const mkD = async (base, body) => (await jpost(base, body)).data.node
+const dqA = await mkD('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: '场景-温度采集A', lineId: lineA.id, intervalMs: 500, posX: dev.posX + 60, posZ: dev.posZ + 60 })
+const dwA = await mkD('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: '场景-温度设定A', lineId: lineA.id, posX: dev.posX - 60, posZ: dev.posZ - 60 })
+const dqB = await mkD('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: '场景-温度采集B', lineId: lineB.id, intervalMs: 500, posX: dev.posX + 120, posZ: dev.posZ + 120 })
+const dwB = await mkD('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: '场景-温度设定B', lineId: lineB.id, posX: dev.posX - 120, posZ: dev.posZ - 120 })
+for (const [n, id] of [[dqA, dqA.id], [dwA, dwA.id], [dqB, dqB.id], [dwB, dwB.id]]) {
+  await jpost(`/api/workshop/${n === dqA || n === dqB ? 'daq' : 'dcw'}/${id}/bind`, { deviceId: dev.id })
+}
+console.log('nodes created: A(daq+dcw) B(daq+dcw), bound to', dev.name)
+
+// ============ 3. 每线产品 + 配方(参数节点级 + 数采监控窗口) ============
+const prodA = (await jpost('/api/workshop/dcw/products', { name: '场景产品A', lineId: lineA.id })).data.product
+const prodB = (await jpost('/api/workshop/dcw/products', { name: '场景产品B', lineId: lineB.id })).data.product
+const rcA = (await jpost('/api/workshop/dcw/recipes', {
+  productId: prodA.id, name: '场景配方A',
+  params: [{ templateRef: 'dcw-temp-sp', nodeId: dwA.id, value: 180, min: 176, max: 188 }],
+  // 数采监控窗口:初始宽松(全量程内,不报警)
+  daqWindows: [{ nodeId: dqA.id, min: 100, max: 260 }],
+})).data.recipe
+const rcB = (await jpost('/api/workshop/dcw/recipes', {
+  productId: prodB.id, name: '场景配方B',
+  params: [{ templateRef: 'dcw-temp-sp', nodeId: dwB.id, value: 165, min: 156, max: 170 }],
+  daqWindows: [{ nodeId: dqB.id, min: 100, max: 260 }],
+})).data.recipe
+if (!rcA?.daqWindows?.length || !rcB?.daqWindows?.length) { console.error('FAIL: recipe daqWindows missing', JSON.stringify(rcA)); process.exit(1) }
+console.log('recipes with daq windows:', rcA.name, JSON.stringify(rcA.daqWindows))
+
+// ============ 4. 开跑 A 线:采集/写入/窗口联锁 ============
+const st = await jpost(`/api/workshop/dcw/lines/${lineA.id}/start`, { recipeId: rcA.id })
+if (!st.data?.line?.active) { console.error('FAIL: line A start', JSON.stringify(st).slice(0, 140)); process.exit(1) }
+await sleep(3000)
+
+const daqNow = await daqNodes()
+const dqALive = daqNow.find(n => n.id === dqA.id)
+console.log('A daq value:', dqALive?.value, dqALive?.state)
+if (dqALive?.value != null && dqALive?.state !== 'offline') console.log('PASS A 线数采流动(500ms 周期)')
+else fail('A 线无数采数据')
+
+const dqBLive = daqNow.find(n => n.id === dqB.id)
+if (dqBLive?.value == null || dqBLive?.state === 'offline') console.log('PASS B 线未开跑 → 不采集(产线隔离)')
+else fail('B 线未开跑却在采样')
+
+// 数控写入:窗口内 180 OK;越窗 195 拒绝(服务端配方联锁)
+const wIn = await jpost(`/api/workshop/dcw/${dwA.id}/write`, { value: 180 })
+const wOut = await jpost(`/api/workshop/dcw/${dwA.id}/write`, { value: 195 })
+if (wIn.data?.outcome?.ok === true) console.log('PASS A 线数控写入 180 成功(真实下发链路)')
+else fail(`A 线写入失败: ${JSON.stringify(wIn).slice(0, 100)}`)
+if (wOut.code === 'VALIDATION_ERROR') console.log('PASS A 线越窗写入 195 被配方联锁拒绝:', (wOut.message ?? '').slice(0, 44))
+else fail('A 线越窗写入未被拒绝')
+
+// 跨线联锁隔离:B 线节点(A 线配方不含)写 195 不受 A 配方约束
+const wCross = await jpost(`/api/workshop/dcw/${dwB.id}/write`, { value: 195 })
+if (wCross.data?.outcome?.ok === true) console.log('PASS 跨线隔离:B 线节点不受 A 线配方窗口约束')
+else fail('跨线联锁泄漏')
+
+// ============ 5. 配方数采窗口越限 → 实时报警 ============
+const dwNarrow = await jpatch(`/api/workshop/dcw/recipes/${rcA.id}`, { daqWindows: [{ nodeId: dqA.id, min: 0, max: 1 }] })
+if (!dwNarrow.data?.recipe) { console.error('FAIL: patch narrow window', JSON.stringify(dwNarrow).slice(0, 120)); process.exit(1) }
+console.log('narrow window [0,1] applied — 等待越限报警…')
+let alarmed = false
+for (let i = 0; i < 12; i++) {
+  await sleep(1000)
+  const n = (await daqNodes()).find(x => x.id === dqA.id)
+  if (n?.state === 'alarm') { alarmed = true; break }
+}
+const alVal = (await daqNodes()).find(x => x.id === dqA.id)
+if (alarmed) console.log('PASS 配方窗口越限 → 节点实时 alarm(值', alVal.value, '∉ [0,1])')
+else fail('越限未触发 alarm')
+
+// 恢复宽窗口 → 自动回落 ok
+await jpatch(`/api/workshop/dcw/recipes/${rcA.id}`, { daqWindows: [{ nodeId: dqA.id, min: 100, max: 260 }] })
+let recovered = false
+for (let i = 0; i < 10; i++) {
+  await sleep(1000)
+  const n = (await daqNodes()).find(x => x.id === dqA.id)
+  if (n?.state === 'ok') { recovered = true; break }
+}
+if (recovered) console.log('PASS 窗口恢复 → 状态自动回落 ok')
+else fail('窗口恢复后未回落')
+
+// ============ 6. 停 A 开 B:采集切换 + B 配方生效 ============
+await jpost(`/api/workshop/dcw/lines/${lineA.id}/stop`, {})
+const stB = await jpost(`/api/workshop/dcw/lines/${lineB.id}/start`, { recipeId: rcB.id })
+if (!stB.data?.line?.active) fail('line B start failed')
+await sleep(3000)
+const after = await daqNodes()
+const aAfter = after.find(n => n.id === dqA.id)
+const bAfter = after.find(n => n.id === dqB.id)
+if (aAfter?.state === 'offline') console.log('PASS A 停 → A 节点 offline')
+else fail(`A 停后未 offline: ${aAfter?.state}`)
+if (bAfter?.value != null && bAfter?.state !== 'offline') console.log('PASS B 开 → B 数采流动(隔离切换)')
+else fail('B 开后无数采')
+
+// B 配方写入窗口(156~170):165 OK
+const wB = await jpost(`/api/workshop/dcw/${dwB.id}/write`, { value: 165 })
+if (wB.data?.outcome?.ok === true) console.log('PASS B 线配方窗口内写入 165 成功')
+else fail('B 线写入失败')
+
+// ============ 7. 浏览器:/daq 行标红 + /town 孪生报警 ============
+// 重新制造 A 线越限(A 线已停 → 用 B 线验证浏览器报警链)
+const dwNarrowB = await jpatch(`/api/workshop/dcw/recipes/${rcB.id}`, { daqWindows: [{ nodeId: dqB.id, min: 0, max: 1 }] })
+if (!dwNarrowB.data?.recipe) fail('patch B narrow failed')
+let alarmedB = false
+for (let i = 0; i < 12; i++) {
+  await sleep(1000)
+  const n = (await daqNodes()).find(x => x.id === dqB.id)
+  if (n?.state === 'alarm') { alarmedB = true; break }
+}
+if (!alarmedB) fail('B 越限未报警')
+else console.log('B 线越限报警就绪 — 开始浏览器验证')
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1920,1080'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1080 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+const pageErrors = []
+page.on('pageerror', (err) => pageErrors.push(String(err).slice(0, 120)))
+
+// 7.1 /daq 页:页面挂载后制造越限跳变 → 行标红 + pill 文案 + 告警面板
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+// 首访页面 dev server 需现场编译 → 轮询等行渲染
+let rowReady = false
+for (let i = 0; i < 30; i++) {
+  rowReady = await page.evaluate((name) => [...document.querySelectorAll('tbody tr')].some(r => r.textContent.includes(name)), '场景-温度采集B')
+  if (rowReady) break
+  await sleep(1000)
+}
+if (!rowReady) fail('/daq 行未渲染(等待超时)')
+
+// 恢复宽窗口 → 等回 ok → 收窄制造页面内的状态跳变(alarm 由 watch 实时上屏)
+await jpatch(`/api/workshop/dcw/recipes/${rcB.id}`, { daqWindows: [{ nodeId: dqB.id, min: 100, max: 260 }] })
+for (let i = 0; i < 12; i++) {
+  await sleep(1000)
+  const n = (await daqNodes()).find(x => x.id === dqB.id)
+  if (n?.state === 'ok') break
+}
+await jpatch(`/api/workshop/dcw/recipes/${rcB.id}`, { daqWindows: [{ nodeId: dqB.id, min: 0, max: 1 }] })
+let daqUi = { rowRed: false, pillText: '' }
+for (let i = 0; i < 15; i++) {
+  await sleep(1000)
+  daqUi = await page.evaluate((name) => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent.includes(name))
+    return {
+      rowFound: !!row,
+      rowRed: row?.classList.contains('row-recipe-alarm') ?? false,
+      pillText: row?.querySelector('.st-pill')?.textContent.trim() ?? '',
+    }
+  }, '场景-温度采集B')
+  if (daqUi.rowRed && daqUi.pillText.includes('配方越限')) break
+}
+console.log('/daq ui:', JSON.stringify(daqUi))
+if (daqUi.rowFound && daqUi.rowRed && daqUi.pillText.includes('配方越限')) console.log('PASS /daq 越限行标红 + 「配方越限」pill')
+else fail(`/daq 行标红缺失: ${JSON.stringify(daqUi)}`)
+await page.screenshot({ path: 'docs/audit/screenshots/scenario-daq-alarm.png' })
+
+// 告警面板条目(跳变已在页面上发生 → raiseAlarm crit)
+await sleep(500)
+const alarmOnDaq = await page.evaluate((name) => [...document.querySelectorAll('.al-txt')].map(e => e.textContent).find(t => t.includes(name)) ?? '', '场景-温度采集B')
+
+// 7.2 /town:孪生节点红环 + 实时告警
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+for (let i = 0; i < 40; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+  await sleep(1000)
+}
+await sleep(4500)
+// 页面就绪后制造跳变:先恢复(→ok)再收窄(→alarm),watch 实时上屏
+await jpatch(`/api/workshop/dcw/recipes/${rcB.id}`, { daqWindows: [{ nodeId: dqB.id, min: 100, max: 260 }] })
+let townOk = false
+for (let i = 0; i < 12; i++) {
+  await sleep(1000)
+  const n = (await daqNodes()).find(x => x.id === dqB.id)
+  if (n?.state === 'ok') { townOk = true; break }
+}
+if (townOk) console.log('PASS 孪生页面内窗口恢复 → 状态回落 ok')
+await jpatch(`/api/workshop/dcw/recipes/${rcB.id}`, { daqWindows: [{ nodeId: dqB.id, min: 0, max: 1 }] })
+let townUi = { found: false, state: '', ring: '', alarmText: '' }
+for (let i = 0; i < 15; i++) {
+  await sleep(1000)
+  townUi = await page.evaluate((id, name) => {
+    const s = window.__town.scene
+    const dev2 = [...s.deviceNodes.values()].find(x => x.twinId === id)
+    return {
+      found: !!dev2,
+      state: dev2?.state ?? '',
+      ring: dev2 ? `#${dev2.ring.material.color.getHexString()}` : '',
+      alarmText: [...document.querySelectorAll('.al-txt')].map(e => e.textContent).find(t => t.includes('越限量程')) ?? '',
+      alRows: [...document.querySelectorAll('.al-txt')].map(e => e.textContent.trim().slice(0, 40)),
+    }
+  }, dqB.id, '场景-温度采集B')
+  if (townUi.state === 'alarm' && townUi.ring === '#ff6b5c' && townUi.alarmText) break
+}
+if (!townUi.alarmText) console.log('  [diag] al rows:', JSON.stringify(townUi.alRows))
+console.log('/town ui:', JSON.stringify(townUi))
+if (townUi.found && townUi.state === 'alarm' && townUi.ring === '#ff6b5c') console.log('PASS 孪生节点 alarm 状态 + 红环')
+else fail(`孪生报警缺失: ${JSON.stringify(townUi)}`)
+if (townUi.alarmText) console.log('PASS 实时告警面板出现越限告警:', townUi.alarmText.slice(0, 50))
+else fail('告警面板无越限条目')
+await page.screenshot({ path: 'docs/audit/screenshots/scenario-town-alarm.png' })
+if (alarmOnDaq) console.log('PASS /daq 页告警面板同步出现越限条目')
+
+// 7.3 /dcw/[lineId] 详情页渲染(A 线):节点表 + 配方卡 + 批次
+await page.goto(`${ROOT}/dcw/${lineA.id}`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+await sleep(6000)
+const detailUi = await page.evaluate(() => ({
+  h1: document.querySelector('h1')?.textContent ?? '',
+  hasRecipe: document.body.textContent.includes('场景配方A'),
+}))
+console.log('/dcw/[id] ui:', JSON.stringify(detailUi))
+if (detailUi.h1.includes('1号产线') && detailUi.hasRecipe) console.log('PASS 产线详情页渲染(A 线数据)')
+else fail(`详情页渲染异常: ${JSON.stringify(detailUi)}`)
+
+if (pageErrors.length) { console.error('pageerrors:', pageErrors.slice(0, 3)); fail('页面 JS 错误') }
+await browser.close()
+
+// ============ 清理 ============
+await jpost(`/api/workshop/dcw/lines/${lineB.id}/stop`, {})
+for (const id of [dqA.id, dqB.id]) await jdel(`/api/workshop/daq/${id}`)
+for (const id of [dwA.id, dwB.id]) await jdel(`/api/workshop/dcw/${id}`)
+for (const id of [rcA.id, rcB.id]) await jdel(`/api/workshop/dcw/recipes/${id}`)
+for (const id of [prodA.id, prodB.id]) await jdel(`/api/workshop/dcw/products/${id}`)
+for (const id of [lineA.id, lineB.id]) await jdel(`/api/workshop/dcw/lines/${id}`)
+console.log('cleanup done')
+
+console.log(process.exitCode ? 'SCENARIO FAILED' : 'SCENARIO ALL PASS')
+process.exit(process.exitCode ?? 0)

package/scripts/_dbg-minimal-omp.mjs

@@ -0,0 +1,77 @@
+/**
+ * 最小复现:omp worker 任务失败根因定位(不清理,便于事后查库)。
+ */
+const ROOT = 'http://127.0.0.1:3000'
+let TOKEN = ''
+const H = () => ({ authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H(), body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jget = (u) => fetch(ROOT + u, { headers: H() }).then(r => r.json())
+
+async function main() {
+  const reg = await jpost('/api/workshop/users/register', { name: 'ompdbg-' + Math.random().toString(36).slice(2, 8) })
+  TOKEN = reg.data?.token
+  if (!TOKEN) { console.error('register failed'); process.exit(1) }
+  console.log('[ok] registered')
+
+  // 产线:1 数采 + 1 数控 + 开跑(Agent 有数据可读)
+  const lineRes = await jpost('/api/workshop/dcw/lines', { name: 'OMPDBG-线' })
+  console.log('[line-res]', JSON.stringify(lineRes).slice(0, 150))
+  const line = lineRes.data.line
+  const dq = (await jpost('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: 'OMPDBG-温度', lineId: line.id, intervalMs: 500 })).data.node
+  const dw = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: 'OMPDBG-设定', lineId: line.id })).data.node
+  const prod = (await jpost('/api/workshop/dcw/products', { name: 'OMPDBG-产品', lineId: line.id })).data.product
+  console.log('[prod]', prod?.id)
+  const rcRes = await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: 'OMPDBG-配方', params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 176, max: 188 }],
+    daqWindows: [{ nodeId: dq.id, min: 100, max: 260 }],
+  })
+  console.log('[rc-res]', JSON.stringify(rcRes).slice(0, 200))
+  const rc = rcRes.data.recipe
+  const st = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  console.log('[line]', st.data?.line?.active ? 'running' : 'FAILED')
+
+  // channel + omp worker(直派,无 lead 调度)
+  const ch = (await jpost('/api/workshop/channels', { name: 'OMPDBG-channel', leadAgent: { name: 'OMPDBG-lead', harness: 'mock', config: { delayMs: 60 } } })).data
+  console.log('[channel]', JSON.stringify(ch).slice(0, 120))
+  const tpl = (await jpost('/api/workshop/agents', {
+    name: 'OMPDBG-worker', harness: 'omp',
+    config: { systemPromptPrefix: '你是测试工程师。收到任务后用 daq_query 读数并汇报均值,不要做其他事。' },
+  })).data
+  await jpost(`/api/workshop/channels/${ch.channelId}/agents`, { agentId: tpl.id, role: 'worker' })
+  const agents = (await jget(`/api/workshop/channels/${ch.channelId}/agents`)).data
+  const worker = agents.find(a => a.role === 'worker')
+  console.log('[worker]', worker?.id?.slice(0, 8), 'harness=' + worker?.harness)
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: worker.id, nodeId: dq.id, kind: 'daq', mode: 'auto' })
+
+  // 直派任务到 worker(assigneeId 直投,不经过 lead)
+  const taskRes = await jpost(`/api/workshop/channels/${ch.channelId}/tasks`, {
+    title: 'OMPDBG-读数任务',
+    parts: [{ text: '用 daq_query 获取 OMPDBG-温度 最近 2 分钟数据,汇报均值。完成后用 complete_task 提交结论。' }],
+    assigneeId: worker.id,
+  })
+  console.log('[task-res]', JSON.stringify(taskRes).slice(0, 260))
+  const task = taskRes.data
+  const taskId = task?.task?.id ?? task?.id
+  console.log('[task]', taskId?.slice(0, 8))
+
+  // 观察任务状态 + 工具审批
+  for (let i = 0; i < 60; i++) {
+    await sleep(3000)
+    const t = (await jget(`/api/workshop/channels/${ch.channelId}/tasks`)).data
+    const arr = Array.isArray(t) ? t : t?.tasks ?? []
+    const me = arr.find(x => x.id === taskId)
+    const proc = await jget('/api/workshop/runtime')
+    if (i % 4 === 0) {
+      console.log(`[t+${i * 3}s] task=${me?.state} progress=${me?.progress} wired=${proc.data?.wiredAgents?.length}`)
+    }
+    if (['COMPLETED', 'FAILED', 'CANCELED'].includes(me?.state)) {
+      console.log('[final]', me?.state)
+      const detail = (await jget(`/api/workshop/tasks/${taskId}`)).data
+      console.log('[history]', JSON.stringify(detail?.history ?? detail?.task?.history ?? []).slice(0, 1500))
+      break
+    }
+  }
+  console.log('[cleanup-hint] channel=' + ch.channelId + ' line=' + line.id)
+}
+main().catch(e => { console.error('FATAL', e.message); process.exit(1) })

package/scripts/_dbg-mode-nav.mjs

@@ -0,0 +1,173 @@
+/**
+ * 运行/编辑只读锁 + 小地图同步 + 数采可视距离 审计:
+ *  1) 运行模式:实体拖拽拒绝 / 投放拒绝+提示 / Inspector 只读(无删除、无绑定添加、名称禁用);
+ *  2) 编辑模式:拖拽放行 / 投放成功 / Inspector 编辑控件在;
+ *  3) 小地图与视角同步:zoomBy 后 meta ×N 变化(navScale=dolly),画布重绘;
+ *  4) 数采可视距离滑杆:300 → 卡隐,3000 → 卡显(注视设备不变);
+ *  5) 截图(编辑模式注视设备,堆叠卡 + 小地图)。
+ */
+import puppeteer from 'puppeteer-core'
+
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const H = { 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+
+const spec = [
+  { name: 'TD 拉幅机 L1', ref: 'dev-folder-tdo', x: 1700, z: 600, kind: 'device' },
+  { name: '温度传感器 01', ref: 'daq-temp-tc', x: 1750, z: 690, kind: 'daq' },
+  { name: '电参采集器 09', ref: 'daq-power-meter', x: 2900, z: 200, kind: 'daq' },
+]
+const created = []
+for (const s of spec) {
+  const res = await fetch(`${BASE}/api/workshop/device-twins`, {
+    method: 'POST', headers: H,
+    body: JSON.stringify({ name: s.name, modelRef: s.ref, kind: s.kind, posX: s.x, posZ: s.z }),
+  })
+  const j = await res.json().catch(() => ({}))
+  const id = j?.data?.twin?.id ?? j?.data?.id
+  if (res.ok && id) created.push({ ...s, id })
+}
+const byName = Object.fromEntries(created.map(c => [c.name, c.id]))
+const bindings = { [byName['温度传感器 01']]: byName['TD 拉幅机 L1'] }
+console.log(`created ${created.length}/${spec.length}`)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--no-first-run', '--disable-extensions', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+await page.evaluateOnNewDocument((b) => {
+  localStorage.setItem('aw.twin.daqBindings', JSON.stringify(b))
+  localStorage.setItem('aw.twin.calloutNear', '1150')
+}, bindings)
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(need => (window.__town?.scene?.deviceNodes?.size ?? 0) >= need, created.length)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 4000))
+
+const twinCount = () => page.evaluate(() => window.__town.scene.deviceNodes.size)
+
+// ---- 1) 运行模式(默认)锁 ----
+// 拖拽门禁:设备「底面」屏幕点起手(y=0 → 射线回投地面即设备根位置)tryStartPointerDrag → false
+const dragGate = await page.evaluate(() => {
+  const s = window.__town.scene
+  const dev = [...s.deviceNodes.values()].find(d => d.modelRef.includes('tdo'))
+  const p = s.worldToScreen(dev.root.position.x, 0, dev.root.position.z)
+  return s.tryStartPointerDrag(p.x, p.y)
+})
+console.log('run dragGate:', dragGate, dragGate === false ? '(OK 运行模式拒绝拖拽)' : '(FAIL 未锁)')
+
+// 投放门禁:drop 数采 → 数量不变 + 只读提示
+const before = await twinCount()
+await page.evaluate(() => {
+  const dt = new DataTransfer()
+  dt.setData('application/x-aw-daq', 'pressure-tx')
+  document.querySelector('#town-host canvas').dispatchEvent(new DragEvent('drop', { dataTransfer: dt, bubbles: true, cancelable: true }))
+})
+await new Promise(r => setTimeout(r, 1200))
+const afterDrop = await twinCount()
+const hint = await page.evaluate(() => document.querySelector('.error-chip')?.textContent ?? '')
+console.log('run drop:', before, '→', afterDrop, afterDrop === before ? '(OK 投放被拒)' : '(FAIL 漏放)', '| hint:', hint.includes('只读') ? '(OK 提示)' : '(FAIL 无提示)')
+
+// Inspector 只读:选中设备 → 无删除钮/无绑定添加/名称禁用
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const dev = [...s.deviceNodes.values()].find(d => d.modelRef.includes('tdo'))
+  s.setSelected({ kind: 'device', id: dev.twinId })
+})
+await new Promise(r => setTimeout(r, 600))
+const ro = await page.evaluate(() => ({
+  del: !!document.querySelector('.ins-del'),
+  bindAdd: !!document.querySelector('.bind-add-wrap'),
+  nameDisabled: document.querySelector('.obj-input')?.disabled ?? null,
+}))
+console.log('run inspector:', JSON.stringify(ro), !ro.del && !ro.bindAdd && ro.nameDisabled === true ? '(OK 只读)' : '(FAIL)')
+
+// ---- 2) 切编辑(点顶栏 seg)→ 解锁 ----
+await page.evaluate(() => {
+  const btn = [...document.querySelectorAll('.topnav .seg button')].find(b => b.textContent?.includes('编辑'))
+  btn?.click()
+})
+await new Promise(r => setTimeout(r, 500))
+const dragGate2 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const dev = [...s.deviceNodes.values()].find(d => d.modelRef.includes('tdo'))
+  const p = s.worldToScreen(dev.root.position.x, 0, dev.root.position.z)
+  const gate = s.tryStartPointerDrag(p.x, p.y)
+  if (gate) s.endPointerDrag()
+  return gate
+})
+await page.evaluate(() => {
+  const dt = new DataTransfer()
+  dt.setData('application/x-aw-daq', 'pressure-tx')
+  document.querySelector('#town-host canvas').dispatchEvent(new DragEvent('drop', { dataTransfer: dt, bubbles: true, cancelable: true }))
+})
+await new Promise(r => setTimeout(r, 1500))
+const afterDrop2 = await twinCount()
+const insp2 = await page.evaluate(() => ({
+  del: !!document.querySelector('.ins-del'),
+  nameDisabled: document.querySelector('.obj-input')?.disabled ?? null,
+}))
+console.log('edit: dragGate', dragGate2, dragGate2 ? '(OK)' : '(FAIL)', '| drop', afterDrop, '→', afterDrop2, afterDrop2 === before + 1 ? '(OK 投放成功)' : '(FAIL)', '| inspector:', JSON.stringify(insp2))
+
+// ---- 3) 小地图与视角同步 ----
+const meta0 = await page.evaluate(() => document.querySelector('.mm-meta')?.textContent ?? '')
+await page.evaluate(() => {
+  const s = window.__town.scene
+  for (let i = 0; i < 2; i++) s.zoomBy(-0.2)
+})
+await new Promise(r => setTimeout(r, 600))
+const meta1 = await page.evaluate(() => document.querySelector('.mm-meta')?.textContent ?? '')
+const sync = meta0.match(/×([\d.]+)/)?.[1] ?? '?'
+const sync1 = meta1.match(/×([\d.]+)/)?.[1] ?? '?'
+console.log('navSync:', sync, '→', sync1, Number(sync1) < Number(sync) ? '(OK 小地图随视角缩放)' : '(FAIL)')
+
+// ---- 4) 数采可视距离滑杆 ----
+await page.evaluate(() => {
+  const s = window.__town.scene
+  s.focusTo(1700, 600)
+})
+await new Promise(r => setTimeout(r, 1800))
+const nearOf = () => page.evaluate(() => [...document.querySelectorAll('.callout')].filter(c => c.classList.contains('near')).length)
+const n0 = await nearOf()
+await page.evaluate(() => {
+  const el = [...document.querySelectorAll('.dock .ctl-row')].find(r => r.textContent?.includes('数采可视距离'))?.querySelector('input')
+  el.value = '300'
+  el.dispatchEvent(new Event('input', { bubbles: true }))
+})
+await new Promise(r => setTimeout(r, 500))
+const n1 = await nearOf()
+await page.evaluate(() => {
+  const el = [...document.querySelectorAll('.dock .ctl-row')].find(r => r.textContent?.includes('数采可视距离'))?.querySelector('input')
+  el.value = '3000'
+  el.dispatchEvent(new Event('input', { bubbles: true }))
+})
+await new Promise(r => setTimeout(r, 500))
+const n2 = await nearOf()
+console.log('calloutDist: 1150→', n0, '张 | 300→', n1, '张 | 3000→', n2, '张',
+  n0 >= 1 && n1 === 0 && n2 >= 1 ? '(OK 距离可控)' : '(FAIL)')
+// 恢复默认并等一拍
+await page.evaluate(() => {
+  const el = [...document.querySelectorAll('.dock .ctl-row')].find(r => r.textContent?.includes('数采可视距离'))?.querySelector('input')
+  el.value = '1150'
+  el.dispatchEvent(new Event('input', { bubbles: true }))
+})
+
+// ---- 5) 截图(编辑模式注视设备)----
+await new Promise(r => setTimeout(r, 600))
+await page.screenshot({ path: 'docs/audit/screenshots/town-mode-nav.png' })
+console.log('pageerrors:', errors.length ? errors : 'none')
+
+await page.close().catch(() => {})
+await browser.close()
+for (const c of created) {
+  await fetch(`${BASE}/api/workshop/device-twins/${c.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+}
+console.log(`cleanup done (${created.length})`)