agentworkshop 0.7.41 → 0.7.46

package/scripts/_audit/detached-instance.mjs

@@ -0,0 +1,112 @@
+/**
+ * 把 AgentWorkShop 以**真分离**方式拉起(dev 或 start),用于真实 E2E 的长跑服务。
+ *
+ * 为什么不用 agent 工具的后台作业:回合结束/回收时会连子进程一起终止,
+ * 表现为「日志停在半路、无 fatal、端口释放、退出码 1」,极易误判成服务崩溃。
+ *
+ * 为什么带隔离:`ensureDataDir()` 在 repo 模式下解析到 `.AgentWorkShop/data`
+ * (线上累积数据)。E2E 必须用**全新 AW_HOME**(home 模式),否则会污染真实库,
+ * 也会读到历史脏数据导致断言随机失败。
+ *
+ * 用法:
+ *   node scripts/_audit/detached-instance.mjs --port 3457 [--mode dev|start] [--home <dir>]
+ *   node scripts/_audit/detached-instance.mjs --port 3457 --status
+ *   node scripts/_audit/detached-instance.mjs --port 3457 --stop
+ */
+import { spawn, spawnSync } from 'node:child_process'
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const arg = (k, d) => {
+  const i = process.argv.indexOf(k)
+  return i >= 0 ? process.argv[i + 1] : d
+}
+const repo = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
+const PORT = Number(arg('--port', '3457'))
+const MODE = arg('--mode', 'dev')
+const HOME = resolve(arg('--home', join(repo, '.e2e-home')))
+const LOG = resolve(arg('--log', join(repo, `.e2e-${MODE}-${PORT}.log`)))
+const PIDFILE = `${LOG}.pid`
+const BASE = `http://127.0.0.1:${PORT}`
+
+const health = async () => {
+  try {
+    const r = await fetch(`${BASE}/api/health`, { signal: AbortSignal.timeout(8000) })
+    const j = await r.json()
+    return j?.data?.status === 'ok' ? { ok: true, version: j.data.version, uptimeMs: j.data.uptimeMs } : { ok: false }
+  }
+  catch { return { ok: false } }
+}
+
+if (process.argv.includes('--status')) {
+  const h = await health()
+  console.log(h.ok ? `✔ 健康 version=${h.version} uptime=${Math.round(h.uptimeMs / 1000)}s` : '✖ 不可达')
+  const pid = existsSync(PIDFILE) ? readFileSync(PIDFILE, 'utf8').trim() : '(无 pid 文件)'
+  console.log(`  pid=${pid}  log=${LOG}  AW_HOME=${HOME}`)
+  if (existsSync(LOG)) {
+    const tail = readFileSync(LOG, 'utf8').split(/\r?\n/).filter(Boolean).slice(-8)
+    for (const l of tail) console.log('    ' + l.slice(0, 160))
+  }
+  process.exitCode = h.ok ? 0 : 1
+}
+else if (process.argv.includes('--stop')) {
+  const pid = existsSync(PIDFILE) ? Number(readFileSync(PIDFILE, 'utf8').trim()) : NaN
+  if (Number.isInteger(pid)) {
+    const r = spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore' })
+    console.log(r.status === 0 ? `✔ 已终止 pid=${pid}` : `· taskkill 退出码 ${r.status}(可能已退出)`)
+  }
+  else console.log('· 无 pid 文件')
+}
+else {
+  const pre = await health()
+  if (pre.ok) {
+    console.log(`· ${BASE} 已有健康实例(version=${pre.version}),不重复启动`)
+  }
+  else {
+    mkdirSync(HOME, { recursive: true })
+    const out = openSync(LOG, 'a')
+    // 本机 7890 代理会拦 localhost;AW_MODE=home + AW_HOME 指向全新目录 = 完全隔离
+    const env = {
+      ...process.env,
+      NO_PROXY: '127.0.0.1,localhost',
+      HTTP_PROXY: '',
+      HTTPS_PROXY: '',
+      no_proxy: '127.0.0.1,localhost',
+      AW_MODE: 'home',
+      AW_HOME: HOME,
+      NUXT_SESSION_PASSWORD: process.env.NUXT_SESSION_PASSWORD ?? 'e2e-session-password-0123456789abcdef',
+    }
+    const args = [join(repo, 'bin', 'aw.mjs'), MODE, '--port', String(PORT)]
+    const child = spawn(process.execPath, args, { cwd: repo, env, detached: true, windowsHide: true, stdio: ['ignore', out, out] })
+    closeSync(out)
+    child.unref()
+    writeFileSync(PIDFILE, String(child.pid), 'utf8')
+    console.log(`✔ 已分离启动(${MODE}) pid=${child.pid} → ${BASE}`)
+    console.log(`  AW_HOME=${HOME}`)
+    console.log(`  日志 ${LOG}`)
+
+    const waitS = Number(arg('--wait', MODE === 'dev' ? '180' : '60'))
+    let ok = false
+    for (let i = 0; i < waitS; i += 3) {
+      await new Promise(r => setTimeout(r, 3000))
+      const h = await health()
+      if (h.ok) {
+        console.log(`✔ 健康门通过 version=${h.version}(${i + 3}s)`)
+        ok = true
+        break
+      }
+    }
+    if (!ok) {
+      console.error(`✖ ${waitS}s 内未通过健康门,看日志:${LOG}`)
+      if (existsSync(LOG)) {
+        const tail = readFileSync(LOG, 'utf8').split(/\r?\n/).filter(Boolean).slice(-15)
+        for (const l of tail) console.error('    ' + l.slice(0, 160))
+      }
+      process.exitCode = 1
+    }
+    else if (existsSync(LOG)) {
+      console.log(`  日志大小 ${(statSync(LOG).size / 1024).toFixed(1)} KB`)
+    }
+  }
+}

