agentworkshop 0.2.1

package/scripts/_dbg-town-daq-shot.mjs

@@ -0,0 +1,26 @@
+/** 一次性:数字孪生页截图(验证 server 驱动的数采节点 3D 渲染 + 值卡) */
+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())
+await page0(login.data.token)
+
+async function page0(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}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await new Promise(r => setTimeout(r, 18000))
+  await page.screenshot({ path: 'docs/audit/screenshots/daq-town-live.png' })
+  console.log('town shot ok')
+  await browser.close()
+}

package/scripts/_dbg-town-full-e2e.mjs

@@ -0,0 +1,104 @@
+/** 数字孪生完整 E2E:帧率切换/实时消费/趋势/绑定/数采/数控下发/事件渲染。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const H = { authorization: 'Bearer ut-ffc1dfbbc0c1444c87c1ec69a9e8208c', 'content-type': 'application/json' }
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+const jget = u => fetch(ROOT + u, { headers: H }).then(r => r.json())
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+
+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()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 140)))
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+
+// ===== 1. 绑定事实(API 权威):device ↔ node =====
+const daqAll = (await jget('/api/workshop/daq')).data
+const dcwAll = (await jget('/api/workshop/dcw')).data
+const boundDaq = daqAll.nodes.filter(n => n.deviceBindingId)
+const boundDcw = dcwAll.nodes.filter(n => n.deviceBindingId)
+console.log(`[绑定] 数采已绑设备 ${boundDaq.length} 路,智控已绑设备 ${boundDcw.length} 路`)
+if (!boundDaq.length || !boundDcw.length) fail('缺少 device↔node 绑定')
+
+// ===== 2. 数采:读数帧持续到达 =====
+const produced0 = daqAll.meta.produced
+await sleep(2500)
+const produced1 = (await jget('/api/workshop/daq')).data.meta.produced
+console.log(`[数采] produced ${produced0} → ${produced1}`, produced1 > produced0 ? 'PASS(采样流活跃)' : 'FAIL(无新样本)')
+
+// ===== 3. 数控下发:REST 写 + 回读 ACK(选 1号产线的设定节点,写完还原) =====
+const target = boundDcw.find(n => n.lineId && dcwAll.lineStates?.find(s => s.lineId === n.lineId)?.active) ?? boundDcw[0]
+if (!target) fail('无可下发的智控节点')
+else {
+  const orig = target.value
+  const wv = +(orig + 2).toFixed(2)
+  const w = await jpost(`/api/workshop/dcw/${target.id}/write`, { value: wv })
+  const okWrite = w?.data?.outcome?.ok ?? w?.data?.outcome?.ack
+  console.log(`[数控] write ${target.name} ${orig} → ${wv}:`, JSON.stringify(w.data?.outcome ?? w).slice(0, 120))
+  await sleep(1200)
+  const after = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === target.id)
+  const hit = Math.abs((after?.value ?? NaN) - wv) < 0.01
+  console.log(`[数控] 回读 ${after?.value}(期望 ${wv})`, hit ? 'PASS(参数真正下发)' : 'FAIL')
+  // 还原
+  await jpost(`/api/workshop/dcw/${target.id}/write`, { value: orig })
+  if (!hit) fail('数控下发未生效')
+}
+
+// ===== 4. 孪生页面:帧率切换 + 实时消费 + 趋势 + 事件 =====
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(16000)
+
+// 4a. 帧率切换:60 → 120 → ∞(预算 16.7/8.3/0)
+for (const [label, want] of [['60', 16.7], ['120', 8.3], ['∞', 0]]) {
+  await page.evaluate((l) => {
+    const btn = [...document.querySelectorAll('.fps-seg button')].find(b => b.textContent.trim() === l)
+    btn?.click()
+  }, label)
+  await sleep(300)
+  const s = await page.evaluate(() => ({ budget: globalThis.__townScene3d?.frameBudgetMs, alive: !globalThis.__townScene3d?.disposed }))
+  const ok = s && Math.abs(s.budget - want) < 0.15 && s.alive
+  console.log(`[帧率] 选 ${label} → budget ${s?.budget}`, ok ? 'PASS' : `FAIL(期望 ${want})`)
+  if (!ok) fail('帧率切换未生效')
+}
+// 恢复 60
+await page.evaluate(() => { [...document.querySelectorAll('.fps-seg button')].find(b => b.textContent.trim() === '60')?.click() })
+
+// 4b. 实时消费:标注数值 4s 内变化(WS 帧 → rtc → 上屏)
+const calloutChanges = await page.evaluate(() => new Promise((resolve) => {
+  const texts = []
+  const iv = setInterval(() => {
+    texts.push([...document.querySelectorAll('.callout .co-val')].map(e => e.textContent).join('|'))
+  }, 100)
+  setTimeout(() => { clearInterval(iv); resolve(texts.filter((v, i) => i && v !== texts[i - 1]).length) }, 4000)
+}))
+console.log('[实时] 标注 4s 变化次数:', calloutChanges, calloutChanges >= 3 ? 'PASS' : 'FAIL')
+if (calloutChanges < 3) fail('标注数据未实时刷新')
+
+// 4c. 趋势曲线实时:画布内容 4s 内变化(200ms 重绘 + rtc 直方)
+const trendChanges = await page.evaluate(() => new Promise((resolve) => {
+  const cv = document.querySelector('.trend-cv')
+  if (!cv) { resolve(-1); return }
+  const frames = []
+  const iv = setInterval(() => {
+    try { frames.push(cv.toDataURL()) } catch { frames.push('err') }
+  }, 150)
+  setTimeout(() => { clearInterval(iv); resolve(frames.filter((v, i) => i && v !== frames[i - 1]).length) }, 4000)
+}))
+console.log('[实时] 趋势画布 4s 内容变化:', trendChanges, trendChanges >= 2 ? 'PASS' : 'FAIL(数据/曲线未动)')
+if (trendChanges < 2) fail('趋势曲线未实时重绘')
+
+// 4d. 事件渲染:实时告警面板行 + 实时事件轨
+const alarmRows = await page.evaluate(() => document.querySelectorAll('.alarm-list .al-row').length)
+const eventRows = await page.evaluate(() => document.querySelectorAll('.event-list .event-row').length)
+console.log('[事件] 告警行:', alarmRows, '| 事件行:', eventRows)
+if (!alarmRows && !eventRows) fail('告警与事件均未渲染(若产线无任何异常可豁免)')
+
+console.log('pageerror:', errors.length ? errors.slice(0, 4) : 'none')
+if (errors.length) fail('页面存在运行时错误')
+await page.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-final-e2e.png' })
+await browser.close()
+console.log(process.exitCode ? 'E2E FAILED' : 'E2E ALL PASS')

package/scripts/_dbg-town-gate.mjs

@@ -0,0 +1,44 @@
+/** 单上下文自洽探针:同一 evaluate 内测 渲染fps/rAF频率/门控frameAcc/档位。 */
+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'] })
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+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(12000)
+
+const report = await page.evaluate(() => new Promise((resolve) => {
+  const sc = globalThis.__townScene3d
+  if (!sc) { resolve({ err: 'no scene hook' }); return }
+  // rAF 频率参照
+  let rafN = 0
+  let rafOn = true
+  const rafCount = () => { if (!rafOn) return; rafN++; requestAnimationFrame(rafCount) }
+  requestAnimationFrame(rafCount)
+  const f0 = sc.frameCount
+  const t0 = performance.now()
+  const accSamples = []
+  const accIv = setInterval(() => accSamples.push(+sc.frameAcc.toFixed(1)), 50)
+  setTimeout(() => {
+    rafOn = false
+    clearInterval(accIv)
+    const wall = (performance.now() - t0) / 1000
+    resolve({
+      wallSec: +wall.toFixed(1),
+      rafHz: Math.round(rafN / wall),
+      renderedFps: Math.round((sc.frameCount - f0) / wall),
+      budgetMs: sc.frameBudgetMs,
+      frameAccRange: [Math.min(...accSamples), Math.max(...accSamples)],
+      qTier: sc.qTier,
+      dpr: +sc.renderer.getPixelRatio().toFixed(2),
+      bloomOn: sc.composer.passes.find(p => p.enabled === false) === undefined,
+    })
+  }, 6000)
+}))
+console.log(JSON.stringify(report, null, 1))
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-ins-probe.mjs

