agentworkshop 0.2.1

package/scripts/test-ws-stress.mjs

@@ -0,0 +1,208 @@
+/**
+ * WS hub 压测与鲁棒性验证(P2 验收):
+ * ① 万级事件:REST 批量注入消息 → hub 逐帧推送(seq 连续、无丢失、耗时)
+ * ② 双 channel 并行不串扰:两 channel 并发任务,事件按 channelId 严格隔离
+ * ③ 环形缓冲溢出:注入超 ring 容量(5000)后,旧 lastSeq 重订阅 → snapshot 对齐兜底
+ * ④ 断线续传:中途断开重连 sub{lastSeq} → 重放连续
+ * ⑤ 服务重启恢复(--phase=recover):重启后重连,游标超前 → snapshot 对齐,历史任务可见
+ * 运行: node scripts/test-ws-stress.mjs [--phase=recover]
+ */
+const BASE = process.env.AW_E2E_BASE ?? 'http://localhost:3000'
+const WS_BASE = BASE.replace(/^http/, 'ws')
+
+let failures = 0
+function check(name, ok, detail = '') {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+// 用户级隔离:注册测试用户;管理面 API 全程携带用户 token
+const __user = await fetch(BASE + '/api/workshop/users/register', {
+  method: 'POST', headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ name: 'e2e-' + Math.random().toString(36).slice(2, 10) }),
+}).then(r => r.json()).catch(() => null)
+const __userToken = __user?.data?.token
+if (!__userToken) {
+  console.error('用户注册失败')
+  process.exit(1)
+}
+
+async function api(method, path, arg) {
+  // 调用侧统一 { body: {...} } 包装;无 body 的 GET 无第三参
+  const body = arg && typeof arg === 'object' && 'body' in arg ? arg.body : arg
+  const res = await fetch(`${BASE}/api/workshop${path}`, {
+    method,
+    headers: {
+      authorization: `Bearer ${__userToken}`,
+      ...(body !== undefined ? { 'content-type': 'application/json' } : {}),
+    },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  const json = await res.json().catch(() => null)
+  return { status: res.status, data: json?.data }
+}
+
+function openWs() {
+  const frames = []
+  const ws = new WebSocket(`${WS_BASE}/api/workshop/ws`)
+  const opened = new Promise((resolve, reject) => {
+    ws.onopen = () => resolve(true)
+    ws.onerror = e => reject(new Error(`ws error: ${e?.message ?? e}`))
+  })
+  ws.onmessage = ev => frames.push(JSON.parse(ev.data))
+  return { ws, frames, opened }
+}
+
+const isRecover = process.argv.includes('--phase=recover')
+
+async function main() {
+  if (isRecover) {
+    // ── ⑤ 服务重启恢复:新建 channel 重连,验证 snapshot 对齐(游标超前场景) ──
+    console.log('=== ⑤ 服务重启恢复 ===')
+    const ch = await api('POST', '/channels', { body: { name: `stress-recover-${Date.now()}` } })
+    const channelId = ch.data?.channelId
+    await api('POST', `/channels/${channelId}/agents`, { body: { name: 'r-lead', harness: 'mock', role: 'lead' } })
+    await api('POST', `/channels/${channelId}/agents`, { body: { name: 'r-w1', harness: 'mock' } })
+    const c = openWs()
+    await c.opened
+    c.ws.send(JSON.stringify({ type: 'sub', channelId, lastSeq: 999_999, token: __userToken })) // 游标超前(模拟重启前状态)
+    await sleep(800)
+    const snap = c.frames.find(f => f.type === 'channel.snapshot')
+    check('游标超前 → snapshot 全量对齐', !!snap && snap.channelId === channelId)
+    // 提交任务验证重启后直推正常
+    const t = await api('POST', `/channels/${channelId}/tasks`, { body: { title: '重启后任务' } })
+    const ok = await (async () => {
+      const deadline = Date.now() + 20_000
+      while (Date.now() < deadline) {
+        if (c.frames.some(f => f.type === 'task.status' && f.payload?.taskId === t.data?.id && f.payload?.state === 'COMPLETED')) return true
+        await sleep(150)
+      }
+      return false
+    })()
+    check('重启后任务全生命周期直推', ok)
+    c.ws.close()
+    await api('DELETE', `/channels/${channelId}`)
+    console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+    process.exit(failures === 0 ? 0 : 1)
+  }
+
+  // ── 前置:双 channel + 成员 ──
+  const mkChannel = async (name) => {
+    for (let i = 0; i < 5; i++) {
+      const r = await api('POST', '/channels', { body: { name } })
+      if (r.data?.channelId) return r.data.channelId
+      await sleep(1000)
+    }
+    throw new Error(`channel 创建失败: ${name}`)
+  }
+  const A = await mkChannel(`stress-a-${Date.now()}`)
+  const B = await mkChannel(`stress-b-${Date.now()}`)
+  for (const [cid, prefix] of [[A, 'a'], [B, 'b']]) {
+    await api('POST', `/channels/${cid}/agents`, { body: { name: `${prefix}-lead`, harness: 'mock', role: 'lead' } })
+    await api('POST', `/channels/${cid}/agents`, { body: { name: `${prefix}-w1`, harness: 'mock' } })
+  }
+
+  console.log('=== ② 双 channel 并行不串扰 ===')
+  const c1 = openWs()
+  await c1.opened
+  c1.ws.send(JSON.stringify({ type: 'sub', channelId: A, token: __userToken }))
+  c1.ws.send(JSON.stringify({ type: 'sub', channelId: B, token: __userToken }))
+  await sleep(600)
+  // 并发提交
+  await Promise.all([
+    api('POST', `/channels/${A}/tasks`, { body: { title: 'A-任务甲' } }),
+    api('POST', `/channels/${B}/tasks`, { body: { title: 'B-任务乙' } }),
+  ])
+  const bothDone = await (async () => {
+    const deadline = Date.now() + 30_000
+    while (Date.now() < deadline) {
+      const aDone = c1.frames.some(f => f.channelId === A && f.type === 'task.status' && f.payload?.state === 'COMPLETED')
+      const bDone = c1.frames.some(f => f.channelId === B && f.type === 'task.status' && f.payload?.state === 'COMPLETED')
+      if (aDone && bDone) return true
+      await sleep(150)
+    }
+    return false
+  })()
+  check('双 channel 任务并行闭环', bothDone)
+  // 严格隔离:所有 A 帧不含 B 的任务标题,反之亦然
+  const aFrames = c1.frames.filter(f => f.channelId === A)
+  const bFrames = c1.frames.filter(f => f.channelId === B)
+  check('A 域无 B 事件泄漏', aFrames.every(f => JSON.stringify(f.payload ?? {}).indexOf('B-') < 0), `aFrames=${aFrames.length}`)
+  check('B 域无 A 事件泄漏', bFrames.every(f => JSON.stringify(f.payload ?? {}).indexOf('A-') < 0), `bFrames=${bFrames.length}`)
+
+  console.log('\n=== ① 万级事件压测(6000 消息注入) ===')
+  const BATCH = 6000
+  const t0 = Date.now()
+  const leadA = (await api('GET', `/channels/${A}/agents`)).data?.[0]?.id
+  const leadB = (await api('GET', `/channels/${B}/agents`)).data?.[0]?.id
+  const injectOk = async (cid, toId, tag) => {
+    const CONC = 30
+    for (let i = 0; i < BATCH / 2; i += CONC) {
+      await Promise.all(Array.from({ length: CONC }, (_, j) =>
+        api('POST', `/channels/${cid}/messages`, { body: { toAgentId: toId, text: `${tag}-${i + j}` } })))
+    }
+  }
+  await Promise.all([injectOk(A, leadA, 'sa'), injectOk(B, leadB, 'sb')])
+  const injectMs = Date.now() - t0
+  // 等待帧到达(限流消费)
+  const settled = await (async () => {
+    const deadline = Date.now() + 60_000
+    let last = -1
+    let stableSince = 0
+    while (Date.now() < deadline) {
+      const total = c1.frames.filter(f => f.type === 'a2a.message').length
+      if (total === last) {
+        stableSince += 400
+        if (stableSince >= 2000) return total
+      }
+      else stableSince = 0
+      last = total
+      await sleep(400)
+    }
+    return last
+  })()
+  console.log(`  注入 ${BATCH} 条耗时 ${injectMs}ms;帧稳定于 ${settled}`)
+  check('hub 高压下持续推送(≥90% 帧到达或缓冲截断后对齐)', settled >= BATCH * 0.9 || settled >= 4000, `frames=${settled}`)
+  // seq 连续性(单 channel)
+  const aSeqs = aFrames.map(f => f.seq).sort((x, y) => x - y)
+  const contiguous = aSeqs.every((s, i) => i === 0 || s === aSeqs[i - 1] + 1)
+  check('A 域 seq 连续(压测后)', contiguous, `n=${aSeqs.length} first=${aSeqs[0]} last=${aSeqs.at(-1)}`)
+
+  console.log('\n=== ③ 环形缓冲溢出对齐 ===')
+  const staleSeq = 5 // 早已被挤出 ring 的游标
+  const c2 = openWs()
+  await c2.opened
+  c2.ws.send(JSON.stringify({ type: 'sub', channelId: A, lastSeq: staleSeq, token: __userToken }))
+  await sleep(1000)
+  const snap2 = c2.frames.find(f => f.type === 'channel.snapshot')
+  check('缓冲窗外 lastSeq → snapshot 对齐兜底', !!snap2)
+  c2.ws.close()
+
+  console.log('\n=== ④ 断线续传(压测流中) ===')
+  // 实时游标:重取当前连接的 A 域最新 seq(压测前引用已过期)
+  const lastSeq = c1.frames.filter(f => f.channelId === A).map(f => f.seq).sort((x, y) => x - y).at(-1) ?? 0
+  c1.ws.close()
+  await sleep(300)
+  // 断开期间继续注入一小批(ring 窗口内,保证可重放)
+  for (let i = 0; i < 50; i++) await api('POST', `/channels/${A}/messages`, { body: { toAgentId: leadA, text: `gap-${i}` } })
+  const c3 = openWs()
+  await c3.opened
+  c3.ws.send(JSON.stringify({ type: 'sub', channelId: A, lastSeq, token: __userToken }))
+  await sleep(1500)
+  const replay = c3.frames.filter(f => f.type !== 'channel.snapshot' && f.type !== 'pong')
+  const rSeqs = replay.map(f => f.seq)
+  check('重放 seq 从 lastSeq+1 连续', rSeqs.length > 0 && rSeqs[0] === lastSeq + 1
+  && rSeqs.every((s, i) => i === 0 || s === rSeqs[i - 1] + 1), `first=${rSeqs[0]} last=${rSeqs.at(-1)}(lastSeq=${lastSeq})`)
+  c3.ws.close()
+
+  await api('DELETE', `/channels/${A}`)
+  await api('DELETE', `/channels/${B}`)
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('压测异常:', e)
+  process.exit(1)
+})

package/scripts/town-demo-seed.mjs

@@ -0,0 +1,75 @@
+/**
+ * 小镇演示数据准备(dev server :3000):注册用户 → workspace → channel(lead+2 worker, mock)
+ * → 挂载 → 场景布局(放置领地)→ 泵机设备孪生 → 提交任务 + 制造 A2A 对话(气泡活动)。
+ * 运行: node scripts/town-demo-seed.mjs [--base http://127.0.0.1:3000]
+ */
+const BASE = (process.argv.find(a => a.startsWith('--base='))?.slice(7) ?? 'http://127.0.0.1:3000') + '/api/workshop'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function api(method, path, { token, body } = {}) {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const r = await fetch(`${BASE}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
+  return { status: r.status, json: await r.json().catch(() => null) }
+}
+
+const name = 'town-demo-' + Math.random().toString(36).slice(2, 7)
+const u = await api('POST', '/users/register', { body: { name } })
+const token = u.json?.data?.token
+if (!token) {
+  console.error('注册失败', u.json)
+  process.exit(1)
+}
+console.log('user:', name, 'token:', token)
+
+const ws = await api('POST', '/workspaces', { token, body: { name: '工业孪生演示工作区' } })
+const wsId = ws.json?.data?.id ?? ws.json?.data?.workspaceId
+console.log('workspace:', wsId)
+
+const ch = await api('POST', '/channels', { token, body: { name: '工业孪生演示频道', description: 'RPG 2.5D 小镇演示' } })
+const cid = ch.json?.data?.channelId
+console.log('channel:', cid)
+await api('POST', `/channels/${cid}/agents`, { token, body: { name: '调度主管', harness: 'mock', role: 'lead' } })
+await api('POST', `/channels/${cid}/agents`, { token, body: { name: '数据工程师', harness: 'mock', role: 'worker' } })
+await api('POST', `/channels/${cid}/agents`, { token, body: { name: '运维工程师', harness: 'mock', role: 'worker' } })
+
+if (wsId && cid) await api('POST', `/workspaces/${wsId}/channels/${cid}`, { token })
+
+// 场景布局:把频道领地放到世界中央偏左(工业园东区)
+await api('PUT', `/scene/layouts/${cid}`, { token, body: { x: 1150, z: 1500, radiusX: 320, radiusZ: 210, shape: 'ellipse', rotationY: 0 } })
+// 第二块领地(同用户再建一个频道,形成"园区"群像)
+const ch2 = await api('POST', '/channels', { token, body: { name: '设备在线监测组', description: '孪生设备监控' } })
+const cid2 = ch2.json?.data?.channelId
+await api('POST', `/channels/${cid2}/agents`, { token, body: { name: '监测主管', harness: 'mock', role: 'lead' } })
+await api('POST', `/channels/${cid2}/agents`, { token, body: { name: '巡检员', harness: 'mock', role: 'worker' } })
+if (wsId && cid2) await api('POST', `/workspaces/${wsId}/channels/${cid2}`, { token })
+await api('PUT', `/scene/layouts/${cid2}`, { token, body: { x: 1950, z: 1520, radiusX: 250, radiusZ: 170, shape: 'rect', rotationY: 18 } })
+
+// 泵机设备孪生(工业园中央)+ 高清遥测
+await api('POST', '/device-twins', {
+  token,
+  body: {
+    name: '循环泵 #01', modelRef: 'pump', kind: 'device',
+    posX: 1580, posZ: 1560, rotationY: 30, scale: 1.6,
+    controls: ['start', 'stop'],
+    telemetry: { rpm: 2960, pressure: 0.82, temp: 63, vibration: 3.4 },
+  },
+})
+
+// 提交任务 → mock 闭环,产生大量事件/气泡
+const t = await api('POST', `/channels/${cid}/tasks`, { token, body: { title: '巡检泵组并汇报', description: '就地巡检 01/02 号循环泵' } })
+console.log('task:', t.json?.data?.id)
+await sleep(2500)
+
+// 制造 A2A 对话气泡(lead → 数据工程师 / 运维工程师)
+const agents = (await api('GET', `/channels/${cid}/agents`, { token })).json?.data ?? []
+const lead = agents.find(a => a.role === 'lead')
+const w = agents.filter(a => a.role === 'worker')
+for (const worker of w) {
+  await api('POST', '/a2a/send', {
+    token: lead?.token,
+    body: { toAgentId: worker.id, parts: [{ text: `巡检完成,请汇总 ${worker.name} 负责的泵组运行数据` }] },
+  })
+}
+console.log('演示数据就绪')
+console.log('DIALOG_READY token=' + token)

package/scripts/town-scene-clear.mjs

@@ -0,0 +1,56 @@
+/** 一次性:清空数字孪生场景实例(非破坏)
+ *  - 数采/数控节点:PATCH posX/posZ = null(解除落位,实体保留在左轨树)
+ *  - 频道布局(含领地/积木):逐个 DELETE /scene/layouts/:cid
+ *  - 设备孪生保留(绑定测试锚点;API 无损清位不支持,如需删除可在 UI 逐台删)
+ */
+const BASE = 'http://127.0.0.1:3000'
+const login = await fetch(`${BASE}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+const H = { 'authorization': `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+
+const daq = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+const daqPlaced = daq.data.nodes.filter(n => typeof n.posX === 'number')
+let daqDone = 0
+for (const n of daqPlaced) {
+  const r = await fetch(`${BASE}/api/workshop/daq/${n.id}`, {
+    method: 'PATCH', headers: H, body: JSON.stringify({ posX: null, posZ: null }),
+  })
+  if (r.ok) daqDone++
+}
+console.log(`daq unplaced: ${daqDone}/${daqPlaced.length}`)
+
+const dcw = await fetch(`${BASE}/api/workshop/dcw`, { headers: H }).then(r => r.json())
+const dcwPlaced = dcw.data.nodes.filter(n => typeof n.posX === 'number')
+let dcwDone = 0
+for (const n of dcwPlaced) {
+  const r = await fetch(`${BASE}/api/workshop/dcw/${n.id}`, {
+    method: 'PATCH', headers: H, body: JSON.stringify({ posX: null, posZ: null }),
+  })
+  if (r.ok) dcwDone++
+}
+console.log(`dcw unplaced: ${dcwDone}/${dcwPlaced.length}`)
+
+const layouts = await fetch(`${BASE}/api/workshop/scene/layouts`, { headers: H }).then(r => r.json())
+const items = layouts.data?.layouts ?? layouts.data?.items ?? []
+let layDone = 0
+for (const it of items) {
+  const cid = it.channelId ?? it.id
+  if (!cid) continue
+  const r = await fetch(`${BASE}/api/workshop/scene/layouts/${cid}`, { method: 'DELETE', headers: H })
+  if (r.ok) layDone++
+}
+console.log(`layouts removed: ${layDone}/${items.length}`)
+
+// 复核
+const daq2 = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+const dcw2 = await fetch(`${BASE}/api/workshop/dcw`, { headers: H }).then(r => r.json())
+const lay2 = await fetch(`${BASE}/api/workshop/scene/layouts`, { headers: H }).then(r => r.json())
+console.log('verify → placed daq:', daq2.data.nodes.filter(n => typeof n.posX === 'number').length,
+  '| placed dcw:', dcw2.data.nodes.filter(n => typeof n.posX === 'number').length,
+  '| layouts:', (lay2.data?.layouts ?? []).length,
+  '| daq entities kept:', daq2.data.nodes.length,
+  '| dcw entities kept:', dcw2.data.nodes.length)
+console.log('scene clear done')

package/scripts/ui-screenshot.mjs

@@ -0,0 +1,128 @@
+/**
+ * UI 改版视觉走查截图 — 在当前设计体系(warm-editorial / ink-pill)下
+ * 对时间线 / lanes / 总览做真实渲染截图,供人工比对。
+ * 依赖:dev server(127.0.0.1:3000) + Edge + puppeteer-core。
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const BASE = 'http://127.0.0.1:3000'
+const OUT = 'gui-test-screenshots/ui-redesign'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, ep, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${ep}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
+  return res.json()
+}
+
+async function main() {
+  fs.mkdirSync(OUT, { recursive: true })
+  const email = `shot-${Date.now().toString(36)}@test.local`
+  const password = 'Passw0rd!123'
+  const reg = await api('POST', '/api/users/register', { body: { name: `shot-${Date.now().toString(36)}`, email, password } })
+
+  const { token } = reg.data
+
+  // channel:mock lead/worker + streamDemo,保证时间线有丰富种类事件(状态/工具/流/任务/收口)
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: {
+      name: 'ui-walk',
+      scenarioPrompt: 'UI 走查场景',
+      leadAgent: { name: 'ui-lead', harness: 'mock', config: { delayMs: 300 } },
+    },
+    token,
+  })
+  const cid = ch.data.channelId
+  await api('POST', `/api/workshop/channels/${cid}/agents`, {
+    body: { name: 'ui-worker', harness: 'mock', role: 'worker', config: { delayMs: 320, streamDemo: true } },
+    token,
+  })
+  await api('POST', `/api/workshop/channels/${cid}/agents`, {
+    body: { name: 'ui-worker2', harness: 'mock', role: 'worker', config: { delayMs: 380, streamDemo: true } },
+    token,
+  })
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'ui-ws' }, token })
+  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${cid}`, { token })
+
+  const browser = await puppeteer.launch({
+    executablePath: EDGE,
+    headless: 'new',
+    args: ['--no-sandbox'],
+    defaultViewport: { width: 1600, height: 1000 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 200)))
+
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2500)
+  const setInput = (sel, v) => page.$eval(sel, (el, val) => {
+    const proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype
+    const set = Object.getOwnPropertyDescriptor(proto, 'value').set
+    set.call(el, val)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, v)
+  await setInput('input[type="email"]', email)
+  await setInput('input[type="password"]', password)
+  await sleep(200)
+  for (const b of await page.$$('button')) {
+    const txt = (await b.evaluate(el => el.textContent) || '').trim()
+    if (txt.replace(/\s/g, '') === '登录') {
+      await b.click()
+      break
+    }
+  }
+  await sleep(4500)
+  await page.screenshot({ path: `${OUT}/01-overview.png` })
+
+  if (!page.url().includes('/workshop/w/')) {
+    await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+    await sleep(2500)
+    for (const b of await page.$$('button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').trim()
+      if (txt.includes('进入控制台')) {
+        await b.click()
+        break
+      }
+    }
+    await sleep(3500)
+  }
+
+  // 提交任务,等 mock 出流;期间截时间线多帧 + lanes
+  await page.evaluate(() => {
+    const ta = document.querySelector('.composer textarea')
+    if (!ta) return
+    const set = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set
+    set.call(ta, '实现一个极简的待办 API:list/add/done 三个端点,附测试要点与验收清单。')
+    ta.dispatchEvent(new Event('input', { bubbles: true }))
+    ta.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', ctrlKey: true, bubbles: true }))
+  })
+  await sleep(6000)
+  await page.screenshot({ path: `${OUT}/02-timeline-streaming.png` })
+  await sleep(14000)
+  await page.screenshot({ path: `${OUT}/03-timeline-settled.png` })
+
+  // lanes 视图
+  await page.evaluate(() => {
+    document.querySelectorAll('.view-switch .ant-segmented-item').forEach((s, i) => {
+      if (i === 1) s.click()
+    })
+  })
+  await sleep(3000)
+  await page.screenshot({ path: `${OUT}/04-lanes.png` })
+
+  // 悬停首块:工具条浮出
+  await page.hover('.event-block')
+  await sleep(600)
+  await page.screenshot({ path: `${OUT}/05-hover-toolbar.png` })
+
+  await browser.close()
+  console.log('screenshots saved ->', OUT)
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/verify-a2a-live.mjs

@@ -0,0 +1,124 @@
+/**
+ * A2A 实时验证脚本(真实 HTTP,dev server 对口)——覆盖 test-workshop-entries 的 A2A 入口部分:
+ *  - AgentCard 结构(supportedInterfaces.protocolBinding=JSONRPC / capabilities.streaming / modes)
+ *  - JSON-RPC:tasks/send(同步阻塞至终态)/ tasks/get / tasks/list / tasks/cancel / message/send / agent/getCard
+ *  - 错误码:-32601 Method not found / -32602 Invalid params / -32005 Agent not authorized / -32700 Parse error
+ * 运行:node scripts/verify-a2a-live.mjs [--base http://127.0.0.1:3000]
+ */
+const BASE = (process.argv.find(a => a.startsWith('--base='))?.slice(7) ?? 'http://127.0.0.1:3000') + '/api/workshop'
+let pass = 0, fail = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  ok ? pass++ : fail++
+}
+
+async function req(method, path, { token, body } = {}) {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
+  return { status: res.status, json: await res.json().catch(() => null) }
+}
+
+async function rpc(agentId, payload, agentToken) {
+  const headers = { 'content-type': 'application/json' }
+  if (agentToken) headers.authorization = `Bearer ${agentToken}`
+  const res = await fetch(`${BASE}/a2a/${agentId}/rpc`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  })
+  return { status: res.status, json: await res.json().catch(() => null) }
+}
+
+const cleanup = { channelId: null, agentIds: [] }
+let __token = null
+
+async function main() {
+  console.log('━━━ A2A 实时验证(真实 HTTP)→', BASE, '━━━')
+  const user = await req('POST', '/users/register', { body: { name: 'a2a-live-' + Math.random().toString(36).slice(2, 9) } })
+  const token = user.json?.data?.token
+  __token = token
+  check('用户注册/拿 token', !!token)
+
+  const ch = await req('POST', '/channels', { token, body: { name: 'a2a-live-check' } })
+  const CH = ch.json?.data?.channelId
+  cleanup.channelId = CH
+  check('channel 创建', ch.json?.code === 0 && !!CH)
+
+  const lead = await req('POST', `/channels/${CH}/agents`, { token, body: { name: 'a2a-lead', harness: 'mock', role: 'lead' } })
+  const worker = await req('POST', `/channels/${CH}/agents`, { token, body: { name: 'a2a-worker', harness: 'mock', role: 'worker' } })
+  const LEAD = lead.json?.data?.id, WORKER = worker.json?.data?.id
+  cleanup.agentIds = [LEAD, WORKER]
+  check('lead/worker 实例创建', !!LEAD && !!WORKER)
+
+  console.log('\n--- 1. AgentCard ---')
+  const card = await req('GET', `/a2a/${LEAD}/card`)
+  const c = card.json
+  check('card 返回', !!c && !!c.name && c.name === 'a2a-lead', JSON.stringify(card.json)?.slice(0, 160))
+  check('card.supportedInterfaces[].protocolBinding=JSONRPC', Array.isArray(c?.supportedInterfaces) && c.supportedInterfaces.some(i => i.protocolBinding === 'JSONRPC' && i.protocolVersion === '1.0'))
+  check('card.capabilities.streaming=true', c?.capabilities?.streaming === true)
+  check('card.skills 为数组(缺省 [])', Array.isArray(c?.skills))
+  check('card.defaultInputModes 含 text/plain', Array.isArray(c?.defaultInputModes) && c.defaultInputModes.includes('text/plain'))
+
+  console.log('\n--- 2. JSON-RPC 方法 ---')
+  // tasks/send:同步阻塞至终态(mock 毫秒级)
+  const sendR = await rpc(LEAD, {
+    jsonrpc: '2.0', id: 1, method: 'tasks/send',
+    params: { message: { role: 'ROLE_USER', parts: [{ text: 'a2a-live 任务', mediaType: 'text/plain' }] } },
+  })
+  const r1 = sendR.json
+  check('tasks/send 返回 result', !!r1?.result, r1?.error ? JSON.stringify(r1.error) : '')
+  check('tasks/send 终态 COMPLETED', r1?.result?.status?.state === 'COMPLETED', r1?.result?.status?.state ?? '')
+  check('tasks/send result 含 id/contextId', !!r1?.result?.id && !!r1?.result?.contextId)
+  const a2aTaskId = r1?.result?.id
+
+  // tasks/get
+  const getR = await rpc(LEAD, { jsonrpc: '2.0', id: 2, method: 'tasks/get', params: { taskId: a2aTaskId } })
+  check('tasks/get 命中', getR.json?.result?.id === a2aTaskId)
+  const badGet = await rpc(LEAD, { jsonrpc: '2.0', id: 3, method: 'tasks/get', params: { taskId: '00000000-0000-0000-0000-000000000000' } })
+  check('tasks/get 不存在 → -32002', badGet.json?.error?.code === -32002, String(badGet.json?.error?.code))
+
+  // tasks/list
+  const listR = await rpc(LEAD, { jsonrpc: '2.0', id: 4, method: 'tasks/list', params: {} })
+  check('tasks/list 含刚创建任务', (listR.json?.result ?? []).some(t => t.id === a2aTaskId))
+
+  // agent/getCard
+  const cardR = await rpc(WORKER, { jsonrpc: '2.0', id: 5, method: 'agent/getCard', params: {} })
+  check('agent/getCard', cardR.json?.result?.supportedInterfaces?.some?.(i => i.protocolBinding === 'JSONRPC') === true)
+
+  // message/send:worker 带 token 发消息给 lead(须真实送达)
+  const workerToken = worker.json?.data?.token
+  const msgR = await rpc(LEAD, {
+    jsonrpc: '2.0', id: 6, method: 'message/send',
+    params: { message: { role: 'ROLE_AGENT', parts: [{ text: 'a2a-live 内部消息', mediaType: 'text/plain' }] } },
+  }, workerToken)
+  check('message/send 带 token 送达', !!msgR.json?.result?.messageId, msgR.json?.error ? JSON.stringify(msgR.json.error) : '')
+  const msgNoToken = await rpc(WORKER, { jsonrpc: '2.0', id: 60, method: 'message/send', params: { message: { role: 'ROLE_AGENT', parts: [{ text: 'x' }] } } })
+  check('message/send 无 token → -32005', msgNoToken.json?.error?.code === -32005, String(msgNoToken.json?.error?.code))
+
+  console.log('\n--- 3. JSON-RPC 错误码 ---')
+  const unknown = await rpc(LEAD, { jsonrpc: '2.0', id: 7, method: 'no/such/method', params: {} })
+  check('未知方法 → -32601', unknown.json?.error?.code === -32601, String(unknown.json?.error?.code))
+  const badParams = await rpc(LEAD, { jsonrpc: '2.0', id: 8, method: 'tasks/get', params: {} })
+  check('缺参 → -32602', badParams.json?.error?.code === -32602, String(badParams.json?.error?.code))
+  const noId = await rpc(LEAD, { jsonrpc: '2.0', method: 'tasks/list', params: {} })
+  check('缺 id 请求仍应答', !!noId.json && (noId.json.result || noId.json.error))
+  const notFound = await rpc('00000000-0000-0000-0000-000000000000', { jsonrpc: '2.0', id: 9, method: 'tasks/list', params: {} })
+  check('不存在的 agent → -32001', notFound.json?.error?.code === -32001, String(notFound.json?.error?.code))
+
+  console.log('\n--- 4. tasks/cancel ---')
+  const cancelTask = await req('POST', `/channels/${CH}/tasks`, { token, body: { title: '待取消任务', description: '将被取消' } })
+  const CT = cancelTask.json?.data?.id
+  const cancelR = await rpc(LEAD, { jsonrpc: '2.0', id: 10, method: 'tasks/cancel', params: { taskId: CT } })
+  check('tasks/cancel 生效 CANCELED', cancelR.json?.result?.status?.state === 'CANCELED', cancelR.json?.result?.status?.state ?? JSON.stringify(cancelR.json))
+
+  console.log(`\n━━━ 结果: PASS=${pass} FAIL=${fail} ━━━`)
+  process.exit(fail === 0 ? 0 : 1)
+}
+
+try {
+  await main()
+}
+finally {
+  if (cleanup.channelId) await req('DELETE', `/channels/${cleanup.channelId}`, { token: __token }).catch(() => {})
+}