package/scripts/_audit/stubs/nuxt-imports.mjs

@@ -0,0 +1,67 @@
+/**
+ * Nuxt `#imports` 测试桩 —— 纯 node / tsx 环境下加载 server 侧源码时使用
+ * (无 Nuxt 运行时,`#imports` 这个虚拟模块在 Node ESM 里不可解析)。
+ *
+ * 只实现 server 侧真正用到的 `useRuntimeConfig()`:取值来自**共享配置引擎**
+ * (shared/config/engine.mjs,config.yml 的单一事实来源),映射口径与
+ * nuxt.config.ts 的 `runtimeConfig` 逐键一致 —— 回归脚本看到的配置与真实
+ * Nitro 运行期同源,不引入第二套默认值。
+ *
+ * 仅用于脚本/回归;真实运行始终走 Nuxt → Nitro。挂在 scripts/_audit/ts-resolve-hook.mjs 上。
+ */
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve as pathResolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findUp, loadEffective, settingsPathFor } from '../../../shared/config/engine.mjs'
+
+const REPO = pathResolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..')
+
+/** 定位配置根(含 config.yml 的目录;优先 cwd 向上,再回落仓库根) */
+function configRoot() {
+  try {
+    const hit = findUp(process.cwd(), 'config.yml')
+    if (hit) return dirname(hit)
+  }
+  catch { /* 继续 */ }
+  return existsSync(join(REPO, 'config.yml')) ? REPO : process.cwd()
+}
+
+/** 等价于 Nuxt 的 useRuntimeConfig()(public + 服务端专用键) */
+export function useRuntimeConfig() {
+  const root = configRoot()
+  const settings = settingsPathFor(root)
+  const { effective } = loadEffective({
+    configPath: join(root, 'config.yml'),
+    settingsPath: existsSync(settings) ? settings : undefined,
+  })
+  const get = (key, fallback) => (effective[key] !== undefined ? effective[key] : fallback)
+
+  return {
+    apiPageSize: get('api.pageSize', 20),
+    apiMaxPageSize: get('api.maxPageSize', 100),
+    session: { password: get('security.sessionPassword', '') },
+    approvalGate: get('security.approvalGate', false),
+    daq: {
+      startInfrastructure: get('daq.startInfrastructure', 'auto'),
+      mqtt: { host: get('daq.mqtt.host', '127.0.0.1'), port: get('daq.mqtt.port', 1883) },
+      timescale: { host: get('daq.timescale.host', '127.0.0.1'), port: get('daq.timescale.port', 5432) },
+    },
+    public: {
+      appName: get('app.name', 'AgentWorkShop'),
+      appTitle: get('app.title', 'AgentWorkShop'),
+      version: get('app.version', '0.0.0'),
+      description: get('app.description', ''),
+      mode: get('mode', 'dev'),
+      apiBase: get('api.baseURL', '/api'),
+      apiTimeout: get('api.timeout', 15_000),
+      primaryColor: get('theme.primaryColor', '#35e0a0'),
+      themeMode: get('theme.mode', 'light'),
+      serverHost: get('server.host', '0.0.0.0'),
+      devPort: get('server.dev.port', 3000),
+      prodPort: get('server.prod.port', 3001),
+      defaultLocale: get('i18n.defaultLocale', 'zh-CN'),
+    },
+  }
+}
+
+export default { useRuntimeConfig }