@@ -0,0 +1,37 @@
+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'] })
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+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)
+// 逐个展开数采模板分组,直到出现已落位节点
+const expanded = await page.evaluate(() => {
+  const heads = [...document.querySelectorAll('.daq-card.tpl')]
+  for (const h of heads) {
+    h.click()
+    if (document.querySelector('.daq-node.placed')) return true
+  }
+  return !!document.querySelector('.daq-node.placed')
+})
+await sleep(400)
+const clicked = await page.evaluate(() => {
+  const node = [...document.querySelectorAll('.daq-node.placed')][0]
+  if (!node) return false
+  node.click()
+  return true
+})
+await sleep(600)
+const ins = await page.evaluate(() => {
+  const el = document.querySelector('.panel.inspector')
+  if (!el) return null
+  return { opacity: getComputedStyle(el).opacity, h: Math.round(el.getBoundingClientRect().height) }
+})
+console.log('展开分组:', expanded, '| 点击落位节点:', clicked, '| Inspector:', JSON.stringify(ins), ins && ins.h > 80 ? 'PASS' : 'FAIL/SKIP')
+const el = await page.$('.town-root') ?? await page.$('body')
+await el.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-inspector2.png' })
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-perf.mjs

@@ -0,0 +1,50 @@
+/** /town 资源优化验证:FPS 走向 + 自适应 DPR + 交互延迟。 */
+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'] })
+const page = await browser.newPage()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+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)
+
+// 采样 FPS 徽标 12s(每 2s 一次):观察自适应 DPR 生效后 FPS 是否回升
+const samples = []
+for (let i = 0; i < 6; i++) {
+  const fps = await page.evaluate(() => {
+    const m = document.body.textContent.match(/(\d+)\s*FPS/i)
+    return m ? Number(m[1]) : null
+  })
+  samples.push(fps)
+  await sleep(2000)
+}
+console.log('FPS 走向(每 2s):', samples.join(' → '))
+const dpr = await page.evaluate(() => {
+  const cv = document.querySelector('#town-host canvas')
+  if (!cv) return null
+  return { bufW: cv.width, cssW: cv.clientWidth, ratio: +(cv.width / cv.clientWidth).toFixed(2) }
+})
+console.log('canvas DPR(实际/初始应≤1.25):', JSON.stringify(dpr))
+
+// 交互延迟:点 视角切换(重置视角按钮)→ 场景响应(exposure 状态变化不可见,改用 KPI 条存在性 + click→下一帧)
+const clickLat = await page.evaluate(() => new Promise((resolve) => {
+  const btn = [...document.querySelectorAll('.ctl-btns .btn')].find(b => b.textContent.includes('重置视角'))
+  if (!btn) { resolve(-2); return }
+  const t0 = performance.now()
+  btn.click()
+  const check = () => {
+    // 重置视角无直接 DOM 反馈;用「再无长任务阻塞且能跑完 rAF」作代理:两帧内返回即流畅
+    requestAnimationFrame(() => requestAnimationFrame(() => resolve(Math.round(performance.now() - t0))))
+  }
+  requestAnimationFrame(check)
+}))
+console.log('重置视角点击→双帧返回延迟:', clickLat, clickLat >= 0 && clickLat < 150 ? 'PASS' : 'CHECK')
+console.log('pageerror:', errors.length ? errors : 'none')
+await page.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-perf.png' })
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-polish-shots.mjs

