agentworkshop 0.7.6 → 0.7.7

package/scripts/_dbg-live-engine-probe.mjs

@@ -0,0 +1,80 @@
+/**
+ * 最小实时探针:单 worker(harness 可选)+ mock lead,注入 requireReply 消息,
+ * 全量拉取 AEP 事件(含 error/delta/status),观察引擎回合的真实行为。
+ * 运行:node scripts/_dbg-live-engine-probe.mjs codex|dsh|omp
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3000'
+const harness = process.argv[2] ?? 'dsh'
+
+const reg = await fetch(`${BASE}/api/workshop/users/register`, {
+  method: 'POST', headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ name: `probe-${harness}-${Date.now() % 100000}` }),
+}).then(r => r.json())
+const T = reg?.data?.token
+if (!T) { console.error('注册失败'); process.exit(1) }
+const api = async (method, path, body) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method, headers: { 'content-type': 'application/json', authorization: `Bearer ${T}` },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  return await res.json().catch(() => ({}))
+}
+
+const ch = await api('POST', '/api/workshop/channels', { name: `probe-${harness}`, leadAgent: { name: 'lead', harness: 'mock' } })
+const cid = ch?.data?.channelId
+const w = await api('POST', `/api/workshop/channels/${cid}/agents`, {
+  name: `w-${harness}`, harness, role: 'worker',
+  config: harness === 'codex' ? { approvalPolicy: 'on-request', sandbox: 'workspace-write' } : {},
+})
+console.log(`channel=${cid} worker=${w?.data?.id} harness=${harness}`)
+
+// 事件录制流由首个 WS 订阅触发(无订阅者不落库),故先接 WS 再触发事件
+const { createRequire } = await import('node:module')
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const { WebSocket } = createRequire(import.meta.url)('D:/codes/ABO/AgentWorkShop/node_modules/.pnpm/ws@8.21.3/node_modules/ws')
+const ws = new WebSocket(BASE.replace(/^http/, 'ws') + '/api/workshop/ws')
+ws.on('open', () => ws.send(JSON.stringify({ type: 'sub', channelId: cid, token: T })))
+ws.on('error', (e) => console.log('[ws error]', e.message))
+await sleep(1200)
+
+const seen = []
+let lastSeq = 0
+const poll = async () => {
+  const res = await api('GET', `/api/workshop/channels/${cid}/events?limit=500`)
+  for (const f of (res?.data?.items ?? [])) {
+    if (Number(f.seq ?? 0) > lastSeq) {
+      lastSeq = Number(f.seq)
+      seen.push(f)
+      const p = f.payload ?? {}
+      if (f.type === 'error') console.log(`[evt] ERROR ${p.code}: ${String(p.message ?? '').slice(0, 200)}`)
+      else if (f.type === 'a2a.message') console.log(`[evt] message ${(p.parts ?? []).map(x => x.text ?? '').join('').slice(0, 120)}`)
+      else if (f.type === 'agent.status.message') console.log(`[evt] status: ${String(p.text ?? '').slice(0, 140)}`)
+      else if (f.type === 'agent.delta') process.stdout.write('.')
+      else if (f.type === 'a2a.artifact') console.log(`[evt] artifact: ${(p.artifact?.parts ?? []).map(x => x.text ?? '').join('').slice(0, 260)}`)
+      else if (f.type === 'task.status') console.log(`[evt] task ${p.state}`)
+      else if (f.type === 'hitl.request') console.log(`[evt] HITL ${p.kind}`)
+    }
+  }
+}
+const poller = setInterval(() => { void poll().catch(() => {}) }, 1500)
+
+const m = await api('POST', `/api/workshop/channels/${cid}/messages`, {
+  toAgentId: w?.data?.id, fromLabel: '探针员', requireReply: true,
+  text: `兼容性检查:请用一句话说明你的引擎(${harness}),然后原样回复"${harness} 在线"。`,
+})
+console.log('message sent:', m.status, m?.data?.messageId?.slice(0, 8))
+
+const deadline = Date.now() + 300_000
+let replied = false
+while (Date.now() < deadline) {
+  await new Promise(r => setTimeout(r, 2000))
+  await poll()
+  replied = seen.some(f => f.type === 'a2a.message' && f.payload?.metadata?.['x-aw-in-reply-to'] === m?.data?.messageId)
+  if (replied) break
+}
+clearInterval(poller)
+console.log(replied ? '\n=== 回执已收到 ===' : '\n=== 300s 未收到回执 ===')
+const byType = {}
+for (const f of seen) byType[f.type] = (byType[f.type] ?? 0) + 1
+console.log('帧分布:', JSON.stringify(byType))
+process.exit(0)

package/scripts/_dbg-mcp-bridge-probe.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * MCP 桥探针:验证 aw-mcp-bridge.mjs 的 MCP stdio ↔ HTTP 回程转译(不依赖真实引擎)。
+ * 运行:node scripts/_dbg-mcp-bridge-probe.mjs
+ */
+import { spawn } from 'node:child_process'
+import { createServer } from 'node:http'
+import { createInterface } from 'node:readline'
+import { randomUUID } from 'node:crypto'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const BRIDGE = join(ROOT, 'server', 'harness', 'aw-mcp-bridge.mjs')
+const AGENT_ID = `a-${randomUUID().slice(0, 8)}`
+const TOKEN = `t-${randomUUID()}`
+
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const seen = { listToken: null, invokeToken: null, invokeBody: null }
+
+/** HTTP stub:模拟平台 agent-tools 面 */
+const server = createServer((req, res) => {
+  const token = req.headers['x-aw-agent-token']
+  if (req.method === 'GET' && req.url?.startsWith('/api/workshop/agent-tools/list')) {
+    seen.listToken = token
+    if (token !== TOKEN) {
+      res.writeHead(401, { 'content-type': 'application/json' })
+      res.end(JSON.stringify({ code: 401, message: 'bad token' }))
+      return
+    }
+    res.writeHead(200, { 'content-type': 'application/json' })
+    res.end(JSON.stringify({
+      code: 0,
+      data: {
+        tools: [
+          { name: 'report_progress', description: 'Report progress', parameters: { type: 'object', properties: { progress: { type: 'number' } }, required: ['progress'] } },
+          { name: 'probe_tool', description: 'Probe tool', parameters: { type: 'object', properties: { q: { type: 'string' } } } },
+        ],
+      },
+    }))
+    return
+  }
+  if (req.method === 'POST' && req.url?.startsWith('/api/workshop/agent-tools/invoke')) {
+    seen.invokeToken = token
+    let body = ''
+    req.on('data', (d) => { body += d })
+    req.on('end', () => {
+      seen.invokeBody = JSON.parse(body || '{}')
+      if (token !== TOKEN) {
+        res.writeHead(401, { 'content-type': 'application/json' })
+        res.end(JSON.stringify({ code: 401, message: 'bad token' }))
+        return
+      }
+      const tool = seen.invokeBody.tool
+      res.writeHead(200, { 'content-type': 'application/json' })
+      if (tool === 'boom') {
+        res.end(JSON.stringify({ code: 0, data: { result: { text: '模拟工具失败', isError: true } } }))
+      }
+      else {
+        res.end(JSON.stringify({ code: 0, data: { result: { text: `OK ${tool} q=${seen.invokeBody.args?.q ?? ''}` } } }))
+      }
+    })
+    return
+  }
+  res.writeHead(404)
+  res.end()
+})
+
+await new Promise((resolve) => { server.listen(0, '127.0.0.1', resolve) })
+const port = server.address().port
+
+function rpc(child, msg, timeoutMs = 10_000) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`RPC 超时: ${msg.method ?? msg.id}`)), timeoutMs)
+    const rl = child.rl
+    const onLine = (line) => {
+      try {
+        const frame = JSON.parse(line)
+        if (frame.id === msg.id) {
+          clearTimeout(timer)
+          rl.removeListener('line', onLine)
+          resolve(frame)
+        }
+      }
+      catch { /* 忽略非 JSON 行 */ }
+    }
+    rl.on('line', onLine)
+    child.stdin.write(JSON.stringify(msg) + '\n')
+  })
+}
+
+console.log('━━━ MCP 桥探针(aw-mcp-bridge.mjs)━━━')
+try {
+  const proc = spawn(process.execPath, [BRIDGE], {
+    env: { ...process.env, AW_BASE_URL: `http://127.0.0.1:${port}`, AW_AGENT_ID: AGENT_ID, AW_AGENT_TOKEN: TOKEN },
+    stdio: ['pipe', 'pipe', 'pipe'],
+  })
+  proc.rl = createInterface({ input: proc.stdout })
+  let stderr = ''
+  proc.stderr.on('data', (d) => { stderr += d })
+
+  // 1. initialize
+  const init = await rpc(proc, { jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05' } })
+  check('initialize 握手', init.result?.serverInfo?.name === 'aw-host-tools', `serverInfo=${JSON.stringify(init.result?.serverInfo)}`)
+
+  // 2. tools/list(验证 token 头与工具面透传)
+  const list = await rpc(proc, { jsonrpc: '2.0', id: 2, method: 'tools/list' })
+  const names = (list.result?.tools ?? []).map(t => t.name)
+  check('tools/list 携带 agent token', seen.listToken === TOKEN)
+  check('tools/list 透传平台工具面', names.includes('report_progress') && names.includes('probe_tool'), `names=${names.join(',')}`)
+  const probe = (list.result?.tools ?? []).find(t => t.name === 'probe_tool')
+  check('inputSchema = parameters', JSON.stringify(probe?.inputSchema ?? {}).includes('q'))
+
+  // 3. tools/call 成功路径
+  const call = await rpc(proc, { jsonrpc: '2.0', id: 3, method: 'tools/call', params: { name: 'probe_tool', arguments: { q: 'hello' } } })
+  check('tools/call 回程 HTTP', seen.invokeBody?.tool === 'probe_tool' && seen.invokeBody?.agentId === AGENT_ID)
+  check('tools/call 结果转译', call.result?.content?.[0]?.text === 'OK probe_tool q=hello', `text=${call.result?.content?.[0]?.text}`)
+  check('tools/call 携带 agent token', seen.invokeToken === TOKEN)
+
+  // 4. isError 透传
+  const boom = await rpc(proc, { jsonrpc: '2.0', id: 4, method: 'tools/call', params: { name: 'boom', arguments: {} } })
+  check('isError 透传', boom.result?.isError === true, `text=${boom.result?.content?.[0]?.text}`)
+
+  proc.kill('SIGKILL')
+}
+catch (err) {
+  check('桥进程往返', false, err.message)
+}
+
+// 5. 缺 token → 桥拒绝启动
+const bad = spawn(process.execPath, [BRIDGE], {
+  env: { ...process.env, AW_BASE_URL: `http://127.0.0.1:${port}`, AW_AGENT_ID: '', AW_AGENT_TOKEN: '' },
+  stdio: ['pipe', 'pipe', 'pipe'],
+})
+let badStderr = ''
+bad.stderr.on('data', (d) => { badStderr += d })
+const badExit = await new Promise((resolve) => { bad.on('exit', (code) => resolve(code)) })
+check('缺 AW_AGENT_ID 拒绝启动', badExit === 1, `exit=${badExit} stderr=${badStderr.trim().slice(0, 80)}`)
+
+server.close()
+console.log(failures === 0 ? '\n━━━ 全部通过 ━━━' : `\n━━━ ${failures} 项失败 ━━━`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-opencode-sse.mjs

@@ -0,0 +1,101 @@
+/**
+ * opencode serve SSE 裸探针:复现 impl 的调用形状,原样打印事件流。
+ * 运行:node scripts/_dbg-opencode-sse.mjs
+ */
+import { spawn } from 'node:child_process'
+import { randomUUID } from 'node:crypto'
+import { mkdtempSync, copyFileSync, mkdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir, tmpdir } from 'node:os'
+
+const dataDir = mkdtempSync(join(tmpdir(), 'aw-oc-data-'))
+const configDir = mkdtempSync(join(tmpdir(), 'aw-oc-cfg-'))
+mkdirSync(join(dataDir, 'opencode'), { recursive: true })
+try { copyFileSync(join(homedir(), '.local', 'share', 'opencode', 'auth.json'), join(dataDir, 'opencode', 'auth.json')) } catch (e) { console.log('auth copy fail', e.message) }
+console.log('dataDir=', dataDir)
+
+const port = 20000 + Math.floor(Math.random() * 20000)
+const pw = randomUUID()
+const child = spawn('opencode', ['serve', '--port', String(port), '--hostname', '127.0.0.1'], {
+  env: { ...process.env, OPENCODE_SERVER_PASSWORD: pw, XDG_DATA_HOME: dataDir, XDG_CONFIG_HOME: configDir },
+  stdio: ['ignore', 'pipe', 'pipe'], shell: false,
+})
+child.stderr.on('data', (d) => process.stderr.write('[err] ' + d))
+
+const auth = { headers: { authorization: `Basic ${Buffer.from(`opencode:${pw}`).toString('base64')}`, 'content-type': 'application/json' } }
+
+setTimeout(async () => {
+  // 健康探测
+  let healthy = false
+  for (let i = 0; i < 60; i++) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${port}/global/health`, { headers: { authorization: auth.headers.authorization }, signal: AbortSignal.timeout(2000) })
+      if (r.ok) { healthy = true; break }
+    }
+    catch {}
+    await new Promise(r => setTimeout(r, 500))
+  }
+  console.log('healthy=', healthy)
+  if (!healthy) process.exit(1)
+
+  // MCP 桥注册(与 impl 同形状)
+  const bridge = process.env.AW_BRIDGE_PATH ?? join(process.cwd(), 'server', 'harness', 'aw-mcp-bridge.mjs')
+  const mcpRes = await fetch(`http://127.0.0.1:${port}/mcp`, { ...auth, method: 'POST', body: JSON.stringify({
+    name: 'aw-host-tools',
+    config: { type: 'local', command: [process.execPath, bridge], environment: { AW_BASE_URL: 'http://127.0.0.1:1', AW_AGENT_ID: 'x', AW_AGENT_TOKEN: 'y' } },
+  }) })
+  console.log('mcp register:', mcpRes.status, (await mcpRes.text()).slice(0, 120))
+
+  // 建会话(带权限规则)
+  const sesRes = await fetch(`http://127.0.0.1:${port}/session`, { ...auth, method: 'POST', body: JSON.stringify({
+    title: 'probe',
+    permission: [{ permission: 'edit', action: 'ask' }, { permission: 'bash', pattern: '*', action: 'ask' }],
+  }) })
+  const ses = await sesRes.json()
+  console.log('session:', sesRes.status, JSON.stringify(ses).slice(0, 200))
+  const sid = ses.id
+
+  // 事件流
+  const es = await fetch(`http://127.0.0.1:${port}/event`, { headers: auth.headers })
+  const reader = es.body.getReader()
+  const dec = new TextDecoder()
+  let buf = ''
+  const events = []
+  ;(async () => {
+    for (;;) {
+      const { done, value } = await reader.read()
+      if (done) break
+      buf += dec.decode(value, { stream: true })
+      const parts = buf.split('\n\n'); buf = parts.pop()
+      for (const chunk of parts) for (const line of chunk.split('\n')) {
+        if (!line.startsWith('data:')) continue
+        try { events.push(JSON.parse(line.slice(5))) } catch {}
+      }
+    }
+  })()
+
+  // 投递
+  const pr = await fetch(`http://127.0.0.1:${port}/session/${sid}/prompt_async`, { ...auth, method: 'POST', body: JSON.stringify({
+    model: { providerID: 'zhipuai-coding-plan', modelID: 'glm-5.3-flash' },
+    parts: [{ type: 'text', text: 'Reply with exactly: OK' }],
+  }) })
+  console.log('prompt_async:', pr.status)
+
+  const deadline = Date.now() + 90_000
+  while (Date.now() < deadline) {
+    await new Promise(r => setTimeout(r, 1500))
+    const err = events.find(e => e.type === 'session.error')
+    const idle = events.find(e => e.type === 'session.idle')
+    if (err || idle) break
+  }
+  console.log('--- events (deduped by type) ---')
+  const seen = new Map()
+  for (const e of events) {
+    const key = e.type + ':' + (e.properties?.part?.type ?? '')
+    if (!seen.has(key)) { seen.set(key, 1); console.log(e.type, JSON.stringify(e.properties ?? {}).slice(0, 260)) }
+    else seen.set(key, seen.get(key) + 1)
+  }
+  for (const [k, n] of seen) if (n > 1) console.log(`(${k} x${n})`)
+  child.kill('SIGKILL')
+  process.exit(0)
+}, 3000)

