agentworkshop 0.7.1 → 0.7.3

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop-prod",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "private": true,
   "dependencies": {

package/app/pages/daq/index.vue

@@ -354,6 +354,8 @@ const rowLabel: Record<RowState, string> = {
 function statePillOf(n: DaqNodeView): { key: RowState, label: string, tip: string } {
   const s = rowStateOf(n)
   if (s === 'offline') {
+    // 采样失败优先透出分类错误(连接/超时/PLC 异常 + 处理提示);无错误才给通用提示
+    if (n.lastError) return { key: s, label: rowLabel.offline, tip: n.lastError }
     const tip = !daq.controller.running
       ? tt('daq.k1gateoff140')
       : tt('daq.k1staled129', { p0: Math.round(Math.max((n.intervalMs ?? daq.controller.defaultIntervalMs) * 4, 12_000) / 1000) })

package/config.yml

@@ -10,7 +10,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.1
+  version: 0.7.3
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "PolyForm-Noncommercial-1.0.0",

package/scripts/_dbg-plc-agent-loop.ts

@@ -0,0 +1,102 @@
+/**
+ * Agent × 数采 × 数控 全闭环真机验证(进程内平台 + 真实 Modbus 接线):
+ * 完整产线运营流(建线/产品/配方,开跑后配方参数经真实 Modbus 写入)。
+ * Agent 工具闭环:dcw_read 取证,dcw_control 调温,数采 PV 跟随收敛,daq_query 取证序列。
+ * 数据目录 AW_HOME 隔离;PLC 模拟器为本脚本子进程(15041)。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-plc-agent-loop.ts
+ */
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { startPlcSim } from './_lib-plc-sim-child.mjs'
+
+const awHome = mkdtempSync(join(tmpdir(), 'aw-plc-loop-'))
+process.env.AW_MODE = 'home'
+process.env.AW_HOME = awHome
+process.env.NO_PROXY = '127.0.0.1,localhost'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+const sleep = (ms: number) => new Promise(r => setTimeout(r, ms))
+
+// ===== 启动 PLC 模拟器(子进程,固定端口) =====
+const PLC_PORT = 15041
+const sim = startPlcSim(PLC_PORT)
+const simReady = await sim.ready
+check('PLC 模拟器就绪(15041)', simReady)
+
+// ===== 平台装配(隔离配置根;真实产线运营流) =====
+const { getDcwController } = await import('../server/services/workshop/dcw/dcw-controller')
+const { getDaqController } = await import('../server/services/workshop/daq/daq-controller')
+const { bindDaqHost } = await import('../server/services/workshop/daq/host-bindings')
+const { getAgentNodeBindingRepo } = await import('../server/services/workshop/agents/node-bindings.repo')
+
+// 数采网关的宿主端口(WS 广播 + 产线运行门控)由 REST 路由绑定;harness 无路由,手动绑定
+bindDaqHost(() => {})
+
+const AGENT = 'agent-plc-loop'
+const dcw = getDcwController()
+const daq = getDaqController()
+
+const line = dcw.createLine({ name: 'PLC 闭环验证线' })
+const product = dcw.createProduct({ name: '闭环验证产品', lineId: line.id })
+const mbSp = { host: '127.0.0.1', port: PLC_PORT, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' }
+const mbPv = { host: '127.0.0.1', port: PLC_PORT, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', byteOrder: 'big' }
+const spNode = dcw.create({ templateRef: 'dcw-temp-sp', name: '烘箱温度设定', driver: 'modbus-tcp', driverConfig: mbSp, min: 0, max: 300, lineId: line.id })
+const pvNode = daq.create({ templateRef: 'daq-temp-tc', name: '烘箱温度PV', driver: 'modbus-tcp', driverConfig: mbPv, lineId: line.id })
+const recipe = dcw.createRecipe({ productId: product.id, name: 'A-闭环工艺', params: [{ nodeId: spNode.id, value: 160, min: 100, max: 200 }], daqWindows: [{ nodeId: pvNode.id, min: 0, max: 400 }] })
+const repo = getAgentNodeBindingRepo()
+repo.bind(AGENT, spNode.id, 'dcw', 'auto')
+repo.bind(AGENT, pvNode.id, 'daq', 'auto')
+console.log(`line=${line.id} sp=${spNode.id} pv=${pvNode.id}\n`)
+
+// ===== ① 开跑:配方参数 160 经真实 Modbus 写入 =====
+const run = await dcw.lineStart(line.id, recipe.id)
+const spResult = run.results.find(r => r.nodeId === spNode.id)
+check('①开跑下发配方参数(160 → 真实 PLC,回读一致)', spResult?.ok === true, spResult?.message.slice(0, 80))
+
+// ===== ② Agent 闭环:观察 PV 收敛 → 调温 → 复核 =====
+const { OmpRpcAgentImpl } = await import('../server/services/workshop/agents/omp-agent')
+const impl = new OmpRpcAgentImpl({ agentId: AGENT, name: '闭环调控员', role: 'worker', channelId: 'ch-plc-loop' })
+;(impl as unknown as { workspace: unknown }).workspace = { listAgents: async () => [] }
+const handle = (impl as unknown as Record<string, (req: unknown) => Promise<{ text: string, isError?: boolean }>>).handleHostTool.bind(impl)
+
+const pvOf = (): number | null => daq.byId(pvNode.id)?.value ?? null
+let pv = pvOf()
+const t0 = Date.now()
+while ((pv == null || pv < 120) && Date.now() - t0 < 90_000) {
+  await sleep(3000)
+  pv = pvOf()
+}
+check('②开跑后 PV 向 160 收敛(越过 120℃)', pv != null && pv > 120, `PV=${pv} 耗时=${Math.round((Date.now() - t0) / 1000)}s`)
+
+const r1 = await handle({ toolName: 'dcw_read', arguments: { node_id: spNode.id } })
+check('③dcw_read 取证:ACT ≈ 配方设定 160', !r1.isError && /160/.test(r1.text) && /一致/.test(r1.text), r1.text.replace(/\n/g, ' ').slice(0, 110))
+
+const w = await handle({ toolName: 'dcw_control', arguments: { node_id: spNode.id, value: 180, hypothesis: '提温 20℃ 预期 PV 跟随上升,60s 后复测' } })
+check('④Agent 联锁内调温 180(开优化记录)', !w.isError && /下发成功/.test(w.text), w.text.replace(/\n/g, ' ').slice(0, 110))
+
+let pv2: number | null = null
+const t1 = Date.now()
+while (Date.now() - t1 < 120_000) {
+  await sleep(4000)
+  pv2 = pvOf()
+  if (pv2 != null && pv2 >= 172) break
+}
+check('⑤调温后 PV 跟随收敛 ≥172℃(真实闭环)', pv2 != null && pv2 >= 172, `PV=${pv2} 耗时=${Math.round((Date.now() - t1) / 1000)}s`)
+
+const r2 = await handle({ toolName: 'dcw_read', arguments: { node_id: spNode.id } })
+check('⑥dcw_read 复核:ACT=180 与 SET 一致', !r2.isError && /180/.test(r2.text) && /一致/.test(r2.text), r2.text.replace(/\n/g, ' ').slice(0, 110))
+
+const q = await handle({ toolName: 'daq_query', arguments: { node_id: pvNode.id, last_minutes: 5 } })
+check('⑦daq_query 取证序列含 PV 数据', !q.isError && /(avg|min|max|样本|latest|最近)/i.test(q.text), q.text.replace(/\n/g, ' ').slice(0, 110))
+
+const deny = await handle({ toolName: 'dcw_control', arguments: { node_id: spNode.id, value: 350 } })
+check('⑧越量程调温被拒(350 ∉ [0,300])', deny.isError === true && /越出|量程/.test(deny.text))
+
+sim.kill()
+console.log(failures === 0 ? '\nPLC-AGENT-LOOP ALL PASS' : `\nPLC-AGENT-LOOP FAILED(${failures})`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-plc-e2e.mjs

@@ -0,0 +1,171 @@
+/**
+ * PLC 真实场景端到端(数采 × 数控闭环;HTTP 面,打真实 dev server):
+ * 自管 PLC 工艺模拟器(dev-plc-simulator,15040)→
+ *   ①数采节点(温度PV 40001)挂运行产线 → 采样流入(基线≈环境温度)
+ *   ②数控节点(温度SP 40021)REST 下发 170℃ → PLC 写入 + 同址回读一致
+ *   ③闭环收敛:数采 PV 跟随爬升并稳态落在 SP 容差内(真实 Modbus 双向走线)
+ *   ④数控周期读 ACT 收敛 = SET;写历史/运维留痕可查
+ * 运行: node scripts/_dbg-plc-e2e.mjs(CLEANUP=1 清理测试节点)
+ */
+import { spawn } from 'node:child_process'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const CLEANUP = process.env.CLEANUP === '1'
+const PORT = Number(process.env.PLC_PORT ?? 15040)
+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++ }
+
+// ===== 启动 PLC 模拟器(子进程;结束即杀) =====
+const sim = spawn(process.execPath, ['scripts/dev-plc-simulator.mjs', '--port', String(PORT)], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true })
+let simLog = ''
+sim.stdout.on('data', d => { simLog += String(d) })
+sim.stderr.on('data', d => { simLog += String(d) })
+await new Promise((resolve) => {
+  const t = setTimeout(resolve, 8000)
+  sim.stdout.on('data', (d) => { if (String(d).includes('就绪')) { clearTimeout(t); resolve() } })
+})
+check('PLC 模拟器就绪(15040)', simLog.includes('就绪'), simLog.split('\n')[0])
+
+process.on('exit', () => { try { sim.kill() } catch {} })
+
+// ===== 登录 + 运行产线 =====
+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 = async (u, m = 'GET', b, attempt = 0) => {
+  try {
+    return await fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined, signal: AbortSignal.timeout(30_000) }).then(r => r.json())
+  }
+  catch (err) {
+    if (attempt >= 2) throw err
+    await sleep(1500)
+    return j(u, m, b, attempt + 1)
+  }
+}
+
+const dcwData = (await j('/api/workshop/dcw')).data
+const running = dcwData.lineStates?.find(s => s.active)
+if (!running) {
+  const cand = dcwData.lines.map(l => ({ line: l, recipe: dcwData.recipes.find(r => r.lineId === l.id) })).find(x => x.recipe)
+  await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+  check('运行产线(自动开跑)', true, cand.line.name)
+}
+else check('运行产线在跑', true, `${running.recipeName} @ line ${running.lineId}`)
+const lineId = running?.lineId ?? (await j('/api/workshop/dcw')).data.lineStates.find(s => s.active)?.lineId
+
+// ===== 幂等清理 + 建节点 =====
+const extraNodes = []
+for (const n of (await j('/api/workshop/daq')).data.nodes.filter(n => n.name?.startsWith('PLC闭环·'))) await j(`/api/workshop/daq/${n.id}`, 'DELETE')
+for (const n of (await j('/api/workshop/dcw')).data.nodes.filter(n => n.name?.startsWith('PLC闭环·'))) await j(`/api/workshop/dcw/${n.id}`, 'DELETE')
+
+const mb = { host: '127.0.0.1', port: PORT, unitId: 1 }
+const daqNode = (await j('/api/workshop/daq', 'POST', {
+  templateRef: 'daq-temp-tc', name: 'PLC闭环·温度PV', driver: 'modbus-tcp', lineId,
+  driverConfig: { ...mb, register: 40001, registerType: 'holding', dataType: 'float32', byteOrder: 'big' },
+})).data.node
+const dcwNode = (await j('/api/workshop/dcw', 'POST', {
+  templateRef: 'dcw-temp-sp', name: 'PLC闭环·温度SP', driver: 'modbus-tcp', lineId, min: 0, max: 300, readIntervalMs: 1000,
+  driverConfig: { ...mb, register: 40021, dataType: 'float32', byteOrder: 'big' },
+})).data.node
+check('①数采 PV 节点 + 数控 SP 节点建立', !!daqNode?.id && !!dcwNode?.id, `${daqNode?.id} / ${dcwNode?.id}`)
+
+const daqValue = async () => ((await j('/api/workshop/daq')).data.nodes.find(n => n.id === daqNode.id))?.value ?? null
+const dcwView = async () => (await j('/api/workshop/dcw')).data.nodes.find(n => n.id === dcwNode.id)
+const write = (id, value) => j(`/api/workshop/dcw/${id}/write`, 'POST', { value }).then((r) => {
+  if (!r.data?.outcome) console.log('  [debug] write envelope:', JSON.stringify(r).slice(0, 200))
+  return r.data?.outcome ?? { ok: false, message: r.message ?? 'unknown' }
+})
+const read = id => j(`/api/workshop/dcw/${id}/read`, 'POST', {}).then(r => r.data?.read ?? { ok: false, value: null, message: r.message ?? 'unknown' })
+
+try {
+  // ===== ① 基线:SP=0 → 工艺处于冷却态(PV 远低于目标,且采样在流入) =====
+  let baseline = null
+  let prev = null
+  let flowing = false
+  for (let i = 0; i < 25; i++) {
+    await sleep(2000)
+    baseline = await daqValue().catch(() => null)
+    if (baseline != null && prev != null && baseline !== prev) flowing = true
+    prev = baseline
+    if (baseline != null && flowing) break
+  }
+  check('②基线:冷却态 PV<35℃ 且采样持续流入', baseline != null && baseline < 35 && flowing, `PV=${baseline}`)
+
+  // ===== ② 数控下发 170(真实 Modbus 写 + 同址回读) =====
+  const wResp = await j(`/api/workshop/dcw/${dcwNode.id}/write`, 'POST', { value: 170 })
+  if (!wResp.data?.outcome) console.log('  [debug] write envelope:', JSON.stringify(wResp).slice(0, 220))
+  const w = wResp.data.outcome
+  check('③数控下发 170℃(写+回读一致)', w.ok === true, w.message.slice(0, 70))
+
+  // ===== ③ 闭环收敛:PV 爬升并稳态(斜率 5℃/s + τ 8s → 90s 内收敛) =====
+  const t0 = Date.now()
+  let crossed = false
+  let settled = null
+  while (Date.now() - t0 < 150_000) {
+    await sleep(3000)
+    const v = await daqValue()
+    if (v != null && v > 150 && !crossed) crossed = true
+    if (crossed && Math.abs(v - 170) <= 4) { settled = v; break }
+  }
+  check('④闭环收敛:PV 越过 150℃(跟随 SP)', crossed)
+  check('④PV 稳态落在 170±4℃(真实工艺闭环)', settled != null, `settled=${settled} 耗时=${Math.round((Date.now() - t0) / 1000)}s`)
+
+  // ===== ④ 数控周期读 ACT 收敛;写历史留痕 =====
+  const v = await dcwView()
+  check('⑤数控周期读 ACT ≈ SET(170±2)', v.readValue != null && Math.abs(v.readValue - 170) <= 2 && v.lastReadAt != null, `ACT=${v.readValue} SET=${v.value}`)
+  const writes = (await j(`/api/workshop/dcw/${dcwNode.id}/param-ledger`)).data?.ledger
+  check('⑤下发留痕可查(param-ledger/写历史)', !!writes)
+
+  // ===== ⑥ 标定换算节点(scale=10):物理量 = 10 × PLC 值 =====
+  const cal = (await j('/api/workshop/dcw', 'POST', {
+    templateRef: 'dcw-temp-sp', name: 'PLC闭环·标定×10', driver: 'modbus-tcp', readIntervalMs: 0,
+    min: 0, max: 3000, transform: { kind: 'linear', scale: 10, offset: 0 },
+    driverConfig: { host: '127.0.0.1', port: PORT, unitId: 1, register: 40023, dataType: 'float32', byteOrder: 'big' },
+  })).data.node
+  extraNodes.push(cal.id)
+  const cw = await write(cal.id, 160)
+  check('⑥标定节点:物理 160 → PLC 16 写入+回读一致', cw.ok === true, cw.message.slice(0, 80))
+  const cr = await read(cal.id)
+  check('⑥标定节点:读回 PLC 16 → 解码 160 工程量', cr.ok && Math.abs(cr.value - 160) < 0.01, `value=${cr.value} raw=${cr.raw}`)
+
+  // ===== ⑦ 错误反馈:连接失败分类文案 =====
+  const dead = (await j('/api/workshop/dcw', 'POST', {
+    templateRef: 'dcw-temp-sp', name: 'PLC闭环·故障注入', driver: 'modbus-tcp', readIntervalMs: 0, min: 0, max: 300,
+    driverConfig: { host: '127.0.0.1', port: 15199, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' },
+  })).data.node
+  extraNodes.push(dead.id)
+  const t = await j(`/api/workshop/dcw/${dead.id}/test`, 'POST').then(r => r.data.test)
+  check('⑦连接失败:测试连接给出可操作诊断', t.ok === false && /(无法建立连接|连接失败|端口)/.test(t.message), t.message.slice(0, 90))
+  const dw = await write(dead.id, 170)
+  check('⑦下发失败:连接类错误文案 + 处理提示', dw.ok === false && /(无法建立连接|超时|通信|连接)/.test(dw.message), dw.message.slice(0, 90))
+  const dr = await read(dead.id)
+  check('⑦读取失败:连接类错误文案', dr.ok === false && /(无法建立连接|超时|读取失败)/.test(dr.message), dr.message.slice(0, 90))
+
+  // DAQ 侧采样失败:lastError 分类文案落到节点视图(API 可查)
+  const deadDaq = (await j('/api/workshop/daq', 'POST', {
+    templateRef: 'daq-temp-tc', name: 'PLC闭环·故障DAQ', driver: 'modbus-tcp', lineId,
+    driverConfig: { host: '127.0.0.1', port: 15199, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', byteOrder: 'big' },
+  })).data.node
+  await sleep(4000)
+  const deadView = (await j('/api/workshop/daq')).data.nodes.find(n => n.id === deadDaq.id)
+  check('⑦DAQ 采样失败:offline + 分类错误透出', deadView.state === 'offline' && !!deadView.lastError && /(无法建立连接|超时|连接)/.test(deadView.lastError), (deadView.lastError ?? '').slice(0, 80))
+
+  // ===== ⑧ 越量程:400 + 量程详情(安全联锁语义) =====
+  const range = await j(`/api/workshop/dcw/${dcwNode.id}/write`, 'POST', { value: 999 })
+  check('⑧越量程下发:400 + 量程详情', range.code === 'VALIDATION_ERROR' && /量程/.test(range.message), range.message.slice(0, 90))
+}
+finally {
+  if (CLEANUP) {
+    for (const id of extraNodes) await j(`/api/workshop/dcw/${id}`, 'DELETE').catch(() => {})
+    await j(`/api/workshop/daq/${daqNode.id}`, 'DELETE').catch(() => {})
+    await j(`/api/workshop/dcw/${dcwNode.id}`, 'DELETE').catch(() => {})
+    const deadDaqId = (await j('/api/workshop/daq')).data.nodes.find(n => n.name === 'PLC闭环·故障DAQ')?.id
+    if (deadDaqId) await j(`/api/workshop/daq/${deadDaqId}`, 'DELETE').catch(() => {})
+    console.log('(cleanup:测试节点已删)')
+  }
+  else console.log(`(节点保留:${daqNode.id} / ${dcwNode.id} / +${extraNodes.length};CLEANUP=1 可清理)`)
+  sim.kill()
+}
+
+console.log(failed === 0 ? '\nPLC-E2E ALL PASS' : `\nPLC-E2E FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_lib-plc-sim-child.mjs

@@ -0,0 +1,28 @@
+/**
+ * PLC 模拟器子进程启动助手(供验证脚本复用)。
+ * 启动 scripts/dev-plc-simulator.mjs 并等待「就绪」;返回句柄与 kill()。
+ */
+import { spawn } from 'node:child_process'
+
+export function startPlcSim(port) {
+  const sim = spawn(process.execPath, ['scripts/dev-plc-simulator.mjs', '--port', String(port)], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true })
+  const ready = new Promise((resolve) => {
+    const t = setTimeout(() => resolve(false), 8000)
+    sim.stdout.on('data', (d) => {
+      if (String(d).includes('就绪')) {
+        clearTimeout(t)
+        resolve(true)
+      }
+    })
+    sim.stderr.on('data', () => {})
+  })
+  return {
+    ready,
+    kill: () => {
+      try {
+        sim.kill()
+      }
+      catch { /* 已退出 */ }
+    },
+  }
+}

package/scripts/dev-plc-simulator.mjs

@@ -0,0 +1,139 @@
+/**
+ * PLC 工艺过程模拟器 —— 真实场景接入用(Modbus TCP 从站,modbus-serial ServerTCP)。
+ *
+ * 仿真对象:涂布产线烘干单元。与「只摆寄存器」的演示从站不同,本模拟器带工艺动力学:
+ *   - 过程值 PV 对设定值 SP 呈一阶惯性响应(PV' = PV + (SP−PV)·(1−e^(−dt/τ)) + 噪声)
+ *   - SP 变更按斜率限制爬升(驱动/加热器执行器速率)——真实 PLC 变频器语义
+ *   - 停机(线圈0=false)时 PV 自由衰减;环境温度慢漂移
+ *   - 状态字 40011(uint16):bit0 运行 / bit1 加热中 / bit2 报警(温度偏差 >12℃)
+ *
+ * 寄存器布局(float32 大端,4xxxx 保持寄存器,协议偏移 = 地址 − 40001):
+ *   40001 温度PV  40003 速度PV  40005 张力PV   40011 状态字(uint16)   40031 环境温度
+ *   40021 温度SP  40023 速度SP  40025 张力SP(可写)
+ *   线圈: 0=运行使能(on)  1=加热使能(on)
+ *
+ * 设计:工艺状态 = JS 数值(每 tick 刷新进字数组);Modbus 写只改 SP 字并解包回状态。
+ * 运行: node scripts/dev-plc-simulator.mjs [--port 15040]
+ */
+import ModbusRTU from 'modbus-serial'
+
+const args = process.argv.slice(2)
+const portIx = args.indexOf('--port')
+const PORT = portIx >= 0 ? Number(args[portIx + 1]) : 15040
+
+// ---- 字镜像(协议偏移 → uint16;与 dev-modbus-simulator 同构的数组载体) ----
+const HOLDING = new Array(100).fill(0)
+const COILS = [true, true] // 0=运行使能 1=加热使能
+
+// ---- 工艺回路(τ 一阶时间常数;rate 执行器斜率/秒;sigma 过程噪声) ----
+const CIRCUITS = [
+  { name: '温度', pvOff: 0, spOff: 20, pv: 0, sp: 0, ramped: 0, tau: 8, rate: 5, sigma: 0.25 },
+  { name: '速度', pvOff: 2, spOff: 22, pv: 0, sp: 0, ramped: 0, tau: 4, rate: 8, sigma: 0.6 },
+  { name: '张力', pvOff: 4, spOff: 24, pv: 0, sp: 0, ramped: 0, tau: 6, rate: 3, sigma: 0.15 },
+]
+const DT_MS = 500
+const AMBIENT = 24 + Math.random() * 3
+CIRCUITS[0].pv = AMBIENT
+
+const wordsOf = (v) => {
+  const b = Buffer.alloc(4)
+  b.writeFloatBE(Number.isFinite(v) ? v : 0, 0)
+  return [b.readUInt16BE(0), b.readUInt16BE(2)]
+}
+const valOf = (off) => {
+  const b = Buffer.alloc(4)
+  b.writeUInt16BE(HOLDING[off] ?? 0, 0)
+  b.writeUInt16BE(HOLDING[off + 1] ?? 0, 2)
+  return b.readFloatBE(0)
+}
+
+// 初始化:SP=0;温度 PV 从环境温度起步
+for (const c of CIRCUITS) {
+  const [hi, lo] = wordsOf(c.sp)
+  HOLDING[c.spOff] = hi
+  HOLDING[c.spOff + 1] = lo
+}
+{
+  const [hi, lo] = wordsOf(CIRCUITS[0].pv)
+  HOLDING[0] = hi
+  HOLDING[1] = lo
+}
+
+const ramped = new Map(CIRCUITS.map(c => [c.name, 0]))
+let ambient = AMBIENT
+let tickN = 0
+let statusWord = 1
+
+function step() {
+  const dt = DT_MS / 1000
+  tickN++
+  ambient = AMBIENT + Math.sin(tickN / 600) * 1.2
+  const run = COILS[0]
+  const heat = COILS[1]
+  for (const c of CIRCUITS) {
+    // 执行器斜率限制(设定值爬坡)
+    const target = run ? c.sp : 0
+    const r = ramped.get(c.name)
+    if (Math.abs(target - r) <= c.rate * dt) ramped.set(c.name, target)
+    else ramped.set(c.name, r + Math.sign(target - r) * c.rate * dt)
+    // 加热线圈断开 → 温度回路失去能量,目标回落环境温度
+    const eff = c.name === '温度' && !heat ? ambient : ramped.get(c.name)
+    // 一阶惯性 + 过程噪声
+    const gain = 1 - Math.exp(-dt / c.tau)
+    const noise = (Math.random() - 0.5) * 2 * c.sigma * Math.sqrt(dt * 2)
+    c.pv = Math.max(-50, c.pv + (eff - c.pv) * gain + noise)
+    const [hi, lo] = wordsOf(c.pv)
+    HOLDING[c.pvOff] = hi
+    HOLDING[c.pvOff + 1] = lo
+  }
+  const t = CIRCUITS[0]
+  statusWord = (run ? 1 : 0) | (heat && t.sp - t.pv > 0.5 ? 2 : 0) | (run && Math.abs(t.sp - t.pv) > 12 ? 4 : 0)
+  HOLDING[40011 - 40001] = statusWord
+  const [ah, al] = wordsOf(ambient)
+  HOLDING[40031 - 40001] = ah
+  HOLDING[40031 - 40001 + 1] = al
+}
+setInterval(step, DT_MS)
+
+// ---- SP 写入 → 解包回工艺状态(下次 step 以新 SP 爬坡) ----
+const CIRCUIT_SP = new Map([[20, CIRCUITS[0]], [22, CIRCUITS[1]], [24, CIRCUITS[2]]])
+function resyncPair(off) {
+  const c = CIRCUIT_SP.get(off)
+  if (c) {
+    c.sp = valOf(off)
+    console.log(`[plc] WRITE ${c.name}SP ${40001 + off} ← ${c.sp.toFixed(3)}`)
+  }
+}
+
+// ---- Modbus 从站载体(与 dev-modbus-simulator 同构) ----
+const vector = {
+  getHoldingRegister: addr => HOLDING[addr] ?? 0,
+  getMultipleHoldingRegisters: (addr, length) => HOLDING.slice(addr, addr + length),
+  setRegister: (addr, value) => {
+    console.log(`[plc:dbg] setRegister addr=${addr} value=${value} → HOLDING[${addr}]=${value & 0xFFFF}`)
+    HOLDING[addr] = value & 0xFFFF
+    resyncPair(addr)
+    resyncPair(addr - 1) // 本字可能是某 SP 对的低位字
+  },
+  setMultipleRegisters: (addr, values) => {
+    for (let i = 0; i < values.length; i++) HOLDING[addr + i] = values[i] & 0xFFFF
+    resyncPair(addr)
+  },
+  readCoils: () => COILS.slice(),
+  readDiscreteInputs: () => new Array(16).fill(false),
+  readInputRegisters: (addr, length) => HOLDING.slice(addr, addr + length),
+  writeCoil: (addr, value) => { COILS[addr] = value },
+  writeMultipleCoils: () => {},
+}
+
+const server = new ModbusRTU.ServerTCP(vector, { host: '0.0.0.0', port: PORT, debug: false })
+server.on('initialized', () => {
+  console.log(`[plc] 烘干单元模拟器就绪 pid=${process.pid} 0.0.0.0:${PORT} unitId=1`)
+  console.log(`[plc] 回路: ${CIRCUITS.map(c => `${c.name}(PV 4${40001 + c.pvOff}/SP 4${40021 + c.spOff - 20},τ=${c.tau}s,rate=${c.rate}/s)`).join(' | ')}`)
+  console.log(`[plc] 环境温度 ${AMBIENT.toFixed(1)}℃ · 线圈 0=运行(on) 1=加热(on)`)
+})
+server.on('socket', () => {})
+process.on('SIGINT', () => {
+  server.close(() => process.exit(0))
+  setTimeout(() => process.exit(0), 500)
+})

package/server/api/plugins/[name]/[...path].ts

@@ -2,6 +2,7 @@
  * /api/plugins/:name/** —— 插件自注册 API 的转发层(exact-match)。
  * 插件经 ctx.route(method, path, handler) 注册;handler(event) 返回值由 nitro 序列化。
  * 鉴权由插件自行处理(v1 不强制;可经 resolveUser 复用业务鉴权)。
+ * 错误隔离:插件 handler 抛错 → 结构化日志(带插件归属)+ 干净 500 信封,不裸传堆栈。
  */
 import { defineEventHandler, createError, readBody } from 'h3'
 import { getPluginHost } from '@/server/services/workshop/plugins/host.mjs'
@@ -18,5 +19,13 @@ export default defineEventHandler(async (event) => {
   // 预读 body 挂到 event(插件 handler 无 h3 导入能力,经 event.awBody 消费)
   const awBody = await readBody(event).catch(() => undefined)
   ;(event as Record<string, unknown>).awBody = awBody
-  return handler(event)
+  try {
+    return await handler(event)
+  }
+  catch (err) {
+    // 问题日志:插件归属 + 路由 + 原始原因(运维按 name 即可定位到具体插件目录)
+    const reason = err instanceof Error ? err.message : String(err)
+    host.logger?.error?.(`插件路由处理失败 [${name}] ${event.method} /api/plugins/${name}${path}: ${reason}`)
+    throw createError({ statusCode: 500, statusMessage: `插件路由处理失败(${name}): ${reason}` })
+  }
 })