package/scripts/_audit/ts-register-hook.mjs

@@ -0,0 +1,12 @@
+/**
+ * `--import` 入口:把 TS 解析钩子注册为 Node ESM loader。
+ *
+ * 用途:纯 node 直接运行 server 侧 .ts 回归脚本(Node 24 内建类型擦除):
+ *   node --import ./scripts/_audit/ts-register-hook.mjs scripts/<suite>.ts
+ *
+ * 与 `register(new URL('./ts-resolve-hook.mjs', ...))` 的 .mjs 包装脚本等价;
+ * 单独成文件是为了让 `--import`(只执行、不注册)也能生效,避免钩子被注册两次。
+ */
+import { register } from 'node:module'
+
+register(new URL('./ts-resolve-hook.mjs', import.meta.url).href)

package/scripts/_audit/ts-resolve-hook.mjs

@@ -16,7 +16,7 @@
  *
  * TS 语法本身由 Node 24 内建的类型擦除处理(strip-types),本钩子只解决"找得到文件"。
  */
-import { existsSync } from 'node:fs'
+import { existsSync, statSync } from 'node:fs'
 import { dirname, resolve as pathResolve } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 
@@ -31,12 +31,12 @@ const ALIASES = [
 
 const SUFFIXES = ['', '.ts', '.mts', '.js', '.mjs', '.cjs', '/index.ts', '/index.mts', '/index.js', '/index.mjs']
 
-/** 逐后缀试探,命中返回 file: URL,否则 null */
+/** 逐后缀试探(必须是**文件** —— 目录命中会让 Node 在 load 阶段 EISDIR),命中返回 file: URL */
 function probe(absBase) {
   for (const suffix of SUFFIXES) {
     const candidate = absBase + suffix
     try {
-      if (existsSync(candidate)) return pathToFileURL(candidate).href
+      if (existsSync(candidate) && statSync(candidate).isFile()) return pathToFileURL(candidate).href
     }
     catch { /* 非法路径字符等忽略 */ }
   }
@@ -47,7 +47,23 @@ function isPathLike(spec) {
   return spec.startsWith('.') || spec.startsWith('/') || /^[A-Za-z]:[\\/]/.test(spec)
 }
 
+/** 目录判定(不存在/不可读 → false) */
+function isDirectory(abs) {
+  try {
+    return statSync(abs).isDirectory()
+  }
+  catch {
+    return false
+  }
+}
+
 export async function resolve(specifier, context, nextResolve) {
+  // ⓪ Nuxt 虚拟模块 #imports → 测试桩(纯 node 无 Nuxt 运行时;
+  //    桩内 useRuntimeConfig 走共享配置引擎,与 nuxt.config runtimeConfig 同源)
+  if (specifier === '#imports' || specifier.startsWith('#imports/')) {
+    const stub = pathToFileURL(pathResolve(REPO, 'scripts/_audit/stubs/nuxt-imports.mjs')).href
+    return { url: stub, shortCircuit: true }
+  }
   // ① 别名:@/x → <repo>/x,#shared/x → <repo>/shared/x
   for (const [prefix, target] of ALIASES) {
     if (!specifier.startsWith(prefix)) continue
@@ -55,11 +71,14 @@ export async function resolve(specifier, context, nextResolve) {
     if (hit) return { url: hit, shortCircuit: true }
   }
   // ② 路径式且缺扩展名:先自己补
+  //    (目录形态同样要探 —— `import '../db/database'` 指向目录时 Node 直接抛
+  //     ERR_UNSUPPORTED_DIR_IMPORT,不会落到下面的兜底分支)
   if (isPathLike(specifier)) {
     const abs = specifier.startsWith('/') || /^[A-Za-z]:[\\/]/.test(specifier)
       ? specifier
       : pathResolve(context.parentURL ? dirname(fileURLToPath(context.parentURL)) : process.cwd(), specifier)
-    if (!existsSync(abs)) {
+    const needsProbe = !existsSync(abs) || isDirectory(abs)
+    if (needsProbe) {
       const hit = probe(abs)
       if (hit) return { url: hit, shortCircuit: true }
     }
@@ -68,7 +87,8 @@ export async function resolve(specifier, context, nextResolve) {
     return await nextResolve(specifier, context)
   }
   catch (err) {
-    if (err?.code !== 'ERR_MODULE_NOT_FOUND' || !isPathLike(specifier) || !context.parentURL) throw err
+    if (err?.code !== 'ERR_MODULE_NOT_FOUND' && err?.code !== 'ERR_UNSUPPORTED_DIR_IMPORT') throw err
+    if (!isPathLike(specifier) || !context.parentURL) throw err
     const hit = probe(pathResolve(dirname(fileURLToPath(context.parentURL)), specifier))
     if (hit) return { url: hit, shortCircuit: true }
     throw err

package/scripts/_audit/watchdog-recovery-test.mjs

@@ -30,11 +30,28 @@ const WAIT_MS = Number(arg('wait', 150_000))
 const INTERRUPT_MS = Number(arg('interrupt', 1500))
 
 let TOKEN = null
+const VERBOSE = process.env.WD_VERBOSE === '1'
 const api = async (method, path, { body } = {}) => {
   const headers = { 'content-type': 'application/json' }
   if (TOKEN) headers.authorization = `Bearer ${TOKEN}`
-  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
-  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+  const payload = body !== undefined ? JSON.stringify(body) : undefined
+  // 本机回环偶发代理 churn/慢响应:8 次退避重试吸收(与 api-live 同策略),避免套件死于瞬断
+  let lastErr
+  for (let attempt = 1; attempt <= 8; attempt++) {
+    const t0 = Date.now()
+    try {
+      const res = await fetch(`${BASE}${path}`, { method, headers, body: payload, signal: AbortSignal.timeout(30_000) })
+      const json = await res.json().catch(() => ({}))
+      if (VERBOSE) console.log(`    [api ${method} ${path} ${res.status} ${Date.now() - t0}ms]`)
+      return { status: res.status, ...json }
+    }
+    catch (err) {
+      lastErr = err
+      if (VERBOSE) console.log(`    [api ${method} ${path} FAILED ${Date.now() - t0}ms ${err.message} (attempt ${attempt})]`)
+      if (attempt < 8) await new Promise(r => setTimeout(r, Math.min(800 * 2 ** (attempt - 1), 8000)))
+    }
+  }
+  throw lastErr
 }
 const data = r => r?.data ?? {}
 const sleep = ms => new Promise(r => setTimeout(r, ms))
@@ -43,6 +60,11 @@ let fail = 0
 const check = (n, ok, d = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${n}${d ? `  — ${d}` : ''}`); ok ? pass++ : fail++ }
 
 TOKEN = data(await api('POST', '/api/users/login', { body: { email: 'plant@awshop.local', password: 'Plant!2026' } })).token
+if (!TOKEN) {
+  // 共享实例上固定账号可能不存在:现场注册(遗留注册,admin 位已在则得普通用户,套件自建夹具够用)
+  const reg = data(await api('POST', '/api/workshop/users/register', { body: { name: 'wd-e2e-' + Math.random().toString(36).slice(2, 8) } }))
+  TOKEN = reg.token
+}
 if (!TOKEN) { console.error('✖ 登录失败'); process.exitCode = 2; throw new Error('login') }
 
 const cfg = data(await api('GET', '/api/system/settings'))

package/scripts/_dbg-comm-verify.mjs

@@ -0,0 +1,188 @@
+/**
+ * 通信系统洁净重启全链路验证(真 omp 引擎)
+ *  T1 mock 任务执行  T2 omp 任务执行
+ *  A1 agent→agent a2a 回执  A2 跨频道 lead→lead
+ *  H1 人类→lead 回执  H2 人类→worker 直发(@)回执
+ *  W1 WS 实时延迟 + seq 单调  W2 断线→lastSeq 重连补发(IM 离线语义)
+ * 运行: node scripts/_dbg-comm-verify.mjs
+ */
+const BASE = 'http://127.0.0.1:3001'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const login = await fetch(BASE + '/api/users/login', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }) }).then(r => r.json())
+const TOKEN = login.data.token
+const H = { 'content-type': 'application/json', authorization: `Bearer ${TOKEN}` }
+const api = async (m, p, b) => (await fetch(BASE + p, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined })).json().catch(() => ({}))
+let pass = 0, fail = 0
+const check = (n, ok, d = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${n}${d ? ` — ${d}` : ''}`); ok ? pass++ : fail++ }
+const textOf = m => (m.parts ?? []).map(p => p.text ?? '').join('')
+const tag = 'cv' + Math.random().toString(36).slice(2, 6)
+
+// ── 建队:主频道(调度+甲 omp+乙 mock)+ 分站(omp lead) ──
+const chA = (await api('POST', '/api/workshop/channels', { name: `通信实验室-${tag}` })).data
+const CH = chA?.channelId ?? chA?.id
+const lead = (await api('POST', '/api/workshop/agents', { name: `调度-${tag}`, harness: 'omp', config: { intro: '调度', systemPromptPrefix: '你是频道调度。中文简短回应。' } })).data
+const wJia = (await api('POST', '/api/workshop/agents', { name: `甲-${tag}`, harness: 'omp', config: { intro: '执行', systemPromptPrefix: '你是成员甲。执行收到的指令,回复保持一句话。中文。' } })).data
+const wYi = (await api('POST', '/api/workshop/agents', { name: `乙-${tag}`, harness: 'mock', config: { delayMs: 300 } })).data
+const team = (await api('POST', '/api/workshop/teams', { name: `通信剧组-${tag}` })).data
+const teamId = team.id ?? team?.team?.id
+for (const [id, role] of [[lead.id, 'lead'], [wJia.id, 'worker'], [wYi.id, 'worker']]) {
+  await api('POST', `/api/workshop/teams/${teamId}/members`, { agentId: id, role })
+}
+await api('POST', `/api/workshop/teams/${teamId}/deploy`, { channelId: CH })
+const inst = (await api('GET', `/api/workshop/channels/${CH}/agents`)).data ?? []
+const L = inst.find(a => a.role === 'lead')
+const JIA = inst.find(a => a.name.includes('甲'))
+const YI = inst.find(a => a.name.includes('乙'))
+console.log(`CH=${CH} lead=${L.id.slice(0, 8)} 甲(omp)=${JIA.id.slice(0, 8)} 乙(mock)=${YI.id.slice(0, 8)}`)
+
+const chB = (await api('POST', '/api/workshop/channels', { name: `分站-${tag}` })).data
+const CHB = chB?.channelId ?? chB?.id
+const leadB = (await api('POST', '/api/workshop/agents', { name: `分站调度-${tag}`, harness: 'omp', config: { intro: '分站', systemPromptPrefix: '你是分站调度。中文一句话回应。' } })).data
+const teamB = (await api('POST', '/api/workshop/teams', { name: `分站剧组-${tag}` })).data
+await api('POST', `/api/workshop/teams/${teamB.id ?? teamB?.team?.id}/members`, { agentId: leadB.id, role: 'lead' })
+await api('POST', `/api/workshop/teams/${teamB.id ?? teamB?.team?.id}/deploy`, { channelId: CHB })
+
+// ═══ T1 mock 任务 ═══
+console.log('━━ T1 mock 任务 ━━')
+const t1 = await api('POST', `/api/workshop/channels/${CH}/tasks`, { title: 'T1-乙速算', parts: [{ text: '1+1 等于几' }], assigneeId: YI.id })
+const t1id = t1.data?.id ?? t1.data?.task?.id
+let t1s = ''
+const d1 = Date.now() + 120000
+while (Date.now() < d1) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/tasks`)
+  const arr = Array.isArray(j.data) ? j.data : j.data?.tasks ?? []
+  t1s = arr.find(x => x.id === t1id)?.state ?? ''
+  if (['COMPLETED', 'FAILED', 'CANCELED'].includes(t1s)) break
+  await sleep(3000)
+}
+check('T1 mock 任务执行无误', t1s === 'COMPLETED', `state=${t1s}`)
+
+// ═══ A1 agent→agent a2a(甲→乙 requireReply;乙 mock 秒回) ═══
+console.log('━━ A1 甲→乙 a2a 回执 ━━')
+// 甲 omp 收到消息后会经 host 工具回信;这里直接驱动乙侧:给乙投递一条要求回复的消息,以甲身份
+const a1 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: YI.id, fromAgentId: JIA.id, text: '乙,报一下你的当前状态。', priority: 'immediate', requireReply: true })
+check('A1 受理', a1.code === 0)
+let a1reply = null
+const da1 = Date.now() + 120000
+while (Date.now() < da1 && !a1reply) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/messages?limit=20`)
+  const arr = j.data?.messages ?? j.data ?? []
+  a1reply = (Array.isArray(arr) ? arr : []).find(m => m.metadata?.['x-aw-in-reply-to'] === a1.data.messageId)
+  if (!a1reply) await sleep(4000)
+}
+check('A1 乙回甲(in_reply_to 关联)', !!a1reply, a1reply ? textOf(a1reply).slice(0, 50) : '')
+
+// ═══ T2 omp 任务 ═══
+console.log('━━ T2 omp 任务 ━━')
+const t2 = await api('POST', `/api/workshop/channels/${CH}/tasks`, { title: 'T2-甲真执行', parts: [{ text: '请只回复一行:执行完毕。' }], assigneeId: JIA.id, mode: 'goal', modeConfig: { goalCriteria: '已输出一行执行完毕' } })
+const t2id = t2.data?.id ?? t2.data?.task?.id
+let t2s = ''
+const d2 = Date.now() + 300000
+while (Date.now() < d2) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/tasks`)
+  const arr = Array.isArray(j.data) ? j.data : j.data?.tasks ?? []
+  t2s = arr.find(x => x.id === t2id)?.state ?? ''
+  if (['COMPLETED', 'FAILED', 'CANCELED'].includes(t2s)) break
+  await sleep(6000)
+}
+check('T2 omp 任务执行无误', t2s === 'COMPLETED', `state=${t2s}`)
+
+// ═══ H1 人类→lead 回执(修复链验证) ═══
+console.log('━━ H1 人类→lead requireReply ━━')
+const h1 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: L.id, text: '调度,回一句:通信正常。', fromLabel: '馆长', priority: 'immediate', requireReply: true })
+let h1reply = null
+const dh1 = Date.now() + 600000
+while (Date.now() < dh1 && !h1reply) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/messages?limit=20`)
+  const arr = j.data?.messages ?? j.data ?? []
+  h1reply = (Array.isArray(arr) ? arr : []).find(m => m.metadata?.['x-aw-in-reply-to'] === h1.data.messageId)
+  if (!h1reply) await sleep(5000)
+}
+check('H1 lead 回执落时间线', !!h1reply, h1reply ? textOf(h1reply).slice(0, 50) : '')
+
+// ═══ H2 人类→worker 直发(@worker) ═══
+console.log('━━ H2 人类→甲 直发 ━━')
+const h2 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: JIA.id, text: '甲,馆长点名:回一句甲在岗。', fromLabel: '馆长', priority: 'immediate', requireReply: true })
+let h2reply = null
+const dh2 = Date.now() + 600000
+while (Date.now() < dh2 && !h2reply) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/messages?limit=20`)
+  const arr = j.data?.messages ?? j.data ?? []
+  h2reply = (Array.isArray(arr) ? arr : []).find(m => m.metadata?.['x-aw-in-reply-to'] === h2.data.messageId)
+  if (!h2reply) await sleep(5000)
+}
+check('H2 worker 直气回执', !!h2reply, h2reply ? textOf(h2reply).slice(0, 50) : '')
+
+// ═══ A2 跨频道 lead→lead ═══
+console.log('━━ A2 跨频道通信 ━━')
+const a2 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toChannelId: CHB, fromAgentId: L.id, text: '分站调度,请回一句:分站在线。', requireReply: true })
+check('A2 跨频道受理', a2.code === 0, JSON.stringify(a2).slice(0, 60))
+let a2reply = null
+const da2 = Date.now() + 600000
+while (Date.now() < da2 && !a2reply) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/messages?limit=30`)
+  const arr = j.data?.messages ?? j.data ?? []
+  a2reply = (Array.isArray(arr) ? arr : []).find(m => m.metadata?.['x-aw-in-reply-to'] === a2.data.messageId)
+  if (!a2reply) await sleep(5000)
+}
+check('A2 分站回信落主频道', !!a2reply, a2reply ? textOf(a2reply).slice(0, 50) : '')
+
+// ═══ W1/W2 WS 实时 + 重连补发 ═══
+console.log('━━ W1/W2 WS 实时与补发 ━━')
+const ws = new globalThis.WebSocket(`${BASE.replace(/^http/, 'ws')}/api/workshop/ws?token=${encodeURIComponent(TOKEN)}`)
+let wsOpen = false
+const frames = []
+let seqOk = true
+let lastSeqSeen = 0
+ws.addEventListener('open', () => { wsOpen = true })
+ws.addEventListener('message', (ev) => {
+  try {
+    const m = JSON.parse(String(ev.data))
+    if (m.type === 'a2a.message' && m.seq > 0) {
+      if (m.seq <= lastSeqSeen) seqOk = false
+      lastSeqSeen = m.seq
+      frames.push({ seq: m.seq, at: Date.now() })
+    }
+  } catch { }
+})
+await new Promise(r => { const iv = setInterval(() => { if (wsOpen) { clearInterval(iv); r() } }, 200) })
+ws.send(JSON.stringify({ type: 'sub', channelId: CH, token: TOKEN }))
+await sleep(1000)
+
+// 实时延迟测量:REST 发送 → WS 帧到达
+const sentAt = Date.now()
+const wmsg = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: YI.id, text: '延迟测量消息', fromLabel: '馆长', priority: 'immediate' })
+let latency = -1
+const dw1 = Date.now() + 15000
+while (Date.now() < dw1) {
+  const hit = frames.find(f => f.at >= sentAt)
+  if (hit) { latency = hit.at - sentAt; break }
+  await sleep(100)
+}
+check('W1 WS 实时推送(≤5s)', latency >= 0 && latency <= 5000, `latency=${latency}ms`)
+check('W1b seq 单调递增', seqOk, `lastSeq=${lastSeqSeen}`)
+
+// 断线 → 离线期发 2 条 → lastSeq 重连 → 补发
+const lastSeqBefore = lastSeqSeen
+ws.close()
+await sleep(500)
+await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: YI.id, text: '离线消息一', fromLabel: '馆长', priority: 'immediate' })
+await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: YI.id, text: '离线消息二', fromLabel: '馆长', priority: 'immediate' })
+await sleep(2500)
+const replay = []
+const ws2 = new globalThis.WebSocket(`${BASE.replace(/^http/, 'ws')}/api/workshop/ws?token=${encodeURIComponent(TOKEN)}`)
+ws2.addEventListener('open', () => {
+  ws2.send(JSON.stringify({ type: 'sub', channelId: CH, token: TOKEN, lastSeq: lastSeqBefore }))
+})
+ws2.addEventListener('message', (ev) => {
+  try {
+    const m = JSON.parse(String(ev.data))
+    if (m.type === 'a2a.message' && m.seq > lastSeqBefore) replay.push(m.seq)
+  } catch { }
+})
+await sleep(6000)
+check('W2 重连补发离线消息', replay.length >= 2, `replayed=${replay.length} (from seq>${lastSeqBefore})`)
+ws2.close()
+
+console.log(`\n━━━ 通信验证: ${pass} pass / ${fail} fail ━━━`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_dbg-full-feature-e2e.mjs

@@ -36,14 +36,20 @@ const tag = Math.random().toString(36).slice(2, 8)
 async function main() {
   // ===== 0. 用户注册 =====
   console.log('━━━ 0. 用户注册 ━━━')
-  const reg = await jpost('/api/workshop/users/register', { name: 'ffx-' + tag })
-  TOKEN = reg.data?.token
-  if (!TOKEN) fail('用户注册失败: ' + JSON.stringify(reg).slice(0, 120))
-  check('用户注册并取得 token', !!TOKEN)
+  // AW_E2E_TOKEN 提供时直接使用(共享实例上遗留注册只会拿到非 admin 用户,后续建线必 403)
+  if (TOKEN) {
+    check('使用 AW_E2E_TOKEN(共享实例跳过注册)', true)
+  } else {
+    const reg = await jpost('/api/workshop/users/register', { name: 'ffx-' + tag })
+    TOKEN = reg.data?.token
+    if (!TOKEN) fail('用户注册失败: ' + JSON.stringify(reg).slice(0, 120))
+    check('用户注册并取得 token', !!TOKEN)
+  }
 
   // ===== 1. 产线搭建:1 线 1 产品 2 数采 1 数控 + 配方 + 开跑 =====
   console.log('\n━━━ 1. 产线搭建与开跑 ━━━')
-  const line = (await jpost('/api/workshop/dcw/lines', { name: '全功能验证线-' + tag })).data.line
+  const line = (await jpost('/api/workshop/dcw/lines', { name: '全功能验证线-' + tag })).data?.line
+  if (!line?.id) fail('产线创建失败(权限不足或数据异常)')
   cleanup.push(['dcw-line', line.id])
   const prod = (await jpost('/api/workshop/dcw/products', { name: '全功能产品-' + tag, lineId: line.id })).data.product
   cleanup.push(['dcw-product', prod.id])
@@ -93,7 +99,7 @@ async function main() {
     name: '数据分析工程师-' + tag, harness: 'omp',
     config: {
       intro: '负责从数采时序库获取产线数据、分析趋势,并按分析结论对数控设定下发工艺优化',
-      systemPromptPrefix: '你是产线数据分析工程师。先用 my_industrial_nodes 查看你的授权节点,再用 daq_query 获取最近 5 分钟数据并给出均值。若温度均值与 182℃ 偏差超过 1℃,用 dcw_control 把温度设定调整为 182(你的温度设定节点是手动确认模式,发起后等待用户批准)。结论必须引用具体数值。',
+      systemPromptPrefix: '你是产线数据分析工程师。先用 my_industrial_nodes 查看你的授权节点,再用 daq_query 获取最近 5 分钟数据并给出均值。若温度均值与 178℃ 偏差超过 1℃,用 dcw_control 把温度设定调整为 178(你的温度设定节点是手动确认模式,发起后等待用户批准)。结论必须引用具体数值。',
     },
   })).data
   cleanup.push(['agent-tpl', tplWorker.id])
