agentworkshop 0.2.1

package/scripts/_dbg-ws-probe.mjs

@@ -0,0 +1,86 @@
+/** 一次性:应用级 WS 连接健康探针(workshop 页 HUD 连接态)+ daq WS 双通道对照 */
+import puppeteer from 'puppeteer-core'
+
+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 token = login.data.token
+const H = { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }
+
+// 生产顺序:进数字孪生空间先 GET daq 快照(此请求同时把 WS 广播出装配到控制器)
+const daqBase = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+console.log('[daq baseline]', JSON.stringify(daqBase.data?.controller), 'nodes =', daqBase.data?.nodes?.length)
+
+// --- 对照组 A:Node 原生 WebSocket(端口 3000 直连)---
+function nodeWsProbe(durMs = 5000) {
+  return new Promise((resolve) => {
+    const sock = new WebSocket(`ws://127.0.0.1:3000/api/workshop/ws?token=${token}`)
+    const seen = { open: false, pong: false, snap: false, reading: 0, other: {} }
+    sock.onopen = () => {
+      seen.open = true
+      sock.send(JSON.stringify({ type: 'ping' }))
+    }
+    sock.onmessage = (ev) => {
+      const d = JSON.parse(String(ev.data))
+      if (d.type === 'pong') seen.pong = true
+      else if (d.type === 'channel.snapshot') seen.snap = true
+      else if (d.type === 'daq.reading') seen.reading++
+      else seen.other[d.type] = (seen.other[d.type] ?? 0) + 1
+    }
+    setTimeout(() => {
+      try { sock.close() }
+      catch {}; resolve(seen)
+    }, durMs)
+  })
+}
+
+const probeA = await nodeWsProbe()
+console.log('[probe A: node ws / no sub]', JSON.stringify(probeA))
+
+// --- 对照组 B:页面上下文开 WS(127.0.0.1 源内),sub 空频道 ---
+const chans = await fetch(`${BASE}/api/workshop/channels`, { headers: H }).then(r => r.json())
+const chanId = (chans.data ?? [])[0]?.id
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu'],
+})
+const page = await browser.newPage()
+await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded', timeout: 60000 }).catch(() => {})
+await new Promise(r => setTimeout(r, 1500))
+if (chanId) {
+  const probeB = await page.evaluate(async ({ tok, ch, durMs }) => new Promise((resolve) => {
+    const seen = { open: false, pong: false, error: '', reading: 0, snap: false, others: {} }
+    const sock = new WebSocket(`ws://127.0.0.1:3000/api/workshop/ws?token=${tok}`)
+    sock.onopen = () => { seen.open = true; sock.send(JSON.stringify({ type: 'ping' })) }
+    sock.onerror = () => { seen.error = 'socket-error' }
+    sock.onclose = (e) => { if (!seen.pong) seen.error += ` close:${e.code}` }
+    sock.onmessage = (ev) => {
+      const d = JSON.parse(String(ev.data))
+      if (d.type === 'pong') { seen.pong = true; sock.send(JSON.stringify({ type: 'sub', channelId: ch, token: tok })) }
+      else if (d.type === 'channel.snapshot') seen.snap = true
+      else if (d.type === 'daq.reading') seen.reading++
+      else seen.others[d.type] = (seen.others[d.type] ?? 0) + 1
+    }
+    setTimeout(() => {
+      try { sock.close() }
+      catch {}; resolve(seen)
+    }, durMs)
+  }), { tok: token, ch: chanId, durMs: 6000 })
+  console.log('[probe B: page ctx + sub]', JSON.stringify(probeB))
+}
+
+// --- 应用级真实连接:workshop HUD 连接状态徽标 ---
+await page.reload({ waitUntil: 'domcontentloaded' }).catch(() => {})
+await new Promise(r => setTimeout(r, 7000))
+const hud = await page.evaluate(() => {
+  const t = document.body.innerText
+  const hits = t.match(/(已连接|实时同步|重连中|已断线|同步中|在线|offline)/g)
+  return hits ? hits.slice(0, 8) : []
+})
+console.log('[workshop HUD hints]', JSON.stringify(hud))
+await browser.close()