@@ -0,0 +1,82 @@
+/** 一次性:UI polish 验收截图 —— 智控设定卡(populated)/DCW 检查器/总览 */
+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 OUT = 'docs/audit/screenshots'
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', 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 { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fx = await makeLineFixture(ROOT, H, 'polish 产线')
+
+// ===== 前置:开跑配方(带窗口) + 绑定智控节点到设备,让「智控设定」卡 populated =====
+const dcw = await jget('/api/workshop/dcw')
+let dwTemp = (dcw.data?.nodes ?? []).find(n => n.name === 'polish-温度设定')
+if (!dwTemp) {
+  dwTemp = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: 'polish-温度设定', posX: -1700, posZ: 2200 })).data.node
+}
+const twins = (await jget('/api/workshop/device-twins')).data.twins.filter(t => t.kind !== 'daq' && typeof t.posX === 'number')
+const dev = twins.find(t => t.name.includes('控制台')) ?? twins[0]
+if (!dwTemp.deviceBindingId || dwTemp.deviceBindingId !== dev.id) {
+  await jpost(`/api/workshop/dcw/${dwTemp.id}/bind`, { deviceId: dev.id })
+}
+let prod = (dcw.data?.products ?? []).find(p => p.name === 'polish-产品')
+if (!prod) prod = (await jpost('/api/workshop/dcw/products', { name: 'polish-产品', lineId: fx.line.id })).data.product
+else await jpost(`/api/workshop/dcw/products/${prod.id}`, { method: 'PATCH', headers: H, body: JSON.stringify({ lineId: fx.line.id }) })
+let rc = (dcw.data?.recipes ?? []).find(r => r.name === 'polish-配方')
+if (!rc) {
+  rc = (await jpost('/api/workshop/dcw/recipes', { productId: prod.id, name: 'polish-配方', params: [{ templateRef: 'dcw-temp-sp', nodeId: dwTemp.id, value: 182, min: 176, max: 188 }] })).data.recipe
+}
+await fx.start(rc.id)
+console.log('line started, bound:', dwTemp.id, '->', dev.name)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1920,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 1.5 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+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(5000)
+
+// 1. 总览(运行视角)
+await page.screenshot({ path: `${OUT}/polish-overview.png` })
+
+// 2. 编辑模式 + 选中设备(智控设定卡 populated:配方窗口行)
+await page.evaluate(() => {
+  const btns = [...document.querySelectorAll('button')]
+  btns.find(b => b.textContent.trim() === '编辑')?.click()
+})
+await sleep(400)
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dev.id)
+await sleep(900)
+await page.screenshot({ path: `${OUT}/polish-device-panel.png` })
+
+// 3. 选中智控节点(DCW 检查器)
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dwTemp.id)
+await sleep(900)
+await page.screenshot({ path: `${OUT}/polish-dcw-inspector.png` })
+
+// 右栏特写(设备面板,高清裁切看卡片细节)
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, dev.id)
+await sleep(900)
+const rail = await page.$('.rail-right')
+if (rail) await rail.screenshot({ path: `${OUT}/polish-right-rail.png` })
+
+await browser.close()
+
+// ===== 清理(停线 + 删 fixture;节点保留供后续轮次复用) =====
+await fx.cleanup()
+await jdel(`/api/workshop/dcw/recipes/${rc.id}`)
+await jdel(`/api/workshop/dcw/products/${prod.id}`)
+await jpost(`/api/workshop/dcw/${dwTemp.id}/bind`, { deviceId: null })
+console.log('SHOTS DONE')

