agentworkshop 0.2.1

package/scripts/_dbg-dcw-twin-e2e.mjs

@@ -0,0 +1,192 @@
+/** E2E:数字孪生智控通道全链路 —— 添加智控通道按钮/检查器绑定/面板直写/配方窗口/越限阻断 */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = process.env.AW_TOKEN ?? 'ut-258a3578a5f2450d92416c08d1c1205f'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fx = await makeLineFixture(ROOT, H, 'twin-e2e 产线')
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const getNode = async (id) => (await (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H })).json()).data.nodes.find(n => n.id === id)
+
+// ---------- REST 前置:专属全新设备孪生 + 产品 + 配方(窗口 176~188) ----------
+const dev = (await (await fetch(`${ROOT}/api/workshop/device-twins`, {
+  method: 'POST', headers: H,
+  body: JSON.stringify({ name: 'E2E 孪生验收机', modelRef: 'dev-folder-extruder', kind: 'device', posX: 2400, posZ: 900 }),
+})).json()).data.twin
+console.log('device:', dev.id, dev.name)
+
+const prod = (await (await fetch(`${ROOT}/api/workshop/dcw/products`, { method: 'POST', headers: H, body: JSON.stringify({ name: 'E2E产品', lineId: fx.line.id }) })).json()).data.product
+// 窗口验证节点:显式挂产线 + 绑定设备;配方参数 nodeId 显式指向它(节点级绑定语义)
+const dwWin = (await (await fetch(`${ROOT}/api/workshop/dcw`, {
+  method: 'POST', headers: H,
+  body: JSON.stringify({ templateRef: 'dcw-temp-sp', name: 'E2E-窗口温度', lineId: fx.line.id, deviceBindingId: dev.id, posX: 2440, posZ: 860 }),
+})).json()).data.node
+const rc = (await (await fetch(`${ROOT}/api/workshop/dcw/recipes`, {
+  method: 'POST', headers: H,
+  body: JSON.stringify({ productId: prod.id, name: 'E2E配方', params: [{ templateRef: 'dcw-temp-sp', nodeId: dwWin.id, value: 182, min: 176, max: 188 }] }),
+})).json()).data.recipe
+const lineStart = await fx.start(rc.id)
+console.log('line active:', lineStart.data?.line?.active)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1400'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1400 })
+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, 160)))
+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(2500)
+
+// ---------- 1. 编辑模式 → 选中设备 → 两个添加按钮并存且顺序正确 ----------
+await page.evaluate(() => {
+  ;[...document.querySelectorAll('button')].find(b => b.textContent.trim() === '编辑')?.click()
+})
+await sleep(600)
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dev.id)
+await sleep(800)
+const btnLayout = await page.evaluate(() => {
+  const adds = [...document.querySelectorAll('.bind-add')].map(b => b.textContent.trim())
+  return { adds, hasDcwBtn: adds.includes('＋ 添加智控通道'), afterDaq: adds.indexOf('＋ 添加智控通道') === adds.indexOf('＋ 添加数采通道') + 1 }
+})
+console.log('add buttons:', JSON.stringify(btnLayout))
+if (!btnLayout.hasDcwBtn || !btnLayout.afterDaq) fail(`添加智控通道按钮缺失或位置不对: ${JSON.stringify(btnLayout)}`)
+else console.log('PASS 添加智控通道按钮位于添加数采通道之下')
+
+// 输入后等 Vue 刷新 disabled 态再点击(否则首击落在仍禁用的按钮上)
+async function panelWrite(page, name, val) {
+  await page.evaluate(({ name, val }) => {
+    const row = [...document.querySelectorAll('.dcw-row')].find(r => r.textContent.includes(name))
+    if (!row) return
+    const inp = row.querySelector('.dcw-write input')
+    const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set
+    setter.call(inp, String(val))
+    inp.dispatchEvent(new Event('input', { bubbles: true }))
+  }, { name, val })
+  await sleep(250)
+  await page.evaluate((name) => {
+    const row = [...document.querySelectorAll('.dcw-row')].find(r => r.textContent.includes(name))
+    row?.querySelector('.dcw-send')?.click()
+  }, name)
+}
+
+// ---------- 2. 点击添加智控通道 → 模板弹层 → 创建并自动绑定 ----------
+await page.evaluate(() => {
+  ;[...document.querySelectorAll('.bind-add')].find(b => b.textContent.trim() === '＋ 添加智控通道')?.click()
+})
+await sleep(500)
+const popRows = await page.evaluate(() => [...document.querySelectorAll('.bind-pop button')].map(b => b.textContent.trim()))
+console.log('dcw pop templates:', JSON.stringify(popRows))
+if (!popRows.some(t => t.includes('温度设定器'))) fail(`模板弹层缺温度设定器: ${JSON.stringify(popRows)}`)
+const beforeCnt = (await (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H })).json()).data.nodes
+  .filter(n => n.templateRef === 'dcw-temp-sp').length
+await page.evaluate(() => {
+  ;[...document.querySelectorAll('.bind-pop button')].find(b => b.textContent.includes('温度设定器'))?.click()
+})
+await sleep(2500)
+const nodes1 = (await (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H })).json()).data.nodes
+const created = nodes1.filter(n => n.templateRef === 'dcw-temp-sp')
+const boundNew = created.find(n => n.deviceBindingId === dev.id && n.id !== dwWin.id)
+console.log(`dcw temp nodes ${beforeCnt} -> ${created.length}; bound to dev: ${boundNew?.id ?? 'none'}`)
+// 设计策略:优先就近复用未绑定节点(计数不变但新增绑定),无复用目标才新建;新建通道继承设备产线
+if (!boundNew) fail('添加智控通道未创建/绑定节点')
+else {
+  const lineOk = !boundNew.lineId || boundNew.lineId === fx.line.id
+  if (lineOk) console.log(`PASS 添加智控通道生效(${created.length > beforeCnt ? '新建并绑定' : '就近复用未绑定节点并绑定'};产线归属 ${boundNew.lineId || '未分配'})`)
+  else fail(`新建通道产线归属错误: ${boundNew.lineId}`)
+}
+const dcwId = boundNew?.id
+const dcwName = boundNew?.name
+
+// ---------- 3. 选中智控节点(dwWin:配方参数显式指向它)→ 检查器 ----------
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dwWin.id)
+await sleep(800)
+const insp = await page.evaluate(() => ({
+  title: [...document.querySelectorAll('.inspector h3')].map(h => h.textContent.trim()).find(t => t.includes('智控')),
+  chip: [...document.querySelectorAll('.ins-chip')].some(c => c.textContent.trim() === 'DCW'),
+  hasBindSel: document.body.textContent.includes('选择设备实例…'),
+  hasWrite: document.body.textContent.includes('下发 write'),
+  winLabel: [...document.querySelectorAll('.daq-info-row')].map(r => r.textContent).find(t => t.includes('配方工艺窗口') || t.includes('节点量程')) ?? '',
+}))
+console.log('dcw inspector:', JSON.stringify(insp))
+if (!(insp.title && insp.chip && insp.hasWrite)) fail(`智控检查器不完整: ${JSON.stringify(insp)}`)
+else if (!insp.winLabel.includes('176') || !insp.winLabel.includes('188')) fail(`检查器窗口未按配方展示: ${insp.winLabel}`)
+else console.log('PASS 智控节点检查器:标题/芯片/直写/配方窗口 176~188')
+
+// ---------- 4. 检查器内解绑 → 重新绑定设备(双向验证;切到 UI 新增的通道) ----------
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dcwId)
+await sleep(600)
+if (insp.hasBindSel) {
+  const dbg = await page.evaluate(() => ({
+    bars: [...document.querySelectorAll('.daq-bind-bar')].map(b => [...b.querySelectorAll('button')].map(x => x.textContent.trim())),
+    devNames: [...document.querySelectorAll('.daq-info-row')].map(r => r.textContent.trim()),
+  }))
+  console.log('bind-bar debug:', JSON.stringify(dbg))
+  await page.evaluate(() => {
+    const bars = [...document.querySelectorAll('.daq-bind-bar')]
+    const bar = bars.find(b => [...b.querySelectorAll('button')].some(x => x.textContent.trim() === '解绑'))
+    bar?.querySelector('button')?.click()
+  })
+  await sleep(1500)
+  const nU = await getNode(dcwId)
+  if (!nU?.deviceBindingId) console.log('PASS 检查器解绑生效')
+  else fail(`解绑未生效: ${nU?.deviceBindingId}`)
+  await page.evaluate((devName) => {
+    const sel = [...document.querySelectorAll('.daq-bind-bar select')].find(s => s.textContent.includes('选择设备实例…'))
+    if (!sel) return
+    const setter = Object.getOwnPropertyDescriptor(window.HTMLSelectElement.prototype, 'value').set
+    const opt = [...sel.options].find(o => o.textContent.trim() === devName)
+    if (!opt) return
+    setter.call(sel, opt.value)
+    sel.dispatchEvent(new Event('change', { bubbles: true }))
+  }, dev.name)
+  await sleep(300)
+  await page.evaluate(() => {
+    const bars = [...document.querySelectorAll('.daq-bind-bar')]
+    const bar = bars.find(b => [...b.querySelectorAll('button')].some(x => x.textContent.trim() === '绑定'))
+    bar?.querySelector('button')?.click()
+  })
+  await sleep(1500)
+  const n1 = await getNode(dcwId)
+  if (n1?.deviceBindingId === dev.id) console.log('PASS 检查器重新绑定设备成功')
+  else fail(`重新绑定失败: ${n1?.deviceBindingId}`)
+}
+
+// ---------- 5. 设备面板:智控设定行 + 配方窗口 + 越窗阻断 + 窗内直写 ----------
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dev.id)
+await sleep(800)
+await panelWrite(page, dwWin.name, 195)
+await sleep(900)
+const overErr = await page.evaluate(() => [...document.querySelectorAll('.dcw-row .dcw-err')].map(e => e.textContent).find(t => t) ?? '')
+console.log('over-window hint:', overErr.slice(0, 80))
+if (overErr.includes('配方工艺窗口')) console.log('PASS 越窗 195 前端阻断并提示配方工艺窗口')
+else fail(`越窗提示缺失: ${overErr}`)
+
+await panelWrite(page, dwWin.name, 180)
+await sleep(1500)
+const n2 = await getNode(dwWin.id)
+console.log('in-window write: value =', n2?.value, 'state =', n2?.state)
+if (n2?.value === 180 && n2?.state === 'ok') console.log('PASS 窗内 180 直写成功且 server ACK')
+else fail(`窗内直写失败: ${n2?.value}/${n2?.state}`)
+
+await page.screenshot({ path: 'docs/audit/screenshots/town-dcw-twin-e2e.png' })
+if (pageErrors.length) { console.error('pageerrors:', pageErrors.slice(0, 3)); fail('页面存在 JS 错误') }
+
+// ---------- 清理(停线 + 删除审计数据与本测试创建的设备) ----------
+await fx.cleanup()
+await fetch(`${ROOT}/api/workshop/dcw/${dwWin.id}`, { method: 'DELETE', headers: H })
+await fetch(`${ROOT}/api/workshop/dcw/${dcwId}`, { method: 'DELETE', headers: H })
+await fetch(`${ROOT}/api/workshop/dcw/recipes/${rc.id}`, { method: 'DELETE', headers: H })
+await fetch(`${ROOT}/api/workshop/dcw/products/${prod.id}`, { method: 'DELETE', headers: H })
+await fetch(`${ROOT}/api/workshop/device-twins/${dev.id}`, { method: 'DELETE', headers: H })
+await browser.close()
+console.log(process.exitCode ? 'E2E FAILED' : 'E2E ALL PASS')