package/scripts/_dbg-ws-shot2.mjs

@@ -0,0 +1,23 @@
+/** 一次性:workshop 工作台主页 + 频道视图截图 */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = 'ut-3b8495cf61b34bd4b3c0e02fc242fc66'
+const routes = [
+  ['workshop', '/workshop', 9000],
+  ['channel', '/workshop?channel=c-demo', 9000],
+]
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1920,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+for (const [name, path, wait] of routes) {
+  await page.goto(`http://127.0.0.1:3000${path}`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await new Promise(r => setTimeout(r, wait))
+  await page.screenshot({ path: `docs/audit/screenshots/huashu-survey2/${name}.png` })
+  console.log('shot:', name, page.url())
+}
+await browser.close()

package/scripts/_dbg-wsdot-sanity.mjs

@@ -0,0 +1,25 @@
+import puppeteer from 'puppeteer-core'
+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 OUT = 'docs/audit/screenshots/ui-polish-0831'
+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: '/' })
+const issues = []
+page.on('pageerror', (e) => issues.push(String(e).slice(0, 150)))
+await page.goto(`${BASE}/workshop`, { waitUntil: 'networkidle0', timeout: 90000 })
+await new Promise(r => setTimeout(r, 5000))
+const dot = await page.evaluate(() => {
+  const el = document.querySelector('.ws-dot')
+  if (!el) return { present: false }
+  return { present: true, cls: el.className, title: el.title }
+})
+console.log('ws-dot on /workshop:', JSON.stringify(dot))
+await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle0', timeout: 90000 })
+await new Promise(r => setTimeout(r, 5000))
+const daqErr = await page.evaluate(() => !!document.querySelector('.ant-alert, [class*=error]'))
+console.log('/daq loads, error-banner present only if error:', daqErr)
+await page.screenshot({ path: `${OUT}/final-daq-page.png` })
+console.log('page errors:', issues.length, issues.slice(0, 3))
+await browser.close()

package/scripts/_dev-stack.mjs

@@ -0,0 +1,46 @@
+/**
+ * 本地协议测试栈启动器:dev server + 4 个模拟器 + mini RTU 从站,一键拉起。
+ * 用法:node scripts/_dev-stack.mjs  (前台常驻;stop = kill 本进程树)
+ */
+import { spawn, spawnSync } from 'node:child_process'
+
+const killPort = (port) => {
+  const out = spawnSync('cmd.exe', ['/c', `netstat -ano | findstr ":${port}" | findstr "LISTENING"`]).stdout?.toString() ?? ''
+  for (const line of out.split('\n')) {
+    const pid = line.trim().split(/\s+/).pop()
+    if (pid && /^\d+$/.test(pid)) {
+      try {
+        spawnSync('taskkill', ['/PID', pid, '/T', '/F'], { shell: 'cmd.exe', stdio: 'ignore' })
+      }
+      catch { /* 已退出 */ }
+    }
+  }
+}
+
+for (const p of [3000, 1502, 4840, 1883, 1889, 15030]) killPort(p)
+
+const logs = {}
+const start = (name, cmd, args, env = {}) => {
+  const child = spawn(process.execPath, cmd, { args, env: { ...process.env, ...env }, stdio: ['ignore', 'pipe', 'pipe'] })
+  logs[name] = ''
+  const keep = (d) => {
+    logs[name] += d
+    if (logs[name].length > 8000)
+      logs[name] = logs[name].slice(-4000)
+  }
+  child.stdout.on('data', keep)
+  child.stderr.on('data', keep)
+  child.on('exit', (c) => {
+    logs[name] += `\n[exited ${c}]`
+  })
+  return child
+}
+
+start('dev', ['scripts/dev-guard.mjs', 'dev'])
+start('modbus-sim', ['scripts/dev-modbus-simulator.mjs'])
+start('opcua-sim', ['scripts/dev-opcua-simulator.mjs'])
+start('proto-sim', ['scripts/dev-protocol-simulators.mjs'])
+start('rtu-slave', ['scripts/_rtu-mini-slave.mjs'])
+
+setInterval(() => {}, 10_000)
+console.log('[dev-stack] 已启动:dev/modbus-sim/opcua-sim/proto-sim/rtu-slave')

