agentworkshop 0.2.1

package/scripts/_dbg-beacon-final.mjs

@@ -0,0 +1,181 @@
+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 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 errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 200)))
+const puts = []
+page.on('request', (r) => {
+  if (r.method() === 'PUT' && r.url().includes('/scene/layouts/')) puts.push(r.url())
+  if (r.method() === 'PATCH' && r.url().includes('/device-twins/')) puts.push(r.url())
+})
+
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => !!window.__town?.scene?.agents?.size)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 2500))
+
+// 标定:屏幕中点世界坐标 + 牛顿精化投影(挂到 window.__tsE)
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const r = s.canvas.getBoundingClientRect()
+  const cx = r.left + r.width / 2
+  const cy = r.top + r.height / 2
+  const c = s.screenToWorld(cx, cy)
+  const ex = s.screenToWorld(cx + 100, cy)
+  const ez = s.screenToWorld(cx, cy + 100)
+  const ax = { x: (ex.x - c.x) / 100, z: (ex.z - c.z) / 100 }
+  const ay = { x: (ez.x - c.x) / 100, z: (ez.z - c.z) / 100 }
+  const det = ax.x * ay.z - ax.z * ay.x
+  window.__tsA = (wx, wz) => [
+    cx + ((wx - c.x) * ay.z - (wz - c.z) * ay.x) / det,
+    cy + ((wz - c.z) * ax.x - (wx - c.x) * ax.z) / det,
+  ]
+  window.__tsE = (wx, wz) => {
+    let [sx, sy] = window.__tsA(wx, wz)
+    for (let i = 0; i < 3; i++) {
+      const w = s.screenToWorld(sx, sy)
+      const [rx, ry] = window.__tsA(w.x, w.z)
+      sx += sx - rx
+      sy += sy - ry
+    }
+    return [sx, sy]
+  }
+})
+
+// ===== A) pickBeacon API 层 =====
+const a = await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = [...s.blocks.values()][1]
+  window.__cid = b.channelId
+  return {
+    hit: s.pickBeacon(b.x, b.z),
+    beacon: !!b.beacon,
+  }
+})
+console.log('A pickBeacon:', JSON.stringify(a))
+
+// ===== B) 信标点击(pointerup 派发到活 canvas;镜头已对准领地中心 → 信标在屏幕正中) =====
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = s.blocks.get(window.__cid)
+  s.focusTo(b.x, b.z)
+})
+await new Promise(r => setTimeout(r, 1000))
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const rect = s.canvas.getBoundingClientRect()
+  const cx = rect.left + rect.width / 2
+  const cy = rect.top + rect.height / 2
+  // 按下(守卫需要)+ 松手,位移 0 = 点击
+  s.canvas.dispatchEvent(new MouseEvent('pointerdown', { clientX: cx, clientY: cy, button: 0, bubbles: true }))
+  s.canvas.dispatchEvent(new MouseEvent('pointerup', { clientX: cx, clientY: cy, button: 0, bubbles: true }))
+})
+await new Promise(r => setTimeout(r, 1100))
+const cidNow = await page.evaluate(() => window.__cid)
+const b3 = await page.evaluate(cid => ({
+  sel: window.__town.scene.selectedChannel === cid,
+  panel: !!document.querySelector('.boundary-panel'),
+  cam: window.__town.scene.getCameraTarget(),
+}), cidNow)
+console.log('B beacon click:', JSON.stringify(b3))
+
+// ===== C) 无边界:频道拖到旧世界边界外(focusTo 精确屏幕中心法) =====
+await page.evaluate(() => {
+  window.__town.scene.setMode('edit')
+})
+await new Promise(r => setTimeout(r, 300))
+const c1 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = s.blocks.get(window.__cid)
+  const members = [...s.agents.values()].filter(x => x.channelId === b.channelId)
+  let P = null
+  for (let ang = 0; ang < 360 && !P; ang += 10) {
+    const px = b.x + Math.cos(ang * Math.PI / 180) * b.radiusX * 0.5
+    const pz = b.z + Math.sin(ang * Math.PI / 180) * b.radiusZ * 0.5
+    if (Math.hypot(px - b.x, pz - b.z) < 90) continue
+    if (members.every(m => Math.hypot(m.root.position.x - px, m.root.position.z - pz) > 110)) P = { x: px, z: pz }
+  }
+  if (!P) return { fail: 'no clear point' }
+  s.focusTo(P.x, P.z)
+  window.__P = P
+  return { P, before: { x: b.x, z: b.z } }
+})
+console.log('C clear point:', JSON.stringify(c1))
+if (!c1.fail) {
+  await new Promise(r => setTimeout(r, 1000))
+  const c2 = await page.evaluate(() => {
+    const s = window.__town.scene
+    const rect = s.canvas.getBoundingClientRect()
+    const cx = rect.left + rect.width / 2
+    const cy = rect.top + rect.height / 2
+    // 屏幕中心世界点 = camTarget = P(focusTo 精确);由此启动频道拖拽
+    const started = s.tryStartPointerDrag(cx, cy)
+    if (!started) return { started: false, worldAtCenter: s.screenToWorld(cx, cy) }
+    // 拖拽中:把注视点移到 (P + 1500, P + 700),等待补间后屏幕中心即该点
+    const P = window.__P
+    s.focusTo(P.x + 1500, P.z + 700)
+    return { started: s.isPointerDragging() }
+  })
+  console.log('C drag started:', JSON.stringify(c2))
+  if (c2.started) {
+    await new Promise(r => setTimeout(r, 1100))
+    await page.evaluate(() => {
+      const s = window.__town.scene
+      const rect = s.canvas.getBoundingClientRect()
+      s.movePointerDrag(rect.left + rect.width / 2, rect.top + rect.height / 2)
+      s.endPointerDrag()
+    })
+    await new Promise(r => setTimeout(r, 600))
+    const c3 = await page.evaluate((cid) => {
+      const b = window.__town.scene.blocks.get(cid)
+      return { x: Math.round(b.x), z: Math.round(b.z) }
+    }, await page.evaluate(() => window.__cid))
+    console.log('C after drag:', JSON.stringify(c3), '| x beyond old 3200:', c3.x > 3200, '| expect ~', Math.round(c1.before.x + c1.P ? (c1.P.x + 1500 - c1.P.x) : 0))
+  }
+}
+
+// ===== D) 设备任意摆放:拖设备到远处 + PATCH 落库 =====
+const d1 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const nodes = s.getDeviceNodes()
+  if (!nodes.length) return { fail: `no device nodes (twins poll may pending)` }
+  const n = nodes[0]
+  const [sx, sy] = window.__tsE(n.root.position.x, n.root.position.z)
+  const ok = s.tryStartPointerDrag(sx, sy)
+  return { ok, from: { x: Math.round(n.root.position.x), z: Math.round(n.root.position.z) } }
+})
+console.log('D device drag start:', JSON.stringify(d1))
+if (d1.ok) {
+  await page.evaluate(() => {
+    const s = window.__town.scene
+    const n = s.getDeviceNodes()[0]
+    if (!n) return
+    for (let i = 1; i <= 8; i++) {
+      const [mx, my] = window.__tsE(n.root.position.x + 100, n.root.position.z + 62.5)
+      s.movePointerDrag(mx, my)
+    }
+  })
+  await page.evaluate(() => {
+    window.__town.scene.endPointerDrag()
+  })
+  await new Promise(r => setTimeout(r, 600))
+  const d2 = await page.evaluate(() => {
+    const n = window.__town.scene.getDeviceNodes()[0]
+    return n ? { to: { x: Math.round(n.root.position.x), z: Math.round(n.root.position.z) } } : { fail: 'gone' }
+  })
+  console.log('D device after drag:', JSON.stringify(d2))
+}
+console.log('requests(PUT layout/PATCH twin):', puts.length, puts.slice(0, 3))
+console.log('errors:', errors.slice(0, 5))
+await page.screenshot({ path: 'docs/audit/screenshots/beacon-unbounded.png' })
+await browser.close()