package/scripts/_dbg-opencode-start.ts

@@ -0,0 +1,57 @@
+/**
+ * opencode impl 启动聚焦探针:复现 e2e 的 spawn+健康探测路径,逐次打印探测结果。
+ * 运行:npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-opencode-start.ts
+ */
+import { spawn as launchChildProcess } from 'node:child_process'
+import { randomUUID } from 'node:crypto'
+import { createServer } from 'node:net'
+
+async function freePort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const srv = createServer()
+    srv.unref()
+    srv.on('error', reject)
+    srv.listen(0, '127.0.0.1', () => {
+      const addr = srv.address()
+      const port = typeof addr === 'object' && addr ? addr.port : 0
+      srv.close(() => (port ? resolve(port) : reject(new Error('无可用端口'))))
+    })
+  })
+}
+
+const port = await freePort()
+const password = randomUUID()
+console.log('port=', port)
+const child = launchChildProcess('opencode', ['serve', '--port', String(port), '--hostname', '127.0.0.1'], {
+  cwd: process.cwd(),
+  env: { ...process.env, OPENCODE_SERVER_PASSWORD: password },
+  windowsHide: true,
+  shell: false,
+})
+console.log('pid=', child.pid)
+child.stdout?.on('data', (d: Buffer) => process.stdout.write(`[out] ${d}`))
+child.stderr?.on('data', (d: Buffer) => process.stderr.write(`[err] ${d}`))
+child.on('exit', code => console.log('exit', code))
+child.on('error', err => console.log('spawn error', err.message))
+
+const basic = `Basic ${Buffer.from(`opencode:${password}`).toString('base64')}`
+const deadline = Date.now() + 45_000
+let n = 0
+while (Date.now() < deadline) {
+  n++
+  try {
+    const res = await fetch(`http://127.0.0.1:${port}/global/health`, {
+      headers: { authorization: basic },
+      signal: AbortSignal.timeout(2000),
+    })
+    const text = await res.text()
+    console.log(`attempt ${n}: ${res.status} ${text.slice(0, 80)}`)
+    if (res.ok) break
+  }
+  catch (err) {
+    if (n % 10 === 0) console.log(`attempt ${n}: ${(err as Error).message}`)
+  }
+  await new Promise(r => setTimeout(r, 500))
+}
+child.kill('SIGKILL')
+process.exit(0)

