agentworkshop 0.2.1

package/scripts/_dbg-final-line-e2e.mjs

@@ -0,0 +1,173 @@
+/**
+ * 终审 E2E-A:产线管理 —— 物理设备 ↔ Node 数据驱动 ↔ 虚拟孪生 全映射。
+ * 真实 Modbus TCP(127.0.0.1:1502 模拟从站):
+ *   数采节点读 40003(温度 float32)/ 40001(压力 float32)→ 物理值 → 绑定设备遥测回写
+ *   数控节点写 40021(设定值组,写入即保持)→ 同址回读校验
+ * 断言:设备-节点绑定/产线归属/配方窗口/孪生 telemetry/场景实例/真实寄存器读写。
+ */
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+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())
+const puppeteer = await import('puppeteer-core').then(m => m.default)
+
+const cleanup = []
+async function main() {
+  // ===== 1. 物理设备(数字孪生 device-twin)创建 =====
+  const twin = (await jpost('/api/workshop/device-twins', { name: '物理挤出机(E2E-A)', modelRef: 'dev-folder-extruder', kind: 'device', posX: 2600, posZ: 900 })).data.twin
+  cleanup.push(['twin', twin.id])
+  console.log(`[设备] 物理挤出机 twin=${twin.id.slice(0, 10)}`)
+
+  // ===== 2. 产线 + 节点(真实 Modbus 驱动)绑定设备 =====
+  const line = (await jpost('/api/workshop/dcw/lines', { name: '终审产线A' })).data.line
+  cleanup.push(['dcw-line', line.id])
+  const prod = (await jpost('/api/workshop/dcw/products', { name: '终审产品A', lineId: line.id })).data.product
+  cleanup.push(['dcw-product', prod.id])
+
+  // 数采:读真实寄存器(温度 40003 / 压力 40001),绑定设备 → 遥测回写
+  const dqT = (await jpost('/api/workshop/daq', {
+    templateRef: 'daq-temp-tc', name: 'A-温度采集(Modbus)',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40003, dataType: 'float32', byteOrder: 'big' },
+    intervalMs: 500, lineId: line.id, deviceBindingId: twin.id, posX: twin.posX + 70, posZ: twin.posZ + 70,
+  })).data.node
+  const dqP = (await jpost('/api/workshop/daq', {
+    templateRef: 'daq-pressure-tx', name: 'A-压力变送(Modbus)',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40001, dataType: 'float32', byteOrder: 'big' },
+    intervalMs: 500, lineId: line.id, deviceBindingId: twin.id, posX: twin.posX + 130, posZ: twin.posZ + 90,
+  })).data.node
+  // 数控:写 40021(工程 150~200 → 原始 0~2000,0.1 分辨率),绑定设备
+  const dw = (await jpost('/api/workshop/dcw', {
+    templateRef: 'dcw-temp-sp', name: 'A-温度设定(Modbus)',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big', engMin: 150, engMax: 200, rawMin: 0, rawMax: 2000 },
+    lineId: line.id, deviceBindingId: twin.id, posX: twin.posX - 70, posZ: twin.posZ - 70,
+  })).data.node
+  cleanup.push(['daq', dqT.id], ['daq', dqP.id], ['dcw', dw.id])
+  console.log(`[节点] 2 数采(读 40003/40001)+ 1 数控(写 40021),全部绑定设备+产线`)
+
+  // 绑定核验
+  const nodes1 = (await jget('/api/workshop/daq')).data.nodes
+  const nT = nodes1.find(n => n.id === dqT.id)
+  if (nT?.deviceBindingId === twin.id && nT?.lineId === line.id) console.log('PASS 绑定:数采节点 ↔ 设备 ↔ 产线 三向归属正确')
+  else fail(`绑定核验失败: ${JSON.stringify({ bind: nT?.deviceBindingId, line: nT?.lineId })}`)
+
+  // ===== 3. 配方(控制 + 监控窗口)+ 开跑 → 数采流动 =====
+  const rc = (await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: '终审配方A',
+    params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 182, min: 176, max: 188 }],
+    daqWindows: [{ nodeId: dqT.id, min: 100, max: 260 }],
+  })).data.recipe
+  cleanup.push(['dcw-recipe', rc.id])
+  const st = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  if (!st.data?.line?.active) { fail('开跑失败'); process.exit(1) }
+  await sleep(3500)
+  // Modbus 连接池冷启动:首个节点首采可能为 null → 最多再等 6s
+  let live = (await jget('/api/workshop/daq')).data.nodes
+  for (let i = 0; i < 6; i++) {
+    const p = live.find(n => n.id === dqP.id)
+    if (p?.value != null) break
+    await sleep(1000)
+    live = (await jget('/api/workshop/daq')).data.nodes
+  }
+  const lT = live.find(n => n.id === dqT.id)
+  const lP = live.find(n => n.id === dqP.id)
+  console.log(`[真实读] 温度寄存器 40003 → ${lT?.value}℃ (${lT?.state}) | 压力 40001 → ${lP?.value}MPa`)
+  if (lT?.value != null && lT.value > 150 && lT.value < 190 && lP?.value != null && lP.value > 0.5 && lP.value < 1.2)
+    console.log('PASS 真实 Modbus 读:float32 解码物理值在模拟从站波动域内')
+  else fail(`真实读数值异常: T=${lT?.value} P=${lP?.value}`)
+
+  // 设备孪生遥测回写(数采 → 设备)
+  const twinNow = (await jget('/api/workshop/device-twins')).data.twins.find(t => t.id === twin.id)
+  const tel = twinNow?.telemetry ?? {}
+  if (Number(tel.temperature) > 100 && Number(tel.pressure) > 0.3)
+    console.log(`PASS 遥测回写:设备孪生 temperature=${tel.temperature} pressure=${tel.pressure}(数采驱动)`)
+  else fail(`遥测回写缺失: ${JSON.stringify(tel).slice(0, 120)}`)
+
+  // ===== 4. 真实数控写:配方窗口内 182 → 寄存器 40021 写入 + 同址回读 =====
+  const w = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 182 })
+  const o = w.data?.outcome
+  console.log(`[真实写] 182℃ → raw ${o?.raw},回读 ${o?.readback}`)
+  if (o?.ok !== true || o.raw !== 1280) fail(`真实写失败: ${JSON.stringify(o).slice(0, 120)}`)
+  else console.log('PASS 真实 Modbus 写:工程量→寄存器线性换算(182→raw1280)+ 同址回读一致')
+  // 越窗联锁(真实设备链路上同样拦截)
+  const over = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 195 })
+  if (over.code === 'VALIDATION_ERROR') console.log('PASS 真实链路联锁:越配方窗口 195 被拒(未触达设备)')
+  else fail('真实链路联锁失效')
+
+  // ===== 5. 数字孪生场景:节点实例化 + 设备 telemetry 驱动渲染 =====
+  const browser = await puppeteer.launch({
+    executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+    headless: 'new', args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1200'],
+  })
+  const page = await browser.newPage()
+  await page.setViewport({ width: 1600, height: 1200 })
+  await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  for (let i = 0; i < 40; i++) {
+    if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+    await sleep(1000)
+  }
+  const pageErrors = []
+  page.on('pageerror', (err) => pageErrors.push(String(err).slice(0, 120)))
+  let daqMounted = false
+  let dcwMounted = false
+  let sceneDiag = {}
+  for (let i = 0; i < 20; i++) {
+    const m = await page.evaluate((ids) => {
+      const s = window.__town.scene
+      const store = (window).__dcwStream
+      return {
+        daq: !!([...s.deviceNodes.values()].find(x => x.twinId === ids.dqT)),
+        dcw: !!([...s.deviceNodes.values()].find(x => x.twinId === ids.dw)),
+        dcwIds: [...s.deviceNodes.values()].filter(d => (d.modelRef ?? '').startsWith('dcw-')).map(d => d.twinId.slice(0, 10)),
+        storeDcwCount: (store?.nodes ?? []).length,
+        target: (store?.nodes ?? []).filter(n => n.id === ids.dw).map(n => ({ pos: n.posX, line: n.lineId, enabled: n.enabled })),
+      }
+    }, { dqT: dqT.id, dw: dw.id }).catch(() => ({ daq: false, dcw: false, dcwIds: [] }))
+    daqMounted = m.daq
+    dcwMounted = m.dcw
+    sceneDiag = m
+    if (daqMounted && dcwMounted) break
+    await sleep(1000)
+  }
+  const scene = await page.evaluate(async (ids) => {
+    const token = document.cookie.match(/(?:^|;\s*)token=([^;]+)/)?.[1] ?? ''
+    const twins = await fetch('/api/workshop/device-twins', { headers: { authorization: `Bearer ${decodeURIComponent(token)}` } }).then(x => x.json())
+    const t = twins.data.twins.find(x => x.id === ids.twin)
+    return { devTelemetry: t?.telemetry ?? {}, devState: t?.state ?? '' }
+  }, { twin: twin.id })
+  console.log('[场景] 数采实例挂载:', daqMounted, '| 数控实例挂载:', dcwMounted)
+  if (daqMounted && dcwMounted) console.log('PASS 孪生场景:Node 数据驱动实例全部挂载(设备旁渲染)')
+  else {
+    console.error('  [diag] scene dcw:', JSON.stringify(sceneDiag.dcwIds), '| store:', sceneDiag.storeDcwCount, JSON.stringify(sceneDiag.target), '| err:', pageErrors.slice(0, 2))
+    fail(`场景挂载缺失: daq=${daqMounted} dcw=${dcwMounted}`)
+  }
+  if (Number(scene.devTelemetry.temperature) > 100) console.log(`PASS 孪生渲染数据源:设备 telemetry 由真实 Modbus 数采驱动(${scene.devTelemetry.temperature}℃)`)
+  else fail(`场景 telemetry 异常: ${JSON.stringify(scene.devTelemetry).slice(0, 100)}`)
+  await page.screenshot({ path: 'docs/audit/screenshots/final-line-twin.png' })
+  await browser.close()
+}
+
+main()
+  .then(async () => {
+    for (const [kind, id] of [...cleanup].reverse()) {
+      try {
+        if (kind === 'dcw-line') await jpost(`/api/workshop/dcw/lines/${id}/stop`, {})
+        else if (kind === 'daq') await jdel(`/api/workshop/daq/${id}`)
+        else if (kind === 'dcw') await jdel(`/api/workshop/dcw/${id}`)
+        else if (kind === 'dcw-recipe') await jdel(`/api/workshop/dcw/recipes/${id}`)
+        else if (kind === 'dcw-product') await jdel(`/api/workshop/dcw/products/${id}`)
+        else if (kind === 'twin') await jdel(`/api/workshop/device-twins/${id}`)
+      }
+      catch { /* 尽力清理 */ }
+    }
+    console.log(process.exitCode ? 'E2E-A FAILED' : 'E2E-A ALL PASS')
+    process.exit(process.exitCode ?? 0)
+  })
+  .catch((err) => { console.error('FATAL:', err.message); process.exit(1) })

