agentworkshop 0.2.1

package/scripts/demo-omp-channel.ts

@@ -0,0 +1,135 @@
+/**
+ * OMP Harness 实战演示 — 真实 omp 子进程驱动 lead-worker 全流程(懒加载版)
+ *
+ * 场景: lead 统筹「项目分析」,分解给 2 个 worker(懒加载装配),
+ *       worker 用 omp 原生 read 工具作业,lead 汇总完成。
+ *
+ * 懒加载:创建后不装配;任务提交才装配 lead + 调度循环;dispatch 才装配 worker;
+ *         完成后 unloadIdleAgents 释放 omp 子进程与内存。
+ *
+ * 运行: npx tsx scripts/demo-omp-channel.ts
+ */
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import type { WorkspaceTask } from '../server/services/workshop/types/task'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+async function waitUntil(cond: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await cond()) return true
+    await sleep(300)
+  }
+  return false
+}
+
+function getEngine(manager: AgentChannelManager) {
+  return (manager as unknown as {
+    getTaskEngine(): {
+      get(id: string): WorkspaceTask | undefined
+      list(channelId: string): WorkspaceTask[]
+    }
+  }).getTaskEngine()
+}
+
+async function main(): Promise<void> {
+  console.log('')
+  console.log('╔══════════════════════════════════════════════════════════════════╗')
+  console.log('║  OMP Harness 实战演示 — 真实 omp 子进程(懒加载)                 ║')
+  console.log('╚══════════════════════════════════════════════════════════════════╝')
+
+  const db = openWorkshopDb(':memory:')
+  const repos = {
+    channels: createChannelRepo(db),
+    agents: createAgentRepo(db),
+    channelAgents: createChannelAgentRepo(db),
+    messages: createMessageRepo(db),
+    subscriptions: createSubscriptionRepo(db),
+    tasks: createTaskRepo(db),
+    memories: createMemoryRepo(db),
+
+    channelEvents: createChannelEventRepo(db),
+
+    teams: createTeamRepo(db),
+
+    teamMembers: createTeamMemberRepo(db),
+  }
+  const manager = createAgentChannelManager({ repos, implFactory: createAgentImpl, db })
+  const startTime = Date.now()
+
+  try {
+    // Step 1: 创建团队(仅持久化,不装配)
+    const ch = await manager.createChannel({
+      name: 'OMP 分析组',
+      leadAgent: { name: 'lead-统筹者', harness: 'omp', config: {} },
+    })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-包分析', harness: 'omp', config: {} })).id, role: 'worker' })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-配置分析', harness: 'omp', config: {} })).id, role: 'worker' })
+
+    check('创建后不装配(懒加载)', manager.runtimeStatus().wiredAgents.length === 0)
+
+    // Step 2: 提交任务(触发 lead + 调度循环装配)
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '读取 package.json 报告项目名',
+      description: '使用 read 工具读取 package.json,报告 name 字段。简短回答。',
+    })
+    console.log(`  任务已提交: ${task.id.slice(0, 8)}…`)
+    check('任务提交后装配 lead', manager.runtimeStatus().wiredAgents.length >= 1)
+
+    // Step 3: 等待闭环
+    const engine = getEngine(manager)
+    const done = await waitUntil(() => {
+      const t = engine.get(task.id)
+      return t?.state === 'COMPLETED' || t?.state === 'FAILED' || t?.state === 'CANCELED'
+    }, 300_000)
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1)
+    console.log(`  ⏱  耗时: ${elapsed}s`)
+    check('主任务完成', done, `state=${engine.get(task.id)?.state}`)
+
+    const children = engine.list(ch.channelId).filter(t => t.parentId === task.id)
+    const completed = children.filter(c => c.state === 'COMPLETED')
+    check('lead dispatch 子任务', children.length >= 1, `子任务=${children.length}`)
+    check('worker 完成子任务', completed.length >= 1, `${completed.length}/${children.length}`)
+
+    // Step 4: 卸载(释放 omp 子进程;omp 收尾较慢,轮询重试)
+    await waitUntil(async () => {
+      await manager.unloadIdleAgents()
+      return manager.runtimeStatus().wiredAgents.length === 0
+    }, 20_000)
+    check('完成后卸载(内存回收)', manager.runtimeStatus().wiredAgents.length === 0)
+  }
+  finally {
+    await manager.shutdown()
+    db.close()
+  }
+
+  console.log('')
+  console.log(`  ${failures === 0 ? '🎉 全部通过' : `❌ ${failures} 项失败`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('演示异常:', e)
+  process.exit(1)
+})

package/scripts/design-preflight.mjs

@@ -0,0 +1,223 @@
+/**
+ * Pre-Flight 断言 — taste-skill §14 的可机械化项
+ * 在真实渲染的 harness 页面上验证:
+ *  1. 色彩锁:页面计算样式中朱砂 accent 生效(按钮/活跃节点/流式边框)
+ *  2. 形状锁:主要交互件圆角 ∈ {6,8,10,12}px 阶梯
+ *  3. 对比度:正文文本 ≥ 4.5:1,mono 元数据 ≥ 3:1(抽样)
+ *  4. 零 em-dash:全部可见文本无 —/–
+ *  5. 灰阶单族:body/canvas 无暖灰(#f9f7f3 族)
+ *  6. reduced-motion:模拟偏好后动画收敛
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const BASE = 'http://localhost:3001'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+let pass = 0
+let fail = 0
+function check(name, ok, detail = '') {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) {
+    pass++
+  }
+  else {
+    fail++
+  }
+}
+
+/** 相对亮度(WCAG) */
+function luminance(r, g, b) {
+  const f = (c) => {
+    c /= 255
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4
+  }
+  return 0.2126 * f(r) + 0.7152 * f(g) + 0.0722 * f(b)
+}
+function contrast(fg, bg) {
+  const l1 = luminance(...fg)
+  const l2 = luminance(...bg)
+  return (Math.max(l1, l2) + 0.05) / (Math.min(l1, l2) + 0.05)
+}
+function parseRgb(s) {
+  const m = s?.match(/rgba?\(([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)(?:[,\s/]+([\d.]+))?\)/)
+  if (!m) return null
+  let [r, g, b, a] = [Number(m[1]), Number(m[2]), Number(m[3]), m[4] === undefined ? 1 : Number(m[4])]
+  if (a < 1) {
+    // 与纸色合成(近似:取页面底色为纸色)
+    r = Math.round(r * a + 246 * (1 - a))
+    g = Math.round(g * a + 246 * (1 - a))
+    b = Math.round(b * a + 246 * (1 - a))
+  }
+  return [r, g, b]
+}
+
+const api = async (method, path, { body, token } = {}) => {
+  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 res.json()
+}
+
+async function main() {
+  // ── 静态扫描:可见模板零 em-dash ──
+  let emdashHits = 0
+  const walk = (dir) => {
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+      const p = `${dir}/${e.name}`
+      if (e.isDirectory()) walk(p)
+      else if (p.endsWith('.vue')) {
+        const s = fs.readFileSync(p, 'utf-8')
+        const tpl = s.slice(s.indexOf('<template>'), s.indexOf('</template>'))
+        const visible = tpl.replace(/<!--[\s\S]*?-->/g, '')
+        for (const line of visible.split('\n')) {
+          if (/[—–]/.test(line)) {
+            emdashHits++
+            console.log('    emdash:', p, line.trim().slice(0, 60))
+          }
+        }
+      }
+    }
+  }
+  walk('app')
+  check('可见模板零 em-dash/en-dash', emdashHits === 0, `${emdashHits} 处`)
+
+  // ── 动态断言 ──
+  const email = `pf-${Date.now().toString(36)}@test.local`
+  const password = 'Passw0rd!123'
+  const reg = await api('POST', '/api/users/register', { body: { name: `pf-${Date.now().toString(36)}`, email, password } })
+  const token = reg.data.token
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: {
+      name: 'preflight',
+      scenarioPrompt: 'preflight',
+      leadAgent: { name: 'pf-lead', harness: 'mock', config: { delayMs: 200 } },
+    },
+    token,
+  })
+  const cid = ch.data.channelId
+  await api('POST', `/api/workshop/channels/${cid}/agents`, { body: { name: 'pf-w', harness: 'mock', role: 'worker', config: { delayMs: 250, streamDemo: true } }, token })
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'pf-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: 1440, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 160)))
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2000)
+  await page.$eval('input[type="email"]', (el, v) => {
+    const set = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set
+    set.call(el, v)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, email)
+  await page.$eval('input[type="password"]', (el, v) => {
+    const set = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set
+    set.call(el, v)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, 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(3500)
+  if (!page.url().includes('/workshop/w/')) {
+    await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+    await sleep(2200)
+    for (const b of await page.$$('button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').trim()
+      if (txt.includes('进入控制台')) {
+        await b.click()
+        await sleep(3200)
+        break
+      }
+    }
+  }
+  await sleep(2500)
+
+  // 提交任务以产生事件流
+  await page.evaluate(() => {
+    const ta = document.querySelector('.composer textarea')
+    if (!ta) return
+    const set = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set
+    set.call(ta, 'preflight 渲染断言')
+    ta.dispatchEvent(new Event('input', { bubbles: true }))
+    ta.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', ctrlKey: true, bubbles: true }))
+  })
+  await sleep(9000)
+
+  const dom = await page.evaluate(() => {
+    const gs = (el, prop) => el ? getComputedStyle(el)[prop] : null
+    const btn = document.querySelector('.composer .ant-btn-primary')
+    const blocks = document.querySelectorAll('.event-block')
+    const streamText = document.querySelector('.stream-text')
+    const body = document.body
+    return {
+      blocks: blocks.length,
+      btnBg: gs(btn, 'backgroundColor'),
+      btnRadius: gs(btn, 'borderRadius'),
+      btnColor: gs(btn, 'color'),
+      streamBorder: gs(streamText, 'borderLeftColor'),
+      streamRadius: gs(streamText, 'borderRadius'),
+      bodyBg: gs(body, 'backgroundColor'),
+      bodyColor: gs(body, 'color'),
+      visibleText: document.body.innerText,
+    }
+  })
+
+  // 1. 事件流入
+  check('harness 事件块渲染', dom.blocks > 0, `${dom.blocks} 块`)
+
+  // 2. 色彩锁:主按钮 = 朱砂 rgb(181,74,46)
+  check('主按钮朱砂强调色', dom.btnBg?.includes('181, 74, 46'), dom.btnBg)
+
+  // 3. 形状锁:按钮圆角 8px(panel-sm 阶梯)
+  check('按钮圆角 = 8px(panel-sm)', dom.btnRadius === '8px', dom.btnRadius)
+
+  // 4. 按钮对比度 AA
+  const btnBg = parseRgb(dom.btnBg) ?? [181, 74, 46]
+  const btnFg = parseRgb(dom.btnColor) ?? [255, 255, 255]
+  const btnRatio = contrast(btnFg, btnBg)
+  check('主按钮文字对比 ≥ 4.5:1', btnRatio >= 4.5, `${btnRatio.toFixed(2)}:1`)
+
+  // 5. 正文对比度 AA(body ink on paper)
+  const bodyRatio = contrast(parseRgb(dom.bodyColor), parseRgb(dom.bodyBg))
+  check('正文对比 ≥ 4.5:1', bodyRatio >= 4.5, `${bodyRatio.toFixed(2)}:1`)
+
+  // 6. canvas 非暖纸(色彩族轮换)
+  check('canvas 为冷中性 #f6f6f7', dom.bodyBg?.includes('246, 246, 247'), dom.bodyBg)
+
+  // 7. 流式块左边框带朱砂成分(流式中或落定 28% 混合)
+  const sb = parseRgb(dom.streamBorder)
+  check('流式块左边框为朱砂族', !!sb && sb[0] > sb[2] && (sb[0] - sb[2]) > 30, dom.streamBorder)
+
+  // 8. 流式块圆角 chip 阶梯 6px
+  check('流式块圆角 = 6px(chip)', dom.streamRadius === '6px', String(dom.streamRadius))
+
+  // 9. 页面运行时可见文本零 em-dash
+  const runtimeEmdash = (dom.visibleText.match(/[—–]/g) || []).length
+  check('运行时文本零 em-dash', runtimeEmdash === 0, `${runtimeEmdash} 处`)
+
+  // 10. reduced-motion 收敛(CSS 层面已全局收敛,验证关键动画带 prefers 门)
+  //     静态抽查 main.css 是否包含 reduce 块
+  const css = fs.readFileSync('app/assets/css/main.css', 'utf-8')
+  check('全局 prefers-reduced-motion 收敛', css.includes('prefers-reduced-motion: reduce'))
+
+  await browser.close()
+  console.log(`\n${pass} pass / ${fail} fail`)
+  process.exit(fail > 0 ? 1 : 0)
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/design-verify-templates.mjs

@@ -0,0 +1,110 @@
+/**
+ * 模板隔离功能前端截图验证:普通用户(模板库/Channel 模板/会话栏挂载模板)+ admin(monitor 归属视图/用户管理)。
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+
+const BASE = process.env.BASE_URL ?? 'http://localhost:3001'
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const SHOT_DIR = '.design-verify'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, path, { body, token } = {}) => {
+  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 res.json()
+}
+
+async function login(page, email, password) {
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2000)
+  const emailInput = await page.$('input[type="email"]')
+  if (!emailInput) throw new Error('未找到登录表单')
+  await page.$eval('input[type="email"]', (el, v) => {
+    const set = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set
+    set.call(el, v)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, email)
+  await page.$eval('input[type="password"]', (el, v) => {
+    const set = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set
+    set.call(el, v)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, 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(3200)
+}
+
+async function main() {
+  mkdirSync(SHOT_DIR, { recursive: true })
+  // 普通用户
+  const email = `ui-verify-${Date.now().toString(36)}@test.local`
+  await api('POST', '/api/users/register', { body: { name: `uiverify-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' } })
+
+  const browser = await puppeteer.launch({
+    executablePath: EDGE,
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-gpu'],
+    defaultViewport: { width: 1440, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 160)))
+  await login(page, email, 'Passw0rd!123')
+
+  await page.goto(`${BASE}/workshop/agents`, { waitUntil: 'domcontentloaded' })
+  await sleep(2600)
+  await page.screenshot({ path: `${SHOT_DIR}/tpl-01-agents-user.png` })
+  console.log('shot: tpl-01-agents-user.png')
+
+  await page.goto(`${BASE}/workshop/channel-templates`, { waitUntil: 'domcontentloaded' })
+  await sleep(2600)
+  await page.screenshot({ path: `${SHOT_DIR}/tpl-02-channel-templates.png` })
+  console.log('shot: tpl-02-channel-templates.png')
+
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2200)
+  for (const b of await page.$$('button')) {
+    const txt = (await b.evaluate(el => el.textContent) || '').trim()
+    if (txt.includes('进入控制台')) {
+      await b.click()
+      await sleep(3200)
+      break
+    }
+  }
+  await sleep(2200)
+  await page.screenshot({ path: `${SHOT_DIR}/tpl-03-harness-session-list.png` })
+  console.log('shot: tpl-03-harness-session-list.png')
+
+  // admin 视图
+  await page.evaluate(() => {
+    localStorage.clear()
+  })
+  await page.reload()
+  await sleep(1500)
+  await login(page, 'zhangwei@awshop.io', 'Awshop@123')
+
+  await page.goto(`${BASE}/monitor`, { waitUntil: 'domcontentloaded' })
+  await sleep(3500)
+  await page.screenshot({ path: `${SHOT_DIR}/tpl-04-monitor-admin.png` })
+  console.log('shot: tpl-04-monitor-admin.png')
+
+  await page.goto(`${BASE}/users`, { waitUntil: 'domcontentloaded' })
+  await sleep(2600)
+  await page.screenshot({ path: `${SHOT_DIR}/tpl-05-users-admin.png` })
+  console.log('shot: tpl-05-users-admin.png')
+
+  await browser.close()
+  console.log('done')
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/design-verify.mjs