package/scripts/_http-driver-probe.mjs

@@ -0,0 +1,30 @@
+/**
+ * HTTP 驱动真连探针:真实驱动代码路径打本地模拟器(http://127.0.0.1:1889)。
+ * 运行:npx tsx scripts/_http-driver-probe.mjs(需 dev-protocol-simulators 已启动)
+ */
+import { httpDaqDriver } from '../server/services/workshop/daq/drivers.ts'
+import { httpDcwDriver } from '../server/services/workshop/dcw/drivers.ts'
+
+// 1) 数采:GET JSON + jsonPath data.value
+const daqCfg = { url: 'http://127.0.0.1:1889/api/value', jsonPath: 'data.value' }
+const t1 = await httpDaqDriver.test(daqCfg)
+console.log('[DAQ test]', t1.ok ? 'PASS' : 'FAIL', '|', t1.message, `(${t1.latencyMs}ms)`)
+const v1 = await httpDaqDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: daqCfg })
+console.log('[DAQ sample]', v1, Number.isFinite(v1) ? 'PASS' : 'FAIL')
+
+// 2) 数控:POST 设定值 66.6(默认 {"value":66.6})
+const w = await httpDcwDriver.write({
+  driverConfig: { url: 'http://127.0.0.1:1889/api/setpoint' },
+  eng: 66.6,
+  tolerance: 0.1,
+  domain: { min: 0, max: 100 },
+})
+console.log('[DCW write]', w.ok ? 'PASS' : 'FAIL', '|', w.message, '| readback:', w.readback)
+
+// 3) test 安全语义:GET 可达即 PASS(不执行写入)
+const t2 = await httpDcwDriver.test({ url: 'http://127.0.0.1:1889/api/setpoint' })
+console.log('[DCW test]', t2.ok ? 'PASS' : 'FAIL', '|', t2.message)
+
+const all = t1.ok && Number.isFinite(v1) && w.ok && t2.ok
+console.log('=== 结果:', all ? 'HTTP 驱动真连 ALL PASS' : 'FAIL', '===')
+process.exit(all ? 0 : 1)

package/scripts/_lib-dcw-line.mjs

@@ -0,0 +1,24 @@
+/** 产线审计夹具:创建产线 → start/stop/cleanup(逐产线 API)。各 _dbg 脚本共用。 */
+
+/**
+ * 创建一条审计产线。
+ * @returns {{ line: {id: string, name: string, color: string}, start: Function, stop: Function, cleanup: Function }}
+ */
+export async function makeLineFixture(ROOT, H, name = '审计产线') {
+  const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+  const jdel = u => fetch(ROOT + u, { method: 'DELETE', headers: H }).then(r => r.json())
+  const created = await jpost('/api/workshop/dcw/lines', { name })
+  if (!created.data?.line) throw new Error(`makeLineFixture: 创建产线失败 ${JSON.stringify(created).slice(0, 120)}`)
+  const line = created.data.line
+  return {
+    line,
+    /** 开跑本产线(配方须挂本产线产品) */
+    start: recipeId => jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId }),
+    stop: () => jpost(`/api/workshop/dcw/lines/${line.id}/stop`, {}),
+    /** 停线 + 删线(节点/产品/配方自动解挂,不删数据) */
+    cleanup: async () => {
+      await jpost(`/api/workshop/dcw/lines/${line.id}/stop`, {}).catch(() => {})
+      await jdel(`/api/workshop/dcw/lines/${line.id}`)
+    },
+  }
+}

package/scripts/_mqtt-driver-probe.mjs

