agentworkshop 0.2.1

package/scripts/_dbg-mqtt-chain-e2e.mjs

@@ -0,0 +1,90 @@
+/**
+ * 一次性:MQTT 规范链路实证。
+ * 独立第三方订阅者挂 broker aw/daq/+/sample → REST 建真实 Modbus 节点 →
+ * 断言:①MQTT 帧真实过 broker(主题/载荷符合规范) ②Timescale 有该节点样本
+ * ③节点+driverConfig 持久化(daqs.json) ④重启存活(交由外部脚本)。
+ */
+import mqtt from 'mqtt'
+import { readFileSync } from 'node:fs'
+
+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' }
+
+// ---------- 第三方 MQTT 订阅者(规范验证:独立于应用进程) ----------
+const frames = []
+const client = mqtt.connect('mqtt://127.0.0.1:1883', { clientId: 'audit-sub-' + Date.now() })
+client.on('message', (topic, payload) => {
+  try {
+    frames.push({ topic, payload: JSON.parse(payload.toString()) })
+  }
+  catch { /* 坏帧忽略 */ }
+})
+const subReady = new Promise((res) => {
+  client.on('connect', () => client.subscribe('aw/daq/+/sample', { qos: 0 }, () => res()))
+})
+await subReady
+console.log('[audit-sub] 已订阅 aw/daq/+/sample')
+
+// ---------- 前端同款操作:REST 创建真实 Modbus 节点 ----------
+const made = await fetch(`${BASE}/api/workshop/daq`, {
+  method: 'POST', headers: H,
+  body: JSON.stringify({
+    templateRef: 'daq-pressure-tx',
+    name: 'MQTT链路审计 · 熔体压力',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', scale: 1, byteOrder: 'big' },
+    intervalMs: 500,
+  }),
+}).then(r => r.json())
+const node = made.data?.node
+console.log('[created]', node?.id, '| driver =', node?.driver, '| cfg =', JSON.stringify(node?.driverConfig))
+
+// ---------- 捕获 5s MQTT 帧 ----------
+await new Promise(r => setTimeout(r, 5000))
+client.end(true)
+
+let specOk = false
+const mine = frames.filter(f => f.topic === `aw/daq/${node.id}/sample`)
+console.log(`[mqtt frames] total=${frames.length} mine=${mine.length}`)
+if (mine[0]) {
+  console.log('[frame sample] topic =', mine[0].topic)
+  console.log('[frame sample] payload =', JSON.stringify(mine[0].payload))
+  const p = mine[0].payload
+  specOk = p.nodeId === node.id && typeof p.value === 'number' && typeof p.at === 'string'
+    && ['ok', 'warn', 'alarm', 'offline'].includes(p.state) && p.templateRef === 'daq-pressure-tx'
+  console.log('[spec check]', specOk ? 'PASS(载荷四要素:nodeId/templateRef/value/state/at)' : 'FAIL')
+}
+const valueInBand = mine.length > 0 && mine.every(f => f.payload.value > 0.5 && f.payload.value < 1.3)
+console.log('[frames mine count]', mine.length)
+console.log('[value band]', valueInBand ? 'PASS(全部在 0.6~1.2 MPa 物理域)' : 'FAIL')
+
+// ---------- Timescale 落库断言 ----------
+await new Promise(r => setTimeout(r, 1500))
+const samples = await fetch(`${BASE}/api/workshop/daq/${node.id}/samples?limit=50`, { headers: H }).then(r => r.json())
+const pts = samples.data?.points ?? []
+console.log(`[tsdb] node 样本行 = ${pts.length}`, pts.length ? `(min=${Math.min(...pts.map(p => p.value)).toFixed(3)}, max=${Math.max(...pts.map(p => p.value)).toFixed(3)})` : '')
+
+// ---------- 持久化断言(daqs.json) ----------
+const daqStore = JSON.parse(readFileSync('server/data/daqs.json', 'utf-8'))
+const persisted = daqStore.find(n => n.id === node.id)
+console.log('[persisted]', persisted
+  ? `PASS(${persisted.name} | driver=${persisted.driver} | cfg=${JSON.stringify(persisted.driverConfig)})`
+  : 'FAIL: daqs.json 无该节点')
+
+// Timescale 侧直查(容器内)
+const { execFile } = await import('node:child_process')
+const { promisify } = await import('node:util')
+const exec = promisify(execFile)
+const pg = await exec('docker', ['exec', 'awshop-daq-timescale', 'psql', '-U', 'postgres', '-d', 'awshop', '-tAc',
+  `SELECT count(*) FROM daq_samples WHERE node_id = '${node.id}'`])
+console.log('[tsdb direct] 该节点行数 =', pg.stdout.trim())
+
+const pass = mine.length >= 4 && specOk && valueInBand && pts.length >= 4 && Boolean(persisted) && Number(pg.stdout.trim()) >= 4
+
+console.log(pass ? '=== MQTT CHAIN AUDIT PASS ===' : '=== MQTT CHAIN AUDIT FAIL ===')
+process.exit(pass ? 0 : 1)