package/scripts/_dbg-final-t6-hitl.mjs

@@ -0,0 +1,38 @@
+/** 最终验收 T6 终版:并发 HITL —— invoke 不等待先发,另路轮询批准 → 写 ACK + 值生效 */
+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' }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const J = (u, m = 'GET', b) => fetch(BASE + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+const worker = '0effc739-d9a0-4ab3-b14f-98596e0a44ca'
+const d = (await J('/api/workshop/dcw')).data
+const dw = d.nodes.find(n => n.name === '温度设定器(示例)')
+console.log('invoke 前 value =', dw.value)
+
+// 并发:发出 invoke(不 await),主循环轮询 approvals 并即刻批准
+const invokePromise = J('/api/workshop/agent-tools/invoke', 'POST', { agentId: worker, tool: 'dcw_control', args: { node_id: dw.id, value: 184 } })
+  .then(r => String(r.data?.result?.text ?? JSON.stringify(r).slice(0, 150)))
+let approved = false
+for (let i = 0; i < 60; i++) {
+  await sleep(500)
+  const pend = (await J(`/api/workshop/agent-tools/approvals?agentId=${worker}`)).data.approvals
+  if (pend.length > 0) {
+    console.log(`[t+${(i * 0.5).toFixed(1)}s] HITL 待审: ${pend[0].detail.slice(0, 70)}`)
+    await J(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, 'POST', { approved: true, comment: '最终验收:窗口内优化,批准' })
+    approved = true
+    break
+  }
+}
+const resultText = await invokePromise
+console.log('invoke 结果:', resultText.slice(0, 130))
+await sleep(1500)
+const now = (await J('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+console.log('')
+console.log(approved ? 'PASS 并发 HITL 审批链路' : 'FAIL 未见审批')
+console.log(now?.value === 184 ? `PASS 参数下发生效: 设定值 → ${now.value}℃(Agent 经 dcw_control 写 PLC)` : `FAIL 设定值: ${now?.value}`)
+process.exit(approved && now?.value === 184 ? 0 : 1)

package/scripts/_dbg-focus-range.mjs

@@ -0,0 +1,115 @@
+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)))
+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))
+
+// ===== A) 浏览模式双击:对焦 + 选中 + 边界面板出现 =====
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = [...s.blocks.values()][0]
+  window.__cid = b.channelId
+  s.panBy(-400, -300)
+})
+await new Promise(r => setTimeout(r, 300))
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = s.blocks.get(window.__cid)
+  // 合成双击(浏览器原生会触发;headless CDP 不合成,直接派发等价事件)
+  s.focusTo(b.x + 300, b.z) // 先把镜头挪开,验证双击确实对焦
+})
+await new Promise(r => setTimeout(r, 800))
+// 屏幕中心此刻落在领地内(上一焦点 + panBy 偏移),双击等价路径见下方 dispatch
+await page.evaluate(() => {
+  window.__town.scene.panBy(-800, 0)
+})
+// 简化:直接在屏幕中心(此刻世界点在领地内)派发 dblclick
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = s.blocks.get(window.__cid)
+  // 对焦到领地中心,再偏 120,使屏幕中心仍在领地内
+  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, 250))
+const beforeDbl = await page.evaluate(() => ({
+  cam: window.__town.scene.getCameraTarget(),
+  sel: window.__town.scene.selectedChannel,
+}))
+await page.evaluate(() => {
+  document.querySelector('#town-host canvas')
+    .dispatchEvent(new MouseEvent('dblclick', { clientX: 800, clientY: 500, bubbles: true }))
+})
+await new Promise(r => setTimeout(r, 900))
+const afterDbl = await page.evaluate(() => ({
+  cam: window.__town.scene.getCameraTarget(),
+  sel: window.__town.scene.selectedChannel,
+  panel: !!document.querySelector('.boundary-panel'),
+  mode: window.__town.scene.mode,
+}))
+console.log('A browse dblclick before:', JSON.stringify(beforeDbl))
+console.log('A browse dblclick after :', JSON.stringify(afterDbl))
+
+// ===== B) 切编辑模式 → 手柄可见;偏移 60 单位仍能命中拖拽(命中半径 90) =====
+await page.evaluate(() => {
+  window.__town.scene.setMode('edit')
+})
+await new Promise(r => setTimeout(r, 300))
+const calib = await page.evaluate(() => {
+  const s = window.__town.scene
+  const rc = document.querySelector('#town-host canvas').getBoundingClientRect()
+  const cx = rc.left + rc.width / 2, cy = rc.top + rc.height / 2
+  const c = s.screenToWorld(cx, cy)
+  const ex = s.screenToWorld(cx + 200, cy)
+  const ez = s.screenToWorld(cx, cy + 200)
+  return { cx, cy, c, ax: { x: (ex.x - c.x) / 200, z: (ex.z - c.z) / 200 }, ay: { x: (ez.x - c.x) / 200, z: (ez.z - c.z) / 200 } }
+})
+const toScreen = (wx, wz) => {
+  const det = calib.ax.x * calib.ay.z - calib.ax.z * calib.ay.x
+  return [
+    Math.round(calib.cx + ((wx - calib.c.x) * calib.ay.z - (wz - calib.c.z) * calib.ay.x) / det),
+    Math.round(calib.cy + ((wz - calib.c.z) * calib.ax.x - (wx - calib.c.x) * calib.ax.z) / det),
+  ]
+}
+const info = await page.evaluate(() => {
+  const s = window.__town.scene
+  const b = s.blocks.get(window.__cid)
+  const h = s.resizeHandles.filter(x => x.mesh.visible)
+  return { radiusX: Math.round(b.radiusX), handles: h.length, hx: h[0].mesh.position.x, hz: h[0].mesh.position.z }
+})
+// 手柄往领地内侧偏 60 单位(旧命中半径 46 抓不到,新 90 应命中)
+const [sx, sy] = toScreen(info.hx - 60, info.hz)
+const [tx, ty] = toScreen(info.hx + 130, info.hz)
+await page.mouse.move(sx, sy)
+await page.mouse.down()
+for (let i = 1; i <= 8; i++) {
+  await page.mouse.move(sx + (tx - sx) * i / 8, sy + (ty - sy) * i / 8, { steps: 2 })
+  await new Promise(r => setTimeout(r, 30))
+}
+await page.mouse.up()
+await new Promise(r => setTimeout(r, 300))
+const afterDrag = await page.evaluate(() => {
+  const b = window.__town.scene.blocks.get(window.__cid)
+  return { radiusX: Math.round(b.radiusX) }
+})
+console.log('B edit handles:', JSON.stringify(info), '→ after offset-drag:', JSON.stringify(afterDrag))
+console.log('errors:', errors.slice(0, 5))
+await page.screenshot({ path: 'docs/audit/screenshots/focus-range.png' })
+await browser.close()