@@ -124,12 +130,14 @@ async function main() {
 
   // ===== 6. goal 任务派发:数据分析 → 判断偏差 → 下发修正 =====
   console.log('\n━━━ 6. goal 任务派发(真实 omp worker 执行)━━━')
-  const goal = `请分析产线当前运行状态:1) 用你的数采工具获取最近 5 分钟温度数据并给出均值;2) 判断温度均值与 182℃ 目标的偏差;3) 偏差超过 1℃ 时,用数控工具把温度设定调整为 182(手动确认模式,发起后等待批准)。完成后汇报数值结论。`
+  const goal = `请分析产线当前运行状态:1) 用你的数采工具获取最近 5 分钟温度数据并给出均值;2) 判断温度均值与 178℃ 目标的偏差;3) 偏差超过 1℃ 时,用数控工具把温度设定调整为 178(手动确认模式,发起后等待批准)。完成后汇报数值结论。`
   const task = (await jpost(`/api/workshop/channels/${ch.id}/tasks`, {
     title: '产线数据分析与工艺优化-' + tag,
     parts: [{ text: goal }],
     mode: 'goal',
-    modeConfig: { goalCriteria: '已产出含具体数值的数据分析结论,且温度设定值已调整为 182℃ 附近(或明确说明未需调整)' },
+    // 目标 178 必须真实触发一次「发起→批准→写穿」:当前值在联锁段已被写成 182,
+    // 目标不得取 182 附近(否则 Agent 正确判为无需调整,HITL 链路永远不触发)
+    modeConfig: { goalCriteria: '已产出含具体数值的数据分析结论,且温度设定值已调整为 178℃ 附近' },
   })).data
   const taskId = task?.task?.id ?? task?.id
   check('goal 任务已提交', !!taskId, `id=${taskId?.slice(0, 8)}`)
@@ -161,9 +169,9 @@ async function main() {
         console.log(`[t+${Math.round((Date.now() - t0) / 1000)}s] [HITL] 用户已批准`)
       }
     }
