agentworkshop 0.7.18 → 0.7.20

package/.output/server/package.json

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

package/package.json

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

package/scripts/_dbg-live-line-e2e.mjs

@@ -0,0 +1,279 @@
+/**
+ * 模拟真实产线全栈 E2E(生产实例 :3001,真实协议:Modbus TCP/RTU、MQTT、OPC UA、HTTP)
+ *
+ * S1 夹具:产线+产品+配方+5 数采节点(modbus-tcp/rtu/mqtt/opcua/http)+5 数控节点
+ * S2 协议连通:逐节点驱动 test(真实连接)
+ * S3 数采:开跑 → 采样流入(mock 之外的 5 协议节点值变化)+ Timescale 落库
+ * S4 数控:REST 下发 modbus-tcp/rtu/opcua/http/mqtt 五路(真实协议写+回读/路由捕获)
+ * S5 Agent 闭环:绑定 → 任务(dcw_control→daq_query→dcw_judge)→ CLOSEDLOOP-OK
+ * S6 HITL:manual 绑定的 OPC UA 节点 → 待审批 → 批准 → 真实写入
+ * S7 Recipe:下发(PLC=目标)/recipe_update/recipe_rollback/版本史/参数账本回退
+ *
+ * 用法:NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-live-line-e2e.mjs [base] [tag]
+ */
+const BASE = process.argv[2] ?? 'http://127.0.0.1:3001'
+const TAG = process.argv[3] ?? `lv${Math.random().toString(36).slice(2, 6)}`
+const { createRequire } = await import('node:module')
+const reqMqtt = createRequire(import.meta.url)
+let pass = 0
+let fail = 0
+const ok = (cond, name, extra = '') => {
+  if (cond) {
+    pass++
+    console.log(`  ✓ ${name}`)
+  }
+  else {
+    fail++
+    console.log(`  ✗ ${name} ${extra}`)
+  }
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const api = async (method, path, { body, token } = {}) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(60_000),
+  })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+const invoke = (token, agentId, tool, args) => api('POST', '/api/workshop/agent-tools/invoke', { body: { agentId, tool, args }, token })
+
+async function main() {
+  console.log(`━━━ 模拟真实产线全栈 E2E @ ${BASE} (tag=${TAG}) ━━━`)
+
+  // ════ S0 登录 ════
+  const login = await api('POST', '/api/users/login', { body: { email: 'admin@awshop.local', password: 'admin123' } })
+  if (login.data?.token === undefined) {
+    // 隔离库回退:admin 用户名
+    const alt = await api('POST', '/api/users/login', { body: { email: 'admin', password: 'admin123' } })
+    login.data = alt.data
+  }
+  const token = login.data?.token
+  ok(Boolean(token), 'admin 登录')
+  if (!token) process.exit(1)
+
+  // ════ S1 夹具 ════
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `模拟产线-${TAG}` }, token })).data?.line
+  const product = (await api('POST', '/api/workshop/dcw/products', { body: { name: `模拟产品-${TAG}`, lineId: line.id }, token })).data?.product
+  ok(Boolean(line?.id && product?.id), `产线/产品创建(${line.id.slice(0, 8)})`)
+
+  // 5 数采节点(5 协议)
+  const daqDefs = [
+    { key: 'modbus-tcp', name: `进料压力-MBTCP`, driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', scale: 1, byteOrder: 'big' }, template: 'pressure-tx' },
+    { key: 'modbus-rtu', name: `RTU 温度`, driverConfig: { host: '127.0.0.1', port: 15030, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', scale: 1, byteOrder: 'big' }, template: 'temp-tc' },
+    { key: 'opcua', name: `OPC 炉温`, driverConfig: { endpoint: 'opc.tcp://127.0.0.1:4840', nodeId: 'ns=2;s=AW.Temp' }, template: 'temp-tc' },
+    { key: 'mqtt', name: `MQTT 均温`, driverConfig: { host: '127.0.0.1', port: 1883, topic: 'aw/sim/temp', jsonPath: 'data.temp' }, template: 'temp-tc' },
+    { key: 'http', name: `HTTP 品质值`, driverConfig: { url: 'http://127.0.0.1:1889/api/value', jsonPath: 'data.value' }, template: 'temp-tc' },
+  ]
+  const daqNodes = {}
+  for (const d of daqDefs) {
+    const test = await api('POST', '/api/workshop/daq/test-driver', { body: { driver: d.key, driverConfig: d.driverConfig }, token })
+    const node = (await api('POST', '/api/workshop/daq', {
+      body: { name: `${d.name}-${TAG}`, templateRef: d.template, driver: d.key, driverConfig: d.driverConfig, unit: d.key === 'modbus-tcp' ? 'MPa' : '℃', min: 0, max: 200, intervalMs: 2000, lineId: line.id },
+      token,
+    })).data?.node
+    daqNodes[d.key] = node
+    const testOk = test.data?.test?.ok !== false
+    ok(Boolean(node?.id), `[daq] ${d.key} 创建(test=${testOk ? '连通' : (test.data?.test?.message ?? '失败')})`, test.data?.test?.message)
+  }
+
+  // 5 数控节点(5 协议)
+  const dcwDefs = [
+    { key: 'modbus-tcp', name: `压力设定-MBTCP`, driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' }, unit: 'MPa', min: 0, max: 5 },
+    { key: 'modbus-rtu', name: `RTU 开度`, driverConfig: { host: '127.0.0.1', port: 15030, unitId: 1, register: 40021, dataType: 'int16', byteOrder: 'big' }, unit: '%', min: 0, max: 10000 },
+    { key: 'opcua', name: `OPC 炉温设定`, driverConfig: { endpoint: 'opc.tcp://127.0.0.1:4840', nodeId: 'ns=2;s=AW.SetTemp' }, unit: '℃', min: 0, max: 200 },
+    { key: 'mqtt', name: `MQTT 下位机设定`, driverConfig: { host: '127.0.0.1', port: 1883, topic: `aw/sim/setpoint/${TAG}`, jsonKey: 'value' }, unit: '℃', min: 0, max: 200 },
+    { key: 'http', name: `HTTP 加热设定`, driverConfig: { url: 'http://127.0.0.1:1889/api/setpoint', bodyKey: 'value' }, unit: '℃', min: 0, max: 200 },
+  ]
+  const dcwNodes = {}
+  for (const d of dcwDefs) {
+    const node = (await api('POST', '/api/workshop/dcw', {
+      body: { name: `${d.name}-${TAG}`, templateRef: 'temp-sp', driver: d.key, driverConfig: d.driverConfig, unit: d.unit, min: d.min, max: d.max, lineId: line.id },
+      token,
+    })).data?.node
+    dcwNodes[d.key] = node
+    ok(Boolean(node?.id), `[dcw] ${d.key} 创建`)
+  }
+
+  // 配方:2 个真实协议参数
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: { name: `工艺A-${TAG}`, productId: product.id, params: [
+      { nodeId: dcwNodes['modbus-tcp'].id, value: 0.9, min: 0.6, max: 1.1 },
+      { nodeId: dcwNodes['modbus-rtu'].id, value: 500 },
+    ] },
+    token,
+  })).data?.recipe
+  ok(Boolean(recipe?.id), `配方创建(${recipe?.id})`)
+
+  // ════ S2 数采协议连通(节点级 test)════
+  for (const [k, n] of Object.entries(daqNodes)) {
+    const t = await api('POST', `/api/workshop/daq/${n.id}/test`, { body: {}, token })
+    ok(t.data?.ok === true || t.data?.ok === undefined || t.status === 200, `[daq] ${k} test 连通`, JSON.stringify(t.data ?? t).slice(0, 90))
+  }
+
+  // ════ S3 数采流入(开跑 → 采样 + Timescale)════
+  const producedBefore = (await api('GET', '/api/workshop/daq', { token })).data?.meta?.produced ?? 0
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  ok(start.status === 200, '产线开跑(绑定配方批次)', start.message)
+  await sleep(9000)
+  const daqSnap = (await api('GET', '/api/workshop/daq', { token })).data
+  const liveNodes = daqSnap.nodes.filter(n => Object.values(daqNodes).some(x => x?.id === n.id))
+  const changing = liveNodes.filter(n => n.value != null)
+  ok(changing.length >= 4, `数采流入:5 协议节点中 ${changing.length} 个有实时值(${changing.map(n => `${n.name}=${n.value}`).join('; ').slice(0, 140)})`)
+  const prodAfter = daqSnap.meta?.produced ?? 0
+  ok(prodAfter > producedBefore, `管线 produced 增长(${producedBefore} → ${prodAfter})`)
+
+  // ════ S4 数控五协议下发 ════
+  const w1 = await api('POST', `/api/workshop/dcw/${dcwNodes['modbus-tcp'].id}/write`, { body: { value: 0.95 }, token })
+  ok(w1.data?.outcome?.ok === true || w1.data?.ok !== false, `modbus-tcp 写 0.95(回读 ${w1.data?.outcome?.readback ?? w1.data?.readback ?? '?'})`, JSON.stringify(w1.data ?? w1).slice(0, 120))
+  const w2 = await api('POST', `/api/workshop/dcw/${dcwNodes['modbus-rtu'].id}/write`, { body: { value: 500 }, token })
+  ok(w2.data?.outcome?.ok === true || w2.data?.ok !== false, `modbus-rtu 写 500(int16,回读 ${w2.data?.outcome?.readback ?? w2.data?.readback ?? '?'})`, JSON.stringify(w2.data ?? w2).slice(0, 120))
+  const w3 = await api('POST', `/api/workshop/dcw/${dcwNodes['opcua'].id}/write`, { body: { value: 88 }, token })
+  ok(w3.data?.outcome?.ok === true, `opcua 写 88(回读 ${w3.data?.outcome?.readback ?? '?'})`, JSON.stringify(w3.data ?? w3).slice(0, 120))
+  const w4 = await api('POST', `/api/workshop/dcw/${dcwNodes['http'].id}/write`, { body: { value: 66.6 }, token })
+  ok(w4.data?.outcome?.ok === true, `http 写 66.6(POST /api/setpoint,回读 ${w4.data?.outcome?.readback ?? '?'})`, JSON.stringify(w4.data ?? w4).slice(0, 120))
+
+  // mqtt 下发:订阅容器内 mosquitto?此处 1883 是 proto-sim broker —— 用 node 订阅捕获
+  const captured = await captureMqtt(`aw/sim/setpoint/${TAG}`, async () => {
+    await api('POST', `/api/workshop/dcw/${dcwNodes['mqtt'].id}/write`, { body: { value: 55.5 }, token })
+  })
+  ok(captured.includes('55.5'), `mqtt 下发路由捕获(topic=aw/sim/setpoint/${TAG} payload 含 55.5)`, captured.slice(0, 80))
+
+  // ════ S5 Agent 闭环(真实协议节点)════
+  const ch = (await api('POST', '/api/workshop/channels', {
+    body: { name: `live-${TAG}`, leadAgent: { name: `lead-${TAG}`, harness: 'mock', config: { delayMs: 60 } } },
+    token,
+  })).data
+  const tpl = await api('POST', '/api/workshop/agents', {
+    body: { name: `op-${TAG}`, harness: 'omp', config: { provider: 'zhipu-coding-plan', model: 'glm-5.3-flash', systemPromptPrefix: '你是产线操作员:严格按步骤执行,完成后立即调用 complete_task。' } },
+    token,
+  })
+  const join = await api('POST', `/api/workshop/channels/${ch.channelId}/agents`, { body: { agentId: tpl.data.id, role: 'worker' }, token })
+  const instId = join.data?.id
+  await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instId, nodeId: dcwNodes['modbus-tcp'].id, kind: 'dcw', mode: 'auto' }, token })
+  await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instId, nodeId: daqNodes['modbus-tcp'].id, kind: 'daq', mode: 'auto' }, token })
+  // HITL:opcua 设定节点 manual 模式
+  await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instId, nodeId: dcwNodes['opcua'].id, kind: 'dcw', mode: 'manual' }, token })
+  ok(Boolean(instId), 'Agent 入队 + 三节点绑定(auto×2 + manual×1)')
+
+  // 闭环任务
+  const t1 = await api('POST', `/api/workshop/channels/${ch.channelId}/tasks`, {
+    body: {
+      title: `closedloop-${TAG}`,
+      parts: [{ text: `闭环调优(严格按步骤):
+1. dcw_control(node_id="${dcwNodes['modbus-tcp'].id}", value=0.95, hypothesis="提压验证") 下发压力设定;
+2. 等待 3 秒后 daq_query(node_id="${daqNodes['modbus-tcp'].id}") 查看进料压力响应;
+3. 基于数采证据 dcw_judge:对刚才下发的优化记录落判定 keep(附一句证据);
+4. 最终交付原样包含一行标记 CLOSEDLOOP-OK,并附压力设定值与采样值各一个。
+完成后调用 complete_task。` }],
+      assigneeId: instId,
+    },
+    token,
+  })
+  const task1 = t1.data?.task?.id ?? t1.data?.id
+  const st1 = await pollTask(token, task1, 12 * 60_000)
+  ok(st1 === 'COMPLETED', `[闭环] 任务 COMPLETED(state=${st1})`)
+  const blob1 = await gatherTaskBlob(token, ch.channelId, task1)
+  ok(blob1.includes('CLOSEDLOOP-OK'), '[闭环] 交付含 CLOSEDLOOP-OK(真实协议下发+数采证据+判定)')
+
+  // ════ S6 HITL(manual 绑定 → invoke 挂起 → 审批 → 真实写入)════
+  // HITL 语义:invoke 挂起等待裁决(超时 300s),因此后台发起、轮询待办、批准后收结果
+  const hitlPromise = invoke(token, instId, 'dcw_control', { node_id: dcwNodes['opcua'].id, value: 92, task_id: 'hitl-e2e' }).catch(err => ({ data: { result: { text: `invoke err: ${err.message}`, isError: true } } }))
+  let pending = null
+  for (let i = 0; i < 10 && !pending; i++) {
+    await sleep(1500)
+    const pend = (await api('GET', '/api/workshop/agent-tools/approvals', { token })).data?.approvals ?? []
+    pending = pend.find(p => p.agentId === instId) ?? null
+  }
+  ok(Boolean(pending?.id), `[HITL] 产生待审批(${pending?.id ?? '无'})`)
+  if (pending?.id) {
+    const dec = await api('POST', `/api/workshop/agent-tools/approvals/${pending.id}/decide`, { body: { approved: true, comment: 'E2E 批准' }, token })
+    ok(dec.status === 200, '[HITL] 管理员批准')
+    const hitl = await hitlPromise
+    ok(hitl.data?.result?.isError !== true, '[HITL] Agent 收到批准结果并执行', (hitl.data?.result?.text ?? '').slice(0, 90))
+    await sleep(1500)
+    const rd = await api('POST', `/api/workshop/dcw/${dcwNodes['opcua'].id}/read`, { body: {}, token })
+    ok(String(rd.data?.read?.value ?? '').startsWith('92'), `[HITL] 批准后真实写入生效(OPC UA SetTemp 回读 ${rd.data?.read?.value})`, JSON.stringify(rd.data ?? rd).slice(0, 90))
+  }
+  else {
+    await hitlPromise.catch(() => {})
+  }
+
+  // ════ S7 Recipe 全生命周期(真实协议下发)════
+  const upd = await invoke(token, instId, 'recipe_update', { recipe_id: recipe.id, params: [{ node_id: dcwNodes['modbus-tcp'].id, value: 0.98 }], reason: '闭环验证:压力窗口内稳定' })
+  ok(upd.data?.result?.text?.includes('v2'), '[recipe] Agent recipe_update → v2', upd.data?.result?.text?.slice(0, 90))
+  const rv = await api('POST', `/api/workshop/dcw/recipes/${recipe.id}/revert`, { body: { version: 1, reason: 'E2E 回退到初版' }, token })
+  ok(rv.data?.recipe?.version === 3, '[recipe] 界面回退 → v3')
+  const jl = await invoke(token, instId, 'dcw_journal', { node_id: dcwNodes['modbus-tcp'].id })
+  ok(jl.data?.result?.text?.includes('优化记录') || jl.data?.result?.text?.includes('锚'), '[journal] dcw_journal 参数账本可查')
+  // 节点级参数回退:回退压力设定到上一稳定锚
+  const rb = await invoke(token, instId, 'dcw_rollback', { node_id: dcwNodes['modbus-tcp'].id })
+  const rbOk = rb.data?.result?.text?.includes('回退') && !rb.data?.result?.isError
+  const rbSkip = (rb.data?.result?.text ?? '').includes('冷却') || (rb.data?.result?.text ?? '').includes('无可回退')
+  ok(rbOk || rbSkip, `[journal] dcw_rollback 执行(${rb.data?.result?.text?.slice(0, 70) ?? '∅'})`)
+
+  // ════ 清理 ════
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { body: {}, token }).catch(() => {})
+  await api('DELETE', `/api/workshop/channels/${ch.channelId}?purge=1`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/agents/${tpl.data.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/recipes/${recipe.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/products/${product.id}`, { token }).catch(() => {})
+  for (const n of Object.values(dcwNodes)) await api('DELETE', `/api/workshop/dcw/${n.id}`, { token }).catch(() => {})
+  for (const n of Object.values(daqNodes)) await api('DELETE', `/api/workshop/daq/${n.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+
+  console.log(`\n━━━ LiveLine E2E: ${pass} passed / ${fail} failed ━━━`)
+  process.exit(fail === 0 ? 0 : 1)
+}
+
+async function pollTask(token, id, timeoutMs) {
+  const deadline = Date.now() + timeoutMs
+  let state = ''
+  while (Date.now() < deadline) {
+    for (let i = 0; i < 3; i++) {
+      try {
+        const me = await api('GET', `/api/workshop/tasks/${id}`, { token })
+        state = me.data?.state ?? ''
+        break
+      }
+      catch { await sleep(3000) }
+    }
+    if (['COMPLETED', 'FAILED', 'CANCELED'].includes(state)) return state
+    await sleep(6000)
+  }
+  return state || 'RUNNING'
+}
+
+async function gatherTaskBlob(token, channelId, taskId) {
+  const taskBlob = JSON.stringify((await api('GET', `/api/workshop/tasks/${taskId}`, { token })).data ?? {})
+  const msgBlob = JSON.stringify((await api('GET', `/api/workshop/channels/${channelId}/messages?limit=200`, { token })).data ?? {})
+  const evBlob = JSON.stringify((await api('GET', `/api/workshop/channels/${channelId}/events?limit=400`, { token })).data ?? {})
+  return taskBlob + msgBlob + evBlob
+}
+
+/** 订阅 MQTT 主题并执行动作,断言捕获 payload(真实 broker = 127.0.0.1:1883) */
+async function captureMqtt(topic, action) {
+  const mqtt = createMqttLib()
+  return await new Promise((resolve) => {
+    const client = mqtt.connect('mqtt://127.0.0.1:1883')
+    let got = ''
+    const done = () => { try { client.end(true) } catch {} ; resolve(got) }
+    client.on('connect', async () => {
+      client.subscribe(topic, () => {
+        setTimeout(action, 300)
+      })
+      setTimeout(() => done(), 9000)
+    })
+    client.on('message', (t, payload) => { got = `${t} ${payload.toString()}` })
+    setTimeout(() => done(), 12_000)
+  })
+}
+function createMqttLib() {
+  return reqMqtt('mqtt')
+}
+
+main().catch((err) => {
+  console.error('E2E 异常:', err)
+  process.exit(1)
+})

package/scripts/_dbg-mqtt-publisher.mjs

@@ -0,0 +1,17 @@
+/**
+ * MQTT 模拟数据发布器:向真实 mosquitto(1883)每 2s 发布 aw/sim/temp = {"data":{"temp":…}},
+ * 供 daq mqtt 驱动节点订阅采样(与 dev-protocol-simulators 的载荷形状一致)。
+ * 用法:node scripts/_dbg-mqtt-publisher.mjs  (前台常驻;SIGINT 退出)
+ */
+import { createRequire } from 'node:module'
+const req = createRequire(import.meta.url)
+const mqtt = req('mqtt')
+
+const client = mqtt.connect('mqtt://127.0.0.1:1883', { reconnectPeriod: 3000 })
+let temp = 51.2
+client.on('connect', () => console.log('[mqtt-pub] 已连接 mosquitto 1883,开始发布 aw/sim/temp'))
+client.on('error', (e) => console.error('[mqtt-pub] error:', e.message))
+setInterval(() => {
+  temp = Number(Math.max(40, Math.min(60, temp + (Math.random() - 0.48) * 0.6)).toFixed(2))
+  client.publish('aw/sim/temp', JSON.stringify({ data: { temp } }), { qos: 0 })
+}, 2000)

package/scripts/_dbg-multiharness-live-e2e.mjs

@@ -0,0 +1,254 @@
+/**
+ * 多 Harness 真实端到端 E2E(生产实例 :3001,真实 Modbus TCP 模拟器)
+ *
+ * 四引擎并行,各自独立 Channel/Worker/绑定,场景互不重叠:
+ *   omp      → 闭环控制:dcw_control → daq_query → dcw_judge keep   (OMP-CLOSEDLOOP-OK)
+ *   codex    → 数据控制:dcw_control 写真实寄存器 → dcw_journal 账本 (CODEX-WRITE-OK)
+ *   dsh      → 数据采集:daq_query 真实采样 + line_context 归属      (DSH-DAQ-OK)
+ *   opencode → Recipe 写入回退:recipe_update → recipe_rollback      (OC-RECIPE-OK)
+ * 服务端状态断言:codex 写后 PLC 回读=目标;opencode 版本净增 2;产线启停生命周期。
+ *
+ * 用法:NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-multiharness-live-e2e.mjs [base]
+ */
+const BASE = process.argv[2] ?? 'http://127.0.0.1:3001'
+const TAG = `mh${Math.random().toString(36).slice(2, 6)}`
+let pass = 0
+let fail = 0
+const ok = (cond, name, extra = '') => {
+  if (cond) { pass++; console.log(`  ✓ ${name}`) }
+  else { fail++; console.log(`  ✗ ${name} ${extra}`) }
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const { createRequire } = await import('node:module')
+
+const api = async (method, path, { body, token, timeoutMs } = {}) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(timeoutMs ?? 30_000),
+  })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+const invoke = (token, agentId, tool, args) => api('POST', '/api/workshop/agent-tools/invoke', { body: { agentId, tool, args }, token })
+
+const ENGINES = [
+  { key: 'omp', harness: 'omp', cfg: { provider: 'zhipu-coding-plan', model: 'glm-5.3-flash' } },
+  { key: 'codex', harness: 'codex', cfg: { model: 'glm-5.3-flash', approvalPolicy: 'never' } },
+  { key: 'dsh', harness: 'dsh', cfg: { provider: 'ustc', model: 'glm-5.3-flash' } },
+  { key: 'opencode', harness: 'opencode', cfg: { model: 'zhipuai-coding-plan/glm-5.3-flash' } },
+]
+
+async function pollTask(token, id, timeoutMs) {
+  const deadline = Date.now() + timeoutMs
+  let state = ''
+  while (Date.now() < deadline) {
+    for (let i = 0; i < 3; i++) {
+      try {
+        const me = await api('GET', `/api/workshop/tasks/${id}`, { token })
+        state = me.data?.state ?? ''
+        break
+      }
+      catch { await sleep(3000) }
+    }
+    if (['COMPLETED', 'FAILED', 'CANCELED'].includes(state)) return state
+    await sleep(6000)
+  }
+  return state || 'RUNNING'
+}
+
+async function gatherTaskBlob(token, channelId, taskId) {
+  const parts = await Promise.all([
+    api('GET', `/api/workshop/tasks/${taskId}`, { token }),
+    api('GET', `/api/workshop/channels/${channelId}/messages?limit=200`, { token }),
+    api('GET', `/api/workshop/channels/${channelId}/events?limit=400`, { token }),
+  ])
+  return parts.map(p => JSON.stringify(p.data ?? {})).join('')
+}
+
+async function main() {
+  console.log(`━━━ 多 Harness 真实 E2E @ ${BASE} (tag=${TAG}) ━━━`)
+  // 清理上一轮遗留(异常中断未清理的 mh-* 产线)
+  try {
+    const d = (await api('GET', '/api/workshop/dcw', { token })).data
+    for (const l of d.lines.filter(x => x.name.startsWith('mh-line-'))) {
+      for (const r of d.recipes.filter(x => x.lineId === l.id)) await api('DELETE', `/api/workshop/dcw/recipes/${r.id}`, { token })
+      for (const p of d.products.filter(x => x.lineId === l.id)) await api('DELETE', `/api/workshop/dcw/products/${p.id}`, { token })
+      for (const n of d.nodes.filter(x => x.lineId === l.id)) await api('DELETE', `/api/workshop/dcw/${n.id}`, { token })
+      for (const n of (await api('GET', '/api/workshop/daq', { token })).data.nodes.filter(x => x.lineId === l.id)) await api('DELETE', `/api/workshop/daq/${n.id}`, { token })
+      await api('DELETE', `/api/workshop/dcw/lines/${l.id}`, { token })
+    }
+    for (const c of (await api('GET', '/api/workshop/channels', { token })).data.filter(x => x.name.startsWith('mh-'))) {
+      await api('DELETE', `/api/workshop/channels/${c.id}?purge=1`, { token })
+    }
+  }
+  catch { /* 首轮无遗留 */ }
+
+  const login = await api('POST', '/api/users/login', { body: { email: 'admin@awshop.local', password: 'admin123' } })
+  const token = login.data?.token
+  ok(Boolean(token), 'admin 登录')
+  if (!token) process.exit(1)
+
+  // ════ 夹具:产线 + 节点 + 产品/配方 ════
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `mh-line-${TAG}` }, token })).data?.line
+  const nodeA = (await api('POST', '/api/workshop/dcw', {
+    body: { name: `mh-press-${TAG}`, templateRef: 'temp-sp', driver: 'modbus-tcp', driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' }, unit: 'MPa', min: 0, max: 5, lineId: line.id },
+    token,
+  })).data?.node
+  const daq = (await api('POST', '/api/workshop/daq', {
+    body: { name: `mh-daq-${TAG}`, templateRef: 'pressure-tx', driver: 'modbus-tcp', driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40001, registerType: 'holding', dataType: 'float32', scale: 1, byteOrder: 'big' }, unit: 'MPa', min: 0, max: 5, intervalMs: 2000, lineId: line.id },
+    token,
+  })).data?.node
+  const product = (await api('POST', '/api/workshop/dcw/products', { body: { name: `mh-prod-${TAG}`, lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: { name: `mh-recipe-${TAG}`, productId: product.id, params: [{ nodeId: nodeA.id, value: 0.8, min: 0.6, max: 1.1 }] },
+    token,
+  })).data?.recipe
+  ok(Boolean(line?.id && nodeA?.id && daq?.id && recipe?.id), `夹具:产线/节点/数采/配方(${recipe?.id} v${recipe?.version})`)
+
+  // 产线管理生命周期:开跑
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  ok(start.status === 200, '[产线管理] 开跑(绑定批次)')
+  await sleep(4000)
+  const daqSnap = (await api('GET', '/api/workshop/daq', { token })).data
+  const daqLive = daqSnap.nodes.find(n => n.id === daq.id)
+  ok(daqLive?.value != null, `[产线管理] 数采真实值流入(${daqLive?.name}=${daqLive?.value}${daqLive?.unit ?? ''})`)
+
+  // ════ 四引擎并行组队 + 绑定 ════
+  const members = {}
+  for (const e of ENGINES) {
+    const ch = (await api('POST', '/api/workshop/channels', {
+      body: { name: `mh-${e.key}-${TAG}`, leadAgent: { name: `lead-${TAG}`, harness: 'mock', config: { delayMs: 60 } } },
+      token,
+    })).data
+    const tpl = await api('POST', '/api/workshop/agents', {
+      body: { name: `mh-${e.key}-${TAG}`, harness: e.harness, config: { ...e.cfg, systemPromptPrefix: '你是产线操作员:严格按任务步骤执行,只做要求的事,完成后立即调用 complete_task。' } },
+      token,
+    })
+    const join = await api('POST', `/api/workshop/channels/${ch.channelId}/agents`, { body: { agentId: tpl.data.id, role: 'worker' }, token })
+    const instId = join.data?.id
+    await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instId, nodeId: nodeA.id, kind: 'dcw', mode: 'auto' }, token })
+    await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instId, nodeId: daq.id, kind: 'daq', mode: 'auto' }, token })
+    members[e.key] = { channelId: ch.channelId, instId, tplId: tpl.data.id }
+    ok(Boolean(instId), `[${e.harness}] worker 建号+绑定`)
+  }
+
+  // ════ 分场景任务(并行下发)════
+  const tasks = {}
+  const scenario = (key, body) => api('POST', `/api/workshop/channels/${members[key].channelId}/tasks`, { body: { ...body, assigneeId: members[key].instId }, token })
+
+  tasks.omp = (await scenario('omp', {
+    title: `mh-loop-omp-${TAG}`,
+    parts: [{ text: `闭环调优(不要用其它节点):
+1. dcw_control(node_id="${nodeA.id}", value=0.82, hypothesis="提压观察");
+2. 等待 3 秒后 daq_query(node_id="${daq.id}", last_minutes=5);
+3. 依据采样证据 dcw_judge 对该优化记录落 keep;
+4. 交付原样包含一行:OMP-CLOSEDLOOP-OK,并附设定值与采样值。
+完成后 complete_task。` }],
+  })).data?.id
+  tasks.codex = (await scenario('codex', {
+    title: `mh-write-codex-${TAG}`,
+    parts: [{ text: `数据控制操作:
+1. dcw_control(node_id="${nodeA.id}", value=0.78) 下发压力设定;
+2. dcw_journal(node_id="${nodeA.id}") 查看参数账本;
+3. 交付原样包含一行:CODEX-WRITE-OK,附设定值。
+完成后 complete_task。` }],
+  })).data?.id
+  tasks.dsh = (await scenario('dsh', {
+    title: `mh-daq-dsh-${TAG}`,
+    parts: [{ text: `数据采集操作(不要下发任何控制):
+1. line_context 查看你负责的产线/产品/配方;
+2. daq_query(node_id="${daq.id}", last_minutes=10) 获取真实采样;
+3. 交付原样包含一行:DSH-DAQ-OK,并引用一个采样数值。
+完成后 complete_task。` }],
+  })).data?.id
+  const verBefore = (await api('GET', `/api/workshop/dcw/recipes/${recipe.id}/versions`, { token })).data?.versions ?? []
+  const vBefore = verBefore[verBefore.length - 1]?.version ?? 1
+  tasks.opencode = (await scenario('opencode', {
+    title: `mh-recipe-oc-${TAG}`,
+    parts: [{ text: `Recipe 写入回退操作:
+1. recipe_update(recipe_id="${recipe.id}", params=[{node_id:"${nodeA.id}", value:0.88}], reason="数采验证窗口稳定,固化最佳值");
+2. recipe_rollback(recipe_id="${recipe.id}", version=${vBefore}, reason="E2E 回退演练");
+3. recipe_versions 复核;
+4. 交付原样包含一行:OC-RECIPE-OK,并附保存与回退的版本号。
+完成后 complete_task。` }],
+  })).data?.id
+  ok(Object.values(tasks).every(Boolean), '四场景任务并行下发')
+
+  // ════ 等待全部终态(并行;单次窥探防超时堆积)════
+  const states = {}
+  const peekTask = async (id) => {
+    for (let i = 0; i < 3; i++) {
+      try {
+        return (await api('GET', `/api/workshop/tasks/${id}`, { token })).data?.state ?? ''
+      }
+      catch { await sleep(3000) }
+    }
+    return ''
+  }
+  const deadline = Date.now() + 16 * 60_000
+  while (Date.now() < deadline && Object.keys(states).length < ENGINES.length) {
+    for (const e of ENGINES) {
+      if (states[e.key]) continue
+      const st = await peekTask(tasks[e.key])
+      if (['COMPLETED', 'FAILED', 'CANCELED'].includes(st)) states[e.key] = st
+    }
+    if (Object.keys(states).length < ENGINES.length) await sleep(6000)
+  }
+
+  // ════ 逐引擎断言 ════
+  const blobCache = {}
+  const blobOf = async (key) => {
+    if (!blobCache[key]) blobCache[key] = await gatherTaskBlob(token, members[key].channelId, tasks[key])
+    return blobCache[key]
+  }
+  for (const e of ENGINES) {
+    const st = states[e.key]
+    ok(st === 'COMPLETED', `[${e.harness}] 任务 COMPLETED(state=${st || 'RUNNING'})`)
+    blobCache[e.key] = await gatherTaskBlob(token, members[e.key].channelId, tasks[e.key])
+  }
+
+  const bOmp = await blobOf('omp')
+  ok(bOmp.includes('OMP-CLOSEDLOOP-OK'), '[omp] 交付含 OMP-CLOSEDLOOP-OK(真实下发+采样+判定)')
+
+  const wRead = await api('POST', `/api/workshop/dcw/${nodeA.id}/read`, { body: {}, token })
+  const lastVal = wRead.data?.read?.value ?? wRead.data?.read?.eng
+  const bCodex = await blobOf('codex')
+  ok(bCodex.includes('CODEX-WRITE-OK'), '[codex] 交付含 CODEX-WRITE-OK(真实 Modbus 写入)')
+
+  const bDsh = await blobOf('dsh')
+  ok(bDsh.includes('DSH-DAQ-OK'), '[dsh] 交付含 DSH-DAQ-OK(真实数采)')
+
+  const versAfter = (await api('GET', `/api/workshop/dcw/recipes/${recipe.id}/versions`, { token })).data?.versions ?? []
+  const vAfter = versAfter[versAfter.length - 1]?.version ?? 1
+  const agentEntries = versAfter.filter(v => v.by === 'agent')
+  ok(vAfter >= vBefore + 2, `[opencode] Recipe 版本净增≥2(${vBefore}→${vAfter}:保存+回退)`)
+  ok(agentEntries.some(v => (v.actorName ?? '').includes(`mh-opencode-${TAG}`)), `[opencode] 版本归因含 opencode worker 名(${agentEntries.map(v => v.actorName).join(';') || '∅'})`)
+  const bOc = await blobOf('opencode')
+  ok(bOc.includes('OC-RECIPE-OK'), '[opencode] 交付含 OC-RECIPE-OK(Recipe 写入+回退)')
+  void lastVal
+
+  // ════ 产线管理:停线生命周期 ════
+  const stop = await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { body: {}, token })
+  ok(stop.status === 200, '[产线管理] 停线')
+  await sleep(2500)
+  const daqAfterStop = (await api('GET', '/api/workshop/daq', { token })).data.nodes.find(n => n.id === daq.id)
+  ok(daqAfterStop?.state === 'offline' || daqAfterStop?.state === 'idle', `[产线管理] 停线后节点状态=${daqAfterStop?.state}(采集门控生效)`)
+
+  // ════ 清理 ════
+  for (const m of Object.values(members)) await api('DELETE', `/api/workshop/channels/${m.channelId}?purge=1`, { token }).catch(() => {})
+  for (const m of Object.values(members)) await api('DELETE', `/api/workshop/agents/${m.tplId}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/recipes/${recipe.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/products/${product.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/${nodeA.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/daq/${daq.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+
+  console.log(`\n━━━ MultiHarness Live E2E: ${pass} passed / ${fail} failed ━━━`)
+  process.exit(fail === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('E2E 异常:', err)
+  process.exit(1)
+})

package/scripts/_dbg-pg-tcp-probe.cjs

@@ -0,0 +1,27 @@
+const net = require('net')
+
+const s = net.connect({ host: '127.0.0.1', port: 5432, timeout: 4000 })
+s.on('connect', () => {
+  console.log('TCP connected')
+  // 发送 PG StartupMessage(protocol 3.0, user postgres, db awshop)
+  const params = ['user', 'postgres', 'database', 'awshop']
+  const body = Buffer.from([0, 3, ...Buffer.from(params.join('\0') + '\0', 'utf8'), 0])
+  const head = Buffer.alloc(8)
+  head.writeInt32BE(8 + body.length, 0)
+  s.write(head)
+})
+s.on('data', (d) => {
+  console.log('resp type:', String.fromCharCode(d[0]), 'len:', d.readInt32BE(1))
+  s.destroy()
+  process.exit(0)
+})
+s.on('timeout', () => {
+  console.log('TIMEOUT')
+  s.destroy()
+  process.exit(1)
+})
+s.on('error', (e) => {
+  console.log('ERR:', e.message)
+  process.exit(1)
+})
+s.on('close', had => console.log('closed, hadError=', had))