package/scripts/_dbg-town-realtime.mjs

@@ -0,0 +1,42 @@
+/** /town 最终验证:FPS 阶梯走向 + 标注数据实时刷新。 */
+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'] })
+const page = await browser.newPage()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+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(16000)
+
+// FPS + DPR 采样 24s(每 3s):阶梯应逐步降档,FPS 向 40 预算爬
+for (let i = 0; i < 8; i++) {
+  const s = await page.evaluate(() => {
+    const m = document.body.textContent.match(/(\d+)\s*FPS/i)
+    const cv = document.querySelector('#town-host canvas')
+    return { fps: m ? Number(m[1]) : null, ratio: cv ? +(cv.width / cv.clientWidth).toFixed(2) : null }
+  })
+  console.log(`t+${i * 3}s fps=${s.fps} dpr=${s.ratio}`)
+  await sleep(3000)
+}
+
+// 标注实时性:5s 窗口内 callout 数值文本变化次数(直通帧应 ≥ 每秒 1 次)
+const changes = await page.evaluate(() => new Promise((resolve) => {
+  const texts = []
+  const iv = setInterval(() => {
+    texts.push([...document.querySelectorAll('.callout .co-val')].map(e => e.textContent).join('|'))
+  }, 100)
+  setTimeout(() => {
+    clearInterval(iv)
+    resolve(texts.filter((v, i) => i && v !== texts[i - 1]).length)
+  }, 5000)
+}))
+console.log('标注数值 5s 内变化次数:', changes, changes >= 4 ? 'PASS(真·实时)' : 'FAIL(仍受合批延迟)')
+console.log('pageerror:', errors.length ? errors.slice(0, 3) : 'none')
+await page.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-realtime.png' })
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-shot3.mjs