package/scripts/_dbg-nav-rpg.mjs

@@ -0,0 +1,84 @@
+/**
+ * RPG 导航图审计:准星钉死图心 + 世界内容随镜头移动。
+ *  - 画布中心像素恒为白色准星(镜头移动前后不变);
+ *  - focusTo 远点 → 画布内容指纹变化(世界在图下滑动);
+ *  - 拖拽画布 → 注视点位移;滚轮 → navZoom 变化(meta 文本 ×N)。
+ */
+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', '--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: '/' })
+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 ?? 0) > 0)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 4000))
+
+// 中心准星恒在
+const centerDot = () => page.evaluate(() => {
+  const cv = document.querySelector('.nav-cv')
+  const x = cv.getContext('2d')
+  const c = x.getImageData(cv.width / 2, cv.height / 2, 1, 1).data
+  return { r: c[0], g: c[1], b: c[2], a: c[3] }
+})
+const d0 = await centerDot()
+console.log('center pixel:', JSON.stringify(d0), d0.a > 200 ? '(OK 准星在图心)' : '(FAIL)')
+
+// 内容指纹:镜头移动 → 指纹必须变化(世界滑动);准星不变
+const finger = () => page.evaluate(() => {
+  const cv = document.querySelector('.nav-cv')
+  const x = cv.getContext('2d')
+  const d = x.getImageData(0, 0, cv.width, cv.height).data
+  let h = 0
+  for (let i = 0; i < d.length; i += 97) h = (h * 31 + d[i]) | 0
+  return h
+})
+await page.evaluate(() => window.__town.scene.focusTo(2600, 1900))
+await new Promise(r => setTimeout(r, 1600))
+const f0 = await finger()
+await page.evaluate(() => window.__town.scene.focusTo(600, 500))
+await new Promise(r => setTimeout(r, 1600))
+const f1 = await finger()
+console.log('focus far: content fingerprint', f0, '→', f1, f0 !== f1 ? '(OK 内容随镜头移动)' : '(FAIL 未变)')
+const d2 = await centerDot()
+console.log('center after moves:', JSON.stringify(d2), d2.a > 200 ? '(OK 准星仍钉图心)' : '(FAIL)')
+
+// 拖拽画布 → 注视点位移(move/up 派发到画布:Vue 处理器绑在 canvas;真实指针经 capture 重定向也到 canvas)
+const t0 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target
+await page.evaluate(() => {
+  const cv = document.querySelector('.nav-cv')
+  cv.dispatchEvent(new PointerEvent('pointerdown', { button: 0, clientX: 1400, clientY: 800, bubbles: true }))
+})
+for (let i = 0; i < 5; i++) {
+  await page.evaluate(k => document.querySelector('.nav-cv').dispatchEvent(new PointerEvent('pointermove', { clientX: 1400 + (k + 1) * 12, clientY: 800, bubbles: true })), i)
+}
+await page.evaluate(() => document.querySelector('.nav-cv').dispatchEvent(new PointerEvent('pointerup', { bubbles: true })))
+const t1 = (await page.evaluate(() => window.__town.scene.getCameraPose())).target
+console.log('nav drag: target delta', (t1.x - t0.x).toFixed(0), Math.hypot(t1.x - t0.x, t1.z - t0.z) > 5 ? '(OK 拖拽平移)' : '(FAIL)')
+
+// 滚轮 → 地图缩放
+await page.evaluate(() => {
+  const cv = document.querySelector('.nav-cv')
+  cv.dispatchEvent(new WheelEvent('wheel', { deltaY: -120, bubbles: true, cancelable: true }))
+})
+await new Promise(r => setTimeout(r, 400))
+const meta = await page.evaluate(() => document.querySelector('.mm-meta')?.textContent ?? '')
+console.log('nav wheel:', meta.trim(), meta.includes('×0.9') || meta.includes('×0.8') ? '(OK 地图缩放)' : '(CHECK)')
+
+// 截图
+await page.evaluate(() => window.__town.scene.focusTo(1700, 1200))
+await new Promise(r => setTimeout(r, 1500))
+await page.screenshot({ path: 'docs/audit/screenshots/town-nav-rpg.png', clip: { x: 1250, y: 640, width: 350, height: 360 } })
+console.log('pageerrors:', errors.length ? errors : 'none')
+await browser.close()

package/scripts/_dbg-nav-shot.mjs

@@ -0,0 +1,28 @@
+/** 一次性:截 RPG 导航图卡片 */
+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, 4000))
+await page.evaluate(() => window.__town.scene.focusTo(1700, 1200))
+await new Promise(r => setTimeout(r, 1800))
+await page.evaluate(() => {
+  const rail = document.querySelector('.rail-right')
+  rail.scrollTop = rail.scrollHeight
+})
+await new Promise(r => setTimeout(r, 600))
+const box = await (await page.$('.mm-body')).boundingBox()
+await page.screenshot({ path: 'docs/audit/screenshots/town-nav-rpg.png', clip: { x: box.x - 8, y: box.y - 44, width: box.width + 66, height: box.height + 88 } })
+await browser.close()
+console.log('shot ok')

