agentworkshop 0.7.6 → 0.7.7

package/scripts/e2e-multiharness-team.mjs

@@ -0,0 +1,319 @@
+/**
+ * 多 Harness 团队协同端到端实测 —— "引擎无关"验收。
+ *   schtask/手动: NO_PROXY='127.0.0.1,localhost' node scripts/e2e-multiharness-team.mjs
+ *
+ * LLM provider 矩阵(用户指定:ustc glm-5.3-flash 优先,无则 zhipu coding plan glm-5.3-flash):
+ *   omp      → zhipu-coding-plan / glm-5.3-flash   (omp 目录无 ustc-glm;目录已验证)
+ *   codex    → default(cc-switch) / glm-5.3-flash  (catalog 已验证)
+ *   opencode → zhipuai-coding-plan / glm-5.3-flash (auth.json 已验证)
+ *   dsh      → ustc / glm-5.3-flash                (settings.yaml 已加模型项;ustc 优先)
+ *
+ * 场景:mock lead 调度 + 4 个不同引擎 worker 同 Channel;
+ *   节点:mqtt-daq(18830)/http-daq(1889)/opcua-dcw(4840)/plc-dcw(15040) 全真实协议模拟工况;
+ *   绑定:每个 worker 绑定自己的节点(daq=auto,dcw=manual→HITL);
+ *   任务:omp/codex 读数汇报;dsh/opencode 数控下发(经 HITL 批准);
+ *   验证:任务终态 + 写入落达(opcua 回读/plc SP+PV)+ HITL 帧面。
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+const TAG = Date.now().toString(36)
+
+let failures = 0
+let passed = 0
+const results = []
+const check = (id, name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${id} ${name}${detail ? ` — ${detail}` : ''}`)
+  results.push({ id, name, ok, detail })
+  ok ? passed++ : failures++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, path, { body, token } = {}, attempt = 0) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  try {
+    const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+    return { status: res.status, ...(await res.json().catch(() => ({}))) }
+  }
+  catch (err) {
+    if (attempt < 20) {
+      await sleep(3000)
+      return api(method, path, { body, token }, attempt + 1)
+    }
+    throw err
+  }
+}
+
+/** ── preflight:dev server + 全部模拟工况自愈(清僵尸/唯一实例) ── */
+async function preflight() {
+  const fs = await import('node:fs')
+  const net = await import('node:net')
+  const resolve2 = (await import('node:path')).resolve
+  const { spawnSync, spawn } = await import('node:child_process')
+  const portUp = port => new Promise((res) => {
+    const s = net.connect(port, '127.0.0.1')
+    const t = setTimeout(() => {
+      s.destroy()
+      res(false)
+    }, 1000)
+    s.on('connect', () => {
+      clearTimeout(t)
+      s.destroy()
+      res(true)
+    })
+    s.on('error', () => {
+      clearTimeout(t)
+      res(false)
+    })
+  })
+  // dev server(锁被在跑实例持有时不抢:等它就绪;仅僵尸锁才清)
+  let devOk = false
+  for (let i = 0; i < 40 && !devOk; i++) {
+    try {
+      devOk = (await fetch(`${BASE}/api/health`)).status === 200
+    }
+    catch { devOk = false }
+    if (!devOk) {
+      if (i === 0) {
+        const lockPath = resolve2('.AgentWorkShop/.runtime/aw.lock')
+        let lockPid = 0
+        let lockAlive = false
+        try {
+          lockPid = Number(JSON.parse(fs.readFileSync(lockPath, 'utf-8')).pid ?? 0)
+          if (lockPid) {
+            const t = spawnSync('tasklist', ['/FI', `PID eq ${lockPid}`, '/FO', 'CSV', '/NH'], { encoding: 'utf-8' })
+            lockAlive = (t.stdout ?? '').trim().length > 0 && !/no tasks/i.test(t.stdout ?? '')
+          }
+        }
+        catch { /* 无锁 */ }
+        if (lockPid && !lockAlive) {
+          spawnSync('cmd', ['/c', `taskkill /F /PID ${lockPid}`])
+          try {
+            fs.unlinkSync(lockPath)
+          }
+          catch { /* 无锁 */ }
+          const fd = fs.openSync(resolve2('.AgentWorkShop/data/dev-server.log'), 'a')
+          const child = spawn(process.execPath, ['bin/aw.mjs', 'dev'], {
+            cwd: process.cwd(), env: { ...process.env, NO_PROXY: '127.0.0.1,localhost' },
+            detached: true, stdio: ['ignore', fd, fd],
+          })
+          child.unref()
+          console.log('  [preflight] dev server 重启中…')
+        }
+        else if (lockAlive) {
+          console.log('  [preflight] 锁被在跑实例持有,等待其就绪…')
+        }
+      }
+      await sleep(3000)
+    }
+  }
+  if (!devOk) throw new Error('preflight:dev server 未恢复')
+  console.log('  [preflight] dev server ✓')
+  // 模拟器(清旧持有者 → 唯一实例)
+  const SIMS = [
+    { name: 'mqtt-http', ports: [18830, 1889], cmd: 'scripts/dev-protocol-simulators.mjs', env: { MQTT_SIM_PORT: '18830', HTTP_SIM_PORT: '1889' }, log: 'sim-mqtt-http.log' },
+    { name: 'modbus-tcp', ports: [1502], cmd: 'scripts/dev-modbus-simulator.mjs', env: {}, log: 'sim-modbus-tcp.log' },
+    { name: 'opcua', ports: [4840], cmd: 'scripts/dev-opcua-simulator.mjs', env: { OPCUA_SIM_PORT: '4840' }, log: 'sim-opcua.log' },
+    { name: 'plc', ports: [15040], cmd: 'scripts/dev-plc-simulator.mjs', env: {}, args: ['--port', '15040'], log: 'sim-plc.log' },
+    { name: 'rtu', ports: [15030], cmd: 'scripts/_rtu-mini-slave.mjs', env: {}, log: 'sim-rtu.log' },
+  ]
+  for (const sim of SIMS) {
+    const owners = spawnSync('cmd', ['/c', `netstat -ano | findstr :${sim.ports[0]} | findstr LISTENING`], { encoding: 'utf-8' })
+    for (const line of (owners.stdout ?? '').split('\n')) {
+      const m = line.trim().match(/\s(\d+)\s*$/)
+      if (m) {
+        spawnSync('cmd', ['/c', `taskkill /F /PID ${m[1]}`])
+        await sleep(300)
+      }
+    }
+    const fd = fs.openSync(resolve2('.AgentWorkShop/data', sim.log), 'a')
+    const child = spawn(process.execPath, [sim.cmd, ...(sim.args ?? [])], {
+      cwd: process.cwd(), env: { ...process.env, NO_PROXY: '127.0.0.1,localhost', ...sim.env },
+      detached: true, stdio: ['ignore', fd, fd],
+    })
+    child.unref()
+    let up = false
+    for (let i = 0; i < 15 && !up; i++) {
+      await sleep(1000)
+      up = await portUp(sim.ports[0])
+    }
+    if (!up) throw new Error(`preflight:${sim.name} 拉起失败`)
+  }
+  console.log('  [preflight] 模拟工况六端口 ✓')
+}
+
+async function main() {
+  console.log(`\n━━━ 多 Harness 团队协同 E2E @ ${BASE} (tag=${TAG}) ━━━`)
+  await preflight()
+
+  const reg = await api('POST', '/api/users/register', {
+    body: { email: `team-${TAG}@test.local`, password: 'Passw0rd!123', name: `team-${TAG}` },
+  })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 200)}`)
+  const auth = { token }
+
+  // ═══ Phase 1:产线 + 全协议节点 ═══
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `多引擎产线-${TAG}` }, ...auth })).data?.line
+  const nMqtt = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: `MQTT温度-${TAG}`, driver: 'mqtt', driverConfig: { host: '127.0.0.1', port: 18830, topic: 'aw/sim/temp', jsonPath: 'data.temp' }, lineId: line.id, intervalMs: 1000, publishIntervalMs: 0 }, ...auth,
+  })).data?.node
+  const nHttp = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: `HTTP流量-${TAG}`, driver: 'http', driverConfig: { url: 'http://127.0.0.1:1889/api/value', jsonPath: 'data.value' }, lineId: line.id, intervalMs: 1000, publishIntervalMs: 0 }, ...auth,
+  })).data?.node
+  const nOcua = (await api('POST', '/api/workshop/dcw', {
+    body: { templateRef: 'dcw-temp-sp', name: `OPCUA设定-${TAG}`, driver: 'opcua', driverConfig: { endpoint: 'opc.tcp://127.0.0.1:4840', nodeId: 'ns=2;s=AW.SetTemp' }, lineId: line.id }, ...auth,
+  })).data?.node
+  const nPlc = (await api('POST', '/api/workshop/dcw', {
+    body: { templateRef: 'dcw-temp-sp', name: `PLC设定-${TAG}`, driver: 'modbus-tcp', driverConfig: { host: '127.0.0.1', port: 15040, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' }, lineId: line.id }, ...auth,
+  })).data?.node
+  check('1.1', '四协议节点创建(mqtt/http 数采 + opcua/modbus 数控)', Boolean(line?.id && nMqtt?.id && nHttp?.id && nOcua?.id && nPlc?.id))
+
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: `多引擎产品-${TAG}`, lineId: line.id }, ...auth })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: {
+      productId: prod.id, name: `多引擎配方-${TAG}`,
+      params: [{ templateRef: 'dcw-temp-sp', nodeId: nPlc.id, value: 180, min: 150, max: 200 }],
+      daqWindows: [{ nodeId: nMqtt.id, min: 0, max: 120 }, { nodeId: nHttp.id, min: 0, max: 120 }],
+    }, ...auth,
+  })).data?.recipe
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, ...auth })
+  check('1.2', '产线开跑(数采门控 + 工艺窗激活)', start.code === 0, start.message ?? '')
+
+  // ═══ Phase 2:四引擎 Agent + Channel + 节点绑定 ═══
+  const engines = [
+    { key: 'omp', harness: 'omp', cfg: { provider: 'zhipu-coding-plan', model: 'glm-5.3-flash' } },
+    { key: 'codex', harness: 'codex', cfg: { model: 'glm-5.3-flash' } },
+    { key: 'dsh', harness: 'dsh', cfg: { provider: 'ustc', model: 'glm-5.3-flash' } },
+    { key: 'opencode', harness: 'opencode', cfg: { model: 'zhipuai-coding-plan/glm-5.3-flash' } },
+  ]
+  const workers = {}
+  for (const e of engines) {
+    const created = await api('POST', '/api/workshop/agents', {
+      body: { name: `${e.key}-${TAG}`, harness: e.harness, config: { ...e.cfg, systemPromptPrefix: '你是产线操作员,严格按任务使用工业工具完成,完成后调用 complete_task。' } }, ...auth,
+    })
+    workers[e.key] = created.data
+    check(`2.${e.key}-tpl`, `${e.harness} 模板创建(provider=${e.cfg.provider ?? 'default'},model=${e.cfg.model})`, Boolean(workers[e.key]?.id))
+  }
+
+  const ch = (await api('POST', '/api/workshop/channels', {
+    body: { name: `多引擎协同-${TAG}`, description: '跨 Harness 团队作业控制验证', leadAgent: { name: `调度长-${TAG}`, harness: 'mock', config: { delayMs: 60 } } }, ...auth,
+  })).data
+  const channelId = ch.channelId
+  check('2.ch', 'Channel 创建(mock lead 调度)', Boolean(channelId))
+  for (const e of engines) {
+    const r = await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: { agentId: workers[e.key].id, role: 'worker' }, ...auth })
+    if (r.code !== 0) check(`2.${e.key}-join`, `${e.key} 入队`, false, r.message ?? '')
+  }
+  const members = (await api('GET', `/api/workshop/channels/${channelId}/agents`, auth)).data ?? []
+  check('2.join', '四引擎 worker 全部入队(lead=mock + 4 引擎)', members.length >= 5, `members=${members.length}`)
+
+  const b1 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: workers.omp.id, nodeId: nMqtt.id, kind: 'daq', mode: 'auto' }, ...auth })
+  const b2 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: workers.codex.id, nodeId: nHttp.id, kind: 'daq', mode: 'auto' }, ...auth })
+  const b3 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: workers.dsh.id, nodeId: nOcua.id, kind: 'dcw', mode: 'manual' }, ...auth })
+  const b4 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: workers.opencode.id, nodeId: nPlc.id, kind: 'dcw', mode: 'manual' }, ...auth })
+  check('2.bind', '节点绑定(omp→mqtt / codex→http / dsh→opcua / opencode→plc)', b1.code === 0 && b2.code === 0 && b3.code === 0 && b4.code === 0)
+
+  // ═══ Phase 3:四路任务并行下发 ═══
+  const tasks = {}
+  const mkTask = async (key, assigneeId, text) => {
+    const t = await api('POST', `/api/workshop/channels/${channelId}/tasks`, { body: { title: `${key}-${TAG}`, parts: [{ text }], assigneeId }, ...auth })
+    tasks[key] = t.data?.task?.id ?? t.data?.id
+    return t
+  }
+  await mkTask('T1-omp-read', workers.omp.id, `用 daq_query 读取「MQTT温度-${TAG}」最近 3 分钟数据,汇报均值即可,然后 complete_task。`)
+  await mkTask('T2-codex-read', workers.codex.id, `用 daq_query 读取「HTTP流量-${TAG}」最近 3 分钟数据,汇报均值即可,然后 complete_task。`)
+  await mkTask('T3-dsh-write', workers.dsh.id, `用 dcw_read 读取「OPCUA设定-${TAG}」当前值;再用 dcw_control 将其调到 171.5(若需审批,等待即可);完成后 dcw_read 复核并 complete_task。`)
+  await mkTask('T4-oc-write', workers.opencode.id, `用 dcw_read 读取「PLC设定-${TAG}」当前值;再用 dcw_control 将其调到 183(若需审批,等待即可);完成后 dcw_read 复核并 complete_task。`)
+  check('3.1', '四路任务下发(omp/codex 读数;dsh/opencode 数控)', Object.values(tasks).every(Boolean), JSON.stringify(tasks).slice(0, 120))
+
+  // ═══ Phase 4:HITL 自动批准(dcw-approval;兼容各引擎权限帧) ═══
+  const approved = new Set()
+  const hitlDeadline = Date.now() + 8 * 60_000
+  while (Date.now() < hitlDeadline && approved.size < 2) {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, auth)
+    const items = p.data?.items ?? []
+    for (const it of items) {
+      if (it.kind === 'dcw-approval' && !approved.has(it.id)) {
+        const r = await api('POST', '/api/workshop/hitl/respond', { body: { kind: 'dcw-approval', id: it.id, confirmed: true, response: 'y' }, ...auth })
+        approved.add(it.id)
+        console.log(`  [hitl] 批准 dcw-approval ${it.id.slice(0, 8)} → ${r.code === 0 ? 'ok' : String(r.message).slice(0, 60)}`)
+      }
+    }
+    await sleep(5000)
+  }
+  check('4.1', '两路 DCW HITL 审批到达并批准(manual 绑定)', approved.size >= 2, `approved=${approved.size}`)
+
+  // ═══ Phase 5:任务终态 + 写入落达验证 ═══
+  const states = {}
+  const tDeadline = Date.now() + 14 * 60_000
+  while (Date.now() < tDeadline) {
+    const list = await api('GET', `/api/workshop/channels/${channelId}/tasks`, auth)
+    const all = list.data ?? []
+    for (const [key, id] of Object.entries(tasks)) {
+      if (states[key]) continue
+      const me = all.find(x => x.id === id)
+      if (me && ['COMPLETED', 'FAILED', 'CANCELED'].includes(me.state)) states[key] = me.state
+    }
+    if (Object.keys(states).length === 4) break
+    await sleep(6000)
+  }
+  check('5.T1', 'omp(zhipu glm-5.3-flash) 读数任务 COMPLETED', states['T1-omp-read'] === 'COMPLETED', `state=${states['T1-omp-read'] ?? 'RUNNING'}`)
+  check('5.T2', 'codex(cc-switch glm-5.3-flash) 读数任务 COMPLETED', states['T2-codex-read'] === 'COMPLETED', `state=${states['T2-codex-read'] ?? 'RUNNING'}`)
+  check('5.T3', 'dsh(ustc glm-5.3-flash) 数控任务 COMPLETED', states['T3-dsh-write'] === 'COMPLETED', `state=${states['T3-dsh-write'] ?? 'RUNNING'}`)
+  check('5.T4', 'opencode(zhipuai glm-5.3-flash) 数控任务 COMPLETED', states['T4-oc-write'] === 'COMPLETED', `state=${states['T4-oc-write'] ?? 'RUNNING'}`)
+
+  // 写入落达:opcua 回读 171.5 / plc SP 183
+  const dcwList = await api('GET', '/api/workshop/dcw', auth)
+  const dcwNodes = Array.isArray(dcwList.data) ? dcwList.data : (dcwList.data?.nodes ?? [])
+  const ocNow = Number(dcwNodes.find(n => n.id === nOcua.id)?.readValue ?? NaN)
+  const plcNow = Number(dcwNodes.find(n => n.id === nPlc.id)?.readValue ?? NaN)
+  check('5.1', 'OPC UA 设定落达(dsh 引擎;171.5±1.5)', Number.isFinite(ocNow) && Math.abs(ocNow - 171.5) <= 1.5, `readValue=${ocNow}`)
+  check('5.2', 'PLC 设定落达(opencode 引擎;183±2)', Number.isFinite(plcNow) && Math.abs(plcNow - 183) <= 2, `readValue=${plcNow}`)
+  // PLC PV 物理收敛(闭环保底:raw 寄存器读)
+  try {
+    const net = await import('node:net')
+    const raw = await new Promise((resolveRaw) => {
+      const sock = net.connect(15040, '127.0.0.1')
+      let buf // 累积缓冲:首帧 data 到达前无读取点(初始空 buffer 语义由 concat 首写承担)
+      let byteLen = 0
+      sock.on('connect', () => sock.write(Buffer.from([0, 1, 0, 0, 0, 6, 1, 3, 0, 0, 0, 2])))
+      sock.on('data', (d) => {
+        buf = buf ? Buffer.concat([buf, d]) : d
+        byteLen = buf.length
+        if (byteLen >= 13) {
+          resolveRaw(Number(buf.subarray(9, 13).readFloatBE(0).toFixed(1)))
+          sock.destroy()
+        }
+      })
+      sock.on('error', () => resolveRaw(null))
+      setTimeout(() => {
+        sock.destroy()
+        resolveRaw(null)
+      }, 4000)
+    })
+    check('5.3', 'PLC PV 物理收敛(寄存器直读 ≥150)', raw !== null && raw >= 150, `rawPV=${raw}`)
+  }
+  catch { check('5.3', 'PLC PV 物理收敛(寄存器直读 ≥150)', false, 'probe error') }
+
+  // ═══ 清理 ═══
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, auth).catch(() => {})
+  for (const id of [nMqtt.id, nHttp.id]) await api('DELETE', `/api/workshop/daq/${id}`, auth).catch(() => {})
+  for (const id of [nOcua.id, nPlc.id]) await api('DELETE', `/api/workshop/dcw/${id}`, auth).catch(() => {})
+  await api('DELETE', `/api/workshop/channels/${channelId}?purge=1`, auth).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, auth).catch(() => {})
+
+  console.log(`\n━━━ 多 Harness 团队 E2E 结果: ${passed} passed / ${failures} failed ━━━`)
+  if (failures) {
+    console.log('失败项:')
+    for (const r of results.filter(x => !x.ok)) console.log(`  ${r.id} ${r.name} — ${r.detail}`)
+  }
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err)
+  process.exit(1)
+})

package/scripts/e2e-plc-scenario.mjs

@@ -0,0 +1,292 @@
+/**
+ * 真实产线场景综合 E2E(PLC 工艺模拟器 + Agent 绑定 + Channel + HITL + TUI + 可视化):
+ *   node scripts/e2e-plc-scenario.mjs [--base http://127.0.0.1:3000]
+ *
+ * 场景:建产线(数采+数控节点,产品/配方)→ 开跑 → Channel(lead)+omp 工人 Agent →
+ *       节点绑定(数采=auto / 数控=manual)→
+ *   任务1  Agent 读数汇报(数采链路)→ TUI /monitor 看执行过程
+ *   任务2  Agent 数控下发 182(manual 绑定 → HITL 审批)→ TUI /hitl 批准 →
+ *          写入生效(readValue→182)→ Agent 复核判定 → 任务完成
+ *   可视化 WebUI /daq /dcw 页面渲染节点实时值(截图)
+ */
+import puppeteer from 'puppeteer-core'
+
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+const WS_BASE = BASE.replace(/^http/, 'ws')
+const TAG = Date.now().toString(36)
+
+let failures = 0
+let passed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed += 1
+  else failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function waitUntil(name, cond, timeoutMs = 300_000, intervalMs = 1000) {
+  const deadline = Date.now() + timeoutMs
+  let last = null
+  while (Date.now() < deadline) {
+    try {
+      last = await cond()
+      if (last) return last
+    }
+    catch (e) { last = e }
+    await sleep(intervalMs)
+  }
+  throw new Error(`waitUntil timeout: ${name} (last=${String(last).slice(0, 200)})`)
+}
+
+const api = async (method, path, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+/** AEP WS:连接即注册全局 peer(daq.reading/dcw.written 等全员帧)+ 订阅频道帧 */
+function openAep(channelId, token) {
+  const envelopes = []
+  const ws = new WebSocket(`${WS_BASE}/api/workshop/ws?token=${encodeURIComponent(token)}`)
+  ws.addEventListener('open', () => channelId && ws.send(JSON.stringify({ type: 'sub', channelId, token })))
+  ws.addEventListener('message', (ev) => {
+    try {
+      const e = JSON.parse(ev.data)
+      if (e.type && e.type !== 'pong') envelopes.push(e)
+    }
+    catch { /* ignore */ }
+  })
+  return { ws, envelopes }
+}
+
+async function main() {
+  console.log(`\n━━━ 真实产线场景综合 E2E @ ${BASE} ━━━`)
+
+  const reg = await api('POST', '/api/users/register', {
+    body: { email: `plc-${TAG}@test.local`, password: 'Passw0rd!123', name: `plc-${TAG}` },
+  })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 160)}`)
+
+  // ═══ Phase 1:产线搭建(PLC 模拟器) ═══
+  console.log('  ── Phase 1:产线搭建 ──')
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `产线-${TAG}` }, token })).data?.line
+  const dq = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: `熔体温度-${TAG}`, lineId: line.id, intervalMs: 500 },
+    token,
+  })).data?.node
+  const dw = (await api('POST', '/api/workshop/dcw', {
+    body: { templateRef: 'dcw-temp-sp', name: `温度设定-${TAG}`, lineId: line.id },
+    token,
+  })).data?.node
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: `产品-${TAG}`, lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: {
+      productId: prod.id,
+      name: `配方-${TAG}`,
+      params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 176, max: 188 }],
+      daqWindows: [{ nodeId: dq.id, min: 100, max: 260 }],
+    },
+    token,
+  })).data?.recipe
+  check('1.1 产线+数采/数控节点+产品/配方', Boolean(line?.id && dq?.id && dw?.id && prod?.id && recipe?.id))
+
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  check('1.2 产线开跑(工艺窗口激活)', start.code === 0)
+
+  await sleep(6000)
+  const samples = await api('GET', `/api/workshop/daq/${dq.id}/samples`, { token })
+  check('1.3 数采模拟器持续出数', ((samples.data?.points ?? samples.data ?? []).length ?? 0) >= 3, `points=${(samples.data?.points ?? []).length}`)
+
+  // ═══ Phase 2:Channel 团队组建 + Agent 节点绑定 ═══
+  console.log('  ── Phase 2:团队组建与绑定 ──')
+  const channelName = `plc-scenario-${TAG}`
+  const ch = (await api('POST', '/api/workshop/channels', {
+    body: { name: channelName, description: '产线控制场景', leadAgent: { name: '调度长', harness: 'mock', config: { delayMs: 60 } } },
+    token,
+  })).data
+  const channelId = ch.channelId
+  const workerTpl = (await api('POST', '/api/workshop/agents', {
+    body: { name: `工艺员-${TAG}`, harness: 'omp', config: { systemPromptPrefix: '你是产线工艺操作员,严格按任务步骤使用工业工具,不做任何额外操作。' } },
+    token,
+  })).data
+  await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: { agentId: workerTpl.id, role: 'worker' }, token })
+  const members = (await api('GET', `/api/workshop/channels/${channelId}/agents`, { token })).data ?? []
+  const worker = members.find(a => a.role === 'worker')
+  check('2.1 Channel 创建(lead)+ omp 工艺员入队', Boolean(channelId && worker?.id), `worker=${worker?.id?.slice(0, 8)}`)
+
+  const b1 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: worker.id, nodeId: dq.id, kind: 'daq', mode: 'auto' }, token })
+  const b2 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: worker.id, nodeId: dw.id, kind: 'dcw', mode: 'manual' }, token })
+  check('2.2 节点绑定(数采=auto / 数控=manual 待审批)', b1.code === 0 && b2.code === 0)
+
+  // ═══ Phase 3:任务1 —— 数采读数链路(Agent 控制) ═══
+  console.log('  ── Phase 3:任务1 数采读数(Agent 执行)──')
+  const aep = openAep(channelId, token)
+  await sleep(500)
+
+  // TUI 并行接入(仓库源码 headless)
+  const { main: tuiMain } = await import('../tui/aw-tui.mjs')
+  await tuiMain(['--headless', '--url', BASE, '--token', token, '--channel', channelName])
+  const vt = globalThis.__tuiSmokeTerminal
+  const type = async (text) => {
+    for (const c of text) vt.emitInput(c)
+    await sleep(50)
+    vt.emitInput('\r')
+    await sleep(400)
+  }
+  const waitTui = async (needle, timeoutMs = 300_000) => {
+    const deadline = Date.now() + timeoutMs
+    while (Date.now() < deadline) {
+      if (vt.text().includes(needle)) return true
+      await sleep(500)
+    }
+    return false
+  }
+  check('3.0 TUI 接入频道', await waitTui(`已切换到频道「${channelName}」`, 30_000))
+
+  const task1 = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    body: {
+      title: `读数汇报-${TAG}`,
+      parts: [{ text: `用 daq_query 读取「熔体温度-${TAG}」最近 2 分钟数据,汇报均值与趋势。完成后调用 complete_task,把均值写进结论。` }],
+      assigneeId: worker.id,
+    },
+    token,
+  })
+  const task1Id = task1.data?.task?.id ?? task1.data?.id
+  check('3.1 任务1 下发(直派工艺员)', Boolean(task1Id), `task=${task1Id?.slice(0, 8)}`)
+
+  console.log('  … 等待 omp spawn + Agent 读数(2-4 分钟)…')
+  const t1State = await waitUntil('3.2 任务1 终态', async () => {
+    const t = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+    const me = (t.data ?? []).find(x => x.id === task1Id)
+    return ['COMPLETED', 'FAILED', 'CANCELED'].includes(me?.state) ? me.state : null
+  }, 480_000).catch(() => null)
+  check('3.2 任务1 COMPLETED(数采链路走通)', t1State === 'COMPLETED', `state=${t1State}`)
+
+  // TUI 监控面板:看工艺员的执行过程
+  await type('/monitor ' + `工艺员-${TAG}`)
+  const monOn = await waitTui('监控已开启:', 20_000)
+  const termFrames = await waitTui('已接入', 120_000)
+  check('3.3 TUI /monitor 接入工艺员终端(实时执行过程)', monOn && termFrames)
+
+  // ═══ Phase 4:任务2 —— 数控下发 + HITL 审批闭环 ═══
+  console.log('  ── Phase 4:任务2 数控下发(manual 绑定 → HITL)──')
+  const task2 = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    body: {
+      title: `调参-${TAG}`,
+      parts: [{ text: `用 dcw_read 读取「温度设定-${TAG}」当前值;再用 dcw_control 将其设定值调到 182(需要人工审批,若被拒绝则汇报被拒即可);批准后再次 dcw_read 复核确认到达 182 附近。完成后调用 complete_task。` }],
+      assigneeId: worker.id,
+    },
+    token,
+  })
+  const task2Id = task2.data?.task?.id ?? task2.data?.id
+  check('4.1 任务2 下发(数控调参)', Boolean(task2Id))
+
+  // 等待 HITL 审批(AEP hitl.request 帧 + REST 待办)
+  const hitlItem = await waitUntil('4.2 HITL 待审到达(dcw-approval)', async () => {
+    const hitlFrame = aep.envelopes.find(e => e.type === 'hitl.request' && e.payload?.kind === 'dcw-approval')
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    const item = (p.data?.items ?? []).find(i => i.kind === 'dcw-approval')
+    return hitlFrame && item ? item : null
+  }, 420_000).catch(() => null)
+  check('4.2 HITL 审批到达(AEP 帧 + REST 待办)', Boolean(hitlItem), hitlItem ? `id=${hitlItem.id} detail=${String(hitlItem.detail).slice(0, 60)}` : 'timeout')
+
+  // TUI 可视化待办并批准(Human-in-the-loop 的 TUI 侧闭环)
+  await type('/hitl')
+  check('4.3 TUI /hitl 渲染审批待办', await waitTui('待人工处理', 20_000))
+  const row = await waitUntil('4.4 定位 dcw-approval 行', () => {
+    const m = vt.text().match(/(\d+)\. \[dcw-approval\]/)
+    return m ? m[1] : null
+  }, 30_000).catch(() => null)
+  check('4.4 审批行定位', Boolean(row), `序号=${row}`)
+  await type(`/hitl ${row}`)
+  check('4.5 进入审批卡', await waitTui('HITL 作答', 20_000))
+  await type('y')
+  check('4.6 批准提交回执', await waitTui('应答已提交', 30_000))
+
+  const approved = await waitUntil('4.7 审批落定(REST)', async () => {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    return (p.data?.items ?? []).every(i => i.id !== hitlItem?.id) ? true : null
+  }, 60_000).catch(() => null)
+  check('4.7 批准落定(TUI → 服务端)', approved === true)
+
+  // 写入生效:设定值收敛 182±2
+  console.log('  … 等待设定值收敛(工艺响应)…')
+  const converged = await waitUntil('4.8 设定值收敛 182±2', async () => {
+    const list = await api('GET', '/api/workshop/dcw', { token })
+    const nodes = Array.isArray(list.data) ? list.data : (list.data?.nodes ?? [])
+    const v = Number(nodes.find(n => n.id === dw.id)?.readValue ?? NaN)
+    return Number.isFinite(v) && Math.abs(v - 182) <= 2 ? v : null
+  }, 60_000, 1500).catch(() => null)
+  check('4.8 数控写入生效(经 Agent dcw_control)', converged !== null, `value=${converged}`)
+
+  const dcwWritten = aep.envelopes.some(e => e.type === 'dcw.written')
+  check('4.9 数控写入实时广播(dcw.written 帧)', dcwWritten)
+
+  const t2State = await waitUntil('4.10 任务2 终态', async () => {
+    const t = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+    const me = (t.data ?? []).find(x => x.id === task2Id)
+    return ['COMPLETED', 'FAILED', 'CANCELED'].includes(me?.state) ? me.state : null
+  }, 480_000).catch(() => null)
+  check('4.10 任务2 COMPLETED(调参+复核闭环)', t2State === 'COMPLETED', `state=${t2State}`)
+
+  // ═══ Phase 5:数控/数采可视化(WebUI) ═══
+  console.log('  ── Phase 5:WebUI 可视化 ──')
+  const chromePath = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+  const browser = await puppeteer.launch({
+    executablePath: chromePath,
+    headless: true,
+    args: ['--no-sandbox', '--disable-gpu', '--window-size=1440,900'],
+    defaultViewport: { width: 1440, height: 900 },
+  })
+  const page = await browser.newPage()
+  const me = await api('GET', '/api/users/me', { token })
+  await page.evaluateOnNewDocument((inject) => {
+    localStorage.setItem('workshop.user', JSON.stringify({ user: { ...inject.me, token: inject.token } }))
+    document.cookie = `token=${inject.token}; path=/; max-age=31536000`
+  }, { me: me.data ?? {}, token })
+  const shot = async name => page.screenshot({ path: `gui-test-screenshots/plc-scenario-${name}.png` }).catch(() => {})
+
+  await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle2', timeout: 60_000 })
+  await sleep(2500)
+  const daqPage = await page.evaluate(() => document.body.textContent)
+  check('5.1 数采中心渲染节点', daqPage.includes(`熔体温度-${TAG}`))
+  await shot('daq')
+
+  await page.goto(`${BASE}/dcw`, { waitUntil: 'networkidle2', timeout: 60_000 })
+  await sleep(1500)
+  const dcwPage = await page.evaluate(() => document.body.textContent)
+  check('5.2 产线运营渲染产线卡片', dcwPage.includes(`产线-${TAG}`))
+  await shot('dcw')
+
+  // 节点卡片与实时值在产线详情页(/dcw/[id] 渲染 readValue)
+  await page.goto(`${BASE}/dcw/${line.id}`, { waitUntil: 'networkidle2', timeout: 60_000 })
+  await sleep(3000)
+  const dcwDetail = await page.evaluate(() => document.body.textContent)
+  check('5.3 产线详情渲染数控节点', dcwDetail.includes(`温度设定-${TAG}`))
+  const valueShown = /18[0-9](\.[0-9]+)?/.test(dcwDetail)
+  check('5.4 数控可视化含当前值(182 附近)', valueShown)
+  await shot('dcw-value')
+
+  await browser.close().catch(() => {})
+
+  // ═══ 清理 + 汇总 ═══
+  await api('DELETE', `/api/workshop/channels/${channelId}?purge=1`, { token }).catch(() => {})
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { token }).catch(() => {})
+  for (const [p, id] of [['/api/workshop/daq', dq.id], ['/api/workshop/dcw', dw.id]]) {
+    await api('DELETE', `${p}/${id}`, { token }).catch(() => {})
+  }
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+
+  console.log(`\n━━━ 结果: ${passed} passed / ${failures} failed ━━━`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err.message)
+  process.exit(1)
+})