@@ -0,0 +1,170 @@
+/**
+ * 设计重设计验证 — taste-skill 规范下的截图矩阵
+ * 亮/暗两模式 × (首页 / monitor / workshop 登录页 / harness 控制台)
+ * 产出 .design-verify/*.png 供人工复核。
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+
+const BASE = process.env.BASE_URL ?? 'http://localhost:3001'
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const SHOT_DIR = '.design-verify'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, path, { body, token } = {}) => {
+  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 res.json()
+}
+
+async function shot(page, name) {
+  await page.screenshot({ path: `${SHOT_DIR}/${name}.png` })
+  console.log(`  shot: ${name}.png`)
+}
+
+async function toggleDark(page) {
+  // 头部主题切换按钮(moon/sun 图标按钮)
+  const clicked = await page.evaluate(() => {
+    const btns = [...document.querySelectorAll('header button, .app-header button')]
+    const theme = btns.find(b => b.querySelector('.i-tabler-moon-stars, .i-tabler-sun-high'))
+    if (theme) {
+      theme.click()
+      return true
+    }
+    return false
+  })
+  await sleep(600)
+  return clicked
+}
+
+async function main() {
+  mkdirSync(SHOT_DIR, { recursive: true })
+  // 注册专用验证账号 + mock 团队(lead + 2 worker,流式演示开启)
+  const email = `design-verify-${Date.now().toString(36)}@test.local`
+  const password = 'Passw0rd!123'
+  const reg = await api('POST', '/api/users/register', { body: { name: `dv-${Date.now().toString(36)}`, email, password } })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 160)}`)
+
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: {
+      name: 'design-review',
+      scenarioPrompt: '设计评审通道:验证 harness 渲染链路的事件流呈现',
+      leadAgent: { name: 'review-lead', harness: 'mock', config: { delayMs: 200 } },
+    },
+    token,
+  })
+  const channelId = ch.data?.channelId
+  if (!channelId) throw new Error(`channel 创建失败: ${JSON.stringify(ch).slice(0, 160)}`)
+  for (const w of [
+    { name: 'frontend-dev', harness: 'mock', role: 'worker', config: { delayMs: 260, streamDemo: true } },
+    { name: 'ux-polish', harness: 'mock', role: 'worker', config: { delayMs: 320, streamDemo: true } },
+  ]) {
+    await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: w, token })
+  }
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'design-verify-ws' }, token })
+  if (ws.code === 0) await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${channelId}`, { token })
+  console.log('  团队就绪 channel=' + channelId.slice(0, 8))
+
+  const browser = await puppeteer.launch({
+    executablePath: EDGE,
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-gpu', '--window-size=1440,900'],
+    defaultViewport: { width: 1440, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 200)))
+
+  console.log('=== 亮模式 ===')
+  await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded', timeout: 30000 })
+  await sleep(2600)
+  await shot(page, '01-home-light')
+
+  await page.goto(`${BASE}/monitor`, { waitUntil: 'domcontentloaded' })
+  await sleep(2200)
+  await shot(page, '02-monitor-light')
+
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2200)
+  await shot(page, '03-workshop-login-light')
+
+  // 登录 → harness 控制台(有 workspace → 控制台入口按钮)
+  const emailInput = await page.$('input[type="email"]')
+  if (emailInput) {
+    await emailInput.type(email, { delay: 6 })
+    const pwd = await page.$('input[type="password"]')
+    await pwd.type(password, { delay: 6 })
+    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(3200)
+  }
+  if (!page.url().includes('/workshop/w/')) {
+    await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+    await sleep(2200)
+    for (const b of await page.$$('button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').trim()
+      if (txt.includes('进入控制台')) {
+        await b.click()
+        await sleep(3000)
+        break
+      }
+    }
+  }
+  console.log('  harness url:', page.url().slice(-48))
+  await sleep(3000)
+  await shot(page, '04-harness-light')
+
+  // 通过 Composer 提交一条任务(驱动事件流入时间线)
+  const typed = await page.evaluate(() => {
+    const ta = document.querySelector('.composer textarea')
+    if (!ta) return false
+    const setter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set
+    setter.call(ta, '验证渲染链路\n请检查时间线事件块渲染')
+    ta.dispatchEvent(new Event('input', { bubbles: true }))
+    return true
+  })
+  if (typed) {
+    await sleep(300)
+    const sent = await page.evaluate(() => {
+      const ta = document.querySelector('.composer textarea')
+      if (!ta) return false
+      ta.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', ctrlKey: true, bubbles: true }))
+      return true
+    })
+    console.log('  task submitted:', sent)
+    await sleep(3500)
+    await shot(page, '05-harness-streaming-light')
+    await sleep(6500)
+    await shot(page, '06-harness-events-light')
+  }
+
+  console.log('=== 暗模式 ===')
+  if (await toggleDark(page)) {
+    await sleep(800)
+    await shot(page, '07-harness-dark')
+    await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded' })
+    await sleep(2600)
+    await shot(page, '08-home-dark')
+  }
+  else {
+    console.log('  [warn] 未找到主题切换按钮')
+  }
+
+  await browser.close()
+  console.log('done')
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})