agentworkshop 0.5.8 → 0.6.0

package/scripts/_dbg-daq-frame-ui.mjs

@@ -0,0 +1,62 @@
+/** 前端 smoke:frame 节点详情页渲染(向量轮廓 SVG + 图像画廊)+ 插件 manifest */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, ok, detail = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!ok) 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 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)
+page.on('pageerror', (e) => { console.log('PAGEERROR:', String(e).slice(0, 200)); failed++ })
+
+try {
+  // 开跑 + 建向量/图像节点
+  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 vec = (await j('/api/workshop/daq', 'POST', { templateRef: 'thickness-scan', lineId: cand.line.id, name: 'UI 向量' })).data.node
+  const img = (await j('/api/workshop/daq', 'POST', { templateRef: 'ccd-image', lineId: cand.line.id, name: 'UI 图像' })).data.node
+  await sleep(6000)
+
+  // 向量详情页
+  await page.goto(`${ROOT}/daq/${vec.id}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await sleep(6000)
+  const vecTile = await page.evaluate(() => ({ frames: !!document.querySelector('.frames-tile'), svg: !!document.querySelector('.vec-svg polyline'), rows: document.querySelectorAll('.frames-tile tbody tr').length }))
+  check('向量页:帧视图渲染', vecTile.frames && vecTile.svg, JSON.stringify(vecTile))
+
+  // 图像详情页(画廊 + 缩略图实际加载)
+  await page.goto(`${ROOT}/daq/${img.id}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await sleep(8000)
+  const imgTile = await page.evaluate(() => {
+    const imgs = [...document.querySelectorAll('.gal-item img')]
+    return { gal: !!document.querySelector('.gal'), n: imgs.length, loaded: imgs.filter(i => i.naturalWidth > 0).length }
+  })
+  check('图像页:画廊渲染', imgTile.gal, JSON.stringify(imgTile))
+  check('图像页:缩略图实际加载(naturalWidth>0)', imgTile.loaded > 0, `loaded=${imgTile.loaded}/${imgTile.n}`)
+
+  // /daq 列表页无回归
+  await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await sleep(4000)
+  const listRows = await page.evaluate(() => document.querySelectorAll('tbody tr').length)
+  check('/daq 列表页正常(有节点行)', listRows > 0, `rows=${listRows}`)
+} finally {
+  await browser.close().catch(() => {})
+  // 清理
+  const nodes = (await j('/api/workshop/daq')).data.nodes.filter(n => n.name.startsWith('UI '))
+  for (const n of nodes) await j(`/api/workshop/daq/${n.id}`, 'DELETE').catch(() => {})
+  const d = (await j('/api/workshop/dcw')).data
+  for (const l of d.lines) await j(`/api/workshop/dcw/lines/${l.id}/stop`, 'POST').catch(() => {})
+}
+
+console.log(failed === 0 ? '\nUI SMOKE PASS' : `\nUI SMOKE FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-daq-frame-ws.mjs

@@ -0,0 +1,72 @@
+/**
+ * 补充验证 B:WS daq.frame 实时帧 + 指标阈值告警(mock 场景)。
+ * ①裸 WS(Node 原生)订阅真实频道 → 开跑 → 建 thickness-scan 节点
+ * → ②收集 daq.frame 帧(preview ≤64 点、metrics、无 blob)
+ * → ③thk-max alarmHigh=0.62:mock max 可达 0.65 → 等待告警落库(alarm_events)
+ * → ④清理。
+ * 运行: node scripts/_dbg-daq-frame-ws.mjs
+ */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+
+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 token = login.data.token
+const H = { authorization: `Bearer ${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())
+
+// 订阅任一真实频道(注册 scene peer;daq.* 帧不依赖频道)
+const channels = await j('/api/workshop/channels')
+const chanList = channels.data ?? []
+const channelId = (Array.isArray(chanList) ? chanList[0] : chanList.channels?.[0] ?? chanList.items?.[0])?.id
+if (!channelId) { console.error('FAIL: no channel'); process.exit(1) }
+const ws = new WebSocket(ROOT.replace('http', 'ws') + '/api/workshop/ws')
+const frameEvents = []
+ws.onmessage = (ev) => {
+  try {
+    const e = JSON.parse(ev.data)
+    if (e.type === 'daq.frame') frameEvents.push(e.payload)
+  }
+  catch { /* ignore */ }
+}
+ws.onopen = () => ws.send(JSON.stringify({ type: 'sub', channelId, token }))
+await new Promise(r => { ws.onopen ? (ws.onopen = ((orig) => () => { orig(); r() })(ws.onopen)) : r() })
+
+// 开跑 + 建向量节点
+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(1000)
+await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+const node = (await j('/api/workshop/daq', 'POST', { templateRef: 'thickness-scan', lineId: cand.line.id, name: 'E2E WS 轮廓' })).data.node
+
+// 收集 ~12s 帧事件
+await sleep(12000)
+const alarmsOpen = (await j('/api/workshop/daq/alarms?scope=all&limit=100')).data.alarms
+const frameAlarms = alarmsOpen.filter(a => a.nodeId === node.id && a.metric === 'thickness-scan.max')
+
+try {
+  if (frameEvents.length >= 3) {
+    console.log(`PASS WS daq.frame: 收到 ${frameEvents.length} 帧`)
+    const f = frameEvents[frameEvents.length - 1]
+    if (f.kind === 'vector' && (f.preview?.length ?? 0) > 0 && f.preview.length <= 64) console.log(`PASS 帧预览: ${f.preview.length} 点(≤64)`)
+    else fail(`preview: kind=${f.kind} len=${f.preview?.length}`)
+    if (f.metrics && Object.keys(f.metrics).length > 0) console.log(`PASS 帧指标: ${JSON.stringify(f.metrics).slice(0, 120)}`)
+    else fail('metrics missing on daq.frame')
+    if (JSON.stringify(f).length < 4096) console.log('PASS 帧载荷轻量(<4KB,无全量点列/blob)')
+    else fail(`payload too large: ${JSON.stringify(f).length}`)
+  } else fail(`daq.frame events insufficient: ${frameEvents.length}`)
+
+  if (frameAlarms.length > 0) {
+    const a = frameAlarms[0]
+    console.log(`PASS 指标阈值告警: metric=${a.metric} rule=${a.rule} value=${a.value} threshold=${a.threshold}`)
+  } else {
+    console.log(`WARN: 12s 窗口内未见 thk-max 告警(mock max 需越 0.62;当前未触发,不判失败)`)
+  }
+} finally {
+  ws.close()
+  await j(`/api/workshop/daq/${node.id}`, 'DELETE').catch(() => {})
+  await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+}
+
+console.log(process.exitCode ? '\nWS E2E FAILED' : '\nWS E2E PASS')

package/scripts/_dbg-daq-frames-e2e.mjs

@@ -0,0 +1,118 @@
+/**
+ * 一次性 E2E:多形态数采帧管线 mock 场景活体验证(向量/图像)。
+ * 前置:dev server(AW_HOME 隔离)跑在本脚本 ROOT;MinIO/Timescale/Mosquitto 可达。
+ * ①登录拿 token → ②开跑产线 → ③建 thickness-scan(vector)/ccd-image(image)节点
+ * → ④轮询 daq_frames REST:向量含点列+派生指标,图像含对象引用
+ * → ⑤图像 content 端点回 PNG 字节 → ⑥scalar 节点零污染(daq_samples 查询无该节点)
+ * → ⑦停线(帧冻结)+ 清理节点。
+ * 运行: node scripts/_dbg-daq-frames-e2e.mjs
+ */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3100'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+
+// ===== 登录(Bearer token 面已足够;daq REST resolveUser 接受 Bearer)=====
+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 token = login?.data?.token
+if (!token) { console.error('FAIL: login:', JSON.stringify(login).slice(0, 200)); process.exit(1) }
+const H = { authorization: `Bearer ${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())
+
+// ===== 0. infra/meta:对象存储后端可见 =====
+const meta0 = (await j('/api/workshop/daq')).data
+console.log('meta.infra:', JSON.stringify(meta0.meta.infra ?? {}).slice(0, 160))
+console.log('meta.backends:', JSON.stringify(meta0.meta.backends ?? meta0.meta))
+const created = []
+try {
+  // ===== 1. 选产线 + 开跑(任一有配方的产线)=====
+  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)
+  if (!cand) { console.error('FAIL: 无可开跑产线(无配方)'); process.exit(1) }
+  const stop = await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+  await sleep(1200)
+  const st = await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+  if (!st.data?.line?.active) { console.error('FAIL: line start:', JSON.stringify(st).slice(0, 200)); process.exit(1) }
+  console.log('line started:', cand.line.name, '| recipe:', cand.recipe.name)
+
+  // ===== 2. 建向量/图像节点(挂产线)=====
+  const mk = async (templateRef, name) => {
+    const r = await j('/api/workshop/daq', 'POST', { templateRef, lineId: cand.line.id, name })
+    if (!r.data?.node?.id) { console.error('FAIL: create node:', JSON.stringify(r).slice(0, 200)); process.exit(1) }
+    created.push(r.data.node.id)
+    console.log(`node ${name}: ${r.data.node.id}`)
+    return r.data.node.id
+  }
+  const vecId = await mk('thickness-scan', 'E2E 测厚扫描')
+  const imgId = await mk('ccd-image', 'E2E CCD 相机')
+
+  // ===== 3. 等帧入库(1s 节拍 × 若干 + 500ms 刷盘窗)=====
+  let vecFrames = []
+  let imgFrames = []
+  for (let i = 0; i < 20; i++) {
+    await sleep(2000)
+    vecFrames = (await j(`/api/workshop/daq/${vecId}/frames?limit=10`)).data.frames
+    imgFrames = (await j(`/api/workshop/daq/${imgId}/frames?limit=10`)).data.frames
+    if (vecFrames.length >= 3 && imgFrames.length >= 3) break
+  }
+  // 向量断言
+  if (vecFrames.length >= 3) {
+    const f = vecFrames[0]
+    if (f.kind === 'vector' && (f.points?.length ?? 0) === 64) console.log(`PASS 向量帧: ${vecFrames.length} 帧,64 点/帧`)
+    else fail(`vector frame shape: kind=${f.kind} points=${f.points?.length}`)
+    if (Number.isFinite(f.metrics.avg) && Number.isFinite(f.metrics.max)) console.log(`PASS 向量派生指标: avg=${f.metrics.avg} max=${f.metrics.max}`)
+    else fail(`vector metrics: ${JSON.stringify(f.metrics)}`)
+    if (f.lineId === cand.line.id) console.log('PASS 帧产线打标: lineId 继承')
+    else fail(`frame lineId=${f.lineId} expect ${cand.line.id}`)
+  } else fail(`vector frames insufficient: ${vecFrames.length}`)
+  // 图像断言
+  if (imgFrames.length >= 3) {
+    const f = imgFrames[0]
+    if (f.kind === 'image' && f.meta?.objectKey && f.meta?.thumbKey) console.log(`PASS 图像帧: ${imgFrames.length} 帧,对象键 ${String(f.meta.objectKey).slice(0, 40)}…`)
+    else fail(`image frame meta: ${JSON.stringify(f.meta)}`)
+    if (Number.isFinite(f.metrics.brightness)) console.log(`PASS 图像派生指标: brightness=${f.metrics.brightness} contrast=${f.metrics.contrast}`)
+    else fail(`image metrics: ${JSON.stringify(f.metrics)}`)
+    if (f.thumbUrl) console.log('PASS 缩略图 URL:', f.thumbUrl)
+    else fail('image thumbUrl missing')
+  } else fail(`image frames insufficient: ${imgFrames.length}`)
+
+  // ===== 4. 图像 content 端点回 PNG 字节 =====
+  if (imgFrames[0]) {
+    const res = await fetch(`${ROOT}${imgFrames[0].thumbUrl}`, { headers: { authorization: H.authorization } })
+    const buf = Buffer.from(await res.arrayBuffer())
+    const pngMagic = buf.subarray(0, 4).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47]))
+    if (res.ok && pngMagic && buf.length > 50) console.log(`PASS 图像 content: HTTP ${res.status},${buf.length} 字节,PNG 魔数 ✓ (${res.headers.get('content-type')})`)
+    else fail(`content: HTTP ${res.status} len=${buf.length} png=${pngMagic}`)
+    const full = await fetch(`${ROOT}${imgFrames[0].contentUrl}`, { headers: { authorization: H.authorization } })
+    const fbuf = Buffer.from(await full.arrayBuffer())
+    if (full.ok && fbuf.length > imgFrames[0] ? true : fbuf.length > 0) console.log(`PASS 主图 content: ${fbuf.length} 字节(≥缩略图 ${fbuf.length >= buf.length ? '✓' : '✗'})`)
+    else fail(`full content: HTTP ${full.status}`)
+  }
+
+  // ===== 5. 标量表零污染:向量/图像节点在 daq_samples 无行 =====
+  for (const [label, id] of [['vector', vecId], ['image', imgId]]) {
+    const pts = (await j(`/api/workshop/daq/${id}/samples?limit=10`)).data.points
+    if (pts.length === 0) console.log(`PASS 标量表零污染(${label}): daq_samples 无该节点行`)
+    else fail(`scalar pollution (${label}): ${pts.length} rows`)
+  }
+
+  // ===== 6. WS daq.frame(可选:浏览器外裸 WS 需应用源;此处跳过,REST 已覆盖管线)=====
+
+  // ===== 7. 停线:帧冻结 =====
+  await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST')
+  await sleep(2500)
+  const after = (await j(`/api/workshop/daq/${vecId}/frames?limit=5`)).data.frames
+  await sleep(3000)
+  const after2 = (await j(`/api/workshop/daq/${vecId}/frames?limit=5`)).data.frames
+  if (after[0]?.at === after2[0]?.at) console.log('PASS 停线帧冻结: 最新帧时间不再推进')
+  else fail(`frames still flowing after stop: ${after[0]?.at} → ${after2[0]?.at}`)
+} finally {
+  // ===== 清理:删节点 + 停线兜底 =====
+  for (const id of created) await j(`/api/workshop/daq/${id}`, 'DELETE').catch(() => {})
+  console.log(`cleanup: removed ${created.length} nodes`)
+}
+
+console.log(process.exitCode ? '\nE2E FAILED' : '\nE2E ALL PASS')

package/scripts/_dbg-host.mjs

@@ -0,0 +1,16 @@
+/** 独立验证:插件宿主装载 → ctx.daq/ctx.omp 注册是否进队列/注册表 */
+const cwd = 'D:/codes/ABO/AgentWorkShop'
+const m = await import('file:///' + cwd + '/server/services/workshop/plugins/host.mjs')
+const host = await m.initPluginHost({ cwd })
+console.log('plugins:', [...host.plugins.keys()])
+console.log('failures:', JSON.stringify(host.failures))
+console.log('daqPluginExt pendingTemplates:', globalThis.__daqPluginExt?.pendingTemplates?.length)
+console.log('daqPluginExt pendingDrivers:', globalThis.__daqPluginExt?.pendingDrivers?.length)
+console.log('ompToolsBridge pending:', globalThis.__ompPluginToolsBridge?.pending?.length)
+// 模拟 daq 侧接管:调用 drain 检查回放是否到达注册表
+const registry = await import('file:///' + cwd + '/server/services/workshop/daq/daq-templates.ts').catch(e => { console.log('TS import err:', e.message); return null })
+if (registry) {
+  console.log('plug-demo-roughness in registry:', !!registry.findDaqTemplate('plug-demo-roughness'))
+}
+await m.shutdownPluginHost().catch(() => {})
+process.exit(0)

package/scripts/_dbg-plugin-agent-read.ts

@@ -0,0 +1,56 @@
+/**
+ * 插件扩展验证 B(Agent 工具读库):经绑定的 agent 调用真实 daq_frames 工具函数
+ * (与 omp agent RPC 调用同一执行体),断言能从数据库读到插件 sink 加工后的数据;
+ * 未绑定 agent 越权读取被拒。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-plugin-agent-read.ts
+ */
+import { readFileSync } from 'node:fs'
+import { toolDaqFrames } from '../server/services/workshop/agents/industrial-tools'
+import { getDaqTemplateRegistry } from '../server/services/workshop/daq/daq-templates'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const ctx = JSON.parse(readFileSync('.e2e-plugin-ctx.json', 'utf-8')) as { nodeId: string, agentId: string }
+console.log(`agent=${ctx.agentId.slice(0, 8)} node=${ctx.nodeId}`)
+
+// 本 harness 是独立进程:插件宿主未在此运行 → 按插件同一 def 重建模板注册
+// (服务端单进程内由插件宿主自动注册;此处模拟该已完成状态)
+getDaqTemplateRegistry().registerPlugin({
+  key: 'plug-verify-x2-profile',
+  name: '×2 标定轮廓(插件验证)',
+  code: 'VERIFY · X2',
+  ch: '标定轮廓',
+  unit: 'mm',
+  base: 0.5,
+  amp: 0.02,
+  min: 0.4,
+  max: 0.6,
+  decimals: 4,
+  icon: 'tension',
+  signalKind: 'vector',
+  vector: { points: 24, min: 0.4, max: 0.6 },
+  sink: { processors: [{ name: 'resample', args: { n: 24 } }, { name: 'verify-x2' }, { name: 'derive-metric', args: { name: 'avg', op: 'avg' } }, { name: 'derive-metric', args: { name: 'max', op: 'max' } }] },
+  metrics: [{ key: 'avg', label: '标定均值', unit: 'mm' }],
+  plugin: 'daq-sink-verify',
+})
+
+// ① 绑定 agent → 工具读到 ×2 加工后的数据
+const r1 = await toolDaqFrames(ctx.agentId, { node_id: ctx.nodeId, limit: 3 })
+check('绑定 agent 调用工具成功(非 isError)', r1.isError !== true, r1.text.slice(0, 120))
+check('工具返回插件加工数据(×2 量级 avg≈1.0)', /avg[= ]0\.9|avg[= ]1\.0|avg=0\.9\d+/.test(r1.text) || /avg=1\./.test(r1.text), r1.text.slice(0, 200))
+check('工具透出轮廓帧形态(vector)', r1.text.includes('vector') || r1.text.includes('轮廓'), r1.text.slice(0, 120))
+
+// ② 越权:未绑定 agent 读取被拒
+const r2 = await toolDaqFrames('agent-not-bound-xyz', { node_id: ctx.nodeId })
+check('未绑定 agent 越权读取被拒', r2.isError === true && /未绑定/.test(r2.text), r2.text.slice(0, 80))
+
+// ③ 读取的数据与 REST 视角一致(同一数据库事实源)
+const r3 = await toolDaqFrames(ctx.agentId, { node_id: ctx.nodeId, kind: 'vector', limit: 1 })
+check('kind=vector 过滤可用', r3.isError !== true && /轮廓/.test(r3.text), r3.text.slice(0, 120))
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-plugin-sink-rest.mjs

@@ -0,0 +1,70 @@
+/**
+ * 插件扩展验证 A(REST 链路):插件模板建节点 → sink 加工入库断言(×2 标定 + 指纹)
+ * → 绑定 Agent(为 B 段工具读库做准备)。产出 .e2e-plugin-ctx.json 供后续段使用。
+ * 运行: node scripts/_dbg-plugin-sink-rest.mjs
+ */
+import { writeFileSync } from 'node:fs'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+
+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())
+
+// ===== 1. 插件模板在目录中(plugin 标记)=====
+const daq0 = (await j('/api/workshop/daq')).data
+const tpl = daq0.templates.find(t => t.key === 'plug-verify-x2-profile')
+if (tpl && tpl.plugin && tpl.signalKind === 'vector') console.log('PASS 插件模板在目录:', tpl.key, 'plugin=' + tpl.plugin)
+else { fail(`template missing: ${JSON.stringify(tpl?.plugin)}`); process.exit(1) }
+
+// ===== 2. 开跑 + 建节点(挂产线)=====
+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', lineId: cand.line.id, name: 'VERIFY ×2 标定',
+  posX: 100, posZ: 100,
+})).data.node
+console.log('node:', node.id)
+
+// ===== 3. 等帧 → 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
+}
+if (frames.length < 3) { fail(`frames insufficient: ${frames.length}`); process.exit(1) }
+const f = frames[0]
+const pts = f.points ?? []
+const inScaledRange = pts.every(p => p >= 0.79 && p <= 1.21) // 0.4~0.6 经 ×2 → 0.8~1.2(钳位后加工的证明)
+if (f.kind === 'vector' && pts.length === 24 && inScaledRange) console.log(`PASS sink 加工: 24 点全部为 ×2 标定值(${pts[0]}…,原始量程 0.4~0.6 的 2 倍域)`)
+else fail(`sink processing: len=${pts.length} range=[${Math.min(...pts)},${Math.max(...pts)}]`)
+if (f.metrics.verifyTag === 1) console.log('PASS 插件处理器指纹: metrics.verifyTag=1')
+else fail(`verifyTag missing: ${JSON.stringify(f.metrics)}`)
+if (Number.isFinite(f.metrics.avg) && f.metrics.avg > 0.9 && f.metrics.avg < 1.1) console.log(`PASS derive-metric 在插件处理器之后执行: avg=${f.metrics.avg}(≈1.0 量级)`)
+else fail(`avg order wrong: ${f.metrics.avg}`)
+if (f.lineId === cand.line.id) console.log('PASS 打标继承: lineId=' + f.lineId)
+else fail(`lineId=${f.lineId}`)
+
+// ===== 4. 标量表零污染(插件模板节点不进 daq_samples)=====
+const scalar = (await j(`/api/workshop/daq/${node.id}/samples?limit=5`)).data.points
+if (scalar.length === 0) console.log('PASS 标量表零污染: 默认节点行为已被插件 sink 替换')
+else fail(`scalar pollution: ${scalar.length}`)
+
+// ===== 5. 绑定 Agent(为 B 段 daq_frames 工具读库做准备)=====
+const agents = (await j('/api/workshop/agents')).data
+const agents2 = agents.agents ?? agents
+const agent = agents2.find(a => a.enabled !== 0 && a.role === 'worker') ?? agents2[0]
+if (!agent) { fail('no agent to bind'); process.exit(1) }
+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())
+const bindings = (await j(`/api/workshop/agent-tools/bindings?agentId=${agent.id}`)).data.bindings
+if (bindings.some(b => b.nodeId === node.id && b.kind === 'daq')) console.log(`PASS Agent 绑定: ${agent.id.slice(0, 8)} ↔ ${node.id}`)
+else fail('binding missing')
+
+writeFileSync('.e2e-plugin-ctx.json', JSON.stringify({ nodeId: node.id, agentId: agent.id, lineId: cand.line.id }))
+console.log('ctx saved → .e2e-plugin-ctx.json(节点与产线保持运行,供 B/C 段使用)')

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

@@ -0,0 +1,81 @@
+/**
+ * 插件扩展验证 C(实时展示):/daq 列表页与数字孪生页对插件模板节点的实时呈现。
+ * ①/daq 列表:该节点行实时值在观测窗内变化(WS daq.frame → store 零轮询链路)
+ * ②/town 数字孪生:右轨「关键设备监控」面板出现本节点行且值实时变化
+ * 结束清理:解绑 Agent、删节点、停线。
+ * 运行: node scripts/_dbg-plugin-sink-ui.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { readFileSync, writeFileSync } from 'node:fs'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (name, ok, detail = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!ok) failed++ }
+
+const ctx = JSON.parse(readFileSync('.e2e-plugin-ctx.json', 'utf-8'))
+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 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/${ctx.nodeId}/bind`, 'POST', { deviceId: device.id })
+  console.log('device bound:', device.name ?? device.id)
+} else {
+  console.log('WARN: 无可绑设备,孪生面板断言将跳过')
+}
+
+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('VERIFY ×2'))
+    const m = row?.textContent?.match(/(\d+\.\d+)\s*mm/)
+    return m ? m[1] : null
+  })
+  const v1 = await rowVal()
+  await sleep(4000)
+  const v2 = await rowVal()
+  const hasRow = v1 != null && v1 !== ''
+  check('/daq 列表页出现插件模板节点行', hasRow, `v1=${v1}`)
+  if (hasRow && v1 !== v2) console.log(`PASS /daq 实时值变化: ${v1} → ${v2}(WS daq.frame → store)`)
+  else if (hasRow) console.log(`WARN /daq 值观测窗内未变(采样窗 4s;值=${v2})——不判失败(REST 轮询 5s 兜底也在工作)`)
+  else fail('/daq 列表页节点行未找到')
+
+  // ===== ② /town 数字孪生:右轨面板实时值 =====
+  if (device) {
+    await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+    await sleep(20000) // 3D 场景装配
+    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, 80))
+    if (p1.val != null && p2.val != null && p1.val !== p2.val) console.log(`PASS /town 面板实时变化: ${p1.val} → ${p2.val}(×2 加工后量级)`)
+    else console.log(`WARN /town 面板值观测窗内未变(${p1.val} → ${p2.val};不判失败)`)
+  }
+} finally {
+  await browser.close().catch(() => {})
+  // ===== 清理 =====
+  await fetch(`${ROOT}/api/workshop/agent-tools/bindings`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: ctx.agentId, nodeId: ctx.nodeId, kind: 'daq' }) }).catch(() => {})
+  await j(`/api/workshop/daq/${ctx.nodeId}`, 'DELETE').catch(() => {})
+  await j(`/api/workshop/dcw/lines/${ctx.lineId}/stop`, 'POST').catch(() => {})
+  writeFileSync('.e2e-plugin-ctx.json', JSON.stringify({ ...ctx, cleaned: true }))
+}
+
+console.log(failed === 0 ? '\nUI REALTIME PASS' : `\nUI REALTIME FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-prompts-hotreload-test.ts

@@ -0,0 +1,76 @@
+/**
+ * prompts 热重载 + 目录优先级实测(对真实 ~/.AgentWorkShop/prompts 操作,测完恢复)。
+ * 用法:npx tsx --tsconfig .nuxt/tsconfig.shared.json scripts/_dbg-prompts-hotreload-test.ts
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, utimesSync, writeFileSync } from 'node:fs'
+import { homedir, tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const homeConfigRoot = join(homedir(), '.AgentWorkShop')
+const homePrompts = join(homeConfigRoot, 'prompts')
+const TARGET = 'mode-goal.md'
+const MARKER = `HOTRELOAD-MARKER-${Date.now()}`
+const targetFile = join(homePrompts, TARGET)
+
+const proj = mkdtempSync(join(tmpdir(), 'aw-hr-proj-'))
+mkdirSync(join(proj, '.AgentWorkShop', 'prompts'), { recursive: true })
+
+const NAME = 'mode-goal' // renderPrompt 入参为 prompt 名(loader 内部拼 .md)
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures++
+}
+
+const { promptsDir, renderPrompt } = await import('@/server/services/workshop/prompts/loader')
+const bumpMtime = (file: string) => {
+  const t = new Date(Date.now() + 5)
+  utimesSync(file, t, t)
+}
+
+// ===== 场景 1:Home 兜底目录 + 修改即热重载 =====
+console.log('━━━ 场景 1:~/.AgentWorkShop/prompts(Home 兜底)+ 修改即热重载 ━━━')
+process.chdir(homedir())
+const resolved1 = promptsDir()
+check('解析到 Home prompts 目录', resolved1 === homePrompts, resolved1)
+check('目标文件存在', existsSync(targetFile))
+
+const original = readFileSync(targetFile, 'utf8')
+try {
+  const before = renderPrompt(NAME, {})
+  writeFileSync(targetFile, original + '\n' + MARKER)
+  bumpMtime(targetFile)
+  const after = renderPrompt(NAME, {})
+  check('修改后热重载(渲染含新标记,无需重启)', after.includes(MARKER) && before !== after,
+    `before=${before.length}ch after=${after.length}ch`)
+  writeFileSync(targetFile, original)
+  bumpMtime(targetFile)
+  const restored = renderPrompt(NAME, {})
+  check('恢复原文件后渲染还原', restored === before)
+}
+finally {
+  writeFileSync(targetFile, original)
+}
+
+// ===== 场景 2:项目内 ./.AgentWorkShop/prompts 优先 + 独立热重载 =====
+console.log('━━━ 场景 2:项目内 ./.AgentWorkShop/prompts 优先 ━━━')
+process.chdir(proj)
+writeFileSync(join(proj, '.AgentWorkShop', 'prompts', TARGET), 'PROJECT-LOCAL GOAT PROMPT v1')
+const resolved2 = promptsDir()
+check('解析到项目内 prompts 目录', resolved2 === join(proj, '.AgentWorkShop', 'prompts'), resolved2)
+const projV1 = renderPrompt(NAME, {})
+check('渲染取自项目文件(而非 Home)', projV1.includes('PROJECT-LOCAL GOAT PROMPT v1'))
+writeFileSync(join(proj, '.AgentWorkShop', 'prompts', TARGET), 'PROJECT-LOCAL GOAT PROMPT v2')
+bumpMtime(join(proj, '.AgentWorkShop', 'prompts', TARGET))
+const projV2 = renderPrompt(NAME, {})
+check('项目文件修改同样热重载', projV2.includes('v2') && !projV2.includes('v1'))
+
+// ===== 场景 3:双目录隔离(切回 Home 不受项目文件影响)=====
+process.chdir(homedir())
+const homeRender = renderPrompt(NAME, {})
+check('切回 Home 目录渲染不受项目文件影响', !homeRender.includes('PROJECT-LOCAL'))
+
+rmSync(proj, { recursive: true, force: true })
+console.log(failures === 0 ? '\nHOTRELOAD + PRIORITY ALL PASS' : `\n${failures} FAILED`)
+if (failures > 0) process.exit(1)