package/scripts/_dbg-plugin-matrix.mjs

@@ -0,0 +1,212 @@
+/**
+ * 插件系统全链路实测:默认下沉路径(MinIO 图像帧) + 自定义模板插件安装/连接/加工验证。
+ *   NO_PROXY='*' node scripts/_dbg-plugin-matrix.mjs [--base http://127.0.0.1:3000]
+ *
+ * R-10 默认节点(默认下沉):ccd-image(mock)→ 帧落对象存储(MinIO/磁盘降级)→ /frames + content;
+ *      标量节点 Timescale 落库与 WS 已由 _dbg-protocol-matrix.mjs 覆盖。
+ * R-11 自定义插件安装:落盘 .AgentWorkShop/plugins/aw-matrix-plugin → REST enable(热重载)。
+ * R-12 插件模板节点接模拟工况:驱动(matrix-thermo→HTTP 模拟设备)→ 自定义算法(1.02x+0.5)
+ *      → 自定义处理器(matrix-derate)→ 入库/WS;断言入库值 ≈ 43.85(非原始 42.5)。
+ * R-13 Agent 工具 + 观测路由:omp 工具注册 + /api/plugins/aw-matrix-plugin/stats。
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+const TAG = Date.now().toString(36)
+
+let failures = 0
+let passed = 0
+const results = []
+const check = (id, name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${id} ${name}${detail ? ` — ${detail}` : ''}`)
+  results.push({ id, name, ok, detail })
+  ok ? passed++ : failures++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, path, { body, token } = {}, attempt = 0) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  try {
+    const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+    return { status: res.status, ...(await res.json().catch(() => ({}))) }
+  }
+  catch (err) {
+    if (attempt < 3) { await sleep(2500); return api(method, path, { body, token }, attempt + 1) }
+    throw err
+  }
+}
+
+async function main() {
+  console.log(`\n━━━ 插件系统全链路实测 @ ${BASE} (tag=${TAG}) ━━━`)
+
+  const fs = await import('node:fs')
+  const { spawnSync, spawn } = await import('node:child_process')
+  const resolve2 = (await import('node:path')).resolve
+  // preflight:dev server 自愈(外部击杀 → 清僵尸 guard → 重启,最多等 90s)
+  {
+    let ok = false
+    for (let i = 0; i < 30 && !ok; i++) {
+      try { ok = (await fetch(`${BASE}/api/health`)).status === 200 } catch { ok = false }
+      if (!ok) {
+        if (i === 0) {
+          const lockPath = resolve2('.AgentWorkShop/.runtime/aw.lock')
+          let lockPid = 0
+          try { lockPid = Number(JSON.parse(fs.readFileSync(lockPath, 'utf-8')).pid ?? 0) } catch { /* 无锁 */ }
+          if (lockPid) {
+            spawnSync('cmd', ['/c', `taskkill /F /PID ${lockPid}`])
+            try { fs.unlinkSync(lockPath) } catch { /* 无锁 */ }
+            console.log(`  [preflight] dev server 僵尸 guard(pid=${lockPid})已清,重启…`)
+            const fd = fs.openSync(resolve2('.AgentWorkShop/data/dev-server.log'), 'a')
+            const { spawn } = await import('node:child_process')
+            const child = spawn(process.execPath, ['bin/aw.mjs', 'dev'], {
+              cwd: process.cwd(), env: { ...process.env, NO_PROXY: '127.0.0.1,localhost' },
+              detached: true, stdio: ['ignore', fd, fd],
+            })
+            child.unref()
+          }
+        }
+        await sleep(3000)
+      }
+    }
+    if (!ok) throw new Error('preflight:dev server 90s 未恢复')
+  }
+  console.log('  [preflight] dev server 健康')
+
+  // preflight:模拟工况自愈(清旧持有者 → 唯一实例)
+  {
+    const net = await import('node:net')
+    const SIMS = [
+      { name: 'mqtt-http', ports: [18830, 1889], cmd: 'scripts/dev-protocol-simulators.mjs', env: { MQTT_SIM_PORT: '18830', HTTP_SIM_PORT: '1889' }, log: 'sim-mqtt-http.log' },
+      { name: 'modbus-tcp', ports: [1502], cmd: 'scripts/dev-modbus-simulator.mjs', env: {}, log: 'sim-modbus-tcp.log' },
+      { name: 'opcua', ports: [4840], cmd: 'scripts/dev-opcua-simulator.mjs', env: { OPCUA_SIM_PORT: '4840' }, log: 'sim-opcua.log' },
+      { name: 'plc', ports: [15040], cmd: 'scripts/dev-plc-simulator.mjs', env: {}, args: ['--port', '15040'], log: 'sim-plc.log' },
+      { name: 'rtu', ports: [15030], cmd: 'scripts/_rtu-mini-slave.mjs', env: {}, log: 'sim-rtu.log' },
+    ]
+    const portUp = (port) => new Promise((res) => {
+      const s = net.connect(port, '127.0.0.1')
+      const t = setTimeout(() => { s.destroy(); res(false) }, 1000)
+      s.on('connect', () => { clearTimeout(t); s.destroy(); res(true) })
+      s.on('error', () => { clearTimeout(t); res(false) })
+    })
+    for (const sim of SIMS) {
+      const owners = spawnSync('cmd', ['/c', `netstat -ano | findstr :${sim.ports[0]} | findstr LISTENING`], { encoding: 'utf-8' })
+      for (const line of (owners.stdout ?? '').split('\n')) {
+        const m = line.trim().match(/\s(\d+)\s*$/)
+        if (m) { spawnSync('cmd', ['/c', `taskkill /F /PID ${m[1]}`]); await sleep(300) }
+      }
+      const fd = fs.openSync(resolve2('.AgentWorkShop/data', sim.log), 'a')
+      const child = spawn(process.execPath, [sim.cmd, ...(sim.args ?? [])], {
+        cwd: process.cwd(), env: { ...process.env, NO_PROXY: '127.0.0.1,localhost', ...sim.env },
+        detached: true, stdio: ['ignore', fd, fd],
+      })
+      child.unref()
+      let up = false
+      for (let i = 0; i < 15 && !up; i++) { await sleep(1000); up = await portUp(sim.ports[0]) }
+      if (!up) throw new Error(`preflight:${sim.name} 拉起失败`)
+    }
+  }
+  console.log('  [preflight] 模拟工况六端口就绪')
+
+  const reg = await api('POST', '/api/users/register', {
+    body: { email: `plug-${TAG}@test.local`, password: 'Passw0rd!123', name: `plug-${TAG}` },
+  })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 200)}`)
+
+  // ═══ R-10 默认节点:图像帧默认下沉(对象存储 MinIO/磁盘) ═══
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `插件产线-${TAG}` }, token })).data?.line
+  const img = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-ccd-image', name: `视觉相机-${TAG}`, driver: 'mock', lineId: line.id, intervalMs: 700, publishIntervalMs: 0 }, token,
+  })).data?.node
+  check('R10.1', '默认节点创建(ccd-image,mock 模拟工况)', Boolean(img?.id))
+  // 配方 mock 参数节点 + 开跑(数采门控需要 active run)
+  const dwMock = (await api('POST', '/api/workshop/dcw', { body: { templateRef: 'dcw-temp-sp', name: `插件参数-${TAG}`, driver: 'mock', lineId: line.id }, token })).data?.node
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: `插件产品-${TAG}`, lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: {
+      productId: prod.id, name: `插件配方-${TAG}`,
+      params: [{ templateRef: 'dcw-temp-sp', nodeId: dwMock.id, value: 180, min: 150, max: 200 }],
+      daqWindows: [{ nodeId: img.id, min: 0, max: 255 }],
+    }, token,
+  })).data?.recipe
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  check('R10.0', '产线开跑(激活数采门控)', start.code === 0, start.message ?? '')
+  await sleep(4500)
+  const frames = await api('GET', `/api/workshop/daq/${img.id}/frames?limit=5`, { token })
+  const frameItems = frames.data?.frames ?? frames.data?.items ?? frames.data ?? []
+  check('R10.2', '图像帧落对象存储(/frames 元数据)', Array.isArray(frameItems) && frameItems.length >= 2, `frames=${Array.isArray(frameItems) ? frameItems.length : 'undefined'}`)
+  const firstFrame = Array.isArray(frameItems) ? frameItems[0] : null
+  const contentUrl = firstFrame?.contentUrl
+  const fTs = firstFrame?.ts ?? firstFrame?.at
+  if (contentUrl || fTs) {
+    const url = contentUrl ?? `/api/workshop/daq/${img.id}/frames/content?ts=${fTs}`
+    const content = await fetch(`${BASE}${url}`, { headers: { authorization: `Bearer ${token}` } })
+    const buf = await content.arrayBuffer()
+    check('R10.3', '帧内容可回源(MinIO/对象存储 GET)', content.status === 200 && buf.byteLength > 100, `status=${content.status} bytes=${buf.byteLength}`)
+  } else {
+    check('R10.3', '帧内容可回源(MinIO/对象存储 GET)', false, `无回源地址 frame=${JSON.stringify(firstFrame ?? {}).slice(0, 100)}`)
+  }
+
+  // ═══ R-11 自定义插件:安装(落盘已完成)→ 发现/启用态 ═══
+  const list0 = await api('GET', '/api/workshop/plugins', { token })
+  const plugins0 = list0.plugins ?? list0.data?.plugins ?? []
+  const mine0 = plugins0.find(p => p.name === 'aw-matrix-plugin')
+  check('R11.1', '插件被发现(plugins 列表)', Boolean(mine0), `enabled=${mine0?.enabled} 共${plugins0.length}个`)
+  if (mine0 && mine0.enabled === false) {
+    const en = await api('POST', '/api/workshop/plugins/aw-matrix-plugin/enable', { body: {}, token })
+    check('R11.2', 'REST 启用插件(热重载)', en.code === 0 || en.status === 200, en.message ?? '')
+    await sleep(3000)
+  } else {
+    check('R11.2', '插件已处于启用态(发现即装载)', true)
+  }
+  const daqList = await api('GET', '/api/workshop/daq', { token })
+  const tplItems = daqList.data?.templates ?? []
+  const mineTpl = tplItems.find(t => t.key === 'plug-matrix-profile')
+  check('R11.3', '自定义模板已注册(plug-matrix-profile)', Boolean(mineTpl), `templates=${tplItems.length}`)
+
+  // ═══ R-12 插件模板节点接模拟工况:自定义驱动+算法+处理器全链路 ═══
+  const drvTest = await api('POST', '/api/workshop/daq/test-driver', { body: { driver: 'matrix-thermo', driverConfig: {} }, token })
+  check('R12.1', '插件自定义驱动连接测试(→HTTP 模拟工况)', drvTest.data?.test?.ok === true, JSON.stringify(drvTest.data?.test ?? {}).slice(0, 100))
+  const calib = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'plug-matrix-profile', name: `插件标定-${TAG}`, driver: 'matrix-thermo', driverConfig: {}, lineId: line.id, intervalMs: 700, publishIntervalMs: 0 }, token,
+  })).data?.node
+  check('R12.2', '插件模板节点创建', Boolean(calib?.id))
+  await sleep(6000)
+  const samples = await api('GET', `/api/workshop/daq/${calib.id}/samples?bucketMs=1000`, { token })
+  const pts = samples.data?.points ?? []
+  const vals = pts.map(p => Number(Object.values(p)[1])).filter(Number.isFinite)
+  // 原始值 42.5±0.5 → 补偿后 1.02x+0.5 ≈ 43.85±1(>48 削峰不会触发)
+  const calibrated = vals.filter(v => v > 42.2 && v < 46)
+  check('R12.3', '自定义算法生效(入库=1.02×42.5+0.5≈43.85,非原始 42.5)', vals.length >= 4 && calibrated.length >= Math.floor(vals.length * 0.6),
+    `points=${pts.length} last=${vals.at(-1)} 原始恒为 42.5±0.5`)
+
+  // ═══ R-13 插件观测路由 + Agent 工具 ═══
+  const stats = await api('GET', '/api/plugins/aw-matrix-plugin/stats', { token })
+  const sbody = stats.body ?? stats.data?.body ?? stats.data ?? {}
+  check('R13.1', '插件 REST 路由(/stats)+ 钩子计数', sbody.ok === true && Number(sbody.samples) > 0,
+    `samples=${sbody.samples} frames=${sbody.frames} last=${sbody.lastValue}`)
+  const tools = await api('GET', '/api/workshop/plugins', { token })
+  const mineNow = (tools.plugins ?? tools.data?.plugins ?? []).find(p => p.name === 'aw-matrix-plugin')
+  check('R13.2', '插件管理面可见(启用态)', Boolean(mineNow?.enabled), `enabled=${mineNow?.enabled}`)
+
+  // ═══ 清理 ═══
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/daq/${img.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/daq/${calib.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/${dwMock.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+
+  console.log(`\n━━━ 插件矩阵结果: ${passed} passed / ${failures} failed ━━━`)
+  if (failures) {
+    console.log('失败项:')
+    for (const r of results.filter(x => !x.ok)) console.log(`  ${r.id} ${r.name} — ${r.detail}`)
+  }
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err)
+  process.exit(1)
+})