@@ -0,0 +1,30 @@
+/**
+ * MQTT 驱动真连探针:真实驱动代码路径打本地模拟器(mqtt://127.0.0.1:1883)。
+ * 运行:npx tsx scripts/_mqtt-driver-probe.mjs(需 dev-protocol-simulators 已启动)
+ */
+import { mqttDaqDriver } from '../server/services/workshop/daq/drivers.ts'
+import { mqttDcwDriver } from '../server/services/workshop/dcw/drivers.ts'
+
+// 1) 数采:test 连接订阅 + 读数(jsonPath data.temp)
+const daqCfg = { host: '127.0.0.1', port: Number(process.env.MQTT_PORT ?? 1883), topic: 'aw/sim/temp', jsonPath: 'data.temp' }
+const t1 = await mqttDaqDriver.test(daqCfg)
+console.log('[DAQ test]', t1.ok ? 'PASS' : 'FAIL', '|', t1.message, `(${t1.latencyMs}ms)`, '| sampleValue:', t1.sampleValue)
+const v1 = await mqttDaqDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: daqCfg })
+console.log('[DAQ sample]', v1, Number.isFinite(v1) ? 'PASS' : 'FAIL')
+
+// 2) 数控:发布设定值 55.5 到 aw/sim/setpoint(模拟器订阅并打印 = 人工/日志核验)
+const w = await mqttDcwDriver.write({
+  driverConfig: { host: '127.0.0.1', port: Number(process.env.MQTT_PORT ?? 1883), topic: 'aw/sim/setpoint', jsonKey: 'setpoint', qos: 1 },
+  eng: 55.5,
+  tolerance: 0.1,
+  domain: { min: 0, max: 100 },
+})
+console.log('[DCW publish]', w.ok ? 'PASS' : 'FAIL', '|', w.message)
+
+// 3) test 语义:Broker 可达即 PASS(不发布)
+const t2 = await mqttDcwDriver.test({ host: '127.0.0.1', port: Number(process.env.MQTT_PORT ?? 1883), topic: 'aw/sim/setpoint' })
+console.log('[DCW test]', t2.ok ? 'PASS' : 'FAIL', '|', t2.message)
+
+const all = t1.ok && Number.isFinite(v1) && w.ok && t2.ok
+console.log('=== 结果:', all ? 'MQTT 驱动真连 ALL PASS' : 'FAIL', '===')
+process.exit(all ? 0 : 1)

package/scripts/_newdriver-rest-probe.mjs