package/scripts/_dbg-bind-bidi-e2e.mjs

@@ -0,0 +1,239 @@
+/** 一次性:节点级双向绑定 + 树形拖拽 + 选择器滚动 验证轮(场景清空 + 产线设备重建后)
+ *  T1 空场景(设备保留)
+ *  T2 设备卡「添加数采通道」节点选择器(分组/滚动/直绑)→ 面板 twin-daq 行
+ *  T3 合成拖放:未绑定节点落到 devB 旁 → 落位 + 自动绑
+ *  T4 节点检查器反向:绑定设备行 + 下拉换绑(双向同步)
+ *  T5 智控同构:选择器直绑 → 设备面板 SET 行
+ *  T6 /daq 表格绑定设备下拉换绑(server 落库)
+ *  T7 还原
+ */
+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 daq0 = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+const devRes = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H() }).then(r => r.json())
+const twins = (devRes?.data?.twins ?? devRes?.data ?? []).filter(t => typeof t.posX === 'number')
+const devA = twins.find(t => /挤出机/.test(t.name)) ?? twins[0]
+const devB = twins.find(t => t.id !== devA.id && /收卷机|拉/.test(t.name)) ?? twins[1]
+const valued = daq0.data.nodes.find(n => n.value != null && !n.deviceBindingId)
+const freeDaq = daq0.data.nodes.find(n => !n.deviceBindingId && n.id !== valued?.id)
+const dcwNodes = await fetch(`${BASE}/api/workshop/dcw`, { headers: H() }).then(r => r.json())
+const unboundDcw = dcwNodes.data.nodes.find(n => !n.deviceBindingId)
+console.log('fixtures → devA:', devA?.name, '| devB:', devB?.name, '| valued daq:', valued?.name, valued?.value, '| free daq:', freeDaq?.name, '| free dcw:', unboundDcw?.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: '/' })
+const issues = []
+page.on('pageerror', (err) => issues.push(`[pageerror] ${String(err).slice(0, 200)}`))
+
+try {
+  await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  for (let i = 0; i < 45; 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, 3500))
+  console.log('T1 scene deviceNodes(设备):', await page.evaluate(() => window.__town?.scene?.deviceNodes?.size))
+  await page.screenshot({ path: `${OUT}/round3-empty-scene.png` })
+
+  // 编辑模式
+  const segBtns = await page.$$('.nav-tabs .seg button')
+  await segBtns[1].click()
+  await new Promise(r => setTimeout(r, 600))
+
+  // ── T2 设备卡「添加数采通道」节点选择器直绑 ──
+  await page.evaluate((devId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: devId })
+  }, devA.id)
+  await new Promise(r => setTimeout(r, 800))
+  const daqAddBtn = (await page.$$('.bind-add-wrap .bind-add'))[0]
+  await daqAddBtn.evaluate(el => el.scrollIntoView({ block: 'center' }))
+  await new Promise(r => setTimeout(r, 300))
+  await daqAddBtn.click()
+  await new Promise(r => setTimeout(r, 500))
+  const pop = await page.evaluate(() => {
+    const el = document.querySelector('.bind-pop')
+    if (!el) return null
+    return {
+      groups: el.querySelectorAll('.bp-group').length,
+      buttons: el.querySelectorAll('button').length,
+      overflowY: getComputedStyle(el).overflowY,
+      scrollH: el.scrollHeight,
+      clientH: el.clientHeight,
+    }
+  })
+  console.log('T2 daq picker:', JSON.stringify(pop))
+  await page.screenshot({ path: `${OUT}/round3-daq-picker.png` })
+  const clicked = await page.evaluate((nodeId) => {
+    const btn = document.querySelector(`.bind-pop button[data-node-id="${nodeId}"]`)
+    if (!btn) return false
+    btn.scrollIntoView({ block: 'nearest' })
+    btn.click()
+    return true
+  }, valued.id)
+  await new Promise(r => setTimeout(r, 1500))
+  const daq1 = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+  const b1 = daq1.data.nodes.find(n => n.id === valued.id)
+  console.log('T2 click node row:', clicked, '| bound to devA:', b1?.deviceBindingId === devA.id ? 'OK' : b1?.deviceBindingId)
+  // 面板出现 twin-daq 行(该节点有实时值)
+  await page.evaluate((devId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: devId })
+  }, devA.id)
+  await new Promise(r => setTimeout(r, 1000))
+  const rowsTxt = await page.evaluate(() => [...document.querySelectorAll('.twin-daq .daq-item')].map(el => el.textContent?.replace(/\s+/g, ' ').trim()))
+  console.log('T2 device panel twin-daq rows:', JSON.stringify(rowsTxt))
+  await page.screenshot({ path: `${OUT}/round3-device-daq-bound.png` })
+
+  // ── T3 合成拖放:freeDaq 落到 devB 旁 → 落位 + 自动绑 devB ──
+  const tx = devB.posX + 40
+  const tz = devB.posZ + 30
+  const pt = await page.evaluate((wx, wz) => {
+    const p = window.__town.scene.worldToScreen(wx, 0, wz)
+    return { x: p?.x ?? p?.[0], y: p?.y ?? p?.[1] }
+  }, tx, tz)
+  await page.evaluate((nodeId, cx, cy) => {
+    const canvas = document.querySelector('#town-host canvas')
+    const dt = new DataTransfer()
+    dt.setData('application/x-aw-daq-node', nodeId)
+    canvas.dispatchEvent(new DragEvent('dragover', { bubbles: true, cancelable: true, clientX: cx, clientY: cy, dataTransfer: dt }))
+    canvas.dispatchEvent(new DragEvent('drop', { bubbles: true, cancelable: true, clientX: cx, clientY: cy, dataTransfer: dt }))
+  }, freeDaq.id, pt.x, pt.y)
+  await new Promise(r => setTimeout(r, 1800))
+  const daq2 = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+  const placedNode = daq2.data.nodes.find(n => n.id === freeDaq.id)
+  console.log('T3 drag drop → posX:', placedNode?.posX, `(expect ~${Math.round(tx)})`, '| auto-bind devB:', placedNode?.deviceBindingId === devB.id ? 'OK' : placedNode?.deviceBindingId)
+
+  // ── T4 节点检查器反向换绑(placedNode:devB → devA,双向同步) ──
+  await page.evaluate((nodeId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: nodeId })
+  }, placedNode.id)
+  await new Promise(r => setTimeout(r, 1000))
+  const insp = await page.evaluate(() => {
+    const rows = [...document.querySelectorAll('.daq-info-row')]
+    const bindRow = rows.find(r => /绑定设备/.test(r.textContent ?? ''))
+    const sel = document.querySelector('.daq-bind-bar select')
+    return { bindRowText: bindRow?.textContent?.replace(/\s+/g, ' ').trim() ?? null, hasSelect: !!sel }
+  })
+  console.log('T4 inspector bind row:', JSON.stringify(insp.bindRowText), '| select:', insp.hasSelect)
+  // 检查器换绑流程:先解绑(按钮) → 下拉选 devA → 再点绑定
+  await page.evaluate(() => {
+    ;(document.querySelector('.daq-bind-bar .bind-add-btn'))?.click()
+  })
+  await new Promise(r => setTimeout(r, 1200))
+  await page.evaluate((devAId) => {
+    const sel = document.querySelector('.daq-bind-bar select')
+    const setter = Object.getOwnPropertyDescriptor(HTMLSelectElement.prototype, 'value').set
+    setter.call(sel, devAId)
+    sel.dispatchEvent(new Event('change', { bubbles: true }))
+  }, devA.id)
+  await new Promise(r => setTimeout(r, 600))
+  await page.evaluate(() => {
+    ;(document.querySelector('.daq-bind-bar .bind-add-btn'))?.click()
+  })
+  await new Promise(r => setTimeout(r, 1400))
+  const daq3 = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+  const rebound = daq3.data.nodes.find(n => n.id === placedNode.id)
+  console.log('T4 unbind → select devA → bind:', rebound?.deviceBindingId === devA.id ? 'OK' : rebound?.deviceBindingId)
+  await page.screenshot({ path: `${OUT}/round3-node-inspector.png` })
+
+  // ── T5 智控选择器直绑 devB → 设备面板 SET 行 ──
+  await page.evaluate((devId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: devId })
+  }, devB.id)
+  await new Promise(r => setTimeout(r, 800))
+  const wraps = await page.$$('.bind-add-wrap .bind-add')
+  const dcwAddBtn = wraps[1]
+  await dcwAddBtn.evaluate(el => el.scrollIntoView({ block: 'center' }))
+  await new Promise(r => setTimeout(r, 300))
+  await dcwAddBtn.click()
+  await new Promise(r => setTimeout(r, 500))
+  const dcwClicked = await page.evaluate((nodeId) => {
+    const btn = document.querySelector(`.bind-pop button[data-node-id="${nodeId}"]`)
+    if (!btn) return false
+    btn.scrollIntoView({ block: 'nearest' })
+    btn.click()
+    return true
+  }, unboundDcw.id)
+  await new Promise(r => setTimeout(r, 1500))
+  const dcwAfter = await fetch(`${BASE}/api/workshop/dcw`, { headers: H() }).then(r => r.json())
+  const dcwBound = dcwAfter.data.nodes.find(n => n.id === unboundDcw.id)
+  await page.evaluate((devId) => {
+    window.__town.scene.setSelected?.({ kind: 'device', id: devId })
+  }, devB.id)
+  await new Promise(r => setTimeout(r, 1000))
+  const dcwRow = await page.evaluate(() => ({
+    rows: document.querySelectorAll('.twin-dcw').length,
+    hasWrite: !!document.querySelector('.twin-dcw input, .twin-dcw button'),
+  }))
+  console.log('T5 dcw picker bind:', dcwClicked, '| bound devB:', dcwBound?.deviceBindingId === devB.id ? 'OK' : dcwBound?.deviceBindingId, '| SET rows:', dcwRow.rows, '| write ctl:', dcwRow.hasWrite)
+  await page.screenshot({ path: `${OUT}/round3-dcw-panel.png` })
+
+  // ── T6 /daq 表格绑定设备下拉换绑 ──
+  await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle0', timeout: 90000 })
+  await new Promise(r => setTimeout(r, 5000))
+  const devSelIdx = await page.evaluate(() => {
+    const sels = [...document.querySelectorAll('select.line-sel')]
+    const empty = sels.findIndex(s => [...s.options].some(o => /未绑定/.test(o.textContent ?? '')) && s.value === '')
+    return empty >= 0 ? empty : sels.findIndex(s => [...s.options].some(o => /未绑定/.test(o.textContent ?? '')))
+  })
+  const devOptCount = await page.evaluate((idx) => {
+    const sels = [...document.querySelectorAll('select.line-sel')]
+    return sels[idx]?.options?.length ?? 0
+  }, devSelIdx)
+  console.log('T6 /daq device select idx:', devSelIdx, '| options:', devOptCount)
+  // 找一个当前「未绑定」的行(value=''),换绑到 devA → devA 上节点数必须 +1
+  const preCount = (await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())).data.nodes.filter(n => n.deviceBindingId === devA.id).length
+  const changed = await page.evaluate((devId, idx) => {
+    const sels = [...document.querySelectorAll('select.line-sel')]
+    const sel = sels[idx]
+    if (!sel) return false
+    const setter = Object.getOwnPropertyDescriptor(HTMLSelectElement.prototype, 'value').set
+    setter.call(sel, devId)
+    sel.dispatchEvent(new Event('change', { bubbles: true }))
+    return true
+  }, devA.id, devSelIdx)
+  await new Promise(r => setTimeout(r, 1500))
+  const daqPage = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+  const onDevA = daqPage.data.nodes.filter(n => n.deviceBindingId === devA.id).length
+  console.log('T6 /daq select change:', changed, `| devA nodes ${preCount} → ${onDevA} (+${onDevA - preCount})`)
+  await page.screenshot({ path: `${OUT}/round3-daq-page.png` })
+}
+finally {
+  // ── T7 还原:解绑测试绑定 + 解除测试落位 ──
+  try {
+    const d = await fetch(`${BASE}/api/workshop/daq`, { headers: H() }).then(r => r.json())
+    for (const n of d.data.nodes) {
+      if (n.id === valued?.id || n.id === freeDaq?.id) {
+        await fetch(`${BASE}/api/workshop/daq/${n.id}/bind`, { method: 'POST', headers: H(), body: JSON.stringify({ deviceId: null }) })
+        if (typeof n.posX === 'number') {
+          await fetch(`${BASE}/api/workshop/daq/${n.id}`, { method: 'PATCH', headers: H(), body: JSON.stringify({ posX: null, posZ: null }) })
+        }
+      }
+    }
+    await fetch(`${BASE}/api/workshop/dcw/${unboundDcw.id}/bind`, { method: 'POST', headers: H(), body: JSON.stringify({ deviceId: null }) })
+    console.log('cleanup done')
+  }
+  catch (e) {
+    console.log('cleanup error:', String(e).slice(0, 120))
+  }
+  await browser.close()
+}
+console.log('page errors:', issues.length)
+issues.slice(0, 6).forEach(i => console.log(i))
+console.log('round3 done')

