agentworkshop 0.7.44 → 0.7.47

package/scripts/_dbg-schedule-e2e.mjs

@@ -0,0 +1,262 @@
+/**
+ * 定时任务 REST E2E(v16)—— 对运行中的隔离实例验证完整链路。
+ *
+ * 前置:隔离 dev 实例(全新配置根,首注册即 admin)
+ *   AW_MODE=home AW_HOME=<fresh-dir> node bin/aw.mjs dev --port 3457
+ * 运行: node scripts/_dbg-schedule-e2e.mjs
+ *   SCHED_E2E_BASE / SCHED_E2E_EMAIL / SCHED_E2E_PASSWORD 可覆写
+ *
+ * 覆盖:
+ *  1. channels 列表附 scheduledCount 标志(0 → 建 2 个计划 → 2 → 删/停用回落)
+ *  2. 建计划:参数校验(interval 下限 / 非法 dailyTime → 400)+ next_run_at 计算
+ *  3. 忙等守卫:channel 有未收口任务 → run-now 409 CHANNEL_BUSY + 计划置 waiting;
+ *     channel 收口后 run-now 成功
+ *  4. 对账收口:在途任务取消 → run FAILED(错误留痕)→ 计划回 idle + 连续失败计数
+ *  5. timer 到点自动触发(60s 间隔计划在 ~75s 内被运行时自动触发)
+ *  6. 状态机:PATCH 停用/启用(disabled ↔ idle 且重新计时)+ 删除清理
+ *
+ * 注:mock lead 的任务不会自行终态(停留 WORKING),故收口验证走「取消任务 →
+ *     reconcile → FAILED」的确定性路径;COMPLETED 路径由单元测试覆盖。
+ */
+const BASE = process.env.SCHED_E2E_BASE ?? 'http://127.0.0.1:3457'
+const EMAIL = process.env.SCHED_E2E_EMAIL ?? 'sched-e2e@awshop.local'
+const PASSWORD = process.env.SCHED_E2E_PASSWORD ?? 'sched2E2e'
+const NAME = 'sched-e2e'
+
+let n = 0
+let bad = 0
+const ok = (name, cond, detail = '') => {
+  n += 1
+  console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!cond) bad += 1
+}
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+
+async function api(method, path, { token, body } = {}) {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: {
+      'content-type': 'application/json',
+      ...(token ? { authorization: `Bearer ${token}` } : {}),
+    },
+    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+  })
+  const json = await res.json().catch(() => ({}))
+  return { status: res.status, ...json }
+}
+
+async function waitUp(deadlineMs = 180_000) {
+  const deadline = Date.now() + deadlineMs
+  while (Date.now() < deadline) {
+    try {
+      const r = await fetch(`${BASE}/api/users/setup-status`)
+      if (r.ok) return true
+    }
+    catch { /* not up yet */ }
+    await sleep(1500)
+  }
+  return false
+}
+
+async function login() {
+  const reg = await api('POST', '/api/users/register', { body: { name: NAME, email: EMAIL, password: PASSWORD } })
+  if (reg.code === 0 && reg.data?.token) return reg.data.token
+  const login = await api('POST', '/api/users/login', { body: { email: EMAIL, password: PASSWORD } })
+  if (login.code === 0 && login.data?.token) return login.data.token
+  throw new Error(`注册/登录均失败: ${JSON.stringify(reg)} / ${JSON.stringify(login)}`)
+}
+
+async function main() {
+  console.log('━━━ 定时任务 REST E2E ━━━')
+  console.log(`base = ${BASE}`)
+  if (!await waitUp()) {
+    console.error('服务未在时限内就绪')
+    process.exit(1)
+  }
+  const token = await login()
+  ok('认证就绪', !!token)
+
+  // 建 channel(mock lead)+ **慢 worker**:
+  // 忙等守卫的"占道任务"必须真的长期在途。mock lead 会把简单任务在首个监督轮直接收口,
+  // 只有把任务显式声明为 complex 并派给 delayMs 很大的 worker,子任务才会稳定停在 WORKING
+  // (delayMs 加在 lead 上没用 —— lead 不执行任务)。
+  const ch = await api('POST', '/api/workshop/channels', {
+    token,
+    body: { name: '定时E2E通道', leadAgent: { name: '定时lead', harness: 'mock' } },
+  })
+  ok('创建 channel + mock lead', ch.code === 0 && !!ch.data?.channelId, ch.message)
+  const channelId = ch.data.channelId
+  const slowWorker = await api('POST', '/api/workshop/agents', {
+    token,
+    body: { name: '定时慢worker', harness: 'mock', config: { delayMs: 300_000 } },
+  })
+  const joined = await api('POST', `/api/workshop/channels/${channelId}/agents`, {
+    token,
+    body: { agentId: slowWorker.data?.id, role: 'worker' },
+  })
+  ok('加入慢 worker(delayMs=300s,占道任务长期在途)', joined.code === 0, joined.message)
+
+  // channels 列表:标志字段恒在
+  const chs0 = await api('GET', '/api/workshop/channels', { token })
+  ok('channels 附 scheduledCount 标志(初始 0)', chs0.data.find(c => c.id === channelId)?.scheduledCount === 0)
+
+  // 参数校验
+  const badShort = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: '太快', title: 't', mode: 'interval', intervalMs: 5000 },
+  })
+  ok('interval < 60s → 400', badShort.status === 400, `${badShort.status}`)
+  const badDaily = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: '坏时刻', title: 't', mode: 'daily', dailyTime: '25:99' },
+  })
+  ok('daily 非法 HH:MM → 400', badDaily.status === 400, `${badDaily.status}`)
+
+  // 建两个计划(interval + daily)
+  const now = new Date()
+  const sInt = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: 'E2E巡检', title: '[mock:complex] 定时巡检任务', description: 'E2E interval:需分解派发给 worker 执行', mode: 'interval', intervalMs: 60_000, maxConsecutiveFailures: 3 },
+  })
+  ok('创建 interval 计划', sInt.code === 0 && sInt.data?.mode === 'interval', sInt.message)
+  const nextMs = sInt.data?.nextRunAt ? new Date(sInt.data.nextRunAt).getTime() - now.getTime() : 0
+  ok('interval next_run_at ≈ +60s', nextMs > 45_000 && nextMs <= 62_000, `${Math.round(nextMs / 1000)}s`)
+  const sDaily = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: 'E2E晨报', title: '定时晨报任务', mode: 'daily', dailyTime: '08:00' },
+  })
+  ok('创建 daily 计划', sDaily.code === 0 && sDaily.data?.dailyTime === '08:00', sDaily.message)
+  const nextDaily = sDaily.data?.nextRunAt ? new Date(sDaily.data.nextRunAt) : null
+  ok('daily next_run_at 落在 08:00 且 > now', nextDaily !== null && nextDaily.getHours() === 8 && nextDaily.getTime() > now.getTime(), sDaily.data?.nextRunAt)
+
+  // channel 定时标志 = 2
+  const chs1 = await api('GET', '/api/workshop/channels', { token })
+  ok('channel scheduledCount = 2', chs1.data.find(c => c.id === channelId)?.scheduledCount === 2,
+    String(chs1.data.find(c => c.id === channelId)?.scheduledCount))
+
+  // ===== 忙等守卫:channel 有未收口任务 =====
+  // `[mock:complex]` → lead 必分解派发给慢 worker,子任务停在 WORKING(占道成立)
+  const busy = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    token,
+    body: { title: '[mock:complex] 占道任务', description: '端到端实现占道:需分解派发给 worker 执行' },
+  })
+  ok('人工提交占道任务(未收口)', busy.code === 0 && busy.data?.state === 'SUBMITTED', busy.data?.state)
+  // 等子任务真正进入 WORKING(忙等守卫把 SUBMITTED/ASSIGNED/WORKING/WAITING 都算在途,
+  // 但派发本身是异步的 —— 先等一拍再断言,避免"提交瞬间就 run-now"的时序假象)
+  let inFlight = false
+  for (let i = 0; i < 20 && !inFlight; i++) {
+    await sleep(500)
+    const ts = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+    inFlight = (ts.data ?? []).some(t => t.parentId && t.state === 'WORKING')
+  }
+  ok('占道子任务进入 WORKING(真实在途)', inFlight)
+  const guard = await api('POST', `/api/workshop/schedules/${sInt.data.id}/run`, { token })
+  ok('channel 忙 → run-now 409 CHANNEL_BUSY', guard.status === 409 && guard.code === 'CHANNEL_BUSY', `${guard.status}`)
+  const waiting = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+  ok('计划置 waiting', waiting.data?.state === 'waiting', waiting.data?.state)
+  ok('忙等不触发、不计次', waiting.data?.runCount === 0)
+
+  // channel 收口(取消占道任务**及其子任务**)→ run-now 成功。
+  // 只取消父任务不够:子任务仍在 WORKING,mock worker 的 delayMs=300s 会一直占着 channel。
+  const release = async () => {
+    const list = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+    for (const t of (list.data ?? []).filter(x => !['COMPLETED', 'FAILED', 'CANCELED'].includes(x.state))) {
+      await api('POST', `/api/workshop/tasks/${t.id}/cancel`, { token })
+    }
+    for (let i = 0; i < 30; i++) {
+      await sleep(500)
+      const again = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+      if ((again.data ?? []).every(x => ['COMPLETED', 'FAILED', 'CANCELED'].includes(x.state))) return true
+    }
+    return false
+  }
+  ok('取消占道任务及子任务 → channel 收口', await release())
+  let freed = false
+  for (let i = 0; i < 15 && !freed; i++) {
+    await sleep(2000)
+    const s = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+    if (s.data?.state !== 'waiting') freed = true
+  }
+  const run = await api('POST', `/api/workshop/schedules/${sInt.data.id}/run`, { token })
+  ok('channel 收口后 run-now 成功', run.code === 0 && !!run.data?.taskId, run.message ?? JSON.stringify(run.data))
+  const tasks = await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })
+  const schedTask = (tasks.data ?? []).find(t => t.id === run.data?.taskId)
+  ok('定时任务已提交到 channel', !!schedTask && schedTask.title === '[mock:complex] 定时巡检任务', `state=${schedTask?.state}`)
+  const runningState = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+  ok('计划翻 running', runningState.data?.state === 'running', runningState.data?.state)
+  const reRun = await api('POST', `/api/workshop/schedules/${sInt.data.id}/run`, { token })
+  ok('在途重复 run-now → 409', reRun.status === 409, `${reRun.status} ${reRun.code}`)
+
+  // ===== 对账收口:取消在途任务(**含其子任务**)→ run FAILED + 计数 =====
+  // 子任务必须一起取消:否则慢 worker 的子任务继续占着 channel,timer 到点会被忙等守卫拦下。
+  ok('取消在途定时任务及子任务 → channel 再次收口', await release())
+  let settled = null
+  for (let i = 0; i < 20 && !settled; i++) {
+    await sleep(3000)
+    const s = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+    if (s.data?.state === 'idle') settled = s.data
+  }
+  ok('run 收口后计划回 idle', !!settled, JSON.stringify(settled?.state))
+  const runs = await api('GET', `/api/workshop/schedules/${sInt.data.id}/runs`, { token })
+  const failedRun = (runs.data ?? []).find(r => r.id === run.data.runId)
+  ok('run FAILED + 错误留痕(CANCELED)', failedRun?.state === 'FAILED' && (failedRun?.error ?? '').includes('CANCELED'),
+    `${failedRun?.state} ${failedRun?.error}`)
+  ok('连续失败计数 = 1(failCount=1,runCount=1)', settled?.consecutiveFailures === 1 && settled?.failCount === 1 && settled?.runCount === 1,
+    `consec=${settled?.consecutiveFailures} fail=${settled?.failCount} runs=${settled?.runCount}`)
+
+  // ===== timer 到点自动触发(60s 计划在 ~75s 内被运行时自动触发)=====
+  const before = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+  let timerFired = false
+  const deadline = Date.now() + 90_000
+  while (Date.now() < deadline && !timerFired) {
+    await sleep(5000)
+    const s = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+    if ((s.data?.runCount ?? 0) > (before.data?.runCount ?? 0) && s.data?.state === 'running') timerFired = true
+  }
+  ok('timer 到点自动触发(runCount 推进 + running)', timerFired, `runCount ${before.data?.runCount} → ?`)
+  const afterRuns = await api('GET', `/api/workshop/schedules/${sInt.data.id}/runs`, { token })
+  ok('自动触发 run 记 trigger_kind=timer', (afterRuns.data ?? [])[0]?.triggerKind === 'timer', (afterRuns.data ?? [])[0]?.triggerKind)
+
+  // ===== 状态机:停用/启用 =====
+  // 先取消 timer 刚触发的任务,让计划回 idle 再做停用/启用断言
+  const liveTask = (await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })).data
+    .find(t => t.state !== 'COMPLETED' && t.state !== 'CANCELED' && t.state !== 'FAILED')
+  if (liveTask) await api('POST', `/api/workshop/tasks/${liveTask.id}/cancel`, { token })
+  for (let i = 0; i < 20; i++) {
+    await sleep(2000)
+    const s = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+    if (s.data?.state === 'idle') break
+  }
+  const off = await api('PATCH', `/api/workshop/schedules/${sInt.data.id}`, { token, body: { enabled: 0 } })
+  ok('停用 → disabled', off.data?.enabled === 0 && off.data?.state === 'disabled', `${off.data?.enabled}/${off.data?.state}`)
+  const chs2 = await api('GET', '/api/workshop/channels', { token })
+  ok('停用后 scheduledCount 只算启用 = 1', chs2.data.find(c => c.id === channelId)?.scheduledCount === 1,
+    String(chs2.data.find(c => c.id === channelId)?.scheduledCount))
+  const on = await api('PATCH', `/api/workshop/schedules/${sInt.data.id}`, { token, body: { enabled: 1 } })
+  ok('启用 → idle + 重新计时(next 未来)', on.data?.enabled === 1 && on.data?.state === 'idle' && new Date(on.data?.nextRunAt).getTime() > Date.now(),
+    `${on.data?.state} next=${on.data?.nextRunAt}`)
+  ok('启用重置连续失败', on.data?.consecutiveFailures === 0, String(on.data?.consecutiveFailures))
+
+  // 列表/详情/删除清理
+  const list = await api('GET', '/api/workshop/schedules', { token })
+  ok('列表含计划(附 channel 名)', (list.data ?? []).length >= 2 && list.data.every(s => s.channelName))
+  const del1 = await api('DELETE', `/api/workshop/schedules/${sInt.data.id}`, { token })
+  const del2 = await api('DELETE', `/api/workshop/schedules/${sDaily.data.id}`, { token })
+  ok('删除两个计划', del1.code === 0 && del2.code === 0)
+  const chs3 = await api('GET', '/api/workshop/channels', { token })
+  ok('删除后 scheduledCount 回落 0', chs3.data.find(c => c.id === channelId)?.scheduledCount === 0)
+  const gone = await api('GET', `/api/workshop/schedules/${sInt.data.id}`, { token })
+  ok('已删计划详情 → 404', gone.status === 404, String(gone.status))
+
+  await api('DELETE', `/api/workshop/channels/${channelId}`, { token })
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log(`  ${bad === 0 ? `🎉 全部通过(${n} 项)` : `❌ ${bad}/${n} 项失败`}`)
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  process.exit(bad === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('E2E 异常:', e)
+  process.exit(1)
+})