@@ -0,0 +1,100 @@
+/**
+ * 新协议全链 REST 验证:MQTT/HTTP/RTU 三种新驱动节点
+ * 创建(元数据持久化)→ 测试连接 → 实际采样数据到达(产线开跑,门控放行)。
+ * 前置:dev-protocol-simulators(1883/1889)+ _rtu-mini-slave(15030)+ DAQ 网关运行
+ * 运行:AW_PAGE_TOKEN=<token> node scripts/_newdriver-rest-probe.mjs
+ */
+const BASE = 'http://127.0.0.1:3000'
+const H = { 'authorization': `Bearer ${process.env.AW_PAGE_TOKEN ?? ''}`, 'content-type': 'application/json' }
+let pass = 0
+let fail = 0
+const ok = (cond, label) => {
+  if (cond) {
+    pass++
+    console.log(`PASS ${label}`)
+  }
+  else {
+    fail++
+    console.log(`FAIL ${label}`)
+  }
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const rand = Math.random().toString(36).slice(2, 6)
+const jpost = async (u, b) => {
+  const r = await fetch(`${BASE}${u}`, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) })
+  const j = await r.json().catch(() => ({}))
+  if (!r.ok || j.code !== 0) console.log(`  [debug] POST ${u} → ${r.status} ${JSON.stringify(j).slice(0, 160)}`)
+  return j
+}
+
+// ---- 0) 网关运行(DCW 写控制 + DAQ 采集共用开关) ----
+{
+  const r = await fetch(`${BASE}/api/workshop/dcw`, { headers: H }).then(x => x.json())
+  if (!r?.data?.controller?.running)
+    await fetch(`${BASE}/api/workshop/dcw/controller?action=resume`, { method: 'POST', headers: H }).then(x => x.json())
+  const d = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(x => x.json())
+  if (!d?.data?.controller?.running)
+    await fetch(`${BASE}/api/workshop/daq/controller`, { method: 'POST', headers: H, body: JSON.stringify({ action: 'resume' }) })
+}
+
+// ---- 1) 夹具:产线 + 数控节点 + 产品 + 配方(开跑激活采集门控) ----
+const line = (await jpost('/api/workshop/dcw/lines', { name: `新协议线-${rand}` })).data.line
+const dcwNode = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: `新协议设定-${rand}`, lineId: line.id })).data.node
+const product = (await jpost('/api/workshop/dcw/products', { lineId: line.id, name: `新协议产品-${rand}` })).data.product
+const recipe = (await jpost('/api/workshop/dcw/recipes', { productId: product.id, name: `新协议配方-${rand}`, params: [{ nodeId: dcwNode.id, value: 175 }] })).data.recipe
+const start = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: recipe.id })
+ok(start.code === 0, `产线开跑(采集门控放行)`)
+
+// ---- 2) MQTT 节点:创建 → 持久化 → test → 采样 ----
+const mqttNode = (await jpost('/api/workshop/daq', {
+  templateRef: 'daq-temp-tc',
+  name: `MQTT采集-${rand}`,
+  driver: 'mqtt',
+  driverConfig: { host: '127.0.0.1', port: 1883, topic: 'aw/sim/temp', jsonPath: 'data.temp' },
+  lineId: line.id,
+  intervalMs: 1000,
+})).data.node
+ok(!!mqttNode?.id && mqttNode.driver === 'mqtt', `MQTT 节点创建(driver=${mqttNode?.driver})`)
+const daqList = (await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())).data
+ok(daqList.nodes.some(n => n.id === mqttNode.id && n.driverConfig?.topic === 'aw/sim/temp'), 'MQTT driverConfig 持久化在册(daqs.json)')
+const mt = await fetch(`${BASE}/api/workshop/daq/${mqttNode.id}/test`, { method: 'POST', headers: H }).then(r => r.json())
+ok(mt.data?.test?.ok === true, `MQTT test 连接(${mt.data?.test?.message?.slice(0, 60)})`)
+
+// ---- 3) HTTP 节点:同链 ----
+const httpNode = (await jpost('/api/workshop/daq', {
+  templateRef: 'daq-temp-tc',
+  name: `HTTP采集-${rand}`,
+  driver: 'http',
+  driverConfig: { url: 'http://127.0.0.1:1889/api/value', jsonPath: 'data.value' },
+  lineId: line.id,
+  intervalMs: 1000,
+})).data.node
+ok(!!httpNode?.id && httpNode.driver === 'http', 'HTTP 节点创建')
+const ht = await fetch(`${BASE}/api/workshop/daq/${httpNode.id}/test`, { method: 'POST', headers: H }).then(r => r.json())
+ok(ht.data?.test?.ok === true && Number.isFinite(ht.data?.test?.sampleValue), `HTTP test 连接+取值(${ht.data?.test?.sampleValue})`)
+
+// ---- 4) RTU 节点:创建 + test(需 RTU 从站模拟器 15030) ----
+const rtuNode = (await jpost('/api/workshop/daq', {
+  templateRef: 'daq-temp-tc',
+  name: `RTU采集-${rand}`,
+  driver: 'modbus-rtu',
+  driverConfig: { host: '127.0.0.1', port: 15030, unitId: 1, register: 40001, dataType: 'uint16' },
+  lineId: line.id,
+  intervalMs: 1000,
+})).data.node
+ok(!!rtuNode?.id && rtuNode.driver === 'modbus-rtu', 'RTU 节点创建')
+const rt = await fetch(`${BASE}/api/workshop/daq/${rtuNode.id}/test`, { method: 'POST', headers: H }).then(r => r.json())
+ok(rt.data?.test?.ok === true, `RTU test 连接(${rt.data?.test?.message?.slice(0, 60)})`)
+
+// ---- 5) 实际采样到达(等 2-3 个采样周期) ----
+await sleep(3500)
+const nodesAfter = (await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())).data
+const mqttLive = nodesAfter.nodes.find(n => n.id === mqttNode.id)
+const httpLive = nodesAfter.nodes.find(n => n.id === httpNode.id)
+const rtuLive = nodesAfter.nodes.find(n => n.id === rtuNode.id)
+ok(mqttLive?.value != null && Number.isFinite(mqttLive.value), `MQTT 节点真实采样值到达(value=${mqttLive?.value})`)
+ok(httpLive?.value != null && Number.isFinite(httpLive.value), `HTTP 节点真实采样值到达(value=${httpLive?.value})`)
+ok(rtuLive?.value != null && Number.isFinite(rtuLive.value), `RTU 节点真实采样值到达(value=${rtuLive?.value})`)
+
+console.log(`\n=== 结果:${pass} PASS / ${fail} FAIL ===`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_node-state-probe.mjs

@@ -0,0 +1,5 @@
+const login = await fetch('http://127.0.0.1:3000/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}` }
+const nodes = (await fetch('http://127.0.0.1:3000/api/workshop/daq', { headers: H }).then(r => r.json())).data.nodes.filter(n => /采集-/.test(n.name))
+for (const n of nodes.slice(0, 8)) console.log(n.name.slice(0, 22), '| driver:', n.driver, '| state:', n.state, '| value:', n.value, '| enabled:', n.enabled, '| line:', (n.lineId ?? '').slice(0, 8))
+process.exit(0)

package/scripts/_opcua-driver-probe.mjs

@@ -0,0 +1,31 @@
+/**
+ * OPC UA 驱动真连探针:用真实驱动代码路径(daq opcUaDriver.test / dcw opcUaDcwDriver.write)
+ * 打真实模拟器(opc.tcp://127.0.0.1:4840,ns=2;s=AW.Temp / AW.SetTemp)。
+ * 运行:npx tsx scripts/_opcua-driver-probe.mjs(需 dev-opcua-simulator 已启动)
+ */
+import { opcUaDriver } from '../server/services/workshop/daq/drivers.ts'
+import { opcUaDcwDriver } from '../server/services/workshop/dcw/drivers.ts'
+
+const endpoint = 'opc.tcp://127.0.0.1:4840'
+const daqCfg = { endpoint, nodeId: 'ns=2;s=AW.Temp', securityMode: 'None' }
+
+// 1) 数采:test 连接 + 读数
+const t1 = await opcUaDriver.test(daqCfg)
+console.log('[DAQ test]', t1.ok ? 'PASS' : 'FAIL', '|', t1.message, `(${t1.latencyMs}ms)`)
+const v1 = await opcUaDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: daqCfg })
+console.log('[DAQ sample]', v1, Number.isFinite(v1) ? 'PASS' : 'FAIL')
+
+// 2) 数控:写 183.5 → 回读校验
+const dcwCfg = { endpoint, nodeId: 'ns=2;s=AW.SetTemp', securityMode: 'None' }
+const w = await opcUaDcwDriver.write({
+  driverConfig: dcwCfg,
+  eng: 183.5,
+  tolerance: 0.5,
+  scale: { engMin: 0, engMax: 200 },
+})
+console.log('[DCW write]', w.ok ? 'PASS' : 'FAIL', '|', w.message, '| raw:', w.raw, 'readback:', w.readback)
+const t2 = await opcUaDcwDriver.test(dcwCfg)
+console.log('[DCW test]', t2.ok ? 'PASS' : 'FAIL', '|', t2.message)
+
+console.log('=== 结果:', t1.ok && Number.isFinite(v1) && w.ok ? 'OPC UA 驱动真连 ALL PASS' : 'FAIL', '===')
+process.exit(t1.ok && Number.isFinite(v1) && w.ok ? 0 : 1)

