agentworkshop 0.6.0 → 0.7.0

package/scripts/_dbg-dcw-read-rest.mjs

@@ -0,0 +1,103 @@
+/**
+ * DCW 读写集成 E2E(真实 dev server):
+ * ①mock 驱动手动读写闭环(读随写变) ②标定 transform 物理域往返
+ * ③周期读服务端调度(不手动读,等节点自己读) ④真实 Modbus TCP(127.0.0.1:1502 从站,
+ * 40021 保持寄存器 float32 大端)写→读 roundtrip ×2  ⑤视图字段/视图列表收敛。
+ * 运行: node scripts/_dbg-dcw-read-rest.mjs(CLEANUP=1 结束后清理测试节点)
+ */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const CLEANUP = process.env.CLEANUP === '1'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, cond, detail = '') => { console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!cond) failed++ }
+
+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())
+const H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+const nodesOf = async () => (await j('/api/workshop/dcw')).data.nodes
+const nodeView = async (id) => (await nodesOf()).find(n => n.id === id)
+const write = (id, value) => j(`/api/workshop/dcw/${id}/write`, 'POST', { value }).then(r => r.data.outcome)
+const read = (id) => j(`/api/workshop/dcw/${id}/read`, 'POST', {}).then(r => r.data.read)
+
+const created = []
+async function mkNode(name, extra) {
+  const node = (await j('/api/workshop/dcw', 'POST', { templateRef: 'dcw-temp-sp', name, readIntervalMs: 0, ...extra })).data.node
+  created.push(node.id)
+  return node
+}
+
+// 幂等清理:上一次异常中断残留的同名节点先删
+for (const stale of (await nodesOf()).filter(n => n.name?.startsWith('读写验证·'))) {
+  await j(`/api/workshop/dcw/${stale.id}`, 'DELETE').catch(() => {})
+}
+// mock PLC 状态在服务进程内掉电保持(同真实寄存器):每次运行用独立 key 避免跨运行串扰
+const RUN = Date.now().toString(36)
+
+// ===== ① mock 手动读写闭环 =====
+console.log('\n--- ① mock 手动读写闭环 ---')
+{
+  const n = await mkNode('读写验证·mock 手动', { driver: 'mock', driverConfig: { key: `rw-e2e-1-${RUN}` } })
+  check('视图透出读字段(readValue/readIntervalMs/lastRead*)', 'readValue' in n && 'readIntervalMs' in n && 'lastReadAt' in n && 'lastReadError' in n)
+  const before = await read(n.id)
+  check('未写入时读取:如实报告失败(mock 无记录)', before.ok === false && before.value == null, before.message.slice(0, 50))
+  const w1 = await write(n.id, 165.5)
+  check('写 165.5 成功(回读一致)', w1.ok === true, w1.message.slice(0, 60))
+  const r1 = await read(n.id)
+  check('读回 = 刚写值(165.5)', r1.ok && Math.abs(r1.value - 165.5) < 0.01, `value=${r1.value}`)
+  await write(n.id, 180)
+  const r2 = await read(n.id)
+  check('再写 180 后读随写变', r2.ok && Math.abs(r2.value - 180) < 0.01, `value=${r2.value}`)
+  const v = await nodeView(n.id)
+  check('节点视图记账(readValue/lastReadAt/SET value)', Math.abs(v.readValue - 180) < 0.01 && v.lastReadAt != null && Math.abs(v.value - 180) < 0.01, `act=${v.readValue} set=${v.value}`)
+}
+
+// ===== ② 标定 transform 物理域往返 =====
+console.log('\n--- ② transform 物理域往返 ---')
+{
+  const n = await mkNode('读写验证·标定×2', { driver: 'mock', driverConfig: { key: `rw-e2e-2-${RUN}` }, transform: { kind: 'linear', scale: 2, offset: 0 }, min: 0, max: 400 })
+  await write(n.id, 100)
+  const r = await read(n.id)
+  check('物理 100(PLC 50)写→读往返一致', r.ok && Math.abs(r.value - 100) < 0.01, `value=${r.value}(raw=${r.raw})`)
+}
+
+// ===== ③ 周期读服务端调度 =====
+console.log('\n--- ③ 周期读调度(readIntervalMs=1000,不手动读) ---')
+{
+  const n = await mkNode('读写验证·周期读', { driver: 'mock', driverConfig: { key: `rw-e2e-3-${RUN}` }, readIntervalMs: 1000 })
+  await write(n.id, 155)
+  check('写入后 SET 已记账', Math.abs((await nodeView(n.id)).value - 155) < 0.01)
+  await sleep(2600)
+  const v = await nodeView(n.id)
+  check('2.6s 内周期读自动回填 ACT(服务端调度)', Math.abs(v.readValue - 155) < 0.01 && v.lastReadAt != null, `act=${v.readValue} @${v.lastReadAt?.slice(11, 19)}`)
+}
+
+// ===== ④ 真实 Modbus TCP 读写 roundtrip =====
+console.log('\n--- ④ 真实 Modbus TCP(1502 从站,float32 大端) ---')
+{
+  const cfg = { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' }
+  const n = await mkNode('读写验证·Modbus真实链路', { driver: 'modbus-tcp', driverConfig: cfg, min: 0, max: 300 })
+  const t = await j(`/api/workshop/dcw/${n.id}/test`, 'POST').then(r => r.data.test)
+  check('真实从站连接测试(40021 可访问)', t.ok === true, t.message.slice(0, 60))
+  const r0 = await read(n.id)
+  check('真实读:初始寄存器值(raw=0 → 0)', r0.ok && r0.raw != null, `raw=${r0.raw}`)
+  const w1 = await write(n.id, 3.1416)
+  check('真实写:3.1416 下发+同址回读一致', w1.ok === true, w1.message.slice(0, 70))
+  const r1 = await read(n.id)
+  check('真实读:寄存器回 3.1416(独立于写回读的第二笔读)', r1.ok && Math.abs(r1.raw - 3.1416) < 0.001, `raw=${r1.raw} eng=${r1.value}`)
+  const w2 = await write(n.id, 2.71828)
+  const r2 = await read(n.id)
+  check('第二轮写读:2.71828 roundtrip', w2.ok && r2.ok && Math.abs(r2.raw - 2.71828) < 0.001, `raw=${r2.raw}`)
+  const v = await nodeView(n.id)
+  check('真实节点视图 ACT 收敛(2.72 MPa? ℃模板域 150~200 → 用原始值展示)', v.readValue != null && v.lastReadAt != null, `act=${v.readValue} raw=${r2.raw}`)
+}
+
+// ===== 收尾 =====
+if (CLEANUP) {
+  for (const id of created) await j(`/api/workshop/dcw/${id}`, 'DELETE').catch(() => {})
+  console.log(`(cleanup:${created.length} 个测试节点已删)`)
+}
+else {
+  console.log(`(节点保留:${created.join(', ')};CLEANUP=1 可清理)`)
+}
+console.log(failed === 0 ? '\nDCW-READ-E2E ALL PASS' : `\nDCW-READ-E2E FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-dcw-read-toolface.ts

@@ -0,0 +1,13 @@
+/**
+ * 一次性检查:dcw_read 进入 hostToolsForRole 工具面(worker/lead)。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-dcw-read-toolface.ts
+ */
+import { hostToolsForRole } from '../server/services/workshop/agents/omp-agent'
+
+for (const role of ['worker', 'lead'] as const) {
+  const names = hostToolsForRole(role).map(t => t.name)
+  const hit = names.includes('dcw_read')
+  console.log(`${role}: dcw_read ${hit ? '在工具面' : '缺失!'}(${names.length} 个工具)`)
+  if (role === 'worker' && !hit) process.exit(1)
+}
+console.log('TOOLFACE PASS')

package/scripts/_dbg-dcw-read-ui.mjs

@@ -0,0 +1,74 @@
+/**
+ * DCW 读写集成 UI 目视验证:/dcw/[line] 节点表「PLC 读数」列(含真实 Modbus 节点)
+ * + /town 设备卡 ACT 读数行。截图落 .e2e-shots/。
+ * 运行: node scripts/_dbg-dcw-read-ui.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const LINE = process.env.LINE ?? 'ln-af002514'
+const DEV = '循环泵 #01'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, cond, detail = '') => { console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!cond) failed++ }
+const shot = async (page, name) => {
+  mkdirSync('.e2e-shots', { recursive: true })
+  await page.screenshot({ path: `.e2e-shots/${name}.png` })
+}
+
+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())
+
+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: login.data.token, domain: '127.0.0.1', path: '/' })
+try {
+  // ① /dcw/[line] 节点表:PLC 读数列 + 读取按钮 + 各节点读数值
+  await page.goto(`${ROOT}/dcw/${LINE}`, { waitUntil: 'networkidle2', timeout: 90000 })
+  await page.waitForSelector('.nodes-table tbody tr', { timeout: 30000 })
+  await sleep(3000)
+  const head = await page.evaluate(() => [...document.querySelectorAll('.nodes-table th')].map(t => t.textContent.trim()))
+  check('①表头含「PLC 读数」列', head.some(t => t.includes('PLC 读数')), head.join('|'))
+  const rows = await page.evaluate(() => [...document.querySelectorAll('.nodes-table tbody tr')].map((tr) => {
+    const cells = [...tr.querySelectorAll('td')]
+    const name = tr.querySelector('td b')?.textContent?.trim() ?? ''
+    return { name, read: cells[4]?.textContent?.replace(/\s+/g, ' ').trim() ?? '', hasReadBtn: !!cells[4]?.querySelector('.read-btn') }
+  }).filter(r => r.name.includes('读写验证')))
+  check('①四个测试节点都在行内', rows.length >= 4, rows.map(r => `${r.name}:${r.read}`).join(' | ').slice(0, 160))
+  check('①行内有「读取」按钮', rows.every(r => r.hasReadBtn) && rows.length > 0)
+  check('①Modbus 真实节点 ACT 已回填', rows.some(r => r.name.includes('Modbus') && /\d/.test(r.read)), rows.find(r => r.name.includes('Modbus'))?.read)
+  await shot(page, 'dcw-line-read-column')
+
+  // ② 点「读取」按钮 → 读数刷新(手动读 UI 路径)
+  const btnOk = await page.evaluate(() => {
+    const row = [...document.querySelectorAll('.nodes-table tbody tr')].find(tr => tr.textContent?.includes('mock 手动'))
+    const btn = row?.querySelector('.read-btn')
+    if (!btn) return false
+    btn.click()
+    return true
+  })
+  await sleep(1500)
+  check('②点击「读取」按钮执行手动读', btnOk)
+
+  // ③ /town 设备卡:SET + ACT 两行实时
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await sleep(20000)
+  const act = () => page.evaluate((dev) => {
+    const card = [...document.querySelectorAll('.twin-card')].find(c => c.querySelector('.twin-name')?.textContent?.includes(dev))
+    const items = card ? [...card.querySelectorAll('.dcw-item')].map(e => ({
+      set: e.querySelector('.dcw-set')?.textContent?.replace(/\s+/g, '') ?? '',
+      act: e.querySelector('.dcw-act b')?.textContent?.replace(/\s+/g, '') ?? null,
+    })) : []
+    return items
+  }, DEV)
+  const a1 = await act()
+  check('③/town 设备卡出现智控通道(SET)', a1.length > 0, JSON.stringify(a1).slice(0, 120))
+  check('③通道带 ACT 读数行', a1.some(r => r.act != null && /\d/.test(r.act)), JSON.stringify(a1.map(r => r.act)))
+  await shot(page, 'town-dcw-act')
+}
+finally {
+  await browser.close().catch(() => {})
+}
+console.log(failed === 0 ? '\nDCW-READ-UI ALL PASS' : `\nDCW-READ-UI FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-plugin-tools-inject.ts

@@ -0,0 +1,80 @@
+/**
+ * 插件扩展验证 C(omp 工具注入,协议层真机):
+ * ①插件工具并入角色工具面 → ②真实 omp --mode rpc 子进程接受含插件工具的
+ *   set_host_tools(协议层注入生效) → ③handleHostTool 分发到插件 handler。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-plugin-tools-inject.ts
+ */
+import { spawn } from 'node:child_process'
+import { registerPluginTool, listPluginTools } from '../server/services/workshop/agents/plugin-tools'
+import { hostToolsForRole, OmpRpcAgentImpl } from '../server/services/workshop/agents/omp-agent'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+// ===== ① 插件工具注册(模拟插件 setup 的注册调用)=====
+registerPluginTool('live-verify', {
+  name: 'plugin_verify_probe',
+  description: '插件验证探针:返回插件链路状态',
+  parameters: { type: 'object', properties: { ping: { type: 'string' } } },
+  handler: args => ({ text: `probe-ok:${String(args.ping ?? '')}` }),
+})
+check('插件工具注册进注册表', listPluginTools().has('plugin_verify_probe'))
+check('hostToolsForRole(worker) 含插件工具', hostToolsForRole('worker').some(t => t.name === 'plugin_verify_probe'))
+
+// ===== ② 真实 omp 子进程:set_host_tools 含插件工具 → 协议接受 =====
+console.log('\n--- 真实 omp 子进程注入 ---')
+{
+  const tools = hostToolsForRole('worker')
+  const child = spawn('omp', ['--mode', 'rpc'], { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true })
+  let buf = ''
+  let sent = false
+  let accepted: unknown = null
+  const result = await new Promise<unknown>((resolve) => {
+    const timer = setTimeout(() => resolve('timeout'), 30_000)
+    child.stdout!.setEncoding('utf-8')
+    child.stdout!.on('data', (chunk: string) => {
+      buf += chunk
+      let idx: number
+      while ((idx = buf.indexOf('\n')) >= 0) {
+        const line = buf.slice(0, idx)
+        buf = buf.slice(idx + 1)
+        if (!line.trim()) continue
+        try {
+          const frame = JSON.parse(line)
+          if (frame.type === 'ready' && !sent) {
+            sent = true
+            // 注入含插件工具的工具面(与 omp-agent ensureClient 同一命令)
+            child.stdin!.write(`${JSON.stringify({ id: 'req_tools', type: 'set_host_tools', tools })}\n`)
+          }
+          else if (frame.type === 'response' && frame.id === 'req_tools') {
+            clearTimeout(timer)
+            accepted = frame
+            resolve(frame)
+          }
+        }
+        catch { /* 非 JSON 行忽略 */ }
+      }
+    })
+    child.on('exit', () => resolve(accepted ?? 'exit'))
+  })
+  child.kill()
+  const resp = accepted as { success?: boolean } | null
+  check('真实 omp 接受含插件工具的 set_host_tools', !!resp && resp.success === true, JSON.stringify(accepted).slice(0, 120))
+  void result
+}
+
+// ===== ③ handleHostTool 分发(真实 OmpRpcAgentImpl 实例)=====
+console.log('\n--- 分发执行 ---')
+{
+  const impl = new OmpRpcAgentImpl({ agentId: 'ag-verify', name: '验证员', role: 'worker', channelId: 'ch-v' })
+  const handle = (impl as unknown as Record<string, (req: unknown) => Promise<{ text: string, isError?: boolean }>>).handleHostTool.bind(impl)
+  const out = await handle({ toolName: 'plugin_verify_probe', toolCallId: 't1', arguments: { ping: 'e2e' } })
+  check('handleHostTool 分发到插件 handler', out.text === 'probe-ok:e2e', out.text)
+  await impl.dispose()
+}
+
+console.log(failures === 0 ? '\nTOOLS INJECT ALL PASS' : `\nTOOLS INJECT FAILED(${failures})`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-plugin-ui-wizard.mjs

@@ -0,0 +1,125 @@
+/**
+ * 插件扩展验证 D(浏览器 UI 真实操作):/daq 新增节点向导选择插件模板 →
+ * 通过 UI 建节点 → 列表行实时值流入 → /town 孪生面板出现该节点。
+ * 截图落 .e2e-shots/(向导/列表/孪生);节点保留(CLEANUP=1 删除)。
+ * 运行: node scripts/_dbg-plugin-ui-wizard.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync, writeFileSync } from 'node:fs'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const CLEANUP = process.env.CLEANUP === '1'
+const NODE_NAME = process.env.NODE_NAME ?? 'UI向导插件验证'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, cond, detail = '') => { console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!cond) failed++ }
+const shot = async (page, name) => {
+  mkdirSync('.e2e-shots', { recursive: true })
+  await page.screenshot({ path: `.e2e-shots/${name}.png` })
+}
+
+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())
+const H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+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: login.data.token, domain: '127.0.0.1', path: '/' })
+let createdNodeId = null
+try {
+  // ① 打开 /daq → 点「添加节点」→ 向导弹出
+  await page.goto(`${ROOT}/daq`, { waitUntil: 'networkidle2', timeout: 90000 })
+  await page.waitForSelector('tbody tr', { timeout: 30000 })
+  await page.click('button.aw-pill.add-btn:not(.outline)')
+  await page.waitForSelector('.modal .f-grid select.inp', { timeout: 15000 })
+
+  // ② 模板下拉含插件模板(服务端目录直出)
+  const opts = await page.$$eval('.modal .f-grid select.inp option', os => os.map(o => ({ v: o.value, t: o.textContent.replace(/\s+/g, ' ').trim() })))
+  const plugOpt = opts.find(o => o.v === 'plug-verify-x2-profile')
+  check('①向导模板下拉含插件模板', plugOpt != null, plugOpt?.t ?? `共 ${opts.length} 项`)
+  check('①插件模板带自定义标记(非内置)', plugOpt != null && /自定义|插件/.test(plugOpt.t), plugOpt?.t)
+
+  // ③ 选中插件模板 → 命名 → 截图 → UI 保存
+  await page.select('.modal .f-grid select.inp', 'plug-verify-x2-profile')
+  await page.type('.modal input.inp', NODE_NAME)
+  await shot(page, 'wizard-plugin-template')
+  await page.click('.m-actions button.aw-pill:not(.outline)')
+  await sleep(4000)
+
+  // ③b 行内产线下拉挂到运行中的产线(采集是配方驱动的:未分配不采样)
+  const ctxFile = await import('node:fs')
+  const runLine = process.env.RUN_LINE ?? JSON.parse(ctxFile.readFileSync('.e2e-plugin-ctx.json', 'utf-8')).lineId
+  const lineName = ((await j('/api/workshop/dcw')).data.lines ?? []).find(l => l.id === runLine)?.name
+  const lineOpts = await page.evaluate((nm) => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes(nm))
+    const sel = row?.querySelector('select.line-sel')
+    return sel ? Array.from(sel.options).map(o => ({ v: o.value, t: o.textContent.trim() })) : null
+  }, NODE_NAME)
+  const lineOpt = (lineOpts ?? []).find(o => o.t === lineName)
+  check('③b 行内产线下拉含运行中产线', lineOpt != null, `${lineName} 选项=${lineOpt?.v ?? '无'}`)
+  // puppeteer 的 page.select 需要全局选择器:行内直接派发 change 更稳
+  await page.evaluate((nm, lineId) => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes(nm))
+    const sel = row?.querySelector('select.line-sel')
+    if (!sel) throw new Error('行内无产线下拉')
+    sel.value = lineId
+    sel.dispatchEvent(new Event('change', { bubbles: true }))
+  }, NODE_NAME, runLine)
+  await sleep(2500)
+
+  // ④ 列表行出现且实时值流入(WS 帧驱动)
+  const rowVal = () => page.evaluate((nm) => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes(nm))
+    const m = row?.textContent?.match(/(\d+\.\d+)\s*mm/)
+    return { v: m ? m[1] : null, row: row?.textContent?.replace(/\s+/g, ' ').slice(0, 120) ?? '' }
+  }, NODE_NAME)
+  const r1 = await rowVal()
+  await sleep(5000)
+  const r2 = await rowVal()
+  check('④UI 建出的插件节点出现在列表', r1.v != null, r1.row)
+  check('④列表实时值变化(帧流入)', r1.v != null && r2.v != null && r1.v !== r2.v, `${r1.v} → ${r2.v}`)
+  await shot(page, 'daq-list-plugin-node')
+  const nodes = (await j('/api/workshop/daq')).data.nodes
+  createdNodeId = nodes.find(n => n.name === NODE_NAME)?.id ?? null
+
+  // ④b 行内设备下拉绑定设备(孪生面板按设备挂数采项)
+  const devOpt = await page.evaluate((nm) => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes(nm))
+    const sel = row?.querySelectorAll('select.line-sel')[1]
+    const first = sel?.querySelector('option[value]:not([value=""])')
+    if (!sel || !first) return null
+    sel.value = first.value
+    sel.dispatchEvent(new Event('change', { bubbles: true }))
+    return { v: first.value, t: first.textContent.trim() }
+  }, NODE_NAME)
+  check('④b 行内绑定设备(第一可绑定项)', devOpt != null, devOpt ? `${devOpt.t}(${devOpt.v})` : '无可绑定设备')
+  await sleep(2000)
+
+  // ⑤ /town 孪生面板出现该节点且实时
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await sleep(20000)
+  // 面板项显示模板通道名(d.ch),节点挂在绑定设备卡下 → 按「设备卡 + 通道名」定位
+  const panel = () => page.evaluate(() => {
+    const card = [...document.querySelectorAll('.twin-card')].find(c => c.querySelector('.twin-name')?.textContent?.includes('循环泵 #01'))
+    const item = card ? [...card.querySelectorAll('.daq-item')].find(e => e.textContent?.includes('标定轮廓')) : null
+    return { card: !!card, text: item?.textContent?.replace(/\s+/g, '') ?? '', val: item?.querySelector('b')?.textContent?.replace(/\s+/g, '') ?? null }
+  })
+  const p1 = await panel()
+  await sleep(5000)
+  const p2 = await panel()
+  check('⑤/town 设备卡(循环泵 #01)出现', p1.card)
+  check('⑤/town 孪生面板出现插件节点通道(标定轮廓)', p1.text !== '', p1.text.slice(0, 60))
+  check('⑤/town 面板实时值变化', p1.val != null && p2.val != null && p1.val !== p2.val, `${p1.val} → ${p2.val}`)
+  await shot(page, 'town-panel-plugin-node')
+}
+finally {
+  await browser.close().catch(() => {})
+  if (CLEANUP && createdNodeId) {
+    await j(`/api/workshop/daq/${createdNodeId}`, 'DELETE').catch(() => {})
+    console.log(`(cleanup:节点 ${createdNodeId} 已删)`)
+  }
+}
+writeFileSync('.e2e-plugin-ui-node.json', JSON.stringify({ nodeId: createdNodeId, name: NODE_NAME }))
+console.log(failed === 0 ? '\nSTACK-D ALL PASS' : `\nSTACK-D FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-plugin-verify-e2e.mjs

@@ -0,0 +1,123 @@
+/**
+ * 插件扩展全栈验证 A(数据管线 + 前端 + 孪生):
+ * ①插件模板+插件驱动建节点 → 产线开跑 → mock 一次性 vector 采样
+ * ②sink 加工断言(×2 确定性签名:argmax=6、points[6]≈1.08、points[0]≈0.90、verifyTag=1)
+ * ③DB 事实(REST frames = Timescale 读取)
+ * ④/daq 列表页实时值变化(浏览器)
+ * ⑤/town 数字孪生右轨面板实时变化(浏览器)
+ * 产出 .e2e-plugin-ctx.json 供 Agent 读库段使用;节点保留(--cleanup=1 时清理)。
+ * 运行: node scripts/_dbg-plugin-verify-e2e.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { writeFileSync, readFileSync } from 'node:fs'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const CLEANUP = process.env.CLEANUP === '1'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, cond, detail = '') => { console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!cond) failed++ }
+
+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())
+const H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const cookie = { name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+// ===== ① 插件模板/驱动在目录 =====
+const daq0 = (await j('/api/workshop/daq')).data
+const tpl = daq0.templates.find(t => t.key === 'plug-verify-x2-profile')
+check('①插件模板在目录(plugin 标记,vector)', !!tpl && tpl.plugin != null && tpl.signalKind === 'vector')
+
+// ===== ② 开跑 + 插件模板 + 插件驱动建节点 =====
+const d = (await j('/api/workshop/dcw')).data
+const cand = d.lines.map(l => ({ line: l, recipe: d.recipes.find(r => r.lineId === l.id) })).find(x => x.recipe)
+await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+await sleep(800)
+await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+const node = (await j('/api/workshop/daq', 'POST', {
+  templateRef: 'plug-verify-x2-profile',
+  driver: 'verify-burst',
+  lineId: cand.line.id,
+  name: '全栈验证 ×2 轮廓',
+  posX: 120, posZ: 120,
+})).data.node
+check('②节点创建(插件模板+插件驱动)', node?.driver === 'verify-burst', `driver=${node?.driver}`)
+
+// ===== ③ 等帧 → sink 加工确定性断言 =====
+let frames = []
+for (let i = 0; i < 15; i++) {
+  await sleep(2000)
+  frames = (await j(`/api/workshop/daq/${node.id}/frames?limit=5`)).data.frames
+  if (frames.length >= 3) break
+}
+check('③帧入库(Rest = Timescale 事实源)', frames.length >= 3, `${frames.length} 帧`)
+if (frames.length >= 3) {
+  const f = frames[0]
+  const pts = f.points ?? []
+  const argmax = pts.reduce((best, p, i) => (p > pts[best] ? i : best), 0)
+  check('一次性 vector:24 点完整轮廓', pts.length === 24, `len=${pts.length}`)
+  check('×2 标定签名:argmax=6(尖峰位)', argmax === 6, `argmax=${argmax}`)
+  check('×2 标定签名:points[6]∈[1.06,1.12](=2×0.54)', pts[6] >= 1.06 && pts[6] <= 1.12, String(pts[6]))
+  check('×2 标定签名:points[0]∈[0.88,0.92](=2×0.45)', pts[0] >= 0.88 && pts[0] <= 0.92, String(pts[0]))
+  check('插件处理器指纹:metrics.verifyTag=1', f.metrics.verifyTag === 1)
+  check('内置 derive-metric 在插件后执行:max=points[6]', Math.abs((f.metrics.max ?? 0) - pts[6]) < 0.001, `max=${f.metrics.max}`)
+  check('产线打标继承', f.lineId === cand.line.id)
+}
+
+// ===== ④/⑤ 浏览器:/daq 列表实时 + /town 孪生面板实时 =====
+const twins = (await j('/api/workshop/device-twins')).data
+const twinsList = twins.twins ?? twins
+const device = twinsList.find(t => t.kind !== 'daq' && t.kind !== 'dcw')
+if (device) await j(`/api/workshop/daq/${node.id}/bind`, 'POST', { deviceId: device.id })
+
+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(cookie)
+try {
+  // ④ /daq 列表页
+  await page.goto(`${ROOT}/daq`, { waitUntil: 'networkidle2', timeout: 90000 })
+  await sleep(5000)
+  const rowVal = () => page.evaluate(() => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes('全栈验证'))
+    const m = row?.textContent?.match(/(\d+\.\d+)\s*mm/)
+    return m ? m[1] : null
+  })
+  const v1 = await rowVal()
+  await sleep(4500)
+  const v2 = await rowVal()
+  check('④/daq 列表页出现插件节点行', v1 != null, `v1=${v1}`)
+  check('④/daq 实时值变化(WS 帧驱动)', v1 != null && v2 != null && v1 !== v2, `${v1} → ${v2}`)
+
+  // ⑤ /town 数字孪生
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await sleep(20000)
+  const panel = () => page.evaluate(() => {
+    const item = [...document.querySelectorAll('.twin-daq .daq-item')].find(e => e.textContent?.includes('标定轮廓'))
+    return { text: item?.textContent?.replace(/\s+/g, '') ?? '', val: item?.querySelector('b')?.textContent?.replace(/\s+/g, '') ?? null }
+  })
+  const p1 = await panel()
+  await sleep(5000)
+  const p2 = await panel()
+  check('⑤/town 孪生面板出现插件节点行(标定轮廓)', p1.text !== '', p1.text.slice(0, 60))
+  check('⑤/town 面板实时值变化(加工后量级)', p1.val != null && p2.val != null && p1.val !== p2.val, `${p1.val} → ${p2.val}`)
+} finally {
+  await browser.close().catch(() => {})
+}
+
+// ===== Agent 绑定(供读库段)=====
+const agents = (await j('/api/workshop/agents')).data
+const list = agents.agents ?? agents
+const agent = list.find(a => a.enabled !== 0 && a.role === 'worker') ?? list[0]
+await fetch(`${ROOT}/api/workshop/agent-tools/bindings`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: agent.id, nodeId: node.id, kind: 'daq', mode: 'manual' }) }).then(r => r.json())
+writeFileSync('.e2e-plugin-ctx.json', JSON.stringify({ nodeId: node.id, agentId: agent.id, lineId: cand.line.id }))
+
+if (CLEANUP) {
+  await j(`/api/workshop/daq/${node.id}`, 'DELETE').catch(() => {})
+  await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+  console.log('(cleanup 模式:节点已删/线已停)')
+} else {
+  console.log(`(节点 ${node.id} 与产线运行保留,供 Agent 段/浏览器复验;CLEANUP=1 可清理)`)
+}
+
+console.log(failed === 0 ? '\nSTACK-A ALL PASS' : `\nSTACK-A FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/test-config-precedence.ts

@@ -0,0 +1,124 @@
+/**
+ * 配置驱动回归:优先级链(env > runtime-settings > config.yml > 描述符默认)+
+ * 历史别名兼容 + 项目级(.AgentWorkShop)优先/用户级(~/.AgentWorkShop)兜底的路径判定。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-config-precedence.ts
+ */
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const root = mkdtemp()
+function mkdtemp(): string {
+  return rm0(join(tmpdir(), 'aw-cfg-prec-'))
+  function rm0(p: string): string {
+    const dir = `${p}${Math.random().toString(36).slice(2, 8)}`
+    mkdirSync(dir, { recursive: true })
+    return dir
+  }
+}
+
+const engine = await import('../shared/config/engine.mjs')
+const { loadDescriptors, envOverridesFromEnv, loadEffective } = engine as unknown as {
+  loadDescriptors: () => Array<Record<string, unknown>>
+  envOverridesFromEnv: (env: Record<string, string | undefined>, d?: unknown) => Record<string, unknown>
+  loadEffective: (o: { configPath?: string, settingsPath?: string, env?: Record<string, string | undefined> }) => { effective: Record<string, unknown>, sources: Record<string, string> }
+}
+
+// ===== 1. 描述符完整性:每个键都有 default + labelKey;别名唯一 =====
+{
+  const descs = loadDescriptors() as Array<{ key: string, default?: unknown, labelKey?: string, aliases?: string[] }>
+  check(`描述符规模(≥62 键,当前 ${descs.length})`, descs.length >= 62)
+  check('全部键带 default 与 labelKey', descs.every(d => d.default !== undefined && !!d.labelKey))
+  const seen = new Map<string, string>()
+  let dup = ''
+  for (const d of descs) {
+    for (const a of [d.key, ...(d.aliases ?? [])].map(x => x.toUpperCase())) {
+      if (seen.has(a) && seen.get(a) !== d.key) dup = `${a}:${seen.get(a)}&${d.key}`
+      seen.set(a, d.key)
+    }
+  }
+  check('键+别名无冲突', dup === '')
+  // 新迁移组抽查
+  const keys = new Set(descs.map(d => d.key))
+  for (const k of ['memory.inject_total', 'omp.compact_enabled', 'dcw.rollback_stale_ms', 'backup.keep', 'retention.audit_days', 'log.level', 'daq.mqtt.qos', 'daq.frameRetentionH', 'security.hitl_timeout_ms', 'workshop.idle_grace_ms']) {
+    if (!keys.has(k)) {
+      check(`迁移键 ${k} 已注册`, false)
+      failures++
+    }
+  }
+  check('迁移键抽查全部注册', true)
+}
+
+// ===== 2. env 覆盖:AW_<KEY> 自动名 + 历史别名 =====
+{
+  const o = envOverridesFromEnv({
+    AW_MEMORY_INJECT_TOTAL: '800',
+    DAQ_FRAME_RETENTION_H: '999', // 历史别名(无 AW_ 前缀)
+    RETENTION_DISABLED: '1', // 历史别名(boolean "1")
+    AWSHOP_LOG_LEVEL: 'warn',
+  })
+  check('AW_<KEY> 自动名覆盖', o['memory.inject_total'] === 800)
+  check('历史别名:DAQ_FRAME_RETENTION_H', o['daq.frameRetentionH'] === 999)
+  check('历史别名 boolean "1"', o['retention.disabled'] === true)
+  check('历史别名:AWSHOP_LOG_LEVEL', o['log.level'] === 'warn')
+}
+
+// ===== 3. 完整优先级链:env > runtime-settings > config.yml > 描述符默认 =====
+{
+  const configPath = join(root, 'config.yml')
+  const settingsPath = join(root, 'runtime-settings.json')
+  writeFileSync(configPath, [
+    'memory:',
+    '  primer_tokens: 111',
+    'backup:',
+    '  keep: 5',
+    'log:',
+    '  level: warn',
+  ].join('\n'))
+  writeFileSync(settingsPath, JSON.stringify({ version: 1, overrides: { 'memory.primer_tokens': 222 } }))
+  const eff = loadEffective({ configPath, settingsPath, env: { AW_MEMORY_INJECT_TOTAL: '800', BACKUP_KEEP: '3' } })
+  check('env 胜 runtime(memory.inject_total=800)', eff.effective['memory.inject_total'] === 800 && eff.sources['memory.inject_total'] === 'env')
+  check('runtime 胜 config.yml(memory.primer_tokens=222)', eff.effective['memory.primer_tokens'] === 222 && eff.sources['memory.primer_tokens'] === 'runtime')
+  check('config.yml 胜默认(log.level=warn)', eff.effective['log.level'] === 'warn' && eff.sources['log.level'] === 'config.yml')
+  check('描述符默认兜底(dcw.rollback_cooldown_ms=300000)', eff.effective['dcw.rollback_cooldown_ms'] === 300000)
+  check('别名 env 胜 config.yml(backup.keep=3)', eff.effective['backup.keep'] === 3 && eff.sources['backup.keep'] === 'env')
+}
+
+// ===== 4. 项目级优先 / 用户级兜底(resolveRunMode 路径判定) =====
+{
+  const home = await import('../shared/config/home.mjs') as unknown as {
+    resolveRunMode: (o: { cwd: string, packageRoot?: string, env?: Record<string, string | undefined> }) => { mode: string, configRoot: string, dataDir: string, configPath: string, settingsPath: string }
+    awHome: (env?: Record<string, string | undefined>) => string
+    ensureDataDir: (cwd?: string, env?: Record<string, string | undefined>) => string
+  }
+  // ④a 项目级:cwd 下存在 .AgentWorkShop → 用它(最高优先)
+  const proj = join(root, 'proj')
+  mkdirSync(join(proj, '.AgentWorkShop'), { recursive: true })
+  const m1 = home.resolveRunMode({ cwd: proj, packageRoot: join(root, 'pkg') })
+  check('④项目级 .AgentWorkShop 优先', m1.mode === 'repo' && m1.configRoot === join(proj, '.AgentWorkShop'), m1.configRoot)
+
+  // ④b 用户级兜底:检出内无 ./.AgentWorkShop → 数据落 ~/.AgentWorkShop(AW_HOME 可重定向)
+  const fakeHome = join(root, 'fake-home')
+  const m2 = home.resolveRunMode({ cwd: join(root, 'empty-cwd'), packageRoot: join(root, 'pkg'), env: { AW_HOME: fakeHome } })
+  check('④无项目根 → 用户级兜底 ~/.AgentWorkShop(AW_HOME)', m2.configRoot === fakeHome, m2.configRoot)
+  mkdirSync(fakeHome, { recursive: true })
+  const dataDir = home.ensureDataDir(join(root, 'empty-cwd'), { AW_HOME: fakeHome })
+  check('④ensureDataDir 初始化创建 <home>/data', dataDir === join(fakeHome, 'data'), dataDir)
+
+  // ④c home 模式(AW_MODE=home,全局安装载荷):强制用户级
+  const m3 = home.resolveRunMode({ cwd: proj, packageRoot: join(root, 'pkg'), env: { AW_MODE: 'home', AW_HOME: fakeHome } })
+  check('④AW_MODE=home 强制用户级(项目 .AgentWorkShop 不采用)', m3.mode === 'home' && m3.configRoot === fakeHome)
+
+  // ④d 默认 awHome = ~/.AgentWorkShop
+  check('④awHome 默认 ~/.AgentWorkShop', /AgentWorkShop$/.test(home.awHome({})) === true, home.awHome({}))
+}
+
+rmSync(root, { recursive: true, force: true })
+console.log(failures === 0 ? '\nCONFIG-PRECEDENCE ALL PASS' : `\nCONFIG-PRECEDENCE FAILED(${failures})`)
+process.exit(failures === 0 ? 0 : 1)