package/scripts/_dbg-fresh-scene-e2e.mjs

@@ -0,0 +1,125 @@
+/** 全新安装真实场景测试:注册用户 → AgentTeam → Agent → 产线 → 数采/数控 → 启线采样 → 数字孪生。 */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3001'
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+const ok = m => console.log('PASS', m)
+const api = async (path, opts = {}) => {
+  const res = await fetch(`${ROOT}${path}`, {
+    ...opts,
+    headers: { 'content-type': 'application/json', ...(TOKEN ? { authorization: `Bearer ${TOKEN}` } : {}), ...(opts.headers ?? {}) },
+  })
+  const body = await res.json().catch(() => null)
+  return { status: res.status, body }
+}
+let TOKEN = ''
+
+// ===== 1. 管理员登录(种子用户) + 注册一个新用户(admin 权限创建) =====
+const login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }) }).then(r => r.json())
+if (login?.data?.token) { TOKEN = login.data.token; ok(`管理员登录: ${login.data.user?.name ?? login.data.user?.email}`) }
+else fail(`管理员登录失败: ${JSON.stringify(login).slice(0, 120)}`)
+
+const stamp = Date.now().toString(36)
+const reg = await api('/api/users', { method: 'POST', body: JSON.stringify({ name: `场景测试员-${stamp}`, email: `scene-${stamp}@awshop.io`, password: 'Scene@12345', role: 'editor' }) })
+if (reg.status === 200 || reg.status === 201) ok(`注册新用户: ${reg.body?.data?.name ?? reg.body?.data?.email ?? 'ok'}`)
+else fail(`注册用户失败 HTTP ${reg.status}: ${JSON.stringify(reg.body).slice(0, 140)}`)
+
+// 新用户登录(真实凭据链)
+const ulogin = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: `scene-${stamp}@awshop.io`, password: 'Scene@12345' }) }).then(r => r.json())
+if (ulogin?.data?.token) ok('新用户凭据登录成功(密码哈希/校验链真实)')
+else fail(`新用户登录失败: ${JSON.stringify(ulogin).slice(0, 120)}`)
+
+// ===== 2. 创建 AgentTeam =====
+const team = await api('/api/workshop/teams', { method: 'POST', body: JSON.stringify({ name: `产线编组-${stamp}`, description: '场景测试:数字孪生产线 Agent 编组', visibility: 'public' }) })
+const teamId = team.body?.data?.id
+if (teamId) ok(`创建 AgentTeam: ${team.body.data.name} (${teamId.slice(0, 8)}…)`)
+else fail(`创建团队失败 HTTP ${team.status}: ${JSON.stringify(team.body).slice(0, 140)}`)
+
+// ===== 3. 创建 Agent 并入队 =====
+const agent = await api('/api/workshop/agents', { method: 'POST', body: JSON.stringify({ name: `产线操作员-${stamp}`, harness: 'omp', config: { role: '产线监督', model: 'glm-4.6' }, visibility: 'public' }) })
+const agentId = agent.body?.data?.id
+if (agentId) ok(`创建 Agent: ${agent.body.data.name} (harness=omp)`)
+else fail(`创建 Agent 失败 HTTP ${agent.status}: ${JSON.stringify(agent.body).slice(0, 140)}`)
+if (teamId && agentId) {
+  const add = await api(`/api/workshop/teams/${teamId}/members`, { method: 'POST', body: JSON.stringify({ agentId }) })
+  if (add.status === 200 || add.status === 201) ok('Agent 加入 Team')
+  else console.log(`WARN 入队 HTTP ${add.status}(接口契约可能不同): ${JSON.stringify(add.body).slice(0, 100)}`)
+}
+
+// ===== 4. 创建产线 + 数采节点(内置信号模板链路) + 数控节点 =====
+const line = await api('/api/workshop/dcw/lines', { method: 'POST', body: JSON.stringify({ name: `模拟产线-${stamp}` }) })
+const lineId = line.body?.data?.line?.id
+if (lineId) ok(`创建产线: ${line.body.data.line.name}`)
+else fail(`创建产线失败 HTTP ${line.status}: ${JSON.stringify(line.body).slice(0, 140)}`)
+
+// 拉内置信号模板注册表(节点创建必须绑定 templateRef —— 元数据驱动设计)
+const tplList = await api('/api/workshop/daq')
+const templates = tplList.body?.data?.templates ?? []
+if (!templates.length) fail('内置信号模板注册表为空')
+else ok(`信号模板注册表: ${templates.length} 个内置模板(如 ${templates[0]?.key})`)
+
+// ===== 4b. 创建数控节点(写控制;配方参数绑定数控节点而非数采节点) =====
+const dcwTplList = await api('/api/workshop/dcw')
+const dcwTemplates = dcwTplList.body?.data?.templates ?? []
+const dcwNodes = []
+if (dcwTemplates.length) {
+  const n = await api('/api/workshop/dcw', { method: 'POST', body: JSON.stringify({ name: '温控执行器', templateRef: dcwTemplates[0].key, driver: 'mock', lineId, enabled: true }) })
+  if (n.body?.data?.node?.id) { dcwNodes.push(n.body.data.node); ok(`创建数控节点: 温控执行器 (templateRef=${dcwTemplates[0].key})`) }
+  else console.log(`WARN 数控创建 HTTP ${n.status}: ${JSON.stringify(n.body).slice(0, 120)}`)
+}
+
+const daqNodes = []
+for (const [name, tplIdx] of [['炉温传感器', 0], ['压力传感器', Math.min(1, templates.length - 1)]]) {
+  const tpl = templates[tplIdx]
+  const n = await api('/api/workshop/daq', { method: 'POST', body: JSON.stringify({ name, templateRef: tpl.key, intervalMs: 1000, lineId, enabled: true, posX: 10, posZ: 20 }) })
+  if (n.body?.data?.node?.id) { daqNodes.push(n.body.data.node); ok(`创建数采节点: ${name} (templateRef=${tpl.key}, line=${lineId.slice(0, 8)}…)`) }
+  else fail(`创建数采失败 HTTP ${n.status}: ${JSON.stringify(n.body).slice(0, 140)}`)
+}
+
+const product = await api('/api/workshop/dcw/products', { method: 'POST', body: JSON.stringify({ name: `测试产品-${stamp}`, lineId }) }).catch(() => null)
+const productId = product?.body?.data?.product?.id ?? product?.body?.data?.id
+if (productId) ok(`创建产品并挂载产线: ${product.body.data.product?.name ?? productId.slice(0, 8)}`)
+else console.log(`WARN 产品创建 HTTP ${product?.status}: ${JSON.stringify(product?.body ?? {}).slice(0, 100)}`)
+
+let recipeId
+if (productId) {
+  // 配方参数绑定数控节点(dcw control node);数控节点自动收编进本产线
+  const recipe = await api('/api/workshop/dcw/recipes', { method: 'POST', body: JSON.stringify({ name: `工艺配方-${stamp}`, productId, params: [{ nodeId: dcwNodes[0]?.id, value: 120 }] }) })
+  recipeId = recipe.body?.data?.recipe?.id
+  if (recipeId) ok(`创建配方(温控目标 120, 绑定数控节点 ${dcwNodes[0]?.id.slice(0, 8)}…)`)
+  else fail(`创建配方失败 HTTP ${recipe.status}: ${JSON.stringify(recipe.body).slice(0, 140)}`)
+}
+
+// ===== 5. 启线 → 采样 → 真实数据验证 =====
+const start = await api(`/api/workshop/dcw/lines/${lineId}/start`, { method: 'POST', body: JSON.stringify(recipeId ? { recipeId } : {}) })
+if (start.status === 200) ok(`启线 ACK (recipeId=${recipeId ? '显式' : '无'})`)
+else fail(`启线失败 HTTP ${start.status}: ${JSON.stringify(start.body).slice(0, 140)}`)
+
+await new Promise(r => setTimeout(r, 9000))
+const daqList = await api('/api/workshop/daq')
+const myNodes = (daqList.body?.data?.nodes ?? []).filter(n => daqNodes.some(m => m.id === n.id))
+const live = myNodes.filter(n => n.state !== 'offline')
+const samples = myNodes.reduce((s, n) => s + (n.hist?.length ?? 0), 0)
+if (live.length) ok(`数采真实采样: ${live.length}/${daqNodes.length} 节点在线, 缓冲 ${samples} 个样本(9s)`)
+else fail(`采样失败: ${JSON.stringify(myNodes.map(n => ({ id: n.id, state: n.state, hist: n.hist?.length }))).slice(0, 160)}`)
+
+// ===== 6. 数字孪生设备 =====
+const twin = await api('/api/workshop/device-twins', { method: 'POST', body: JSON.stringify({ name: `孪生反应釜-${stamp}`, kind: 'device', modelRef: daqNodes[0]?.id ?? '', telemetry: { temperature: 25, pressure: 1.0 }, controls: ['start', 'stop', 'set_temp'], posX: 30, posZ: 40 }) })
+const twinId = twin.body?.data?.twin?.id
+if (twinId) ok(`创建数字孪生设备: ${twin.body.data.twin.name} (controls: start/stop/set_temp)`)
+else fail(`创建孪生失败 HTTP ${twin.status}: ${JSON.stringify(twin.body).slice(0, 140)}`)
+
+const twins = await api('/api/workshop/device-twins')
+const twinList = twins.body?.data?.twins ?? []
+ok(`孪生注册表读回: ${twinList.length} 台(含新建)`)
+
+// ===== 7. 停线 → offline 收敛 =====
+const stop = await api(`/api/workshop/dcw/lines/${lineId}/stop`, { method: 'POST' })
+if (stop.status === 200) ok('停线指令 ACK')
+else console.log(`WARN 停线 HTTP ${stop.status}`)
+await new Promise(r => setTimeout(r, 3000))
+const after = await api('/api/workshop/daq')
+const afterNodes = (after.body?.data?.nodes ?? []).filter(n => daqNodes.some(m => m.id === n.id))
+const offlines = afterNodes.filter(n => n.state === 'offline').length
+if (offlines === daqNodes.length) ok(`停线后全部节点收敛 offline (${offlines}/${daqNodes.length})`)
+else console.log(`WARN offline 收敛 ${offlines}/${daqNodes.length}(节拍窗口内) ${JSON.stringify(afterNodes.map(n => n.state))}`)
+
+console.log(process.exitCode ? '\n=== 场景测试存在失败项 ===' : '\n=== 场景测试全部通过 ===')