package/scripts/_rtu-debug.mjs

@@ -0,0 +1,41 @@
+/** 一次性:RTU 从站隔离调试(手搓 FC03 应答;驱动 uint16 读) */
+import net from 'node:net'
+import { modbusRtuDriver } from '../server/services/workshop/daq/drivers.ts'
+
+const regs = new Uint16Array(100)
+regs[0] = 0x1234
+regs[1] = 0x5678
+const crc16 = (buf) => {
+  let crc = 0xffff
+  for (const b of buf) {
+    crc ^= b
+    for (let i = 0; i < 8; i++) crc = (crc & 1) ? (crc >> 1) ^ 0xa001 : crc >> 1
+  }
+  return crc
+}
+const server = net.createServer((sock) => {
+  let buf = Buffer.alloc(0)
+  sock.on('data', (d) => {
+    buf = Buffer.concat([buf, d])
+    console.log('slave recv:', buf.toString('hex'))
+    while (buf.length >= 8) {
+      const fc = buf[1]
+      if (fc === 0x03) {
+        const count = (buf[4] << 8) | buf[5]
+        const body = Buffer.from([buf[0], fc, count * 2, regs[0] >> 8, regs[0] & 0xff, regs[1] >> 8, regs[1] & 0xff])
+        const crc = Buffer.alloc(2)
+        crc.writeUInt16LE(crc16(body), 0)
+        const resp = Buffer.concat([body, crc])
+        console.log('slave resp:', resp.toString('hex'))
+        sock.write(resp)
+      }
+      buf = buf.subarray(8)
+    }
+  })
+})
+server.listen(15031, '127.0.0.1', async () => {
+  const v = await modbusRtuDriver.sample({ ctx: { nodeId: 'x', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: { host: '127.0.0.1', port: 15031, unitId: 1, register: 40001, dataType: 'uint16', byteOrder: 'big' } })
+  console.log('driver read =', v, '(expect 22136)')
+  server.close()
+  process.exit(0)
+})

package/scripts/_rtu-direct.mjs

@@ -0,0 +1,6 @@
+/** 一次性:15030 直连测试 */
+import { modbusRtuDriver } from '../server/services/workshop/daq/drivers.ts'
+
+const t = await modbusRtuDriver.test({ host: '127.0.0.1', port: 15030, unitId: 1, register: 40001, dataType: 'uint16' })
+console.log('direct test:', t.ok, '|', t.message)
+process.exit(0)

package/scripts/_rtu-driver-probe.mjs

@@ -0,0 +1,53 @@
+/**
+ * Modbus RTU over TCP 驱动真连探针:官方 ServerTCP 从站(modbus-serial 自带)
+ * + 真实驱动代码路径(daq modbusRtuDriver / dcw modbusRtuDcwDriver)全链验证。
+ * 运行:npx tsx scripts/_rtu-driver-probe.mjs
+ */
+import { createRequire } from 'node:module'
+
+import { modbusRtuDriver } from '../server/services/workshop/daq/drivers.ts'
+import { modbusRtuDcwDriver } from '../server/services/workshop/dcw/drivers.ts'
+
+const req = createRequire(process.cwd() + '/package.json')
+const { ServerTCP } = req('modbus-serial')
+
+const PORT = 15030
+// 官方 vector:holding 寄存器读写(FC03/FC06/FC10 由 ServerTCP 内部处理)
+const holding = new Map()
+const vector = {
+  getHoldingRegister: addr => holding.get(addr) ?? 0,
+  setRegister: (addr, value) => { holding.set(addr, value & 0xffff) },
+}
+
+const server = new ServerTCP(vector, { host: '127.0.0.1', port: PORT, unitID: 1 })
+console.log(`[rtu-sim] ServerTCP 从站 127.0.0.1:${PORT} 就绪`)
+
+const cfg = { host: '127.0.0.1', port: PORT, unitId: 1, register: 40001, dataType: 'float32', byteOrder: 'big' }
+
+// 数采:test + 读(初始 0)
+const t1 = await modbusRtuDriver.test(cfg)
+console.log('[DAQ test]', t1.ok ? 'PASS' : 'FAIL', '|', t1.message, `(${t1.latencyMs}ms)`)
+const v0 = await modbusRtuDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: cfg })
+console.log('[DAQ sample]', v0)
+
+// 预置寄存器值(float32 45.5 big 端 words)→ 数采读回
+holding.set(0, 0x4236)
+holding.set(1, 0x0000)
+const v1 = await modbusRtuDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: cfg })
+console.log('[DAQ sample]', v1, Math.abs(v1 - 45.5) < 0.1 ? 'PASS(读回 45.5)' : 'FAIL')
+
+// 数控:写 48.25 → ServerTCP 内部 setRegister 落 vector → 读回验证
+const w = await modbusRtuDcwDriver.write({
+  driverConfig: cfg,
+  eng: 48.25,
+  tolerance: 0.1,
+  domain: { min: 0, max: 100 },
+})
+console.log('[DCW write]', w.ok ? 'PASS' : 'FAIL', '|', w.message)
+const v2 = await modbusRtuDriver.sample({ ctx: { nodeId: 'probe', now: Date.now(), ageMs: 0 }, config: { base: 0, amp: 0, min: 0, max: 0 }, driverConfig: cfg })
+console.log('[DAQ sample after write]', v2, Math.abs(v2 - 48.25) < 0.1 ? 'PASS(写后读回一致)' : 'FAIL')
+
+server.close()
+const all = t1.ok && Math.abs(v1 - 45.5) < 0.1 && w.ok && Math.abs(v2 - 48.25) < 0.1
+console.log('=== 结果:', all ? 'Modbus RTU over TCP 驱动真连 ALL PASS' : 'FAIL', '===')
+process.exit(all ? 0 : 1)