package/scripts/_dbg-dt-interact.mjs

@@ -0,0 +1,193 @@
+/**
+ * Digital-Twin 交互审计(设计稿 OrbitLite 语义 + 四圆钮 + 导航图 + 告警链):
+ *  - 相机:左键拖右 yaw 应减小(内容跟手不反向);Shift+拖 = 平移注视点移动;
+ *    滚轮上 = dolly 减小(拉近);setAutoOrbit 开启后 yaw 自转;
+ *  - 四圆钮:标注显隐 / 自动环绕 / 全屏按钮存在且可点;
+ *  - 导航图:nav-cv 画布有绘制(非全黑)+ 相机锥;
+ *  - 告警链:阈值收紧 → 越限告警入面板 → E-STOP crit 告警;
+ *  - 铺一条薄膜产线 + 数采绑定,截图验收后清理。
+ */
+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 lineZ = 1200
+const spec = [
+  { name: '挤出机 L1', ref: 'dev-folder-extruder', x: 1000, z: lineZ, kind: 'device' },
+  { name: 'MD 纵拉机 L1', ref: 'dev-folder-mdo', x: 1680, z: lineZ, kind: 'device' },
+  { name: 'TD 拉幅机 L1', ref: 'dev-folder-tdo', x: 2080, z: lineZ, kind: 'device' },
+  { name: '收卷机 L1', ref: 'dev-folder-winder', x: 2430, z: lineZ, kind: 'device' },
+  { name: '压力变送器 01', ref: 'daq-pressure-tx', x: 1060, z: lineZ + 70, kind: 'daq' },
+  { name: '温度传感器 01', ref: 'daq-temp-tc', x: 1690, z: lineZ + 80, kind: 'daq' },
+  { name: '张力传感器 01', ref: 'daq-tension-cell', x: 2100, z: lineZ + 80, 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 })
+}
+console.log(`created ${created.length}/${spec.length}`)
+const byName = Object.fromEntries(created.map(c => [c.name, c.id]))
+const bindings = {
+  [byName['压力变送器 01'] ?? 'x']: byName['挤出机 L1'] ?? 'y',
+  [byName['温度传感器 01'] ?? 'x']: byName['MD 纵拉机 L1'] ?? 'y',
+  [byName['张力传感器 01'] ?? 'x']: byName['TD 拉幅机 L1'] ?? 'y',
+}
+
+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))
+}, bindings)
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 200)))
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(need => (window.__town?.scene?.agents?.size ?? 0) > 0 && (window.__town?.scene?.deviceNodes?.size ?? 0) >= need, created.length)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 5000))
+
+// ---- 1) 相机方向语义(全部按设计稿 OrbitLite 断言方向,不只断言位移) ----
+const cam0 = await page.evaluate(() => window.__town.scene.getCameraPose())
+// 左键拖右 60px:theta -= dx·k → yaw 减小(内容跟手)
+await page.evaluate(() => {
+  const cv = window.__town.scene.canvas
+  cv.dispatchEvent(new PointerEvent('pointerdown', { button: 0, clientX: 800, clientY: 400, bubbles: true }))
+})
+for (let i = 0; i < 6; i++) {
+  await page.evaluate(k => window.dispatchEvent(new PointerEvent('pointermove', { clientX: 800 + (k + 1) * 10, clientY: 400, bubbles: true })), i)
+}
+await page.evaluate(() => window.dispatchEvent(new PointerEvent('pointerup', { bubbles: true })))
+const cam1 = await page.evaluate(() => window.__town.scene.getCameraPose())
+const yawDelta = cam1.yaw - cam0.yaw
+console.log('orbit→: yawDelta =', yawDelta.toFixed(4), yawDelta < 0 ? '(OK 设计稿:拖右 yaw 减小)' : '(REVERSED!)')
+
+// 左键下拖 60px:仰角 += dy·k → 相机升高(cam.y 增大,俯视方向)
+const y0 = cam1.pos.y
+await page.evaluate(() => {
+  const cv = window.__town.scene.canvas
+  cv.dispatchEvent(new PointerEvent('pointerdown', { button: 0, clientX: 800, clientY: 400, bubbles: true }))
+})
+for (let i = 0; i < 6; i++) {
+  await page.evaluate(k => window.dispatchEvent(new PointerEvent('pointermove', { clientX: 800, clientY: 400 + (k + 1) * 10, bubbles: true })), i)
+}
+await page.evaluate(() => window.dispatchEvent(new PointerEvent('pointerup', { bubbles: true })))
+const y1 = (await page.evaluate(() => window.__town.scene.getCameraPose())).pos.y
+console.log('orbit↓: cam.y', y0.toFixed(1), '→', y1.toFixed(1), y1 > y0 ? '(OK 设计稿:下拖升向俯视)' : '(REVERSED!)')
+
+// Shift+左键拖右 60px:target += −right·dx → 注视点 x 减小(内容跟随光标右移)
+const t0 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target.x
+await page.evaluate(() => {
+  const cv = window.__town.scene.canvas
+  cv.dispatchEvent(new PointerEvent('pointerdown', { button: 0, shiftKey: true, clientX: 800, clientY: 400, bubbles: true }))
+})
+for (let i = 0; i < 6; i++) {
+  await page.evaluate(k => window.dispatchEvent(new PointerEvent('pointermove', { clientX: 800 + (k + 1) * 10, clientY: 400, bubbles: true })), i)
+}
+await page.evaluate(() => window.dispatchEvent(new PointerEvent('pointerup', { bubbles: true })))
+const t1 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target.x
+console.log('pan→: target.x', t0.toFixed(1), '→', t1.toFixed(1), t1 < t0 ? '(OK 设计稿:拖右注视点 -right)' : '(REVERSED!)')
+
+// Shift+左键下拖 60px:target += up·dy(up 地面分量 = −sinP·(sinY,cosY)) → 注视点 z 减小
+const z0 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target.z
+await page.evaluate(() => {
+  const cv = window.__town.scene.canvas
+  cv.dispatchEvent(new PointerEvent('pointerdown', { button: 0, shiftKey: true, clientX: 800, clientY: 400, bubbles: true }))
+})
+for (let i = 0; i < 6; i++) {
+  await page.evaluate(k => window.dispatchEvent(new PointerEvent('pointermove', { clientX: 800, clientY: 400 + (k + 1) * 10, bubbles: true })), i)
+}
+await page.evaluate(() => window.dispatchEvent(new PointerEvent('pointerup', { bubbles: true })))
+const z1 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target.z
+console.log('pan↓: target.z', z0.toFixed(1), '→', z1.toFixed(1), z1 < z0 ? '(OK 设计稿:下拖 up 分量 −z)' : '(REVERSED!)')
+
+// 滚轮上 = 拉近(dolly 减小)
+const d0 = await page.evaluate(() => window.__town.scene.dolly)
+await page.evaluate(() => {
+  const cv = window.__town.scene.canvas
+  cv.dispatchEvent(new WheelEvent('wheel', { deltaY: -120, bubbles: true, cancelable: true }))
+})
+await new Promise(r => setTimeout(r, 300))
+const d1 = await page.evaluate(() => window.__town.scene.dolly)
+console.log('wheel: dolly', d0.toFixed(3), '→', d1.toFixed(3), d1 < d0 ? '(OK 拉近)' : '(FAIL)')
+
+// 自动环绕
+await page.evaluate(() => window.__town.scene.setAutoOrbit(true))
+const yawA = (await page.evaluate(() => window.__town.scene.getCameraPose())).yaw
+await new Promise(r => setTimeout(r, 1200))
+const yawB = (await page.evaluate(() => window.__town.scene.getCameraPose())).yaw
+console.log('autoOrbit: yaw', yawA.toFixed(4), '→', yawB.toFixed(4), yawB !== yawA ? '(OK 自转)' : '(FAIL)')
+await page.evaluate(() => window.__town.scene.setAutoOrbit(false))
+
+// ---- 2) 四圆钮 + 导航图 + 告警 UI 骨架 ----
+const ui = await page.evaluate(() => ({
+  vpTools: document.querySelectorAll('.stage-top .vp-tool').length,
+  vpSvg: document.querySelectorAll('.stage-top .vp-tool svg').length,
+  navCanvas: !!document.querySelector('.nav-cv'),
+  alarmPanel: !!document.querySelector('.alarm-list'),
+  kpi5: document.querySelectorAll('.kpi-strip .kpi').length,
+  estopBtn: !!document.querySelector('.btn-danger'),
+  threshSlider: [...document.querySelectorAll('.ctl-row .ctl-name')].some(el => el.textContent?.includes('告警阈值')),
+  leaders: !!document.querySelector('.leaders'),
+  callouts: document.querySelectorAll('.callout').length,
+  navBell: !!document.querySelector('.nav-bell-warn'),
+}))
+console.log('ui:', JSON.stringify(ui))
+
+// ---- 3) 导航图非空绘制(读像素) ----
+const navPixels = await page.evaluate(() => {
+  const cv = document.querySelector('.nav-cv')
+  if (!cv) return -1
+  const x = cv.getContext('2d')
+  const d = x.getImageData(0, 0, cv.width, cv.height).data
+  let n = 0
+  for (let i = 3; i < d.length; i += 4) if (d[i] > 0) n++
+  return n
+})
+console.log('navPixels:', navPixels, navPixels > 500 ? '(OK 已绘制)' : '(FAIL 全黑)')
+
+// ---- 4) E-STOP 告警链(点 dock 里的紧急停止,非 inspector 删除钮) ----
+await page.evaluate(() => {
+  const btn = [...document.querySelectorAll('.dock .btn-danger')].find(b => (b.textContent ?? '').includes('紧急停止'))
+  btn?.dispatchEvent(new MouseEvent('click', { bubbles: true }))
+})
+await new Promise(r => setTimeout(r, 500))
+const alarmAfterEstop = await page.evaluate(() => ({
+  rows: document.querySelectorAll('.al-row').length,
+  txt: document.querySelector('.al-row .al-txt')?.textContent ?? '',
+  armed: [...document.querySelectorAll('.dock .btn-danger')].some(b => b.classList.contains('armed')),
+  bell: document.querySelector('.nav-bell-warn')?.textContent?.trim() ?? '',
+}))
+console.log('estop:', JSON.stringify(alarmAfterEstop))
+await page.evaluate(() => {
+  const btn = [...document.querySelectorAll('.dock .btn-danger')].find(b => (b.textContent ?? '').includes('紧急停止'))
+  btn?.dispatchEvent(new MouseEvent('click', { bubbles: true }))
+}) // 解除
+
+// ---- 5) 截图 ----
+await page.evaluate(() => window.__town.scene.focusTo(1700, 1200))
+await new Promise(r => setTimeout(r, 3000))
+await page.screenshot({ path: 'docs/audit/screenshots/town-dt-interact.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})`)

package/scripts/_dbg-error-probe.mjs

@@ -0,0 +1,54 @@
+/** 线上错误响应探针:固化信封契约(形状/状态码/消息非空),任何破坏信封的改动都会在此失败 */
+const BASE = 'http://127.0.0.1:3000'
+let failed = 0
+const okIf = (m, c) => { if (c) console.log(`PASS ${m}`); else { console.log(`FAIL ${m}`); failed++ } }
+const login = await fetch(`${BASE}/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 H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const probe = async (name, url, init, expectStatus, expectCode) => {
+  const r = await fetch(`${BASE}${url}`, init)
+  const j = await r.json().catch(() => null)
+  const envelopeOk = j && 'code' in j && 'message' in j && 'data' in j && j.message
+  okIf(`${name} → HTTP ${r.status} (${expectStatus}) 信封完整 code=${j?.code} msg="${String(j?.message ?? '').slice(0, 40)}"`,
+    r.status === expectStatus && envelopeOk && (!expectCode || String(j?.code) === expectCode))
+}
+
+// ① 无 token → 401 USER_UNAUTHORIZED
+await probe('① 无 token PATCH', '/api/workshop/daq/dn-43f55a32', { method: 'PATCH', headers: { 'content-type': 'application/json' }, body: '{}' }, 401, 'USER_UNAUTHORIZED')
+// ② 坏输入 → 400 VALIDATION_ERROR
+await probe('② 缺 templateRef', '/api/workshop/daq', { method: 'POST', headers: H, body: '{}' }, 400, 'VALIDATION_ERROR')
+// ③ 未匹配路由 → 404 NOT_FOUND(nitro catch-all 信封)
+await probe('③ 未匹配路由 404', '/api/workshop/daq/dn-notexist/write', { method: 'POST', headers: H, body: '{}' }, 404, 'NOT_FOUND')
+// ④ 越窗下发 → 400 VALIDATION_ERROR 且消息带配方窗口
+{
+  const r = await fetch(`${BASE}/api/workshop/dcw/dw-322b1978/write`, { method: 'POST', headers: H, body: JSON.stringify({ value: 500 }) })
+  const j = await r.json().catch(() => null)
+  okIf(`④ 越窗/超量程下发 → HTTP ${r.status}, 消息含量程或窗口语义("${String(j?.message ?? '').slice(0, 46)}...")`, r.status === 400 && /窗口|量程|188|200/.test(j?.message ?? ''))
+}
+// ⑤ 越权 channel → 404 NOT_FOUND
+await probe('⑤ 越权 channel', '/api/workshop/channels/00000000-0000-0000-0000-000000000000/tasks', { headers: H }, 404, 'NOT_FOUND')
+// ⑥ Agent 工具:未绑定节点 → 工具级权限拒绝文本
+{
+  const login2 = await fetch(`${BASE}/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 H2 = { authorization: `Bearer ${login2.data.token}`, 'content-type': 'application/json' }
+  const ch = await fetch(`${BASE}/api/workshop/channels`, { headers: H2 }).then(r => r.json())
+  const channels = Array.isArray(ch.data) ? ch.data : ch.data?.channels ?? []
+  let deniedSeen = false
+  for (const c of channels.slice(0, 12)) {
+    const agents = await fetch(`${BASE}/api/workshop/channels/${c.id}/agents`, { headers: H2 }).then(r => r.json()).catch(() => null)
+    const arr = agents?.data ?? []
+    const ompWorker = arr.find(a => a.harness === 'omp' && a.role === 'worker')
+    if (!ompWorker) continue
+    const r = await fetch(`${BASE}/api/workshop/agent-tools/invoke`, { method: 'POST', headers: H2, body: JSON.stringify({ agentId: ompWorker.id, tool: 'dcw_control', args: { node_id: 'dw-notexist', value: 1 } }) }).then(r => r.json()).catch(() => null)
+    const text = String(r?.data?.result?.text ?? '')
+    if (/无权|不存在/.test(text)) { deniedSeen = true; console.log(`⑥ Agent 工具权限拒绝: ${text.slice(0, 70)}`) }
+    break
+  }
+  okIf('⑥ Agent 工具对未知节点返回可读拒绝(非静默)', deniedSeen)
+}
+
+console.log(failed ? `ERROR PROBE FAILED(${failed})` : 'ERROR PROBE ALL PASS')
+process.exit(failed ? 1 : 0)

package/scripts/_dbg-filter-light-verify.mjs

@@ -0,0 +1,54 @@
+/** 验证:/dcw 筛选交互 + 仪表盘亮色模式。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+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'],
+})
+
+// ---- A. /dcw 筛选 ----
+const p1 = await browser.newPage()
+await p1.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+await p1.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await p1.goto(`${ROOT}/dcw`, { waitUntil: 'domcontentloaded', timeout: 45000 })
+await sleep(6000)
+const cardCount = () => p1.evaluate(() => document.querySelectorAll('.line-grid .line-card:not(.new-card)').length)
+console.log('[dcw] all cards:', await cardCount())
+const segBtns = await p1.$$('.fleet-filter .aw-seg button')
+console.log('[dcw] seg labels:', await p1.evaluate(() => [...document.querySelectorAll('.fleet-filter .aw-seg button')].map(b => b.textContent.trim())))
+await segBtns[1].click()
+await sleep(500)
+console.log('[dcw] running filter cards:', await cardCount())
+await segBtns[0].click()
+await sleep(400)
+await p1.type('.fleet-search', '1号')
+await sleep(600)
+console.log('[dcw] search「1号」cards:', await cardCount())
+await p1.evaluate(() => { document.querySelector('.fleet-search').value = '' })
+await p1.click('.fleet-filter .aw-seg button')
+await sleep(600)
+const hd = await p1.$('.page')
+await hd.screenshot({ path: 'docs/audit/screenshots/redesign0831/dcw-filter.png' })
+
+// ---- B. 仪表盘亮色 ----
+const p2 = await browser.newPage()
+await p2.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+await p2.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await p2.evaluateOnNewDocument(() => localStorage.setItem('app', JSON.stringify({ isDark: false, sidebarCollapsed: false, accent: null })))
+await p2.goto(`${ROOT}/`, { waitUntil: 'domcontentloaded', timeout: 45000 })
+await sleep(9000)
+console.log('[light] html.dark:', await p2.evaluate(() => document.documentElement.classList.contains('dark')))
+await p2.screenshot({ path: 'docs/audit/screenshots/redesign0831/dash-light.png' })
+
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-final-acceptance-2.mjs

@@ -0,0 +1,72 @@
+/** 最终验收续跑:T4 恢复增长确认 + T5 真实 Modbus 下发 + T6 Agent 权限 */
+const BASE = 'http://127.0.0.1:3000'
+const login = await fetch(`${BASE}/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 H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const J = (u, m = 'GET', b) => fetch(BASE + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+const fails = []
+const okIf = (m, c) => { if (c) console.log(`PASS ${m}`); else { console.log(`FAIL ${m}`); fails.push(m) } }
+const metaWithRetry = async () => {
+  for (let i = 0; i < 5; i++) {
+    const d = (await J('/api/workshop/daq')).data
+    if (d?.meta) return d.meta
+    await sleep(1500)
+  }
+  return null
+}
+
+// ── T4 恢复增长确认(线已在 T4 末尾复跑) ──
+{
+  const m1 = await metaWithRetry()
+  await sleep(6000)
+  const m2 = await metaWithRetry()
+  okIf(`T4 复跑恢复: produced ${m1?.produced} → ${m2?.produced}(增长)`, m2?.produced > m1?.produced)
+  const consumedOk = (m2?.consumed ?? 0) > 0 && (m2?.samplesStored ?? 0) > 0
+  okIf(`T4 消费链路: consumed=${m2?.consumed} samplesStored=${m2?.samplesStored}(队列消费+入库在走)`, consumedOk)
+}
+
+// ── T5 真实 Modbus PLC 下发 ──
+{
+  let mk = (await J('/api/workshop/dcw')).data.nodes.find(n => n.name === '真机-温度设定')
+  const w = await fetch(`${BASE}/api/workshop/dcw/${mk.id}/write`, { method: 'POST', headers: H, body: JSON.stringify({ value: 175 }) }).then(r => r.json())
+  const oc = w.data?.outcome
+  okIf(`T5 真实 PLC 写: 175 → raw ${oc?.raw}(回读一致) msg=${String(oc?.message ?? '').slice(0, 45)}`, w.code === 0 && oc?.ok === true && oc?.raw === 1000)
+  const w2 = await fetch(`${BASE}/api/workshop/dcw/${mk.id}/write`, { method: 'POST', headers: H, body: JSON.stringify({ value: 180 }) }).then(r => r.json())
+  okIf(`T5 真实 PLC 写: 180 → raw ${w2.data?.outcome?.raw}(1200)`, w2.code === 0 && w2.data?.outcome?.ok === true && w2.data?.outcome?.raw === 1200)
+  await sleep(4500)
+  const daqLive = (await J('/api/workshop/daq')).data.nodes.find(n => n.name === '真机-温度采集')
+  okIf(`T5 真机数采: ${daqLive?.name} = ${daqLive?.value} ${daqLive?.unit} (${daqLive?.state}, 真实 Modbus 读 40003)`, daqLive?.value != null && daqLive?.value > 100 && daqLive?.state === 'ok')
+}
+
+// ── T6 Agent 权限注入 ──
+{
+  const worker = '0effc739-d9a0-4ab3-b14f-98596e0a44ca'
+  const unboundDcw = (await J('/api/workshop/dcw')).data.nodes.find(n => n.name === '真机-温度设定')
+  const denied = await J('/api/workshop/agent-tools/invoke', 'POST', { agentId: worker, tool: 'dcw_control', args: { nodeId: unboundDcw.id, value: 185 } }).then(r => r.data?.result)
+  const deniedText = String(denied?.text ?? denied ?? '')
+  okIf(`T6 无绑定节点 dcw_control 被拒(${deniedText.slice(0, 60)})`, /未授权|无权|绑定|denied|权限|失败|拒绝|error/i.test(deniedText))
+
+  const dwTemp = (await J('/api/workshop/dcw')).data.nodes.find(n => n.name === '温度设定器(示例)')
+  await J('/api/workshop/agent-tools/invoke', 'POST', { agentId: worker, tool: 'dcw_control', args: { nodeId: dwTemp.id, value: 184 } })
+  const pend = (await J(`/api/workshop/agent-tools/approvals?agentId=${worker}`)).data.approvals
+  okIf(`T6 已绑定节点发起下发 → HITL 待审(${pend.length} 条)`, pend.length > 0)
+  if (pend.length > 0) {
+    await J(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, 'POST', { approved: false, comment: '最终验收:保持 183,拒绝本次变更' })
+    await sleep(1200)
+    const now = (await J('/api/workshop/dcw')).data.nodes.find(n => n.id === dwTemp.id)
+    const pendAfter = (await J(`/api/workshop/agent-tools/approvals?agentId=${worker}`)).data.approvals
+    okIf(`T6 HITL 拒绝路径: pending 收敛(${pendAfter.length})且值保持(${now.value})`, pendAfter.length === 0 && Math.abs(now.value - 183) < 0.01)
+  }
+  const q = await J('/api/workshop/agent-tools/invoke', 'POST', { agentId: worker, tool: 'daq_query', args: { last_minutes: 5 } }).then(r => r.data?.result)
+  const qText = String(q?.text ?? '')
+  okIf('T6 daq_query 仅列有权节点(有压力/温度,无真机-温度采集)', qText.includes('压力变送器 01') && !qText.includes('真机-温度采集'))
+}
+
+console.log('')
+console.log(fails.length ? `=== 续跑 FAILED(${fails.length}) ===` : '=== 续跑 ALL PASS ===')
+fails.forEach(f => console.log(' -', f))
+process.exit(fails.length ? 1 : 0)