package/scripts/_dbg-schedule-ui-verify.mjs

@@ -0,0 +1,115 @@
+/**
+ * 定时任务前端视觉验收 —— 对隔离实例验证 schedules 页与 Channel「定时」标签。
+ *
+ * 运行(AW_BASE 指向隔离实例):
+ *   AW_BASE=http://127.0.0.1:3457 node scripts/_dbg-schedule-ui-verify.mjs
+ *
+ * 覆盖:
+ *  1. /workshop/schedules:表格渲染 2 行计划(状态 tag/计划/操作),新建按钮在位
+ *  2. /workshop/w/:id:左栏 Channel 行出现「定时」标签(scheduledCount>0)
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+import { api } from './ui/lib.mjs'
+
+const CHROME = process.env.AW_CHROME ?? 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3457'
+const OUT = 'scripts/_audit/schedules-ui'
+mkdirSync(OUT, { recursive: true })
+
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let bad = 0
+const ok = (name, cond, detail = '') => {
+  console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!cond) bad += 1
+}
+
+async function login() {
+  const email = 'sched-e2e@awshop.local'
+  const password = 'sched2E2e'
+  let r = await api('POST', '/api/users/login', { body: { email, password } })
+  if (r.code === 0 && r.data?.token) return r.data.token
+  r = await api('POST', '/api/users/register', { body: { name: 'sched-e2e', email, password } })
+  if (r.code === 0 && r.data?.token) return r.data.token
+  throw new Error(`登录失败: ${r.message}`)
+}
+
+// ===== 种子:channel + 2 计划 + workspace 挂载 =====
+async function seed(token) {
+  const ch = await api('POST', '/api/workshop/channels', {
+    token,
+    body: { name: '光学薄膜优化组', leadAgent: { name: '生产主管', harness: 'mock' } },
+  })
+  const channelId = ch.data.channelId
+  const s1 = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: '产线数据晨检', title: '汇总昨日产线数据并生成晨报', mode: 'interval', intervalMs: 1_800_000 },
+  })
+  const s2 = await api('POST', '/api/workshop/schedules', {
+    token,
+    body: { channelId, name: '夜班收口盘点', title: '盘点夜班任务收口情况并向 lead 汇报', mode: 'daily', dailyTime: '08:00' },
+  })
+  const ws = await api('POST', '/api/workshop/workspaces', { token, body: { name: '演示工作区' } })
+  const wsId = ws.data?.id
+  await api('POST', `/api/workshop/workspaces/${wsId}/channels/${channelId}`, { token })
+  return { channelId, wsId, schedules: [s1.data, s2.data] }
+}
+
+async function main() {
+  console.log('━━━ 定时任务前端视觉验收 ━━━')
+  const token = await login()
+  const seedData = await seed(token)
+  ok('种子就绪(channel + 2 计划 + workspace)', !!seedData.channelId && seedData.schedules.every(Boolean))
+
+  const browser = await puppeteer.launch({
+    executablePath: CHROME,
+    headless: true,
+    args: ['--no-sandbox', '--disable-dev-shm-usage', '--hide-scrollbars', '--force-color-profile=srgb'],
+    defaultViewport: { width: 1440, height: 900, deviceScaleFactor: 2 },
+  })
+  try {
+    const page = await browser.newPage()
+    await page.setCookie({ name: 'token', value: token, domain: '127.0.0.1', path: '/' })
+    await page.setCookie({ name: 'aw-theme', value: 'dark', domain: '127.0.0.1', path: '/' })
+
+    // 1. schedules 页
+    await page.goto(`${BASE}/workshop/schedules`, { waitUntil: 'domcontentloaded', timeout: 90_000 })
+    await page.waitForFunction(() => document.documentElement.dataset.vpTier !== undefined, { timeout: 90_000, polling: 200 })
+    await page.waitForFunction(() => document.querySelectorAll('.ant-table-row').length > 0, { timeout: 30_000, polling: 300 }).catch(() => {})
+    await sleep(1500)
+    const rows = await page.evaluate(() => document.querySelectorAll('.ant-table-row').length)
+    ok('schedules 表格渲染 2 行', rows >= 2, String(rows))
+    const hasTag = await page.evaluate(() => !!document.querySelector('.ant-table-row .ant-tag'))
+    ok('状态 tag 渲染', hasTag)
+    await page.screenshot({ path: `${OUT}/schedules-page.png`, fullPage: true })
+    console.log(`  截图 → ${OUT}/schedules-page.png`)
+
+    // 2. workspace 页:左栏 Channel「定时」标签
+    await page.goto(`${BASE}/workshop/w/${seedData.wsId}`, { waitUntil: 'domcontentloaded', timeout: 90_000 })
+    await page.waitForFunction(() => document.documentElement.dataset.vpTier !== undefined, { timeout: 90_000, polling: 200 })
+    await page.waitForFunction(() => !!document.querySelector('.sched-tag'), { timeout: 30_000, polling: 300 }).catch(() => {})
+    await sleep(1500)
+    const tagInfo = await page.evaluate(() => {
+      const el = document.querySelector('.sched-tag')
+      const name = document.querySelector('.channel-item .ch-name')?.textContent?.trim()
+      return { present: !!el, count: el?.querySelector('.sched-n')?.textContent?.trim(), channel: name }
+    })
+    ok('Channel 行出现「定时」标签', tagInfo.present, JSON.stringify(tagInfo))
+    ok('标签带计划计数 = 2', tagInfo.count === '2', String(tagInfo.count))
+    await page.screenshot({ path: `${OUT}/workspace-channel-tag.png`, fullPage: false })
+    console.log(`  截图 → ${OUT}/workspace-channel-tag.png`)
+  }
+  finally {
+    await browser.close()
+  }
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log(`  ${bad === 0 ? '🎉 视觉验收通过' : `❌ ${bad} 项失败`}`)
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  process.exit(bad === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('视觉验收异常:', e)
+  process.exit(1)
+})

package/scripts/_dbg-team-matrix.mjs

@@ -0,0 +1,148 @@
+/**
+ * AgentTeam 真实运行场景矩阵(omp 真引擎,REST 契约层)
+ * S1 用户→lead 聊天 + requireReply 回执
+ * S2 用户→worker 直发(@worker 等价) + 回执,lead 不经手
+ * S3 @worker 直派任务(assigneeId)直达到人并完成
+ * S4 loop 模式限次任务
+ * S5 频道公共记忆写入/检索/去重
+ * S6 跨频道 lead→lead 通信 + 回执
+ * S7 成员 disable/enable
+ * 运行: node scripts/_dbg-team-matrix.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 H = { 'content-type': 'application/json', authorization: `Bearer ${login.data.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 tag = 'mt' + Math.random().toString(36).slice(2, 6)
+const textOf = m => (m.parts ?? []).map(p => p.text ?? '').join('')
+const msgsOf = async (ch, limit = 40) => {
+  const j = await api('GET', `/api/workshop/channels/${ch}/messages?limit=${limit}`)
+  const arr = j.data?.messages ?? j.data ?? []
+  return Array.isArray(arr) ? arr : []
+}
+
+// ── 建队:总调度 + 快手 + 细笔 ──
+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 wk1 = (await api('POST', '/api/workshop/agents', { name: `快手-${tag}`, harness: 'omp', config: { intro: '快速执行', systemPromptPrefix: '你是频道成员快手。收到任何人(馆长或总调度)的消息与指令都要直接回应与执行,执行完向请求方回执。中文交流,回复务必简短。' } })).data
+const wk2 = (await api('POST', '/api/workshop/agents', { name: `细笔-${tag}`, harness: 'omp', config: { intro: '细致执行', systemPromptPrefix: '你是频道成员细笔。认真执行收到的指令并回执。中文交流,回复务必简短。' } })).data
+const team = (await api('POST', '/api/workshop/teams', { name: `接线剧组-${tag}` })).data
+const teamId = team.id ?? team?.team?.id
+await api('POST', `/api/workshop/teams/${teamId}/members`, { agentId: lead.id, role: 'lead' })
+await api('POST', `/api/workshop/teams/${teamId}/members`, { agentId: wk1.id, role: 'worker' })
+await api('POST', `/api/workshop/teams/${teamId}/members`, { agentId: wk2.id, role: 'worker' })
+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 W1 = inst.find(a => a.name.includes('快手'))
+const W2 = inst.find(a => a.name.includes('细笔'))
+console.log(`channel=${CH} lead=${L.id.slice(0, 8)} 快手=${W1.id.slice(0, 8)} 细笔=${W2.id.slice(0, 8)}`)
+
+/** 等待出现满足条件的消息(轮询历史) */
+async function waitMsg(pred, budgetMs, label) {
+  const deadline = Date.now() + budgetMs
+  while (Date.now() < deadline) {
+    const msgs = await msgsOf(CH)
+    const hit = msgs.find(pred)
+    if (hit) return hit
+    await sleep(5000)
+  }
+  console.log(`  (超时未等到: ${label})`)
+  return null
+}
+
+// ═══ S1 用户→lead 聊天 + requireReply ═══
+console.log('━━ S1 用户→lead requireReply ━━')
+const s1 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: L.id, text: '总调度,请用一句话确认你在岗。', fromLabel: '馆长', priority: 'immediate', requireReply: true })
+check('S1 消息受理', s1.code === 0, JSON.stringify(s1).slice(0, 60))
+const s1Reply = await waitMsg(m => m.metadata?.['x-aw-in-reply-to'] === s1.data.messageId || (m.metadata?.['x-aw-to-label'] === '馆长' && (m.createdAt ?? '') > s1.data?.message?.createdAt), 180000, 'S1 回执')
+check('S1 lead 回执(要求回复必有应答)', !!s1Reply, s1Reply ? textOf(s1Reply).slice(0, 60) : '')
+
+// ═══ S2 用户→worker 直发(@worker 等价) ═══
+console.log('━━ S2 用户→快手 直发(@worker) ━━')
+const s2 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: W1.id, text: '快手,这条是馆长直接点名给你(经 @提及 锁定)。请回一句「快手在岗」,不要转给总调度。', fromLabel: '馆长', priority: 'immediate', requireReply: true })
+check('S2 消息受理', s2.code === 0)
+const s2Reply = await waitMsg(m => m.metadata?.['x-aw-in-reply-to'] === s2.data.messageId, 180000, 'S2 回执')
+check('S2 worker 直气回执', !!s2Reply, s2Reply ? textOf(s2Reply).slice(0, 60) : '')
+
+// ═══ S3 @worker 直派任务(assigneeId) ═══
+console.log('━━ S3 任务直派 细笔(assigneeId) ━━')
+const s3 = await api('POST', `/api/workshop/channels/${CH}/tasks`, { title: '细笔速记', parts: [{ text: '请用一行字写出今天日期与你的名字缩写,直接完成。' }], mode: 'goal', assigneeId: W2.id, modeConfig: { goalCriteria: '已输出一行日期与名字缩写' } })
+const s3id = s3.data?.id ?? s3.data?.task?.id
+check('S3 任务受理', !!s3id)
+let s3done = null
+const dl3 = Date.now() + 240000
+while (Date.now() < dl3) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/tasks`)
+  const arr = Array.isArray(j.data) ? j.data : j.data?.tasks ?? []
+  s3done = arr.find(x => x.id === s3id)
+  if (s3done && (s3done.state === 'COMPLETED' || s3done.state === 'FAILED')) break
+  await sleep(6000)
+}
+check('S3 直派任务完成(不经 lead 拆解)', s3done?.state === 'COMPLETED', `state=${s3done?.state} assignee=${(s3done?.assigneeId ?? '').slice(0, 8) === W2.id.slice(0, 8) ? '细笔✓' : s3done?.assigneeId}`)
+// 断言无 lead 拆解子任务
+const s3all = (await api('GET', `/api/workshop/channels/${CH}/tasks`))
+const s3arr = Array.isArray(s3all.data) ? s3all.data : s3all.data?.tasks ?? []
+check('S3 无额外子任务(直达不拆解)', s3arr.filter(x => x.parentId === s3id).length === 0, `children=${s3arr.filter(x => x.parentId === s3id).length}`)
+
+// ═══ S4 loop 模式限次 ═══
+console.log('━━ S4 loop 限次任务 ━━')
+const s4 = await api('POST', `/api/workshop/channels/${CH}/tasks`, { title: '循环点名', parts: [{ text: '每轮只回复一行:本轮完成。' }], mode: 'loop', assigneeId: W1.id, modeConfig: { intervalMs: 1000, maxIterations: 2 } })
+const s4id = s4.data?.id ?? s4.data?.task?.id
+check('S4 loop 受理', !!s4id)
+let s4state = ''
+const dl4 = Date.now() + 300000
+while (Date.now() < dl4) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/tasks`)
+  const arr = Array.isArray(j.data) ? j.data : j.data?.tasks ?? []
+  s4state = arr.find(x => x.id === s4id)?.state ?? ''
+  if (['COMPLETED', 'FAILED', 'CANCELED'].includes(s4state)) break
+  await sleep(8000)
+}
+check('S4 loop 限次收口', s4state === 'COMPLETED' || s4state === 'CANCELED', `state=${s4state}`)
+
+// ═══ S5 频道公共记忆 写入/去重 ═══
+console.log('━━ S5 公共记忆 ━━')
+await api('POST', `/api/workshop/channels/${CH}/messages`, { toAgentId: W1.id, text: '请把这条信息写入频道公共记忆(title=本店暗号,content=雪里青,用于对暗号)。写完不用回复。', fromLabel: '馆长', priority: 'immediate' })
+let memHit = null
+const dl5 = Date.now() + 150000
+while (Date.now() < dl5 && !memHit) {
+  const j = await api('GET', `/api/workshop/channels/${CH}/agents/${W1.id}/memories`)
+  const arr = j.data ?? []
+  const list = Array.isArray(arr) ? arr : arr?.memories ?? []
+  memHit = list.find(x => JSON.stringify(x).includes('雪里青'))
+  if (!memHit) await sleep(6000)
+}
+check('S5 记忆可检索', !!memHit, memHit ? JSON.stringify(memHit).slice(0, 80) : '')
+
+// ═══ S6 跨频道 lead→lead ═══
+console.log('━━ S6 跨频道通信 ━━')
+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 })
+const instB = (await api('GET', `/api/workshop/channels/${CHB}/agents`)).data ?? []
+const LB = instB.find(a => a.role === 'lead')
+const s6 = await api('POST', `/api/workshop/channels/${CH}/messages`, { toChannelId: CHB, fromAgentId: L.id, text: '总调度,请用一句话向总店报到。', requireReply: true })
+check('S6 跨频道受理(仅 lead)', s6.code === 0, JSON.stringify(s6).slice(0, 70))
+const s6Reply = await waitMsg(m => m.metadata?.['x-aw-in-reply-to'] === s6.data?.messageId, 180000, 'S6 回信')
+check('S6 对端回信(in_reply_to 关联)', !!s6Reply, s6Reply ? textOf(s6Reply).slice(0, 60) : '')
+
+// ═══ S7 成员 disable/enable ═══
+console.log('━━ S7 成员启停 ━━')
+const d1 = await api('PATCH', `/api/workshop/channels/${CH}/agents/${W2.id}`, { enabled: 0 })
+const list1 = (await api('GET', `/api/workshop/channels/${CH}/agents`)).data ?? []
+const w2after = list1.find(a => a.id === W2.id)
+check('S7 disable 生效', d1.code === 0 && w2after?.enabled === 0, `enabled=${w2after?.enabled}`)
+const d2 = await api('PATCH', `/api/workshop/channels/${CH}/agents/${W2.id}`, { enabled: 1 })
+const list2 = (await api('GET', `/api/workshop/channels/${CH}/agents`)).data ?? []
+check('S7 enable 恢复', (list2.find(a => a.id === W2.id))?.enabled === 1)
+
+console.log(`\n━━━ 场景矩阵: ${pass} pass / ${fail} fail ━━━`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_dbg-ui-fullcrawl.mjs

@@ -0,0 +1,91 @@
+/**
+ * UI 全路由爬测(admin 登录态):20 条路由逐页访问,收集
+ *   ① 控制台 error / pageerror(含 hydration mismatch)
+ *   ② 全部 /api/ 响应中 >=400 的「死 API」
+ *   ③ 渲染完整性(正文非空 + 无错误边界)
+ *   ④ 每页可交互元素计数(异常归零 = 页面壳没挂上)
+ * 运行: AW_BASE=http://127.0.0.1:3001 node scripts/_dbg-ui-fullcrawl.mjs
+ */
+import { launch, openPage, sleep } from './ui/lib.mjs'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const api = async (m, p, body, token) => {
+  const h = { 'content-type': 'application/json' }
+  if (token) h.authorization = `Bearer ${token}`
+  const r = await fetch(BASE + p, { method: m, headers: h, body: body ? JSON.stringify(body) : undefined })
+  return r.json().catch(() => ({}))
+}
+
+const login = await api('POST', '/api/users/login', { email: process.env.E2E_USER ?? 'admin@awshop.local', password: process.env.E2E_PASS ?? 'admin123' })
+const token = login.data?.token
+if (!token) { console.error('FATAL 管理员登录失败', login.message); process.exit(1) }
+
+// 真实实体 id → 详情路由
+const first = (d, k) => (Array.isArray(d) ? d : d?.[k] ?? [])[0]
+const daqNode = first((await api('GET', '/api/workshop/daq', null, token)).data, 'nodes')
+const dcwNode = first((await api('GET', '/api/workshop/dcw', null, token)).data, 'nodes')
+const ws = first((await api('GET', '/api/workshop/workspaces', null, token)).data, undefined)
+
+const ROUTES = [
+  ['/', '仪表盘'],
+  ['/workshop', 'Agent 工作台'],
+  ['/workshop/agents', 'Agent 管理'],
+  ['/workshop/teams', '团队/频道'],
+  ['/workshop/channel-templates', '频道模板'],
+  ['/workshop/schedules', '定时任务'],
+  ['/workshop/w/' + (ws?.id ?? 'none'), '工作区详情'],
+  ['/monitor', '实时监控 HITL'],
+  ['/daq', '数采中心'],
+  ['/daq/' + (daqNode?.id ?? 'none'), '数采详情'],
+  ['/dcw', '产线作业'],
+  ['/dcw/' + (dcwNode?.id ?? 'none'), '产线详情'],
+  ['/aml', '自动建模实验室'],
+  ['/town', '数字孪生'],
+  ['/logs', '审计日志'],
+  ['/permissions', '产线权限'],
+  ['/plugins', '插件'],
+  ['/settings', '设置'],
+  ['/tokens', 'API Token'],
+  ['/users', '用户'],
+]
+
+const browser = await launch({ width: 1440, height: 900 })
+let failed = 0, passed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed++; else failed++
+}
+
+for (const [path, name] of ROUTES) {
+  const page = await openPage(browser, { token })
+  const consoleErrs = []
+  const deadApis = []
+  page.on('pageerror', e => consoleErrs.push(String(e?.message ?? e).slice(0, 160)))
+  page.on('console', (m) => { if (m.type() === 'error') consoleErrs.push(m.text().slice(0, 160)) })
+  page.on('response', (r) => {
+    const u = r.url()
+    if (u.includes('/api/') && r.status() >= 400) deadApis.push(`${r.status()} ${u.replace(BASE, '').slice(0, 90)}`)
+  })
+  try {
+    await page.goto(BASE + path, { waitUntil: 'networkidle2', timeout: 30000 })
+  }
+  catch { await sleep(3000) }
+  await sleep(2500)
+  const info = await page.evaluate(() => ({
+    textLen: (document.body.innerText || '').trim().length,
+    buttons: document.querySelectorAll('button, [role="button"], .ant-btn').length,
+    errBoundary: /Application error|发生错误|页面走丢了|Internal Server Error/.test(document.body.innerText || ''),
+  }))
+  const ok = info.textLen > 40 && !info.errBoundary
+  check(`${name}(${path})`, ok, `text=${info.textLen} btns=${info.buttons}${info.errBoundary ? ' [错误边界!]' : ''}`)
+  const hydration = consoleErrs.filter(e => /Hydration|hydration/.test(e))
+  const hardErrs = consoleErrs.filter(e => !/Hydration|hydration/.test(e))
+  for (const e of hardErrs.slice(0, 5)) console.log(`      · console: ${e}`)
+  for (const d of deadApis.slice(0, 6)) console.log(`      · deadapi: ${d}`)
+  if (hydration.length) console.log(`      · hydration: ${hydration.length} 条(已知 8 页挂账,单独跟踪)`)
+  if (hardErrs.length || deadApis.length) { failed++; passed-- }
+  await page.close()
+}
+await browser.close()
+console.log(`\n━━━ 全路由爬测: ${passed} pass / ${failed} fail ━━━`)
+process.exit(failed > 0 ? 1 : 0)