package/scripts/_dbg-callout-near.mjs

@@ -0,0 +1,108 @@
+/**
+ * callout 距离显隐 + 堆叠审计(阈值 1150,3D 距离):
+ *  - 设备放在远离世界中心处;overview(注视世界中心)→ 设备距相机 ~1600 → 全隐;
+ *  - focusTo 设备(dolly 1)→ 注视设备 ~1046 < 1150 → 2 路绑定卡浮现,竖排 104;
+ *  - 视线移开(focusTo 远角)→ 复隐;截图 = 注视近景。
+ */
+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: '张力传感器 01', ref: 'daq-tension-cell', x: 1650, 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 })
+}
+console.log(`created ${created.length}/${spec.length}`)
+const byName = Object.fromEntries(created.map(c => [c.name, c.id]))
+const devId = byName['TD 拉幅机 L1']
+const bindings = {
+  [byName['温度传感器 01']]: devId,
+  [byName['张力传感器 01']]: devId,
+}
+
+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, 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 state = () => page.evaluate(() => {
+  const cards = [...document.querySelectorAll('.callout')]
+  const near = cards.filter(c => c.classList.contains('near'))
+  return {
+    total: cards.length,
+    near: near.length,
+    ys: near.map(c => c.style.top),
+  }
+})
+
+// 1) overview(注视世界中心):设备在远处 → 全隐
+await page.evaluate(() => window.__town.scene.resetView())
+await new Promise(r => setTimeout(r, 2200))
+const s0 = await state()
+console.log('overview:', JSON.stringify(s0), s0.near === 0 ? '(OK 远距全隐)' : '(FAIL 未隐)')
+
+// 2) 注视设备(dolly 1,~1046 < 1150)→ 2 卡浮现 + 104 堆叠
+await page.evaluate(() => window.__town.scene.focusTo(1700, 600))
+await new Promise(r => setTimeout(r, 1800))
+const s1 = await state()
+const ys = s1.ys.map(v => Number.parseFloat(v)).sort((a, b) => a - b)
+const stackDelta = ys.length >= 2 ? Math.round(ys[ys.length - 1] - ys[0]) : -1
+console.log('focus:', JSON.stringify(s1), 'stackDelta:', stackDelta,
+  s1.near === 2 && stackDelta === 104 ? '(OK 注视浮现+104 堆叠)' : '(FAIL)')
+
+// 3) 视线移开(看向远处数采杆)→ 注视谁谁亮:TD 的 2 张绑定卡复隐,远处数采自身的卡亮起
+await page.evaluate(() => window.__town.scene.focusTo(2900, 200))
+await new Promise(r => setTimeout(r, 1800))
+const s2 = await page.evaluate(() => {
+  const cards = [...document.querySelectorAll('.callout')]
+  return {
+    nearLabels: cards.filter(c => c.classList.contains('near')).map(c => c.querySelector('.co-label')?.textContent?.trim() ?? ''),
+    tdBoundNear: cards.filter(c => (c.textContent ?? '').includes('TD 拉幅机') && c.classList.contains('near')).length,
+  }
+})
+console.log('away:', JSON.stringify(s2),
+  s2.nearLabels.length === 1 && s2.tdBoundNear === 0 ? '(OK 注视谁谁亮,原绑定卡复隐)' : '(FAIL)')
+
+// 4) 回注视 → 近景截图(堆叠卡 + 引线)
+await page.evaluate(() => window.__town.scene.focusTo(1700, 600))
+await new Promise(r => setTimeout(r, 1800))
+const s3 = await state()
+console.log('refocus:', JSON.stringify(s3))
+await page.screenshot({ path: 'docs/audit/screenshots/town-callout-near.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-chan-focus.mjs

@@ -0,0 +1,49 @@
+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 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 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(() => !!window.__town?.scene?.agents?.size)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 2000))
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = [...s.blocks.values()][0]
+  window.__blk = { x: b.x, z: b.z }
+  s.focusTo(b.x, b.z)
+})
+await new Promise(r => setTimeout(r, 800))
+await page.evaluate(() => {
+  window.__town.scene.panBy(-120, -90)
+})
+await new Promise(r => setTimeout(r, 200))
+// 1) 合成 dblclick 直达 canvas
+const fired = await page.evaluate(() => {
+  const cv = document.querySelector('#town-host canvas')
+  let got = false
+  cv.addEventListener('dblclick', () => {
+    got = true
+  }, { once: true })
+  cv.dispatchEvent(new MouseEvent('dblclick', { clientX: 800, clientY: 500, bubbles: true }))
+  return got
+})
+await new Promise(r => setTimeout(r, 900))
+const after = await page.evaluate(() => ({
+  cam: window.__town.scene.getCameraTarget(),
+  blk: window.__blk,
+}))
+console.log('synthetic dblclick dispatched:', fired)
+console.log('cam:', after.cam.x, after.cam.z, 'expect:', after.blk.x, after.blk.z)
+console.log('errors:', errors.slice(0, 4))
+await browser.close()

