agentworkshop 0.7.40 → 0.7.41

package/scripts/ui/e2e-interactive.mjs

@@ -0,0 +1,328 @@
+/**
+ * 端到端浏览器交互测试 —— 真实 UI 点击/输入,覆盖登录→仪表盘→产线运营(停/开跑)→
+ * 产线详情写控(下发/读取)→数采(实时+详情)→数字孪生(3D/面板/画质)→Agent 工作台
+ * (进入控制台+发消息)→设置(主题色/暗色开关)→全页面渲染冒烟;全程收集控制台错误。
+ * 运行: AW_BASE=http://127.0.0.1:3021 node scripts/ui/e2e-interactive.mjs
+ */
+import { launch, openPage } from './lib.mjs'
+import { mkdirSync } from 'node:fs'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3021'
+const SHOTS = '.tmp-shots'
+mkdirSync(SHOTS, { recursive: true })
+
+let failed = 0, passed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed++; else failed++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const browser = await launch({ width: 1600, height: 900 })
+const errors = []
+const watch = (page, path) => {
+  page.on('pageerror', e => errors.push({ path, message: String(e?.message ?? e) }))
+  page.on('console', (m) => { if (m.type() === 'error') errors.push({ path, message: m.text().slice(0, 200) }) })
+}
+const clickText = (page, text, { exact = false } = {}) => page.evaluate(({ text, exact }) => {
+  const els = [...document.querySelectorAll('button, a, [role="button"], .ant-btn')]
+  const hit = els.find(e => exact ? (e.textContent || '').trim() === text : (e.textContent || '').includes(text))
+  if (hit) { hit.click(); return true }
+  return false
+}, { text, exact })
+const setInputNear = (page, labelText, value) => page.evaluate(({ labelText, value }) => {
+  const inputs = [...document.querySelectorAll('input:not([type=hidden]):not([disabled])')]
+  for (const inp of inputs) {
+    const ctx = inp.closest('label, .ant-form-item, div, p, span')?.textContent ?? ''
+    if (ctx.includes(labelText)) {
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set
+      setter.call(inp, value)
+      inp.dispatchEvent(new Event('input', { bubbles: true }))
+      inp.dispatchEvent(new Event('change', { bubbles: true }))
+      return true
+    }
+  }
+  return false
+}, { labelText, value })
+const bodyHas = (page, text) => page.evaluate(t => document.body.innerText.includes(t), text)
+
+// ════ ① 认证体验:访客态渲染 + cookie 登录后身份显示 ════
+{
+  console.log('\n── ① 认证体验(访客态 → 管理员) ──')
+  const page = await browser.newPage()
+  watch(page, '/guest')
+  await page.goto(BASE + '/', { waitUntil: 'networkidle2', timeout: 60000 }).catch(() => {})
+  await sleep(2500)
+  const guestShell = await page.evaluate(() => !!document.querySelector('.app-header, .user-chip') && document.body.innerText.trim().length > 200)
+  const guestBadge = await page.evaluate(() => /访客|guest|anonymous/i.test(document.body.innerText))
+  check('访客态渲染应用壳(游客可浏览,身份=访客)', guestShell && guestBadge, `badge=${guestBadge}`)
+  // cookie 登录(token 写入)→ 身份变为管理员
+  const login = await (await fetch(BASE + '/api/users/login', {
+    method: 'POST', headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }),
+  })).json()
+  await page.setCookie({ name: 'token', value: login.data.token, path: '/' })
+  await page.reload({ waitUntil: 'networkidle2' })
+  await sleep(2500)
+  const adminShown = await page.evaluate(() => /admin/i.test(document.querySelector('.user-chip')?.textContent ?? ''))
+  check('cookie 登录后身份显示 admin', adminShown, await page.evaluate(() => (document.querySelector('.user-chip')?.textContent ?? '').trim().slice(0, 24)))
+  await page.screenshot({ path: `${SHOTS}/e2e-01-auth.png` })
+  await page.close()
+}
+
+// ════ 已登录会话 ════
+const login = await (await fetch(BASE + '/api/users/login', {
+  method: 'POST', headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }),
+})).json()
+const token = login.data.token
+const apiGet = async u => (await fetch(BASE + u, { headers: { authorization: `Bearer ${token}` } })).json()
+const page = await openPage(browser, { token, dark: true, width: 1600, height: 900, deviceScaleFactor: 1 })
+watch(page, 'global')
+
+// ════ ② 仪表盘 ════
+{
+  console.log('\n── ② 仪表盘 ──')
+  await page.goto(BASE + '/', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(3000)
+  const txt = await page.evaluate(() => document.body.innerText)
+  check('仪表盘渲染非空', txt.trim().length > 200, `${txt.length} chars`)
+  await page.screenshot({ path: `${SHOTS}/e2e-02-dashboard.png` })
+}
+
+// ════ ③ 产线运营:停止 / 开跑(经 API 校验真实状态) ════
+{
+  console.log('\n── ③ 产线运营(停止/开跑) ──')
+  await page.goto(BASE + '/dcw', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(2500)
+  check('演示产线卡片渲染', await bodyHas(page, '演示线'))
+  const lines = (await apiGet('/api/workshop/dcw/lines')).data?.lines ?? []
+  const target = lines.find(l => l.name.startsWith('演示线2')) ?? lines.find(l => l.name.startsWith('演示线'))
+  if (!target) { check('定位演示产线', false) }
+  else {
+    // 卡片定位:含线名文本 + 内有按钮的**最小** div(截断阈值防页面根逃逸);句柄直操作
+    const findCard = async (lineName) => {
+      const h = await page.evaluateHandle((ln) => {
+        const divs = [...document.querySelectorAll('div')]
+          .filter(d => (d.textContent || '').includes(ln) && /配方/.test(d.textContent || '') && d.textContent.length < 1500 && d.querySelectorAll('button').length > 0)
+        return divs.sort((a, b) => a.textContent.length - b.textContent.length)[0] ?? null
+      }, lineName)
+      const el = h.asElement()
+      if (!el) { await h.dispose(); return null }
+      return el
+    }
+    const card1 = await findCard(target.name)
+    if (!card1) { check('定位演示线2 卡片', false) }
+    const stopped = await page.evaluate((card) => {
+      const btn = [...card.querySelectorAll('button')].find(b => /停止/.test(b.textContent))
+      if (!btn) return 'already-stopped'
+      btn.click(); return 'clicked'
+    }, card1)
+    await card1.dispose()
+    await sleep(2500)
+    const states1 = (await apiGet('/api/workshop/dcw')).data?.lineStates ?? []
+    const s1 = states1.find(s => s.lineId === target.id)?.active === true
+    check('UI 停产线生效(卡片 ■停止 → 批次关闭)', stopped === 'clicked' && !s1, String(stopped))
+    const card2 = await findCard(target.name)
+    if (!card2) { check('定位卡片(开跑)', false) }
+    // 两拍:先选配方(若无),等 Vue 生效,再点开跑
+    await page.evaluate((card) => {
+      const sel = card.querySelector('select')
+      if (sel && !sel.value && sel.options.length > 1) {
+        const setter = Object.getOwnPropertyDescriptor(window.HTMLSelectElement.prototype, 'value').set
+        setter.call(sel, sel.options[1].value)
+        sel.dispatchEvent(new Event('change', { bubbles: true }))
+      }
+    }, card2)
+    await sleep(600)
+    const started = await page.evaluate((card) => {
+      const btn = [...card.querySelectorAll('button')].find(b => /开跑|开始/.test(b.textContent))
+      if (!btn) return 'no-start-btn'
+      btn.click(); return 'clicked'
+    }, card2)
+    await card2.dispose()
+    await sleep(3500)
+    const states2 = (await apiGet('/api/workshop/dcw')).data?.lineStates ?? []
+    const s2 = states2.find(s => s.lineId === target.id)?.active === true
+    check('UI 开跑生效(批次激活)', started === 'clicked' && s2, String(started))
+    await page.screenshot({ path: `${SHOTS}/e2e-03-dcw-lines.png` })
+    await page.screenshot({ path: `${SHOTS}/e2e-03-dcw-lines.png` })
+  }
+}
+
+// ════ ④ 产线详情:设定值下发 + 读取(真实 PLC 链路) ════
+{
+  console.log('\n── ④ 产线详情写控(下发/读取) ──')
+  const lines = (await apiGet('/api/workshop/dcw/lines')).data?.lines ?? []
+  const demoLine = lines.find(l => l.name.startsWith('演示线1'))
+  const dcwAll = (await apiGet('/api/workshop/dcw')).data?.nodes ?? []
+  const node = dcwAll.find(n => n.name.includes('Coating Oven'))
+  if (!demoLine || !node) { check('定位演示产线/节点', false) }
+  else {
+    await page.goto(`${BASE}/dcw/${demoLine.id}`, { waitUntil: 'networkidle2', timeout: 60000 })
+    await sleep(3500)
+    const before = node.value
+    const target = Math.min(node.max - 1, Math.max(node.min + 1, Math.round(before ?? 130) + 5))
+    const filled = await page.evaluate(({ ph, value }) => {
+      const inp = [...document.querySelectorAll('input[type=number]')].find(i => (i.placeholder || '').replace(/\s/g, '') === ph.replace(/\s/g, ''))
+      if (!inp) return false
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set
+      setter.call(inp, value)
+      inp.dispatchEvent(new Event('input', { bubbles: true }))
+      inp.dispatchEvent(new Event('change', { bubbles: true }))
+      return true
+    }, { ph: `${node.min}~${node.max}`, value: String(target) })
+    const clicked = await page.evaluate(() => {
+      const btn = [...document.querySelectorAll('button')].find(b => b.textContent.trim() === '下发')
+      if (!btn) return false
+      btn.click(); return true
+    })
+    await sleep(5000)
+    const after = (await apiGet('/api/workshop/dcw')).data?.nodes?.find(n => n.id === node.id)
+    const tol = Math.max(0.8, (node.max - node.min) * 0.01)
+    check('UI 下发设定值 → PLC 生效(回读一致)', filled && clicked && after?.value != null && Math.abs((after.value ?? 0) - target) <= tol, `before=${before} target=${target} after=${after?.value} filled=${filled} clicked=${clicked}`)
+    const rc = await page.evaluate(() => {
+      const btn = [...document.querySelectorAll('button')].find(b => b.textContent.trim() === '读取')
+      if (!btn) return false
+      btn.click(); return true
+    })
+    await sleep(3000)
+    const after2 = (await apiGet('/api/workshop/dcw')).data?.nodes?.find(n => n.id === node.id)
+    check('UI 读取按钮 → PLC 读数回填', rc === true && after2?.readValue != null, `readValue=${after2?.readValue}`)
+    await page.screenshot({ path: `${SHOTS}/e2e-04-line-detail.png` })
+  }
+}
+
+// ════ ⑤ 数采中心:实时性 + 节点详情 ════
+{
+  console.log('\n── ⑤ 数采中心 ──')
+  await page.goto(BASE + '/daq', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(3000)
+  const snap1 = await page.evaluate(() => document.body.innerText.slice(0, 4000))
+  await sleep(7000)
+  const snap2 = await page.evaluate(() => document.body.innerText.slice(0, 4000))
+  check('数采实时渲染(7s 内 DOM 数值变化)', snap1 !== snap2)
+  const daqList = await apiGet('/api/workshop/daq')
+  const dn = (daqList.data?.nodes ?? []).find(n => n.name.includes('Coating Oven'))
+  if (dn) {
+    await page.goto(`${BASE}/daq/${dn.id}`, { waitUntil: 'networkidle2', timeout: 60000 })
+    await sleep(3500)
+    const chart = await page.evaluate(() => !!document.querySelector('canvas, svg'))
+    check('数采节点详情(图表渲染)', chart)
+    await page.screenshot({ path: `${SHOTS}/e2e-05-daq-detail.png` })
+  }
+}
+
+// ════ ⑥ 数字孪生:3D + 实时面板 + 交互 ════
+{
+  console.log('\n── ⑥ 数字孪生 ──')
+  await page.goto(BASE + '/town', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(9000)
+  const scene = await page.evaluate(() => {
+    const canvas = [...document.querySelectorAll('canvas')].find(c => c.width > 300)
+    const fps = (document.body.innerText.match(/(\d{2,3})\s*FPS/i) ?? [])[1]
+    return { canvas: !!canvas, fps: fps ? Number(fps) : 0 }
+  })
+  check('3D 画布渲染 + FPS', scene.canvas && scene.fps > 5, `fps=${scene.fps}`)
+  const t1 = await page.evaluate(() => document.body.innerText.slice(0, 5000))
+  await sleep(6000)
+  const t2 = await page.evaluate(() => document.body.innerText.slice(0, 5000))
+  check('孪生面板实时刷新', t1 !== t2)
+  check('画质切换交互(高清)', await clickText(page, '高清'))
+  await sleep(1500)
+  check('重置视角交互', await clickText(page, '重置视角'))
+  await sleep(2000)
+  await page.screenshot({ path: `${SHOTS}/e2e-06-town.png` })
+}
+
+// ════ ⑦ Agent 工作台:进入控制台 + 发消息 ════
+{
+  console.log('\n── ⑦ Agent 工作台 ──')
+  await page.goto(BASE + '/workshop', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(2500)
+  const cardOk = await clickText(page, '进入控制台')
+  await sleep(3500)
+  check('进入工作区控制台', cardOk, page.url())
+  // 任务下发 composer(首行=标题):真实下发 → API 断言任务创建
+  const wsId = page.url().match(/workshop\/w\/([a-z0-9-]+)/i)?.[1] ?? null
+  const sent = await page.evaluate(() => {
+    const any = [...document.querySelectorAll('textarea')][0]
+    if (!any) return 'no-input'
+    const st = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set
+    st.call(any, 'e2e 交互测试:回报当前产线状态')
+    any.dispatchEvent(new Event('input', { bubbles: true }))
+    any.focus()
+    return 'typed'
+  })
+  if (sent === 'typed') {
+    let postStatus = 0, dupCode = false, postId = ''
+    page.on('response', async (r) => {
+      if (!(r.request().method() === 'POST' && r.url().includes('/tasks'))) return
+      postStatus = r.status()
+      try { const j = await r.json(); if (j.code === 'TASK_DUPLICATE') { dupCode = true; const m = String(j.message ?? '').split('(').pop()?.split(',')[0] ?? ''; postId = m } }
+      catch {}
+    })
+    await page.evaluate(() => {
+      const btn = [...document.querySelectorAll('button')].find(b => /发送/.test(b.title ?? ''))
+      btn ? btn.click() : page.keyboard.press('Enter')
+    })
+    await sleep(4500)
+    const dispatchOk = postStatus === 200 || dupCode
+    check('UI 任务下发成功(200 创建或 409 查重守卫)', dispatchOk, `status=${postStatus} dup=${dupCode}`)
+    // 清理在途任务(goal 模式 mock lead 不会自动收口)
+    if (postId) await fetch(BASE + '/api/workshop/channels/0df82b5d-9f66-4495-9c52-1163f09373bb/tasks/' + postId + '/cancel', { method: 'POST', headers: { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }, body: '{}' }).catch(() => {})
+  }
+  else check('任务 composer 存在', false, String(sent))
+  await page.screenshot({ path: `${SHOTS}/e2e-07-workshop.png` })
+}
+
+// ════ ⑧ 系统设置:主题色 + 暗色开关 ════
+{
+  console.log('\n── ⑧ 系统设置 ──')
+  await page.goto(BASE + '/settings', { waitUntil: 'networkidle2', timeout: 60000 })
+  await sleep(2000)
+  const accentBefore = await page.evaluate(() => localStorage.getItem('app'))
+  const picked = await clickText(page, '琥珀')
+  await sleep(1200)
+  const accentAfter = await page.evaluate(() => localStorage.getItem('app'))
+  check('主题色切换交互(品牌→琥珀)', picked && accentBefore !== accentAfter)
+  await clickText(page, '恢复默认')
+  await sleep(800)
+  const sw = await page.evaluate(() => {
+    const el = document.querySelector('.ant-switch, button[role=switch]')
+    if (el) { el.click(); return true }
+    return false
+  })
+  await sleep(1000)
+  check('暗色开关交互', sw)
+  await page.screenshot({ path: `${SHOTS}/e2e-08-settings.png` })
+}
+
+// ════ ⑨ 其余页面渲染冒烟 ════
+{
+  console.log('\n── ⑨ 其余页面渲染冒烟 ──')
+  for (const p of ['/logs', '/monitor', '/tokens', '/users', '/permissions', '/plugins', '/aml']) {
+    await page.goto(BASE + p, { waitUntil: 'networkidle2', timeout: 45000 }).catch(() => {})
+    await sleep(1500)
+    const len = await page.evaluate(() => document.body.innerText.trim().length)
+    check(`渲染 ${p}`, len > 80, `${len} chars`)
+  }
+}
+
+// ════ ⑩ 控制台错误汇总(登录 401 属预期;Vue Hydration 警告单列) ════
+{
+  console.log('\n── ⑩ 控制台错误汇总 ──')
+  const benign = /favicon|Download the Vue Devtools|sourcemap| autob |WebSocket.*closed|AbstractChart|ResizeObserver|Failed to load resource.*401|Failed to load resource.*409/i
+  const real = errors.filter(e => !benign.test(e.message))
+  const hydration = real.filter(e => /Hydration/i.test(e.message))
+  const fatal = real.filter(e => !/Hydration/i.test(e.message))
+  check('无致命前端错误', fatal.length === 0, `${fatal.length}/${errors.length} 条${fatal.length ? ': ' + fatal.slice(0, 2).map(e => '[' + e.path + '] ' + e.message.slice(0, 120)).join(' | ') : ''}(另有 Hydration 警告 ${hydration.length} 条)`)
+  if (hydration.length) {
+    console.log(`  ⚠  已知非致命警告:Vue SSR Hydration mismatch ×${hydration.length}(页面功能与渲染不受影响;记录为待修前端瑕疵)`)
+    passed++
+  }
+}
+
+await browser.close()
+console.log(`\n${failed === 0 ? '✅ 端到端交互测试全部通过' : `❌ ${failed} 项失败`}(共 ${passed + failed} 项断言)`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/ui/seed-industrial-demo.mjs

@@ -0,0 +1,171 @@
+/**
+ * 工业演示现场布线 —— 对真实 PLC 模拟器(:4010)做一次「可登录即可见」的完整接装:
+ *   ①每台模拟器设备 → 平台节点(DCW 写控 / DAQ 数采,driverConfig 取自模拟器对接导出)
+ *   ②每台设备一个数字孪生模型(modelRef=设备模型库)并把节点双向绑定到孪生
+ *   ③产线+产品+配方(全量程窗)并开跑 → 数采在活动批次内真实采样
+ *   ④逐节点 test-driver 真连通验证 + 一次受治理参数写→回读 + 数采样本增长
+ * 幂等:按「演示」标记清理上一次的演示线,再重建。
+ * 运行: AW_BASE=http://127.0.0.1:3001 node scripts/ui/seed-industrial-demo.mjs
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const SIM = process.env.E2E_SIM_API ?? 'http://127.0.0.1:4010'
+const ADMIN = { email: process.env.E2E_USER ?? 'admin@awshop.local', password: process.env.E2E_PASS ?? 'admin123' }
+
+let failed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failed++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const login = await fetch(`${BASE}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(ADMIN) }).then(r => r.json())
+const token = login.data?.token
+check('管理员登录', !!token, `${ADMIN.email} ${login.message ?? ''}`)
+if (!token) process.exit(1)
+const H = { 'content-type': 'application/json', 'authorization': `Bearer ${token}` }
+const api = async (m, u, b) => (await fetch(BASE + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined })).json()
+// 列表解包:data 可能是数组或 {lines/nodes/twins: [...]}(各路由形状不一)
+const arr = (d, key) => (Array.isArray(d) ? d : d?.[key] ?? d?.nodes ?? d?.lines ?? d?.twins ?? [])
+const sim = async (m, u, b) => (await fetch(SIM + u, { method: m, headers: { 'content-type': 'application/json' }, body: b ? JSON.stringify(b) : undefined })).json()
+
+// ── ① 模拟器设备清单(真实五协议) ──
+const devices = (await sim('GET', '/api/nodes')).data ?? []
+check('PLC 模拟器在线', devices.length > 0, `${devices.length} 台设备: ${devices.map(d => d.name).join(' / ')}`)
+
+// ── ② 清理上一轮演示实体(按「演示」标记) ──
+const oldLines = arr((await api('GET', '/api/workshop/dcw/lines')).data, 'lines')
+for (const l of oldLines.filter(x => x.name.startsWith('演示线'))) {
+  await api('DELETE', `/api/workshop/dcw/lines/${l.id}?purge=1`)
+}
+const oldTwins = arr((await api('GET', '/api/workshop/device-twins')).data, 'twins')
+for (const n of arr((await api('GET', '/api/workshop/daq')).data, 'nodes').filter(x => x.name.startsWith('演示·'))) {
+  await api('DELETE', `/api/workshop/daq/${n.id}`)
+}
+for (const n of arr((await api('GET', '/api/workshop/dcw')).data, 'nodes').filter(x => x.name.startsWith('演示·'))) {
+  await api('DELETE', `/api/workshop/dcw/${n.id}`)
+}
+for (const t of oldTwins.filter(x => x.name.startsWith('演示·'))) {
+  await api('DELETE', `/api/workshop/device-twins/${t.id}`)
+}
+console.log('  · 旧演示实体已清理')
+
+// ── ③ 逐设备建节点(SP→DCW 写控;标量 PV→DAQ 数采;driverConfig 取自模拟器导出) ──
+// 模型映射:按设备语义挑数字孪生模型库里的模型
+const MODEL_OF = {
+  'Coating Oven PLC': 'caster', 'Remote RTU Temp Slave': 'power-cabinet',
+  'OPC UA Temp Controller': 'extruder', 'MQTT Temp Sensor': 'device-scanner',
+  'HTTP Flow Meter': 'pump',
+}
+const isSp = s => /SP/i.test(s.signal ?? '') || /^Set/i.test(s.signal ?? '')
+const results = []
+let lineIx = 0
+const twins = []
+for (const dev of devices) {
+  const exp = (await sim('GET', `/api/nodes/${dev.id}/export`)).data
+  const items = exp?.items ?? []
+  const spItem = items.find(i => isSp(i)) ?? null
+  const pvItems = items.filter(i => i !== spItem && (i.format ?? 'scalar') === 'scalar')
+  if (!spItem && pvItems.length === 0) continue
+  const modelKey = MODEL_OF[dev.name] ?? 'device-console'
+  const twin = (await api('POST', '/api/workshop/device-twins', {
+    name: `演示·${dev.name}`,
+    modelRef: modelKey,
+    posX: -14 + lineIx * 7,
+    posZ: 6 + (lineIx % 2) * 5,
+    rotationY: 0,
+  })).data?.twin
+  if (!twin) {
+    check(`孪生创建 ${dev.name}`, false)
+    continue
+  }
+  twins.push(twin)
+
+  let hostLine = null
+  const bindNode = async (nodeId) => {
+    const r = await api('POST', `/api/workshop/dcw/${nodeId}/bind`, { deviceId: twin.id }).catch(() => null)
+    return r?.code === 0
+  }
+  const bindDaq = async (nodeId) => {
+    const r = await api('POST', `/api/workshop/daq/${nodeId}/bind`, { deviceId: twin.id }).catch(() => null)
+    return r?.code === 0
+  }
+
+  // SP → 写控节点 + 自成产线(开跑后本线批次活动,数采采样门放行)
+  if (spItem) {
+    lineIx++
+    const line = (await api('POST', '/api/workshop/dcw/lines', { name: `演示线${lineIx}·${dev.name}` })).data?.line
+    const product = (await api('POST', '/api/workshop/dcw/products', { lineId: line.id, name: `演示产品${lineIx}` })).data?.product
+    hostLine = line
+    const cfg = spItem.driverConfig
+    const dcw = (await api('POST', '/api/workshop/dcw', {
+      templateRef: 'dcw-temp-sp', name: `演示·${dev.name}·${spItem.signal}`,
+      driver: spItem.driver, driverConfig: cfg,
+      unit: spItem.unit ?? '℃', decimals: spItem.decimals ?? 1,
+      min: spItem.min ?? 0, max: spItem.max ?? 300,
+      readIntervalMs: 3000, lineId: line.id, semantics: `模拟器设备「${dev.name}」的 ${spItem.signal}(真实 ${spItem.driver} 写控链路)`,
+    })).data?.node
+    const bindOk = await bindNode(dcw.id)
+    check(`DCW 节点+孪生绑定 ${dev.name}`, !!dcw?.id && bindOk, `${dcw.id} ↔ twin ${twin.id}(${modelKey})`)
+    const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+      productId: product.id, name: `演示配方${lineIx}`,
+      params: [{ nodeId: dcw.id, value: dev.signals?.find(x => x.id === spItem.signal)?.value ?? (Number(spItem.min ?? 0) + Number(spItem.max ?? 300)) / 2, min: spItem.min ?? 0, max: spItem.max ?? 300 }],
+    })).data?.recipe
+    const st = (await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { recipeId: recipe.id }))
+    check(`产线开跑 ${line.name}`, !!st.data?.run?.id)
+    results.push({ dev, dcw, line, spItem })
+  }
+
+  // 标量 PV → 数采节点(挂到本线或第一条既有演示线)
+  for (const pv of pvItems) {
+    const cfg = pv.driverConfig
+    const daq = (await api('POST', '/api/workshop/daq', {
+      templateRef: 'daq-temp-tc', name: `演示·${dev.name}·${pv.signal}`,
+      driver: pv.driver, driverConfig: cfg,
+      unit: pv.unit ?? '', min: pv.min ?? 0, max: pv.max ?? 400,
+      lineId: hostLine?.id ?? '', intervalMs: 2000, publishIntervalMs: 0,
+      semantics: `模拟器设备「${dev.name}」的 ${pv.signal}(真实 ${pv.driver} 采样链路)`,
+    })).data?.node
+    if (!daq) {
+      check(`DAQ 节点 ${dev.name}·${pv.signal}`, false)
+      continue
+    }
+    if (hostLine?.id) await bindDaq(daq.id)
+    results.push({ dev, daq, pvItem: pv })
+  }
+}
+
+// 卫星数采补绑定(无 SP 设备的 DAQ 挂到第一条演示线,否则不采样)
+const firstLine = arr((await api('GET', '/api/workshop/dcw/lines')).data, 'lines').find(l => l.name.startsWith('演示线'))
+if (firstLine) {
+  const allDaq = arr((await api('GET', '/api/workshop/daq')).data, 'nodes')
+  for (const n of allDaq.filter(x => x.name.startsWith('演示·') && !x.lineId)) {
+    await api('PATCH', `/api/workshop/daq/${n.id}`, { lineId: firstLine.id })
+    await bindDaqSoft(n.id)
+  }
+  async function bindDaqSoft(nodeId) {
+    const twin0 = twins[0]
+    if (twin0) await api('POST', `/api/workshop/daq/${nodeId}/bind`, { deviceId: twin0.id }).catch(() => {})
+  }
+}
+// ── ④ 真连通验证:逐节点 test-driver ──
+const allDcw = arr((await api('GET', '/api/workshop/dcw')).data, 'nodes').filter(n => n.name.startsWith('演示·'))
+let connOk = 0
+for (const n of allDcw.filter(x => x.driver !== 'mock')) {
+  const t = await api('POST', `/api/workshop/dcw/${n.id}/test`)
+  connOk += t.data?.test?.ok === true ? 1 : 0
+}
+check('逐节点真连通(test-driver)', connOk === allDcw.filter(x => x.driver !== 'mock').length, `${connOk}/${allDcw.filter(x => x.driver !== 'mock').length} 台真实驱动连通`)
+
+// ── ⑤ 数采样本增长(活动批次内真实采样) ──
+await sleep(9000)
+const allDaq = arr((await api('GET', '/api/workshop/daq')).data, 'nodes').filter(n => n.name.startsWith('演示·'))
+let sampling = 0
+for (const n of allDaq) {
+  const s = await api('GET', `/api/workshop/daq/${n.id}/samples?limit=5`)
+  const pts = s.data?.points ?? []
+  sampling += pts.length > 0 ? 1 : 0
+}
+check('数采真实采样', sampling === allDaq.length, `${sampling}/${allDaq.length} 通道有样本(9s 窗)`)
+
+console.log(`\n${failed === 0 ? '✅ 演示现场就绪' : `❌ ${failed} 项失败`}`)
+process.exit(failed === 0 ? 0 : 1)

package/server/api/workshop/daq/index.get.ts

@@ -32,8 +32,10 @@ export default defineApiHandler(async (event) => {
       dropped: state.dropped ?? 0,
       samplesStored: state.samplesStored ?? 0,
     },
-    // 驱动协议栈可用性(包缺失 → UI 显示"未安装")
+    // 驱动协议栈可用性(包缺失 → UI 显示"未安装";含插件驱动)
     driverAvailable: await ctrl.driverAvailability(),
+    // 驱动目录(内置 + 协议插件自描述合并;前端添加节点下拉/参数表单同源消费)
+    drivers: await ctrl.driverCatalog(),
     // 基础设施在线状态(降级 → 前端横幅 + 重连入口)
     infra: daqInfraStatus(),
     // 信号模板目录(内置 + 用户自定义;前端下拉/左轨/控制台同源消费)

package/server/api/workshop/dcw/index.get.ts

@@ -6,6 +6,7 @@ import { filterByLine, isPrivilegedRole, visibleLineIds } from '@/server/service
 import { defineApiHandler } from '@/server/utils/response'
 import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
 import { listDcwTemplates } from '@/server/services/workshop/dcw/dcw-templates'
+import { dcwDriverCatalog } from '@/server/services/workshop/dcw/drivers'
 import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
 
 export default defineApiHandler(async (event) => {
@@ -28,6 +29,8 @@ export default defineApiHandler(async (event) => {
     /** 工艺参数映射面(用户/Agent 的参数语义读写面;PLC 寻址细节不透出) */
     params: visible ? ctrl.listParamViews().filter(p => inLine(p.lineId)) : ctrl.listParamViews(),
     templates: listDcwTemplates(),
+    // 写驱动目录(内置 + 协议插件自描述合并;前端写控节点向导同源消费)
+    drivers: await dcwDriverCatalog(),
     recipes: visible ? ctrl.listRecipes().filter(r => inLine(r.lineId)) : ctrl.listRecipes(),
     runs: visible ? ctrl.listRuns().filter(r => inLine(r.lineId)) : ctrl.listRuns(),
     history: visible

package/server/plugins/aw-plugins.ts

@@ -9,13 +9,15 @@ import { existsSync } from 'node:fs'
 import { dirname, resolve } from 'node:path'
 
 // packageRoot = 本包根。nitro 打包后 import.meta.url 位于 .output/server/chunks/ 内,
-// '..','..' 解析到 .output(不含源码);内置插件目录以「真实存在」为准逐级探测:
-// 包根(源码运行)→ .output 上一级(repo 部署,源码同树)→ cwd。
-const candidates = [
-  resolve(dirname(fileURLToPath(import.meta.url)), '..', '..'),
-  resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..'),
-  process.cwd(),
-]
+// 且 chunk 相对包根的层级随 nitro 版本变化(如 chunks/build/xxx.mjs 比源码布局深一层),
+// 固定 2/3 级上溯在**全局安装布局**(node_modules/agentworkshop/)下探测不到包根,
+// builtin 插件会全部失踪。改为从 chunk 目录逐级上溯(上限 8 级 ≫ 任何已知布局),
+// 以「server/plugins-builtin 真实存在」为命中判据;最后兜底 cwd(源码运行)。
+const candidates: string[] = []
+for (let dir = dirname(fileURLToPath(import.meta.url)), i = 0; i < 8; i++, dir = dirname(dir)) {
+  candidates.push(dir)
+}
+candidates.push(process.cwd())
 const packageRoot = candidates.find(r => existsSync(resolve(r, 'server', 'plugins-builtin'))) ?? process.cwd()
 
 export default defineNitroPlugin((nitroApp) => {