agentworkshop 0.2.1

package/scripts/_dbg-twindaq-focus.mjs

@@ -0,0 +1,81 @@
+/** 一次性:设备面板数采监控行聚焦验证 —— 存量有值节点临时绑定 → twin-daq 行出现 → 还原 */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+let TOKEN = ''
+const H = () => ({ 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+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())
+TOKEN = login.data.token
+const OUT = 'docs/audit/screenshots/ui-polish-0831'
+
+const daq = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+const valued = daq.data.nodes.filter(n => n.value != null && n.state !== 'offline')
+const node = valued[0]
+console.log('probe node:', node.id, node.name, 'value =', node.value, '| original binding:', node.deviceBindingId)
+
+const dev = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H() }).then(r => r.json())
+const twinsRaw = dev?.data?.twins ?? dev?.data ?? []
+const target = twinsRaw.find(t => typeof t.posX === 'number' && !String(t.id).startsWith('dn-'))
+console.log('target device:', target.id, target.name)
+
+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: TOKEN, domain: '127.0.0.1', path: '/' })
+
+try {
+  await page.goto(`${BASE}/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 new Promise(r => setTimeout(r, 1000))
+  }
+  await new Promise(r => setTimeout(r, 2500))
+
+  // 展开该节点所在模板组(按 node.templateRef 找 daq-<key>)
+  const tplKey = node.templateRef.startsWith('daq-') ? node.templateRef.slice(4) : node.templateRef
+  await page.evaluate((key) => {
+    const ls = window.localStorage
+    const cur = JSON.parse(ls.getItem('aw.twin.treeOpen') || '{}')
+    cur[`daq:${key}`] = true
+    ls.setItem('aw.twin.treeOpen', JSON.stringify(cur))
+  }, tplKey)
+  await page.reload({ waitUntil: 'domcontentloaded' })
+  for (let i = 0; i < 40; i++) {
+    if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+    await new Promise(r => setTimeout(r, 1000))
+  }
+  await new Promise(r => setTimeout(r, 2000))
+
+  // 绑定(REST;WS 收敛到面板)
+  await fetch(`${BASE}/api/workshop/daq/${node.id}/bind`, { method: 'POST', headers: H(), body: JSON.stringify({ deviceId: target.id }) })
+  await new Promise(r => setTimeout(r, 1800))
+
+  await page.evaluate((devId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: devId })
+  }, target.id)
+  await new Promise(r => setTimeout(r, 1200))
+
+  const res = await page.evaluate((nodeName) => {
+    const rows = [...document.querySelectorAll('.twin-daq .daq-item')].map(el => el.textContent?.trim())
+    const leaf = [...document.querySelectorAll('.daq-node')].find(el => el.textContent?.includes(nodeName))
+    return { rows, leafText: leaf?.textContent?.replace(/\s+/g, ' ').trim().slice(0, 80) ?? null }
+  }, node.name)
+  console.log('twin-daq rows:', res.rows.length, JSON.stringify(res.rows.slice(0, 4)))
+  console.log('rail leaf row:', res.leafText)
+  await page.screenshot({ path: `${OUT}/tree-device-daq-panel.png` })
+}
+finally {
+  // 还原原绑定
+  await fetch(`${BASE}/api/workshop/daq/${node.id}/bind`, { method: 'POST', headers: H(), body: JSON.stringify({ deviceId: node.deviceBindingId ?? null }) })
+  console.log('binding restored →', node.deviceBindingId ?? 'null')
+  await browser.close()
+}
+console.log('done')

package/scripts/_dbg-ui-polish-shot.mjs

@@ -0,0 +1,43 @@
+/** 一次性:UI 打磨基线 —— /daq /dcw /dcw-line 详情页截图 */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+const H = { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }
+
+const dcwLines = await fetch(`${BASE}/api/workshop/dcw/lines`, { headers: H }).then(r => r.json()).catch(() => null)
+const lineId = dcwLines?.data?.lines?.[0]?.id ?? dcwLines?.data?.[0]?.id
+console.log('line =', lineId)
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+const OUT = 'docs/audit/screenshots/ui-polish-0831'
+await page.goto(`${BASE}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 6000))
+await page.screenshot({ path: `${OUT}/daq-list.png` })
+console.log('daq ok')
+
+await page.goto(`${BASE}/dcw`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 5000))
+await page.screenshot({ path: `${OUT}/dcw-list.png` })
+console.log('dcw ok')
+
+if (lineId) {
+  await page.goto(`${BASE}/dcw/${lineId}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await new Promise(r => setTimeout(r, 5000))
+  await page.screenshot({ path: `${OUT}/dcw-line.png` })
+  console.log('dcw-line ok')
+}
+await browser.close()

package/scripts/_dbg-ui-polish-verify1.mjs

@@ -0,0 +1,92 @@
+/** 一次性:UI 打磨验证轮 1 —— node-close 悬停显隐 / page-fade 类 / dcw Popconfirm */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+const OUT = 'docs/audit/screenshots/ui-polish-0831'
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+// ── T1: AppHeader 航点悬停 → 关闭钮淡入(预留槽位,零布局抖动) ──
+await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 9000))
+const node = await page.$('.trail-node')
+const box = await node.boundingBox()
+const before = await page.evaluate(() => {
+  const el = document.querySelector('.node-close')
+  const cs = getComputedStyle(el)
+  const chipW0 = document.querySelector('.trail-node').getBoundingClientRect().width
+  return { opacity: cs.opacity, transform: cs.transform, chipW: chipW0 }
+})
+await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2)
+await new Promise(r => setTimeout(r, 400))
+const after = await page.evaluate(() => {
+  const cs = getComputedStyle(document.querySelector('.node-close'))
+  const chipW1 = document.querySelector('.trail-node').getBoundingClientRect().width
+  return { opacity: cs.opacity, transform: cs.transform, chipW: chipW1 }
+})
+console.log('T1 node-close before:', JSON.stringify(before))
+console.log('T1 node-close after :', JSON.stringify(after), '| layoutShift =', Math.abs(after.chipW - before.chipW))
+await page.screenshot({ path: `${OUT}/t1-header-hover.png`, clip: { x: 0, y: 0, width: 800, height: 56 } })
+
+// ── T2: 路由切换 page-fade(仪表盘 → API Token) ──
+const nav = page.goto(`${BASE}/tokens`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+await nav
+let sawEnterActive = false
+for (let i = 0; i < 30; i++) {
+  sawEnterActive = await page.evaluate(() => !!document.querySelector('.page-fade-enter-active, .page-fade-leave-active'))
+  if (sawEnterActive) break
+  await new Promise(r => setTimeout(r, 10))
+}
+await new Promise(r => setTimeout(r, 2000))
+console.log('T2 page-fade class seen:', sawEnterActive)
+await page.screenshot({ path: `${OUT}/t2-tokens-after-nav.png` })
+
+// ── T3: dcw 产线卡 ✕ → Popconfirm(替代原生 confirm) ──
+await page.goto(`${BASE}/dcw`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 8000))
+const del = await page.$('.lc-del')
+if (!del) {
+  console.log('T3: no lc-del button found')
+}
+else {
+  const dbox = await del.boundingBox()
+  await page.mouse.move(dbox.x + dbox.width / 2, dbox.y + dbox.height / 2)
+  await new Promise(r => setTimeout(r, 200))
+  await page.mouse.click(dbox.x + dbox.width / 2, dbox.y + dbox.height / 2)
+  await new Promise(r => setTimeout(r, 700))
+  const pop = await page.evaluate(() => {
+    const el = document.querySelector('.ant-popover')
+    if (!el) return { open: false }
+    const cs = getComputedStyle(el)
+    return { open: cs.display !== 'none' && !el.classList.contains('ant-popover-hidden'), text: (el.innerText || '').slice(0, 60) }
+  })
+  console.log('T3 popconfirm:', JSON.stringify(pop))
+  await page.screenshot({ path: `${OUT}/t3-dcw-popconfirm.png` })
+  // 点取消关闭(不删除,无副作用)
+  const cancelBtn = await page.$('.ant-popover .ant-btn:not(.ant-btn-dangerous)')
+  if (cancelBtn) await cancelBtn.click()
+  await new Promise(r => setTimeout(r, 500))
+  const closed = await page.evaluate(() => {
+    const el = document.querySelector('.ant-popover:not(.ant-popover-hidden)')
+    return !el
+  })
+  console.log('T3 popconfirm dismissed (cancel):', closed)
+  const lineCount = await page.evaluate(() => document.querySelectorAll('.line-card').length)
+  console.log('T3 line cards intact:', lineCount)
+}
+
+await browser.close()
+console.log('verify1 done')

package/scripts/_dbg-ui-polish-verify2.mjs

@@ -0,0 +1,50 @@
+/** 一次性:UI 打磨验证轮 2 —— 客户端路由 page-fade 类捕获 */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+const OUT = 'docs/audit/screenshots/ui-polish-0831'
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+await page.goto(`${BASE}/tokens`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 5000))
+
+// 客户端导航:点击侧栏「运行时监控」
+const seen = { leave: false, enter: false }
+page.on('framenavigated', () => {})
+const clickAndWatch = async () => {
+  const items = await page.$$('.menu-item')
+  // 第 8 个 = /monitor
+  await items[7].click()
+  for (let i = 0; i < 60; i++) {
+    const r = await page.evaluate(() => ({
+      leave: !!document.querySelector('.page-fade-leave-active'),
+      enter: !!document.querySelector('.page-fade-enter-active'),
+      path: location.pathname,
+    }))
+    if (r.leave) seen.leave = true
+    if (r.enter) seen.enter = true
+    if (r.path === '/monitor' && !r.enter && !r.leave && i > 5) break
+    await new Promise(r2 => setTimeout(r2, 10))
+  }
+}
+await clickAndWatch()
+console.log('T2 page-fade leave seen:', seen.leave, '| enter seen:', seen.enter)
+await new Promise(r => setTimeout(r, 2500))
+console.log('T2 final path ok:', await page.evaluate(() => location.pathname))
+await page.screenshot({ path: `${OUT}/t2-monitor-after-clientnav.png` })
+await browser.close()
+console.log('verify2 done')

package/scripts/_dbg-ui-polish-verify3.mjs

@@ -0,0 +1,51 @@
+/** 一次性:UI 打磨验证轮 3 —— page-fade 用 MutationObserver 捕获(只读观测) */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+const OUT = 'docs/audit/screenshots/ui-polish-0831'
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+await page.goto(`${BASE}/tokens`, { waitUntil: 'networkidle0', timeout: 90000 })
+await new Promise(r => setTimeout(r, 4000))
+
+// 只读 MutationObserver:记录 page-fade 类的出现
+await page.evaluate(() => {
+  window.__fadeSeen = { leave: 0, enter: 0 }
+  const mo = new MutationObserver(() => {
+    if (document.querySelector('.page-fade-leave-active')) window.__fadeSeen.leave++
+    if (document.querySelector('.page-fade-enter-active')) window.__fadeSeen.enter++
+  })
+  mo.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'] })
+})
+
+// 点击侧栏「运行时监控」(重试至路径变化)
+const items = await page.$$('.menu-item')
+await items[7].click()
+for (let i = 0; i < 20; i++) {
+  const path = await page.evaluate(() => location.pathname)
+  if (path === '/monitor') break
+  const list = await page.$$('.menu-item')
+  await list[7].click()
+  await new Promise(r => setTimeout(r, 700))
+}
+await new Promise(r => setTimeout(r, 1200))
+const seen = await page.evaluate(() => window.__fadeSeen)
+console.log('T2 fade leave count:', seen.leave, '| enter count:', seen.enter)
+console.log('T2 final path:', await page.evaluate(() => location.pathname))
+await page.screenshot({ path: `${OUT}/t2-monitor-after-clientnav.png` })
+await browser.close()
+console.log('verify3 done')

package/scripts/_dbg-ui-polish-verify4.mjs

@@ -0,0 +1,50 @@
+/** 一次性:UI 打磨验证轮 4 —— dcw Popconfirm 完整确认/取消链路 */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+await page.goto(`${BASE}/dcw`, { waitUntil: 'networkidle0', timeout: 90000 })
+await new Promise(r => setTimeout(r, 5000))
+const count0 = await page.evaluate(() => document.querySelectorAll('.line-card').length)
+
+const del = await page.$('.lc-del')
+const dbox = await del.boundingBox()
+await page.mouse.click(dbox.x + dbox.width / 2, dbox.y + dbox.height / 2)
+await new Promise(r => setTimeout(r, 600))
+
+// 点「取消」(popconfirm 按钮组内第一个按钮)
+const cancelled = await page.evaluate(() => {
+  const btns = [...document.querySelectorAll('.ant-popover:not([style*="display: none"]) .ant-popconfirm-buttons button, .ant-popover:not(.ant-popover-hidden) .ant-popconfirm-buttons button')]
+  const cancel = btns.find(b => /取\s*消|Cancel/.test(b.innerText))
+  if (!cancel) return false
+  cancel.click()
+  return true
+})
+await new Promise(r => setTimeout(r, 600))
+const count1 = await page.evaluate(() => document.querySelectorAll('.line-card').length)
+const popGone = await page.evaluate(() => !document.querySelector('.ant-popover:not(.ant-popover-hidden)'))
+console.log('T3b cancel clicked:', cancelled, '| pop gone:', popGone, '| cards', count0, '→', count1, '| nothing deleted:', count0 === count1)
+
+// 悬停 ✕ 时按压反馈 transform 存在性(只读检查 CSS 生效)
+const hasTransition = await page.evaluate(() => {
+  const el = document.querySelector('.lc-del')
+  return getComputedStyle(el).transitionProperty.includes('transform')
+})
+console.log('T3b lc-del press transition wired:', hasTransition)
+await browser.close()
+console.log('verify4 done')

package/scripts/_dbg-ui-shot.mjs

@@ -0,0 +1,26 @@
+/** 一次性:全页 UI 截图(高视口,右轨完整)+ 右轨滚动到底截图 */
+import puppeteer from 'puppeteer-core'
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1600'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1600 })
+await page.setCookie({ name: 'token', value: 'ut-bdebd04701084e8ab6a1a4c51f5375e4', domain: '127.0.0.1', path: '/' })
+await page.goto('http://127.0.0.1:3000/town', { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.agents?.size ?? 0) > 0)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 4500))
+await page.screenshot({ path: 'docs/audit/screenshots/town-ui-full.png' })
+await page.evaluate(() => {
+  const rail = document.querySelector('.rail-right')
+  if (rail) rail.scrollTop = rail.scrollHeight
+})
+await new Promise(r => setTimeout(r, 500))
+await page.screenshot({ path: 'docs/audit/screenshots/town-ui-right-bottom.png' })
+await browser.close()
+console.log('shots ok')

package/scripts/_dbg-unify-shot.mjs

@@ -0,0 +1,43 @@
+/** 一次性:全站页面截图(控制室暗色统一化验证)——登录态 + 各主路由 */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+
+// 登录拿会话 token(种子管理员)
+const loginRes = 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 token = loginRes?.data?.token
+if (!token) throw new Error(`login failed: ${JSON.stringify(loginRes).slice(0, 200)}`)
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+const PAGES = [
+  ['dashboard', '/'],
+  ['workshop', '/workshop'],
+  ['town', '/town'],
+  ['tokens', '/tokens'],
+  ['users', '/users'],
+  ['monitor', '/monitor'],
+  ['settings', '/settings'],
+]
+
+for (const [name, path] of PAGES) {
+  await page.goto(`${BASE}${path}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await new Promise(r => setTimeout(r, name === 'town' ? 8000 : 3200))
+  await page.screenshot({ path: `docs/audit/screenshots/unify-${name}.png` })
+  const dark = await page.evaluate(() => document.documentElement.classList.contains('dark'))
+  console.log(`${name}: dark=${dark}`)
+}
+
+await browser.close()
+console.log('shots ok')

package/scripts/_dbg-uplink-probe.mjs

@@ -0,0 +1,36 @@
+/** 一次性:上行 sub 帧 → channel.snapshot 的直达验证(Node 原生 WS) */
+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 token = login.data.token
+const H = { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }
+const chanId = (await fetch(`${BASE}/api/workshop/channels`, { headers: H }).then(r => r.json())).data[0]?.id
+console.log('channel =', chanId)
+
+const seen = { open: false, pong: false, snap: false, err: null, daqReading: 0 }
+const sock = new WebSocket(`ws://127.0.0.1:3000/api/workshop/ws?token=${token}`)
+sock.onopen = () => {
+  seen.open = true
+  sock.send(JSON.stringify({ type: 'ping' }))
+}
+sock.onmessage = (ev) => {
+  const d = JSON.parse(String(ev.data))
+  if (d.type === 'pong') {
+    if (!seen.pong) {
+      seen.pong = true
+      console.log('pong → sending sub')
+      sock.send(JSON.stringify({ type: 'sub', channelId: chanId, token }))
+    }
+    return
+  }
+  if (d.type === 'channel.snapshot') { seen.snap = true; console.log('snapshot arrived') }
+  else if (d.type === 'daq.reading') seen.daqReading++
+  else if (d.type === 'error') { seen.err = d.payload }
+}
+setTimeout(() => {
+  console.log(JSON.stringify(seen))
+  process.exit(0)
+}, 6000)

package/scripts/_dbg-wizard-preview-shot.mjs

@@ -0,0 +1,58 @@
+/** 一次性:preview 修复验证(town 左轨模型库裁剪)+ 添加节点向导截图(真实场景动态表单) */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+
+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: token, domain: '127.0.0.1', path: '/' })
+
+// ---- 1) town 左轨模型库:裁剪左轨区域(preview 缩略图) ----
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 9000))
+const lib = await page.$('.rail-left')
+if (lib) {
+  const box = await lib.boundingBox()
+  if (box) await lib.screenshot({ path: 'docs/audit/screenshots/preview-fix-library.png' })
+}
+// 额外:数采模板面板那一段(能看到卡片 3D 缩略)
+await page.evaluate(() => { const el = document.querySelector('.rail-left'); if (el) el.scrollTop = 360 })
+await new Promise(r => setTimeout(r, 1500))
+if (lib) await lib.screenshot({ path: 'docs/audit/screenshots/preview-fix-library-scrolled.png' })
+console.log('library shots ok')
+
+// ---- 2) /daq 添加节点向导:真实场景动态表单 + 测试连接 ----
+await page.goto(`${BASE}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 4500))
+const addBtn = await page.$('.add-btn')
+if (addBtn) {
+  await addBtn.click()
+  await new Promise(r => setTimeout(r, 600))
+  // 切到真实设备采集
+  const segs = await page.$$('.seg')
+  if (segs[1]) await segs[1].click()
+  await new Promise(r => setTimeout(r, 600))
+  // 填入模拟器参数(不点测试,截静态表单)
+  await page.type('input[placeholder="192.168.1.10"]', '127.0.0.1').catch(() => {})
+  await page.screenshot({ path: 'docs/audit/screenshots/daq-add-wizard-real.png' })
+  // 点测试连接(打到 1502 模拟器)
+  const btns = await page.$$('.test-row .pill-btn')
+  if (btns[0]) {
+    await btns[0].click()
+    await new Promise(r => setTimeout(r, 2500))
+    await page.screenshot({ path: 'docs/audit/screenshots/daq-add-wizard-tested.png' })
+  }
+  console.log('wizard shots ok')
+}
+await browser.close()

package/scripts/_dbg-wizard-ui-e2e.mjs

@@ -0,0 +1,93 @@
+/**
+ * 一次性:前端点击式向导 e2e —— 真实用户路径(UI 无 REST 直调):
+ * 打开向导 → 真实设备采集 → Modbus TCP → 填模拟器参数 → 测试连接(断言成功)
+ * → 创建 → 列表出现新节点(modbus-tcp 驱动)→ 控制台实时值非空 → 清理。
+ */
+import puppeteer from 'puppeteer-core'
+
+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 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(`${BASE}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 5000))
+
+// 1) 打开向导
+const before = await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr:not([style*="display: none"])').length)
+await page.click('.add-btn')
+await new Promise(r => setTimeout(r, 800))
+const diag = await page.evaluate(() => ({
+  modal: Boolean(document.querySelector('.modal')),
+  segs: [...document.querySelectorAll('.seg')].map(x => x.textContent?.trim()),
+  mask: Boolean(document.querySelector('.modal-mask')),
+}))
+console.log('[diag]', JSON.stringify(diag))
+if (!diag.modal) { console.log('=== UI WIZARD E2E FAIL(向导未打开)==='); await browser.close(); process.exit(1) }
+
+// 2) 真实设备采集
+const segs = await page.$$('.modal .seg')
+await segs[1].click()
+await new Promise(r => setTimeout(r, 400))
+
+// 3) 协议保持 Modbus TCP(默认),填参数
+await page.type('.modal input[placeholder="192.168.1.10"]', '127.0.0.1')
+const numInputs = await page.$$('.modal .driver-form input[type="number"]')
+// driver-form 顺序:port(默认502) / unitId(1) / register(空) / scale(1)
+await numInputs[0].evaluate((el) => { el.value = '' })
+await numInputs[0].type('1502')
+if (numInputs[2]) await numInputs[2].type('40001')
+
+// 4) 测试连接 → 断言成功文案
+await page.click('.modal .test-row .pill-btn')
+await page.waitForFunction(() => (document.querySelector('.modal .test-result')?.textContent ?? '').length > 2, { timeout: 20000 })
+const testMsg = await page.evaluate(() => document.querySelector('.modal .test-result')?.textContent)
+console.log('[UI test-connection]', testMsg)
+await page.screenshot({ path: 'docs/audit/screenshots/wizard-ui-tested.png' })
+
+// 5) 创建 → 列表出现新节点
+const createBtns = await page.$$('.m-actions .aw-pill')
+await createBtns[1].click()
+await page.waitForFunction(() => !document.querySelector('.modal-mask'), { timeout: 15000 })
+await new Promise(r => setTimeout(r, 3500))
+const after = await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length)
+console.log('[table rows before/after]', before, '→', after)
+const tableTxt = await page.evaluate(() => document.querySelector('.nodes-table')?.innerText ?? '')
+const hasNew = /modbus-tcp/.test(tableTxt)
+console.log('[table has modbus-tcp node]', hasNew)
+await page.screenshot({ path: 'docs/audit/screenshots/wizard-ui-created.png' })
+
+// 6) 进控制台看实时值
+// 断言:UI 创建的 modbus-tcp 行存在且状态正常、有实时值(表行内即完整证据)
+await page.waitForFunction(() => {
+  const rows = [...document.querySelectorAll('.nodes-table tbody tr')]
+  return rows.some(r => r.innerText.includes('modbus-tcp') && r.innerText.includes('正常') && /MPa|kW|℃/.test(r.innerText))
+}, { timeout: 20000 })
+const newRow = await page.evaluate(() => {
+  const rows = [...document.querySelectorAll('.nodes-table tbody tr')]
+  const r = rows.find(x => x.innerText.includes('modbus-tcp') && x.innerText.includes('正常'))
+  return r?.innerText.replace(/\s+/g, ' ').slice(0, 120) ?? ''
+})
+console.log('[created row live]', newRow)
+await page.screenshot({ path: 'docs/audit/screenshots/wizard-ui-created.png' })
+const pass = after > before && hasNew && newRow.includes('正常')
+
+// 清理:本 e2e 产生的 modbus-tcp 测试节点(保留 7 个 mock 基线)
+const list2 = await fetch(`${BASE}/api/workshop/daq`, { headers: { authorization: `Bearer ${login.data.token}` } }).then(r => r.json())
+for (const n of list2.data.nodes.filter(x => x.driver === 'modbus-tcp')) {
+  await fetch(`${BASE}/api/workshop/daq/${n.id}`, { method: 'DELETE', headers: { authorization: `Bearer ${login.data.token}` } })
+}
+console.log('[cleanup] modbus-tcp test nodes removed')
+console.log(pass ? '=== UI WIZARD E2E PASS ===' : '=== UI WIZARD E2E FAIL ===')
+await browser.close()
+process.exit(pass ? 0 : 1)