package/scripts/_rtu-mini-slave.mjs

@@ -0,0 +1,63 @@
+/** 迷你 RTU over TCP 从站(15030):FC03/FC10 + CRC16,常驻供节点采样验证。 */
+import net from 'node:net'
+
+const regs = new Uint16Array(100)
+let flip = false
+setInterval(() => {
+  flip = !flip
+  // float32 42.5 / 44.25 交替(big 端 word 对 0x4222/0x0000 ↔ 0x4231/0x0000)
+  const v = flip ? 0x4222 : 0x4231
+  regs[0] = v >> 8
+  regs[1] = v & 0xff
+}, 800)
+regs[0] = 0x42
+regs[1] = 0x22
+
+net.createServer((sock) => {
+  let buf = Buffer.alloc(0)
+  sock.on('error', err => console.error('[rtu-mini] socket error:', err.code ?? err.message))
+  sock.on('data', (d) => {
+    buf = Buffer.concat([buf, d])
+    while (buf.length >= 7) {
+      const len = buf.readUInt16BE(4)
+      const total = 6 + len
+      if (buf.length < total) break
+      const txnId = buf.readUInt16BE(0)
+      const unitId = buf[6]
+      const fc = buf[7]
+      let respBody = null
+      if (fc === 0x03 || fc === 0x04) {
+        const start = (buf[8] << 8) | buf[9]
+        const count = (buf[10] << 8) | buf[11]
+        respBody = Buffer.alloc(3 + count * 2)
+        respBody[0] = unitId
+        respBody[1] = fc
+        respBody[2] = count * 2
+        for (let i = 0; i < count; i++) {
+          respBody[3 + i * 2] = regs[start + i] >> 8
+          respBody[4 + i * 2] = regs[start + i] & 0xff
+        }
+      }
+      else if (fc === 0x10) {
+        const start = (buf[8] << 8) | buf[9]
+        const count = (buf[10] << 8) | buf[11]
+        for (let i = 0; i < count; i++) regs[start + i] = (buf[13 + i * 2] << 8) | buf[14 + i * 2]
+        respBody = Buffer.alloc(6)
+        respBody[0] = unitId
+        respBody[1] = fc
+        respBody.writeUInt16BE(start, 2)
+        respBody.writeUInt16BE(count, 4)
+      }
+      if (respBody) {
+        // 响应 = 标准 Modbus TCP 形式(MBAP + PDU,无 CRC);
+        // TcpRTUBufferedPort 的 _emitData 会自行补 CRC 后交给事务层
+        const head = Buffer.alloc(6)
+        head.writeUInt16BE(txnId, 0)
+        head.writeUInt16BE(0, 2)
+        head.writeUInt16BE(respBody.length, 4)
+        sock.write(Buffer.concat([head, respBody]))
+      }
+      buf = buf.subarray(total)
+    }
+  })
+}).listen(15030, '127.0.0.1', () => console.log('[rtu-mini] RTU over TCP 从站 127.0.0.1:15030 就绪(FC03/FC10)'))