@@ -0,0 +1,17 @@
+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'] })
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+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)
+await page.evaluate(() => { [...document.querySelectorAll('.daq-card.tpl')].forEach(h => h.click()) })
+await sleep(400)
+await page.evaluate(() => { [...document.querySelectorAll('.daq-node.placed')][0]?.click() })
+await sleep(700)
+await page.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-inspector3.png' })
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-truth.mjs

@@ -0,0 +1,37 @@
+/** /town 真值探针:渲染帧计数(非 rAF 频率)+ 质量档 + 实时标注。 */
+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'] })
+const page = await browser.newPage()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+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(15000)
+
+for (let i = 0; i < 6; i++) {
+  const s = await page.evaluate(() => new Promise((resolve) => {
+    const sc = globalThis.__townScene3d
+    if (!sc) { resolve(null); return }
+    const f0 = sc.renderer.info.render.frame
+    const t0 = performance.now()
+    setTimeout(() => {
+      const f1 = sc.renderer.info.render.frame
+      resolve({
+        realFps: Math.round((f1 - f0) / ((performance.now() - t0) / 1000)),
+        qTier: sc.qTier,
+        dpr: +sc.renderer.getPixelRatio().toFixed(2),
+        budget: Math.round(sc.frameBudgetMs),
+      })
+    }, 2000)
+  }))
+  console.log(`t+${i * 2}s`, JSON.stringify(s))
+  if (s === null) break
+  await sleep(1000)
+}
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-town-truth2.mjs

@@ -0,0 +1,27 @@
+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'] })
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+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(15000)
+const s = await page.evaluate(() => new Promise((resolve) => {
+  const sc = globalThis.__townScene3d
+  if (!sc) { resolve(null); return }
+  const f0 = sc.frameCount
+  const t0 = performance.now()
+  setTimeout(() => {
+    resolve({
+      renderedFps: Math.round((sc.frameCount - f0) / ((performance.now() - t0) / 1000)),
+      frameAccSample: +sc.frameAcc.toFixed(1),
+      budget: sc.frameBudgetMs,
+      qTier: sc.qTier,
+    })
+  }, 2000)
+}))
+console.log(JSON.stringify(s))
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-transform-audit.mjs