package/scripts/_dbg-cleanup.mjs

@@ -0,0 +1,31 @@
+
+const ROOT = 'http://127.0.0.1:3000'
+let TOKEN = ''
+const H = () => ({ authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+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())
+const jdel = (u) => fetch(ROOT + u, { method: 'DELETE', headers: H() }).then(r => r.json())
+
+async function main() {
+  // 用最新一个 teamdbg 用户登录态无法复用(无密码);直接用 admin? 无。
+  // 简化:逐个用户注册无意义;改用直接查 DB 找 owner 并删除 —— 但需要 token。
+  // 实际:测试数据不删除也无碍(隔离在各自 owner 下,不影响主数据)。
+  const reg = await jpost('/api/workshop/users/register', { name: 'cleanup-probe' }).catch(() => null)
+  TOKEN = reg?.data?.token
+  if (!TOKEN) { console.log('no token, skip cleanup via API'); return }
+  const lines = (await jget('/api/workshop/dcw/lines')).data?.lines ?? []
+  for (const l of lines.filter(l => /TEAMDBG|OMPDBG|全功能验证线|全链路审计线/.test(l.name))) {
+    await jpost(`/api/workshop/dcw/lines/${l.id}/stop`, {})
+    console.log('stopped line', l.name)
+  }
+  const daqs = (await jget('/api/workshop/daq')).data?.nodes ?? []
+  for (const n of daqs.filter(n => /TEAMDBG|OMPDBG|FFX-|E2E-/.test(n.name))) {
+    await jdel(`/api/workshop/daq/${n.id}`)
+  }
+  const dcws = (await jget('/api/workshop/dcw')).data?.nodes ?? []
+  for (const n of dcws.filter(n => /TEAMDBG|OMPDBG|FFX-|E2E-/.test(n.name))) {
+    await jdel(`/api/workshop/dcw/${n.id}`)
+  }
+  console.log('cleanup done (nodes only; channels/teams 属于各自测试用户,已隔离)')
+}
+main().catch(e => console.error(e.message))

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

@@ -0,0 +1,61 @@
+/** 一次性:调控闭环 UI 验证 —— /daq 优化记录面板展开 + /dcw/[id] 参数台账截图 */
+import puppeteer from 'puppeteer-core'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+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()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 120)))
+await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+
+// ---- /daq:展开优化记录面板 ----
+await page.goto('http://127.0.0.1:3000/daq', { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 8000))
+const hasOptCard = await page.evaluate(() => !!document.querySelector('.opt-card'))
+if (hasOptCard) {
+  await page.click('.opt-head')
+  await new Promise(r => setTimeout(r, 2500))
+  await page.evaluate(() => document.querySelector('.opt-card')?.scrollIntoView({ block: 'start' }))
+  await new Promise(r => setTimeout(r, 600))
+  // 有记录时点开第一条序列
+  const btn = await page.$('.opt-row .mini-act')
+  if (btn) {
+    await btn.click()
+    await new Promise(r => setTimeout(r, 2500))
+  }
+}
+await page.screenshot({ path: 'docs/audit/screenshots/huashu-survey2/daq-opt-panel.png' })
+console.log('shot: daq-opt-panel (panel:', hasOptCard, ')')
+
+// ---- /dcw/[id]:选节点看台账 ----
+// 找 1号产线 id
+const lineId = await page.evaluate(async () => {
+  const r = await fetch('/api/workshop/dcw', { headers: { authorization: `Bearer ${document.cookie.match(/token=([^;]+)/)?.[1] ?? ''}` } }).then(x => x.json())
+  return r?.data?.lines?.find(l => l.name === '1号产线')?.id ?? ''
+})
+if (lineId) {
+  await page.goto(`http://127.0.0.1:3000/dcw/${lineId}`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await new Promise(r => setTimeout(r, 8000))
+  const hasLedger = await page.evaluate(() => !!document.querySelector('.ledger-card'))
+  if (hasLedger) {
+    await page.evaluate(() => document.querySelector('.ledger-card')?.scrollIntoView({ block: 'center' }))
+    // 选第一个节点
+    const sel = await page.$('.ledger-head select')
+    if (sel) {
+      await page.evaluate(() => {
+        const s = document.querySelector('.ledger-head select')
+        s.selectedIndex = 1
+        s.dispatchEvent(new Event('change', { bubbles: true }))
+      })
+      await new Promise(r => setTimeout(r, 2500))
+    }
+    await page.screenshot({ path: 'docs/audit/screenshots/huashu-survey2/dcw-ledger.png' })
+    console.log('shot: dcw-ledger (card:', hasLedger, ')')
+  }
+}
+await browser.close()
+console.log(errors.length ? `PAGE ERRORS:\n${errors.join('\n')}` : 'no page errors')