package/scripts/_dbg-nav.mjs

@@ -0,0 +1,27 @@
+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: '/' })
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 6000))
+const d = await page.evaluate(() => {
+  const nav = document.querySelector('.nav-tabs')
+  if (!nav) return { err: 'no nav' }
+  return [...nav.children].map((el) => {
+    const cs = getComputedStyle(el)
+    const r = el.getBoundingClientRect()
+    return {
+      tag: el.tagName, cls: el.className.toString().slice(0, 40), text: el.textContent.trim().slice(0, 12),
+      w: Math.round(r.width), bg: cs.backgroundColor, color: cs.color,
+    }
+  })
+})
+console.log(JSON.stringify(d, null, 1))
+await browser.close()

package/scripts/_dbg-opslog-e2e.mjs

@@ -0,0 +1,121 @@
+/**
+ * 运维日志(OpsLog)e2e:全操作入册 + 维度隔离查询 + 实时帧 + 人工记录。
+ * 链路:夹具产线开跑 → 手动下发 → 越限告警 → 人工记录 → 按产线/Recipe/分类/来源过滤。
+ * 前置:dev server + DAQ/DCW 网关运行;mock 驱动节点即可(无需真机)。
+ * 运行:ADMIN_TOKEN=<token> node scripts/_dbg-opslog-e2e.mjs
+ */
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${process.env.ADMIN_TOKEN ?? process.env.AW_PAGE_TOKEN ?? ''}`, 'content-type': 'application/json' }
+let pass = 0
+let fail = 0
+const ok = (cond, label) => {
+  if (cond) { pass++; console.log(`PASS ${label}`) }
+  else { fail++; console.log(`FAIL ${label}`) }
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const rand = Math.random().toString(36).slice(2, 7)
+const jget = async p => (await fetch(`${BASE}${p}`, { headers: H })).json()
+const jpost = async (p, b) => (await fetch(`${BASE}${p}`, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) })).json()
+const jpatch = async (p, b) => (await fetch(`${BASE}${p}`, { method: 'PATCH', headers: H, body: JSON.stringify(b ?? {}) })).json()
+
+// ---- WS 实时帧监听(ops.log / daq.alarm 直推验证;Node 24 全局 WebSocket) ----
+let wsSeen = []
+let wsClose = null
+async function startWs() {
+  const token = H.authorization.split(' ')[1]
+  const sock = new WebSocket(`ws://127.0.0.1:3000/api/workshop/ws?token=${token}`)
+  await new Promise((resolve, reject) => { sock.addEventListener('open', resolve, { once: true }); sock.addEventListener('error', reject, { once: true }) })
+  sock.addEventListener('message', (ev) => {
+    try {
+      const f = JSON.parse(String(ev.data))
+      if (f.type === 'ops.log' || f.type === 'daq.alarm') wsSeen.push(f.type)
+    }
+    catch { /* 忽略非 JSON 帧 */ }
+  })
+  wsClose = () => sock.close()
+}
+
+// ---- 0) 网关运行 ----
+{
+  const r = await jget('/api/workshop/dcw')
+  if (!r?.data?.controller?.running)
+    await fetch(`${BASE}/api/workshop/dcw/controller?action=resume`, { method: 'POST', headers: H })
+  const d = await jget('/api/workshop/daq')
+  if (!d?.data?.controller?.running)
+    await jpost('/api/workshop/daq/controller', { action: 'resume' })
+}
+
+// ---- 1) 夹具:产线 + 数控 + 产品 + 配方 + 数采节点(mock 温度 ~165-180) ----
+const line = (await jpost('/api/workshop/dcw/lines', { name: `OpsLog线-${rand}` })).data.line
+const dw = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: `OpsLog设定-${rand}`, lineId: line.id })).data.node
+const product = (await jpost('/api/workshop/dcw/products', { lineId: line.id, name: `OpsLog产品-${rand}` })).data.product
+const recipe = (await jpost('/api/workshop/dcw/recipes', { productId: product.id, name: `OpsLog配方-${rand}`, params: [{ nodeId: dw.id, value: 175 }] })).data.recipe
+const dq = (await jpost('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: `OpsLog采集-${rand}`, lineId: line.id, intervalMs: 500 })).data.node
+ok(!!line?.id && !!dq?.id, '夹具创建(产线/数控/配方/数采)')
+
+// ---- 2) WS 先连上,覆盖后续全部操作(直推验证) ----
+await startWs()
+
+// ---- 3) 产线开跑 → ops 日志应有 line.start(携带产线/产品/Recipe) ----
+const start = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: recipe.id })
+ok(start.code === 0, '产线开跑')
+await sleep(700)
+{
+  const r = await jget(`/api/workshop/ops-logs?lineId=${line.id}&kind=line&limit=20`)
+  const row = (r.data?.logs ?? []).find(x => x.action === 'line.start')
+  ok(!!row, '开跑入册(line.start)')
+  ok(row?.lineId === line.id && row?.productId === product.id && row?.recipeId === recipe.id, '开跑维度三联正确(line/product/recipe)')
+}
+
+// ---- 3) 手动下发 → write 入册 ----
+{
+  const w = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 176 })
+  ok(w.data?.outcome?.ok !== false, '手动下发 176')
+  await sleep(600)
+  const r = await jget(`/api/workshop/ops-logs?lineId=${line.id}&kind=write&limit=20`)
+  const writes = (r.data?.logs ?? []).filter(x => x.action === 'dcw.write.manual')
+  ok(writes.length >= 1, `下发入册(dcw.write.manual ×${writes.length})`)
+  ok(writes.every(x => x.recipeId === recipe.id), '下发条目携带活动批次 Recipe')
+}
+
+// ---- 4) 越限告警:配方窗 [900,950](mock 温度必越)→ alarm 沿 → raise → ops 入册 ----
+{
+  const p = await jpatch(`/api/workshop/dcw/recipes/${recipe.id}`, { daqWindows: [{ nodeId: dq.id, min: 900, max: 950 }] })
+  ok(p.code === 0, '配方追加越限监控窗 [900,950]')
+  await sleep(4500)
+  const alarms = await jget('/api/workshop/daq/alarms?scope=open&limit=50')
+  const hit = (alarms.data?.alarms ?? []).find(a => a.nodeId === dq.id)
+  ok(!!hit, `越窗告警已产生(node=${hit?.nodeName ?? '—'})`)
+  await sleep(400)
+  const r = await jget(`/api/workshop/ops-logs?lineId=${line.id}&kind=alarm&limit=10`)
+  ok((r.data?.logs ?? []).some(x => x.action === 'daq.alarm.raise'), '告警入册(daq.alarm.raise)')
+}
+
+// ---- 5) 人工记录(带产线/产品/Recipe)→ kind=manual 按 Recipe 可查 ----
+{
+  const post = await jpost('/api/workshop/ops-logs', { summary: `OpsLog e2e 人工事件 ${rand}:现场处置留痕`, lineId: line.id, productId: product.id, recipeId: recipe.id })
+  ok(post.code === 0, '人工记录入册成功')
+  const r = await jget(`/api/workshop/ops-logs?recipeId=${recipe.id}&kind=manual&limit=10`)
+  const hit = (r.data?.logs ?? []).find(x => x.kind === 'manual')
+  ok(!!hit && (hit.summary ?? '').includes(rand), '按 Recipe 过滤命中人工记录')
+}
+
+// ---- 6) WS 实时帧:监听器全程在线,应已收到 ops.log 与 daq.alarm ----
+{
+  await sleep(800)
+  wsClose?.()
+  ok(wsSeen.includes('ops.log'), `WS 收到 ops.log 帧(×${wsSeen.filter(t => t === 'ops.log').length})`)
+  ok(wsSeen.includes('daq.alarm'), `WS 收到 daq.alarm 帧(×${wsSeen.filter(t => t === 'daq.alarm').length})`)
+}
+
+// ---- 7) 组合过滤:来源=system + 产线隔离 ----
+{
+  const r = await jget(`/api/workshop/ops-logs?lineId=${line.id}&actorKind=system&limit=50`)
+  const rows = r.data?.logs ?? []
+  ok(rows.length >= 2 && rows.every(x => x.actorKind === 'system' && x.lineId === line.id), `来源+产线组合过滤(×${rows.length})`)
+}
+
+// ---- 8) 清场:停线 ----
+await jpost(`/api/workshop/dcw/lines/${line.id}/stop`, {})
+console.log(`\n=== 结果:${pass} PASS / ${fail} FAIL ===`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_dbg-opslog-shots.mjs

@@ -0,0 +1,62 @@
+/**
+ * 视觉验证:/daq 双面板(实时告警+实时事件)/ /logs 日志管理 / /town 孪生场景实时渲染。
+ * 输出 PNG 到 docs/audit/screenshots/opslog/;场景实时性 = 两次采样 callout 值必变化。
+ * 运行:AW_PAGE_TOKEN=<token> node scripts/_dbg-opslog-shots.mjs
+ */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--proxy-server=direct://', '--proxy-bypass-list=*', '--window-size=1920,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+
+// ---- 1) /daq:双面板(实时告警 + 实时事件) ----
+await page.goto('http://127.0.0.1:3000/daq', { waitUntil: 'domcontentloaded', timeout: 120000 })
+await sleep(10000)
+const panels = await page.evaluate(() => ({
+  alarmPanel: !!document.querySelector('.alarm-panel'),
+  eventPanel: !!document.querySelector('.event-panel'),
+  evtRows: document.querySelectorAll('.evt-row').length,
+  alarmRows: document.querySelectorAll('.alarm-row').length,
+}))
+console.log('/daq panels:', JSON.stringify(panels))
+await page.screenshot({ path: 'docs/audit/screenshots/opslog/daq-panels.png' })
+
+// ---- 2) /logs:日志管理页(筛选/表格/实时) ----
+await page.goto('http://127.0.0.1:3000/logs', { waitUntil: 'domcontentloaded', timeout: 120000 })
+await sleep(9000)
+const logsState = await page.evaluate(() => ({
+  rows: document.querySelectorAll('.log-table tbody tr').length,
+  chips: document.querySelectorAll('.scope-chip').length,
+  badges: document.querySelectorAll('.src-badge').length,
+}))
+console.log('/logs state:', JSON.stringify(logsState))
+await page.screenshot({ path: 'docs/audit/screenshots/opslog/logs-page.png' })
+
+// ---- 3) /town:孪生场景实时渲染(callout 值两次采样必变化) ----
+await page.goto('http://127.0.0.1:3000/town', { waitUntil: 'domcontentloaded', timeout: 120000 })
+await sleep(16000)
+const sampleCallouts = () => page.evaluate(() => [...document.querySelectorAll('.callout .co-val')].map(e => e.textContent?.trim()).slice(0, 12))
+try {
+  await page.waitForFunction(() => document.querySelectorAll('.callout').length > 0, { timeout: 30000 })
+}
+catch {
+  console.log('warn: 场景无 callout(可能镜头距离远/无数采节点)')
+}
+const v1 = await sampleCallouts()
+await sleep(6000)
+const v2 = await sampleCallouts()
+const changed = v1.filter((x, i) => v2[i] !== undefined && v1[i] !== v2[i]).length
+console.log(`/town callouts: n=${v1.length} 值变化通道=${changed}`)
+console.log('  t0:', JSON.stringify(v1.slice(0, 6)))
+console.log('  t1:', JSON.stringify(v2.slice(0, 6)))
+await page.screenshot({ path: 'docs/audit/screenshots/opslog/town-live.png' })
+
+console.log('VISUAL PASS:', panels.alarmPanel && panels.eventPanel && logsState.rows > 0 && v1.length > 0 && changed > 0 ? 'ALL GREEN' : 'CHECK ABOVE')
+await browser.close()

package/scripts/_dbg-opt-team-e2e.mjs

@@ -0,0 +1,133 @@
+/**
+ * M3 e2e:omp 团队活体 —— Agent 闭环控制策略(设定→复测→判定→回退)真实 LLM 全链。
+ * 复用 1号产线 demo 资产;worker(auto 绑定)被要求:dcw_control(带 hypothesis)→
+ * daq_query 复测 → dcw_judge 落判定 →(判 rollback 时)dcw_rollback 执行 → dcw_journal 复盘。
+ * 硬断言:该节点出现 agentId=worker 的优化记录且 judge.by='agent'(判定真的由 LLM 落下)。
+ * 用法:ADMIN_TOKEN=<token> node scripts/_dbg-opt-team-e2e.mjs [--monitor]
+ */
+const BASE = 'http://127.0.0.1:3000'
+const MONITOR = process.argv.includes('--monitor')
+const adminToken = process.env.ADMIN_TOKEN ?? ''
+let H = { 'content-type': 'application/json' }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const J = async (u, m = 'GET', b) => {
+  const r = await fetch(BASE + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined })
+  return r.json()
+}
+
+// ---- 登录 ----
+if (!adminToken) {
+  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())
+  H.authorization = `Bearer ${login.data.token}`
+} else {
+  H.authorization = `Bearer ${adminToken}`
+}
+
+const d = (await J('/api/workshop/dcw')).data
+const line = d.lines.find(l => l.name === '1号产线')
+const dwTemp = d.nodes.find(n => n.name === '温度设定器(示例)')
+if (!line || !dwTemp) { console.error('FAIL 1号产线/温度设定器缺失'); process.exit(1) }
+// 确保产线在跑(记录需要 recipeId 归属)
+const st = d.lineStates?.find(s => s.lineId === line.id)
+if (!st?.active) {
+  const recipe = d.recipes.find(r => r.lineId === line.id)
+  const s = await J(`/api/workshop/dcw/lines/${line.id}/start`, 'POST', { recipeId: recipe.id })
+  console.log('lineStart:', s.code === 0 ? 'OK' : JSON.stringify(s).slice(0, 120))
+}
+console.log(`目标 → ${dwTemp.name}(当前 ${dwTemp.value}℃,窗口 176~188)`)
+
+// ---- monitor 模式:只观察最近的记录与判定 ----
+if (MONITOR) {
+  const recs = (await J(`/api/workshop/dcw/optimizations?nodeId=${dwTemp.id}&limit=6`)).data.records
+  for (const r of recs) {
+    console.log(`[${r.status}] ${r.id} ${r.setAt.slice(11, 19)} ${r.params[0]?.from}→${r.params[0]?.to} judge=${r.judge ? `${r.judge.by}:${r.judge.verdict}` : '未判定'}${r.judge ? `(${r.judge.reason.slice(0, 46)})` : ''}`)
+  }
+  process.exit(0)
+}
+
+// ---- 1. Channel + 团队(worker=omp 真实 LLM,auto 绑定以便 Agent 全程自主) ----
+const rand = Math.random().toString(36).slice(2, 6)
+const ch = (await J('/api/workshop/channels', 'POST', { name: `闭环优化团队(${rand})`, description: '设定→判定→回退 闭环活体验证' })).data
+const team = (await J('/api/workshop/teams', 'POST', { name: `闭环优化组(${rand})` })).data
+await J(`/api/workshop/teams/${team.id}/members`, 'POST', { agentId: 'tpl-default-lead', role: 'lead' })
+const workerTpl = (await J('/api/workshop/agents', 'POST', {
+  name: `闭环调控工程师(${rand})`, harness: 'omp',
+  config: {
+    intro: '负责产线工艺参数的闭环优化:设定→复测→判定→必要回退',
+    systemPromptPrefix: '你是产线闭环调控工程师,严格执行七步作业环:1) my_industrial_nodes 读节点;2) daq_query 观察工况;'
+      + '3) 声明假设并用 dcw_control 小步下发(必带 hypothesis 参数);4) 等待 60 秒后 daq_query 复测;'
+      + '5) 用 dcw_judge 对返回的优化记录 id 落判定(keep/rollback/uncertain,理由必须引用复测数值);'
+      + '6) 若判 rollback,立即用 dcw_rollback(record_id) 执行回退并复测;'
+      + '7) dcw_journal 查看在册记录,汇报记录 id 与判定结论。所有数值带单位。',
+  },
+})).data
+await J(`/api/workshop/teams/${team.id}/members`, 'POST', { agentId: workerTpl.id, role: 'worker' })
+const dep = await J(`/api/workshop/teams/${team.id}/deploy`, 'POST', { channelId: ch.channelId })
+void dep
+const chAgents = (await J(`/api/workshop/channels/${ch.channelId}/agents`)).data
+const workerInst = chAgents.find(a => a.role === 'worker' && a.harness === 'omp')
+if (!workerInst) { console.error('FAIL worker 实例缺失'); process.exit(1) }
+console.log('worker 实例:', workerInst.id.slice(0, 8), '(omp)')
+
+// ---- 2. 绑定:daq auto + dcw auto(Agent 全程自主;系统有越限兜底) ----
+const daqAll = (await J('/api/workshop/daq')).data
+const dqTemp = daqAll.nodes.find(n => n.name === '温度传感器 01' && n.lineId === line.id)
+if (dqTemp) await J('/api/workshop/agent-tools/bindings', 'POST', { agentId: workerInst.id, nodeId: dqTemp.id, kind: 'daq', mode: 'auto' })
+await J('/api/workshop/agent-tools/bindings', 'POST', { agentId: workerInst.id, nodeId: dwTemp.id, kind: 'dcw', mode: 'auto' })
+console.log('绑定完成(daq auto + dcw auto)')
+
+// ---- 3. 工具冒烟(闭环面) ----
+const invoke = (tool, args) => J('/api/workshop/agent-tools/invoke', 'POST', { agentId: workerInst.id, tool, args }).then(r => r.data?.result)
+const mine = await invoke('my_industrial_nodes', {})
+console.log('[冒烟] my_industrial_nodes:', (mine?.text ?? '').slice(0, 80).replace(/\n/g, ' '))
+
+// ---- 4. 派发闭环任务(直发 worker:assigneeId 指定成员,绕过 lead 调度不确定性) ----
+const valueBefore = (await J('/api/workshop/dcw')).data.nodes.find(n => n.id === dwTemp.id).value
+const goal = `闭环调控任务:烘箱温度当前设定 ${valueBefore}℃,工艺窗口 176~188℃。请严格执行七步作业环:daq_query 观察后,用 dcw_control 将设定调整到 178℃(hypothesis 写明假设);等待约 60 秒 daq_query 复测;然后必须用 dcw_judge 对优化记录落判定(引用复测数值;若复测显示温度向错误方向移动或越窗,判 rollback 并用 dcw_rollback 执行);最后 dcw_journal 确认记录在册。汇报:记录 id、判定结论、依据数值。`
+const task = (await J(`/api/workshop/channels/${ch.channelId}/tasks`, 'POST', { title: `烘箱温度闭环调控(${rand})`, parts: [{ text: goal }], mode: 'loop', assigneeId: workerInst.id })).data
+const taskId = task?.task?.id ?? task?.id
+if (!taskId) { console.error('FAIL 任务派发失败:', JSON.stringify(task).slice(0, 150)); process.exit(1) }
+console.log('任务已直发 worker:', taskId.slice(0, 10), `(${valueBefore} → 178,期望判定+必要回退)`)
+
+// ---- 5. 轮询:任务工件 + 优化记录判定 ----
+const deadline = Date.now() + 12 * 60_000
+let done = false
+let agentJudgeSeen = false
+while (Date.now() < deadline) {
+  await sleep(20_000)
+  const env = await J(`/api/workshop/channels/${ch.channelId}/tasks`)
+  const t = env.data ?? []
+  const me = t.find(x => x.id === taskId)
+  const status = me?.status ?? '?'
+  const recs = (await J(`/api/workshop/dcw/optimizations?nodeId=${dwTemp.id}&limit=8`)).data.records
+  const mine2 = recs.filter(r => r.agentId === workerInst.id)
+  agentJudgeSeen = mine2.some(r => r.judge?.by === 'agent')
+  console.log(`  [${new Date().toISOString().slice(11, 19)}] task=${status} | 优化记录 ${mine2.length} 条(判定 ${mine2.filter(r => r.judge).length})`)
+  if (me && ['COMPLETED', 'FAILED', 'CANCELED'].includes(status)) {
+    done = status === 'COMPLETED'
+    const art = me.artifacts?.[0]?.parts?.map(p => p.text ?? '').join(' ') ?? ''
+    console.log('  worker 结论片段:', art.slice(-400).replace(/\n+/g, ' | '))
+    break
+  }
+}
+
+// ---- 6. 硬断言:Agent 判定真的落下 ----
+const recs = (await J(`/api/workshop/dcw/optimizations?nodeId=${dwTemp.id}&limit=10`)).data.records
+const mineFinal = recs.filter(r => r.agentId === workerInst.id)
+const judged = mineFinal.find(r => r.judge?.by === 'agent')
+let pass = 0
+let fail = 0
+const ok = (cond, label) => { if (cond) { pass++; console.log(`PASS ${label}`) } else { fail++; console.log(`FAIL ${label}`) } }
+ok(!!judged, `Agent 判定入册(judge.by=agent,verdict=${judged?.judge?.verdict ?? '-'})`)
+ok(mineFinal.length > 0, `优化记录在册(${mineFinal.length} 条,含假设:${mineFinal[0]?.hypothesis?.slice(0, 30) ?? '-'})`)
+if (judged?.verdict === 'rollback') {
+  const rb = mineFinal.find(r => r.rollbackOf === judged.id)
+  ok(!!rb, 'rollback 判定已被执行(回退记录在册)')
+}
+ok(done || agentJudgeSeen, `任务完成/判定达成(done=${done},agentJudge=${agentJudgeSeen})`)
+console.log(`\n=== 结果:${pass} PASS / ${fail} FAIL ===`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_dbg-optimization-e2e.mjs

@@ -0,0 +1,94 @@
+/**
+ * M3 e2e:系统兜底自动回退全链(越配方监控窗 → sweep 评估 → 自动回退 → 冷却)。
+ * 需要短窗 env:DCW_ROLLBACK_MIN_WINDOW_MS=6000 DCW_ROLLBACK_COOLDOWN_MS=8000(由启动方注入)。
+ * 用法:ADMIN_TOKEN=<token> node scripts/_dbg-optimization-e2e.mjs
+ */
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const H = { 'authorization': `Bearer ${process.env.ADMIN_TOKEN ?? process.env.AW_PAGE_TOKEN ?? ''}`, 'content-type': 'application/json' }
+let pass = 0
+let fail = 0
+const ok = (cond, label) => {
+  if (cond) { pass++; console.log(`PASS ${label}`) }
+  else { fail++; console.log(`FAIL ${label}`) }
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const jget = p => fetch(`${BASE}/api/workshop/dcw${p}`, { headers: H }).then(r => r.json())
+const jpost = async (p, b) => {
+  const r = await fetch(`${BASE}/api/workshop/dcw${p}`, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) })
+  const j = await r.json().catch(() => ({}))
+  if (!r.ok || j.code !== 0) console.log(`  [debug] POST ${p} → ${r.status} ${JSON.stringify(j).slice(0, 160)}`)
+  return j
+}
+const rand = () => Math.random().toString(36).slice(2, 7)
+const AGENT = `opt-agent-${rand()}`
+
+// ---- 0) 网关运行 ----
+{
+  const r = await jget('')
+  if (!r?.data?.controller?.running)
+    await fetch(`${BASE}/api/workshop/dcw/controller?action=resume`, { method: 'POST', headers: H }).then(x => x.json())
+}
+
+// ---- 1) 夹具:产线 + 产品 + 配方(daqWindows 设为不可达区间 → 全样本越限) ----
+const line = (await jpost('/lines', { name: `OptE2E线-${rand()}` })).data.line
+const product = (await jpost('/products', { lineId: line.id, name: `OptE2E产品-${rand()}` })).data.product
+const devList = (await fetch(`${BASE}/api/workshop/device-twins`, { headers: H }).then(r => r.json())).data?.twins ?? []
+const device = devList.find(t => t.kind !== 'daq' && typeof t.posX === 'number')
+ok(!!device?.id, `设备孪生可用(${device?.id})`)
+
+// 数采节点(绑定同设备 → 优化记录通道选择命中)
+const daqCreate = await fetch(`${BASE}/api/workshop/daq`, { method: 'POST', headers: H, body: JSON.stringify({ templateRef: 'daq-temp-tc', name: `OptE2E温度采集-${rand()}`, lineId: line.id, intervalMs: 500, deviceBindingId: device.id, posX: (device.posX ?? 0) + 30, posZ: (device.posZ ?? 0) + 30 }) }).then(r => r.json())
+const dq = daqCreate.data?.node
+ok(!!dq?.id, `数采节点创建(${dq?.id})`)
+const dcwCreate = await jpost('', { templateRef: 'dcw-temp-sp', name: `OptE2E温度设定-${rand()}`, lineId: line.id, deviceBindingId: device.id, posX: (device.posX ?? 0) - 30, posZ: (device.posZ ?? 0) - 30 })
+const dw = dcwCreate.data?.node
+ok(!!dw?.id, `数控节点创建(${dw?.id})`)
+
+// 配方:参数 175 + 监控窗 [900, 950](mock 数采温度 ~165-180 → 全越限 → 必触发)
+const recipe = (await jpost('/recipes', { productId: product.id, name: `OptE2E配方-${rand()}`, params: [{ nodeId: dw.id, value: 175 }], daqWindows: [{ nodeId: dq.id, min: 900, max: 950 }] })).data.recipe
+ok(!!recipe?.id, '配方创建(含越限监控窗)')
+
+// ---- 2) Agent 绑定(auto)→ 开跑 → dcw_control 开记录 ----
+const bind = await fetch(`${BASE}/api/workshop/agent-tools/bindings`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: AGENT, nodeId: dw.id, kind: 'dcw', mode: 'auto' }) })
+ok(bind.status === 200, 'Agent 绑定(auto)')
+const start = await jpost(`/lines/${line.id}/start`, { recipeId: recipe.id })
+ok(start.code === 0, '产线开跑(数采门控开启,样本带 recipeId 打标)')
+
+const c1 = await fetch(`${BASE}/api/workshop/agent-tools/invoke`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: AGENT, tool: 'dcw_control', args: { node_id: dw.id, value: 176, hypothesis: 'OptE2E:提温 1℃(预期越窗触发系统回退)' } }) }).then(r => r.json())
+const recId = (c1.data?.result?.text.match(/优化记录 (opt-[0-9a-f]+)/) ?? [])[1]
+ok(!!recId, `dcw_control 开记录(${recId})`)
+
+// ---- 3) 等 sweep 兜底评估(MIN_WINDOW 6s + 余量)→ 系统自动回退 ----
+console.log('  等待系统兜底评估(约 10s)…')
+let rolled = null
+for (let i = 0; i < 20; i++) {
+  await sleep(1500)
+  const records = (await jget(`/optimizations?nodeId=${dw.id}`)).data.records
+  rolled = records.find(r => r.id === recId)
+  if (rolled?.status === 'rolled-back') break
+}
+ok(rolled?.status === 'rolled-back', `记录被系统回退(rolled-back)`)
+ok(rolled?.judge?.by === 'system' && rolled?.judge?.verdict === 'rollback' && /越配方监控窗/.test(rolled.judge.reason), `系统判定入册(by=system,越窗证据:${rolled?.judge?.reason.slice(0, 40)}…)`)
+ok((rolled?.windowAgg?.channels ?? []).some(c => c.breaches >= 3), `窗口聚合含越限计数(breaches=${rolled?.windowAgg?.channels?.map(c => c.breaches)?.join('/')})`)
+
+// 回退后设定值 = 记录 from 值
+const ledger = (await jget(`/${dw.id}/param-ledger`)).data.ledger
+ok(ledger.current === rolled.params[0]?.from, `PLC 设定已恢复基线(${ledger.current} = from ${rolled.params[0]?.from})`)
+
+// ---- 4) 冷却内同向重写被拒 ----
+const c2 = await fetch(`${BASE}/api/workshop/agent-tools/invoke`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: AGENT, tool: 'dcw_control', args: { node_id: dw.id, value: 176 } }) }).then(r => r.json())
+ok(/冷却/.test(c2.data?.result?.text ?? ''), `冷却护栏生效(${(c2.data?.result?.text ?? '').slice(0, 46)}…)`)
+// 反向写不受冷却限制(写回更低值)
+const c3 = await fetch(`${BASE}/api/workshop/agent-tools/invoke`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: AGENT, tool: 'dcw_control', args: { node_id: dw.id, value: 174 } }) }).then(r => r.json())
+ok(/下发成功/.test(c3.data?.result?.text ?? ''), '反向调整不受冷却限制')
+
+// ---- 5) 持久化:dcw-rollback.json 落盘在册 ----
+const fs = await import('node:fs')
+const path = process.cwd().endsWith('server') ? 'data/dcw-rollback.json' : 'server/data/dcw-rollback.json'
+const db = JSON.parse(fs.readFileSync(path, 'utf-8'))
+ok(db.records.some(r => r.id === recId) && db.anchors.length > 0, `持久化在册(records ${db.records.length}/anchors ${db.anchors.length})`)
+
+// ---- 6) 清场:停线 ----
+await jpost(`/lines/${line.id}/stop`, {})
+console.log(`\n=== 结果:${pass} PASS / ${fail} FAIL ===`)
+process.exit(fail > 0 ? 1 : 0)