@@ -0,0 +1,98 @@
+/** 一次性:数据语义标定钩子审计 —— Modbus 真实链路 decoder(数采)/encode(智控)+ 动态改标定 */
+const TOKEN = process.env.DAQ_TOKEN ?? 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = process.env.DAQ_BASE ?? 'http://127.0.0.1:3000'
+const DAQ = ROOT + '/api/workshop/daq'
+const DCW = ROOT + '/api/workshop/dcw'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const post = (u, b) => fetch(u, { method: 'POST', headers: H, body: JSON.stringify(b) }).then(r => r.json())
+const get = (u) => fetch(u, { headers: H }).then(r => r.json())
+const del = (u) => fetch(u, { method: 'DELETE', headers: H }).then(r => r.json())
+const { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fx = await makeLineFixture(ROOT, H, 'transform-audit 线')
+
+// 产线开跑(配方驱动采集门控)
+const prod = (await post(DCW + '/products', { name: '标定审计产品', lineId: fx.line.id })).data.product
+// 配方参数节点(显式 nodeId + 自建节点):templateRef 兼容解析会命中"最早同模板节点"
+// —— 多产线环境下那可能是用户 fixture 节点(已挂产线),产线隔离会正确拒绝
+const dwFix = (await post(DCW, { templateRef: 'dcw-temp-sp', name: '标定审计-参数节点', driver: 'mock', lineId: fx.line.id })).data.node
+const rc = (await post(DCW + '/recipes', { productId: prod.id, name: '标定审计配方', params: [{ nodeId: dwFix.id, value: 180 }] })).data.recipe
+if (!rc) { console.error('FAIL: create recipe'); process.exit(1) }
+await fx.start(rc.id)
+
+// ===== 1. DAQ decoder:读 40003(温度 float32,PLC 值 165~175),标定 scale 0.1 → 物理 ≈ 16.5~17.5 =====
+const dq = (await post(DAQ, {
+  templateRef: 'daq-pressure-tx', // 模板域 0.6~1.2 仅作展示;标定后物理值独立
+  name: '标定-温度decoder',
+  driver: 'modbus-tcp',
+  driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40003, dataType: 'float32', byteOrder: 'big' },
+  transform: { kind: 'linear', scale: 0.1, offset: 0 },
+  intervalMs: 500,
+  lineId: fx.line.id,
+})).data.node
+if (!dq) { console.error('FAIL: create daq node'); process.exit(1) }
+await sleep(2600)
+let n = (await get(DAQ)).data.nodes.find(x => x.id === dq.id)
+console.log(`decoder: node.value=${n.value} ${n.unit} (PLC 165~175 × 0.1 → 期望 16.5~17.5), state=${n.state}`)
+if (n.value != null && n.value >= 15 && n.value <= 20) console.log('PASS daq decoder: 物理值 = PLC值 × 0.1')
+else fail(`daq decoder wrong: ${n.value}`)
+
+// 动态改标定(scale 1 → 物理值回归 PLC 域 165~175)
+await fetch(`${DAQ}/${dq.id}`, { method: 'PATCH', headers: H, body: JSON.stringify({ transform: { kind: 'linear', scale: 1, offset: 0 } }) })
+await sleep(1800)
+n = (await get(DAQ)).data.nodes.find(x => x.id === dq.id)
+console.log(`decoder live change: node.value=${n.value} (scale 1 → 期望 165~175)`)
+if (n.value != null && n.value >= 160 && n.value <= 180) console.log('PASS transform change takes effect immediately')
+else fail(`transform change not applied: ${n.value}`)
+
+// ===== 2. DCW encode:写 40021(float32),节点 transform scale 0.1 → 设定 180 → PLC 写 1800;回读 decode → 180 =====
+const dw = (await post(DCW, {
+  templateRef: 'dcw-temp-sp',
+  name: '标定-温度encode',
+  driver: 'modbus-tcp',
+  driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' },
+  transform: { kind: 'linear', scale: 0.1, offset: 0 },
+})).data.node
+if (!dw) { console.error('FAIL: create dcw node'); process.exit(1) }
+const w = await post(`${DCW}/${dw.id}/write`, { value: 180 })
+const o = w.data?.outcome
+console.log(`encode: ok=${o?.ok}, raw(PLC)=${o?.raw}, readback(物理)=${o?.readback}`)
+console.log(`  ${o?.message ?? ''}`)
+if (o?.ok === true && o.raw === 1800 && Math.abs(o.readback - 180) < 0.01) {
+  console.log('PASS dcw encode: 物理 180 → PLC 1800(÷0.1),回读 1800 → decode 180 一致')
+}
+else fail(`dcw encode wrong: ${JSON.stringify(o)}`)
+const dwNode = (await get(DCW)).data.nodes.find(x => x.id === dw.id)
+if (dwNode?.value === 180) console.log('PASS node value keeps physical unit (180 ℃)')
+else fail(`node value not physical: ${dwNode?.value}`)
+
+// ===== 3. 无标定对照:同寄存器不带 transform 写 185 → PLC 直写 185 =====
+const dw2 = (await post(DCW, {
+  templateRef: 'dcw-temp-sp',
+  name: '对照-无标定',
+  driver: 'modbus-tcp',
+  driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40023, dataType: 'float32', byteOrder: 'big' },
+})).data.node
+const w2 = await post(`${DCW}/${dw2.id}/write`, { value: 185 })
+const o2 = w2.data?.outcome
+console.log(`passthrough: ok=${o2?.ok}, raw=${o2?.raw}(期望 185,无二次换算)`)
+if (o2?.ok && o2.raw === 185) console.log('PASS passthrough: kind=none 不做二次换算(防重复 scaling)')
+else fail(`passthrough wrong: ${JSON.stringify(o2)}`)
+
+// ===== 4. 非法标定拒绝(scale=0) =====
+const badT = await fetch(`${DCW}/${dw.id}`, { method: 'PATCH', headers: H, body: JSON.stringify({ transform: { kind: 'linear', scale: 0, offset: 0 } }) }).then(r => r.json())
+if (badT.code === 'VALIDATION_ERROR') console.log('PASS invalid transform(scale=0) rejected:', (badT.message ?? '').slice(0, 44))
+else fail(`invalid transform accepted: ${badT.code}`)
+
+// cleanup
+await fetch(`${DAQ}/${dq.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+await fetch(`${DCW}/${dw.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+await fetch(`${DCW}/${dw2.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+await fetch(`${DCW}/${dwFix.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+await fx.cleanup()
+await del(DCW + `/recipes/${rc.id}`)
+await del(DCW + `/products/${prod.id}`)
+console.log('cleanup done')
+console.log(process.exitCode ? 'AUDIT FAILED' : 'AUDIT ALL PASS')
+process.exit(process.exitCode ?? 0)

package/scripts/_dbg-trend-expand-test.mjs

@@ -0,0 +1,38 @@
+/** 交互验证:/town 趋势「+N」展开 → 收起。 */
+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'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+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)
+
+const chipCount = () => page.evaluate(() => document.querySelectorAll('.trend-legend .lg-chip:not(.lg-more)').length)
+const moreText = () => page.evaluate(() => document.querySelector('.lg-more')?.textContent.trim())
+
+console.log('collapsed chips:', await chipCount(), '| more btn:', await moreText())
+await page.click('.lg-more')
+await sleep(600)
+console.log('expanded chips:', await chipCount(), '| more btn:', await moreText())
+const dock = await page.$('.dock')
+await dock.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-dock-expanded.png' })
+await page.click('.lg-more')
+await sleep(600)
+console.log('collapsed again chips:', await chipCount(), '| more btn:', await moreText())
+await dock.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-dock-collapsed.png' })
+await browser.close()
+console.log('DONE')