-    // 写副作用:温度设定被 Agent 更新为 182±3
+    // 写副作用:温度设定被 Agent 更新为 178±3(178 与联锁段写入的 182 距离 >3,不会误判)
     const dwNow = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
-    if (dwNow?.value != null && Math.abs(dwNow.value - 182) <= 3 && dwNow.value !== 180) workerValueSeen = true
+    if (dwNow?.value != null && Math.abs(dwNow.value - 178) <= 3 && dwNow.value !== 180 && dwNow.value !== 182) workerValueSeen = true
     if (i % 10 === 0 && i > 0) {
       const mem = (await jget(`/api/workshop/channels/${ch.id}/queue`)).data
       const arr = Array.isArray(mem) ? mem : []
@@ -175,7 +183,7 @@ async function main() {
   check('lead 调度:主任务拆解并派发子任务', subTaskSeen)
   check('HITL:Agent 经工具发起数控下发,用户批准后执行', hitlSeen)
   const dwFinal = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
-  check('写副作用:温度设定被 Agent 更新为 182 附近', workerValueSeen, `value=${dwFinal?.value}℃(目标 182)`)
+  check('写副作用:温度设定被 Agent 更新为 178 附近', workerValueSeen, `value=${dwFinal?.value}℃(目标 178)`)
   const parentState = (await jget(`/api/workshop/channels/${ch.id}/tasks`)).data
   const parent = (Array.isArray(parentState) ? parentState : parentState?.tasks ?? []).find(t => t.id === taskId)
   check('goal 任务最终完成', parent?.state === 'COMPLETED', `state=${parent?.state} sub=${subState}`)