agentworkshop 0.7.39 → 0.7.40

package/scripts/ui/md-lint.mjs

@@ -0,0 +1,80 @@
+/**
+ * README 结构自检:标签配平、图片/链接存在、模板残留、表格列数一致。
+ * GitHub 的渲染器很宽容,写坏了不报错 —— 只会在页面上难看,所以得自己查。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+
+const files = process.argv.slice(2)
+const FENCE = String.fromCharCode(96).repeat(3)
+let bad = 0
+const fail = (f, m) => {
+  bad += 1
+  console.log('  x ' + f + ': ' + m)
+}
+
+for (const f of files) {
+  const t = fs.readFileSync(f, 'utf8')
+  const ls = t.split(/\r?\n/)
+  console.log('·', f)
+
+  // 转义残留:只把'转义了不该转义的字符'当问题(表格里的 \\| 是合法的)
+  const esc = ls.findIndex(l => l.includes('\\' + String.fromCharCode(96)))
+  if (esc >= 0) fail(f, 'line ' + (esc + 1) + ' 存在反引号转义残留')
+
+  // ${...} 只在不处于围栏代码块里时才算未求值模板(shell 示例里的 ${VAR} 合法)
+  {
+    let fenced = false
+    let hit = -1
+    for (let i = 0; i < ls.length; i++) {
+      if (ls[i].trim().startsWith(FENCE)) {
+        fenced = !fenced
+        continue
+      }
+      if (!fenced && /\$\{[a-zA-Z_]/.test(ls[i])) {
+        hit = i
+        break
+      }
+    }
+    if (hit >= 0) fail(f, 'line ' + (hit + 1) + ' 存在未求值的模板占位')
+  }
+
+  // 标签配平
+  for (const tag of ['div', 'table', 'tr', 'td', 'details', 'summary', 'picture', 'sub', 'code', 'a']) {
+    const open = (t.match(new RegExp('<' + tag + '(\\s|>)', 'g')) || []).length
+    const close = (t.match(new RegExp('</' + tag + '>', 'g')) || []).length
+    const self = (t.match(new RegExp('<' + tag + '[^>]*/>', 'g')) || []).length
+    if (open - self !== close) fail(f, '<' + tag + '> 不配平: open=' + open + ' self=' + self + ' close=' + close)
+  }
+
+  // 本地图片 / 链接存在
+  for (const m of t.matchAll(/<img[^>]+src="([^"]+)"/g)) {
+    const src = m[1]
+    if (/^https?:/.test(src)) continue
+    const abs = path.resolve(path.dirname(f), src.replace(/^\.\//, ''))
+    if (!fs.existsSync(abs)) fail(f, '图片不存在: ' + src)
+  }
+  for (const m of t.matchAll(/\]\((\.\/[^)#]+)\)/g)) {
+    const abs = path.resolve(path.dirname(f), m[1].replace(/^\.\//, ''))
+    if (!fs.existsSync(abs)) fail(f, '链接目标不存在: ' + m[1])
+  }
+
+  // 表格列数一致(转义管道符不算分隔)
+  const cells = row => row.replace(/\\\|/g, '\u0000').split('|').length
+  let cols = null, start = 0
+  for (let i = 0; i <= ls.length; i++) {
+    const isRow = i < ls.length && /^\s*\|.*\|\s*$/.test(ls[i])
+    if (!isRow) {
+      cols = null
+      continue
+    }
+    const n = cells(ls[i])
+    if (cols === null) {
+      cols = n
+      start = i
+    }
+    else if (n !== cols) fail(f, 'line ' + (i + 1) + ' 表格列数 ' + n + ' != 表头 ' + cols + '(表从 line ' + (start + 1) + ' 起)')
+  }
+}
+console.log(bad ? '\n' + bad + ' 个问题' : '\n全部通过')
+process.exit(bad ? 1 : 0)

package/scripts/ui/perf-audit.mjs

@@ -0,0 +1,132 @@
+/**
+ * 前端实时链路性能体检 —— 用真实浏览器量"数据刷新是否把主线程压垮"。
+ *
+ * 量的是四件事(全部来自运行时,不是估算):
+ *  1. Long Task:>50ms 的主线程阻塞任务数 与 总阻塞时长(TBT)
+ *  2. FPS:用 requestAnimationFrame 采样的真实帧率 + 掉帧比例
+ *  3. DOM 变更速率:每秒多少次节点/属性变更(重渲染churn 的直接代理指标)
+ *  4. CDP Performance 指标:ScriptDuration / LayoutDuration / RecalcStyleDuration 的增量
+ *
+ * 用法: node scripts/ui/perf-audit.mjs [--routes daq,town,dashboard] [--secs 20] [--vp 1440x900]
+ */
+import { ensureVisualUser, launch, openPage, gotoReady, sleep, ROUTES } from './lib.mjs'
+
+const argv = process.argv.slice(2)
+const arg = (k, d) => {
+  const i = argv.indexOf(`--${k}`)
+  return i >= 0 ? argv[i + 1] : d
+}
+const ONLY = arg('routes', 'daq,town,dashboard,monitor')
+const SECS = Number(arg('secs', 20))
+const [W, H] = arg('vp', '1440x900').split('x').map(Number)
+
+const picks = ROUTES.filter(r => ONLY.split(',').includes(r.name))
+// 频道会话台(/workshop/w/<id>)不在静态 ROUTES 里,但它是事件最密的页面 ——
+// 用真实 workspace id 合成一条,才能量到"Agent 事件流是否压垮主线程"。
+
+const token = await ensureVisualUser()
+// 频道会话台(/workshop/w/<id>)不在静态 ROUTES 里,但它是事件最密的页面 ——
+// 用真实 workspace id 合成一条,才能量到"Agent 事件流是否压垮主线程"。
+if (ONLY.includes('console')) {
+  const { api } = await import('./lib.mjs')
+  const ws = await api('GET', '/api/workshop/workspaces', { token })
+  const list = ws.data?.workspaces ?? ws.data ?? []
+  const wid = (Array.isArray(list) ? list[0] : null)?.id
+  if (wid) picks.push({ path: `/workshop/w/${wid}`, name: 'console', title: '频道会话台' })
+  else console.log('!! 没有可用工作区,跳过 console(先跑 scripts/ui/seed-demo.mjs)')
+}
+const browser = await launch()
+
+const INSTRUMENT = () => {
+  const w = window
+  w.__perf = { longTasks: 0, tbt: 0, frames: 0, slowFrames: 0, mutations: 0, last: performance.now(), maxGap: 0 }
+  try {
+    new PerformanceObserver((list) => {
+      for (const e of list.getEntries()) {
+        w.__perf.longTasks++
+        w.__perf.tbt += Math.max(0, e.duration - 50)
+      }
+    }).observe({ entryTypes: ['longtask'] })
+  }
+  catch { /* 不支持 longtask 就只靠 FPS */ }
+  const mo = new MutationObserver((recs) => {
+    w.__perf.mutations += recs.length
+  })
+  mo.observe(document.body, { childList: true, subtree: true, attributes: true, characterData: true })
+  const tick = (t) => {
+    const p = w.__perf
+    const gap = t - p.last
+    p.last = t
+    if (p.frames > 0) {
+      if (gap > p.maxGap) p.maxGap = gap
+      if (gap > 33) p.slowFrames++
+    }
+    p.frames++
+    requestAnimationFrame(tick)
+  }
+  requestAnimationFrame(tick)
+}
+
+const rows = []
+for (const r of picks) {
+  const page = await openPage(browser, { token, dark: true, width: W, height: H, deviceScaleFactor: 1 })
+  const errs = []
+  page.on('pageerror', e => errs.push(String(e.message).slice(0, 140)))
+  try {
+    await gotoReady(page, r.path, { wait: 4000 })
+    await page.evaluate(INSTRUMENT)
+    const client = await page.createCDPSession()
+    await client.send('Performance.enable')
+    const m0 = await client.send('Performance.getMetrics')
+    const t0 = Date.now()
+
+    await sleep(SECS * 1000)
+
+    const m1 = await client.send('Performance.getMetrics')
+    const p = await page.evaluate(() => ({ ...window.__perf }))
+    const metric = (name) => {
+      const a = m0.metrics.find(x => x.name === name)?.value ?? 0
+      const b = m1.metrics.find(x => x.name === name)?.value ?? 0
+      return b - a
+    }
+    const secs = (Date.now() - t0) / 1000
+    const row = {
+      route: r.name,
+      secs: +secs.toFixed(1),
+      fps: +(p.frames / secs).toFixed(1),
+      slowFramePct: +((p.slowFrames / Math.max(1, p.frames)) * 100).toFixed(1),
+      maxGapMs: Math.round(p.maxGap),
+      longTasks: p.longTasks,
+      tbtMs: Math.round(p.tbt),
+      mutPerSec: Math.round(p.mutations / secs),
+      scriptMs: Math.round(metric('ScriptDuration') * 1000),
+      layoutMs: Math.round(metric('LayoutDuration') * 1000),
+      styleMs: Math.round(metric('RecalcStyleDuration') * 1000),
+      nodes: Math.round(metric('Nodes')),
+      listeners: Math.round(metric('JSEventListeners')),
+      pageErrors: errs.length,
+    }
+    rows.push(row)
+    console.log(JSON.stringify(row))
+  }
+  catch (e) {
+    console.log(r.name, 'FAIL', String(e.message).slice(0, 120))
+  }
+  await page.close()
+}
+await browser.close()
+console.log('\n路由          FPS   掉帧%  最大间隔  长任务  阻塞ms  DOM变更/s  脚本ms  布局ms  样式ms')
+for (const r of rows) {
+  console.log(
+    r.route.padEnd(12),
+    String(r.fps).padStart(5),
+    String(r.slowFramePct).padStart(6),
+    String(r.maxGapMs).padStart(8),
+    String(r.longTasks).padStart(7),
+    String(r.tbtMs).padStart(7),
+    String(r.mutPerSec).padStart(10),
+    String(r.scriptMs).padStart(7),
+    String(r.layoutMs).padStart(7),
+    String(r.styleMs).padStart(7),
+  )
+}

package/scripts/ui/readme-assets.mjs

@@ -0,0 +1,30 @@
+/**
+ * README / 文档站素材一键重建。
+ *
+ * 顺序不能换:截图 → GIF → hero。hero.html 里内嵌的是同目录的 town.png / daq.png,
+ * 所以 hero 必须最后渲,否则首屏会用到上一轮的界面截图(实测踩过)。
+ *
+ *   node scripts/ui/readme-assets.mjs [--skip-gif]
+ */
+import fs from 'node:fs'
+import { execFileSync } from 'node:child_process'
+
+const skipGif = process.argv.includes('--skip-gif')
+const run = (script, args = []) => {
+  console.log('\n▶ node ' + script + ' ' + args.join(' '))
+  execFileSync(process.execPath, [script, ...args], { stdio: 'inherit' })
+}
+
+run('scripts/ui/readme-shots.mjs')
+
+if (!skipGif) {
+  for (const story of ['agents', 'daq', 'dcw', 'town', 'dashboard', 'responsive']) {
+    const num = { agents: '01-closedloop', daq: '02-daq', dcw: '03-dcw', town: '04-town', dashboard: '05-dashboard', responsive: '06-responsive' }[story]
+    // record.mjs 按剧本名输出 <story>.gif,这里落成 README 里的 fig-NN-*.gif 编号名
+    run('scripts/ui/record.mjs', [story, '--out', 'docs/readme-assets', '--gifw', '1000'])
+    fs.renameSync('docs/readme-assets/' + story + '.gif', 'docs/readme-assets/fig-' + num + '.gif')
+  }
+}
+
+run('scripts/ui/shot-hero.mjs')
+console.log('\n✔ README 素材重建完成')

package/scripts/ui/readme-shots.mjs

@@ -0,0 +1,42 @@
+/**
+ * README 用真实截图(与 record.mjs 的 GIF 配套)。
+ * 全部 1600×1000 @2x 出图,固定暗色控制室主题 —— README 首屏是深色语境,
+ * 混入亮色截图会让整页忽明忽暗。
+ */
+import path from 'node:path'
+import { ensureVisualUser, launch, openPage, gotoReady } from './lib.mjs'
+
+const OUT = 'docs/readme-assets'
+const W = 1600
+const H = 1000
+
+const SHOTS = [
+  { file: 'town.png', route: '/town', wait: 11000 },
+  { file: 'daq.png', route: '/daq', wait: 8000 },
+  { file: 'shot-workshop.png', route: '/workshop', wait: 7000 },
+  { file: 'shot-monitor.png', route: '/monitor', wait: 6000 },
+  { file: 'shot-settings.png', route: '/settings', wait: 6000 },
+  { file: 'shot-plugins.png', route: '/plugins', wait: 6000 },
+  { file: 'shot-dcw.png', route: '/dcw', wait: 7000 },
+  { file: 'shot-aml.png', route: '/aml', wait: 7000 },
+  { file: 'shot-logs.png', route: '/logs', wait: 6000 },
+]
+
+const token = await ensureVisualUser()
+const browser = await launch()
+for (const s of SHOTS) {
+  const page = await openPage(browser, { token, dark: true, width: W, height: H, deviceScaleFactor: 2 })
+  const errs = []
+  page.on('pageerror', e => errs.push(String(e.message).slice(0, 120)))
+  try {
+    await gotoReady(page, s.route, { wait: s.wait })
+    await page.screenshot({ path: path.join(OUT, s.file) })
+    console.log('  ok  ' + s.file.padEnd(22) + s.route + (errs.length ? '  errs=' + errs.length : ''))
+  }
+  catch (e) {
+    console.log('  FAIL ' + s.file + ' — ' + String(e.message).slice(0, 120))
+  }
+  await page.close()
+}
+await browser.close()
+console.log('-> ' + OUT)

package/scripts/ui/record.mjs

@@ -0,0 +1,225 @@
+/**
+ * 真实流程录屏 → GIF(README / 文档站用)。
+ *
+ * 为什么不用现成录屏工具:这些 GIF 要展示的是**系统的真实行为**
+ * (Agent 真的在跑、DAQ 数值真的在变),所以必须是一段"操作剧本"驱动真实页面,
+ * 再逐帧采集。所有帧都来自 127.0.0.1:3021 上跑着的真服务,没有任何摆拍。
+ *
+ * 管线: puppeteer 定频截图 → ffmpeg palettegen/paletteuse → 有界 GIF
+ *
+ * 用法: node scripts/ui/record.mjs <story> [--out docs/readme-assets] [--w 1440] [--h 900]
+ *       node scripts/ui/record.mjs --list
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { execFileSync } from 'node:child_process'
+import { ensureVisualUser, api, launch, openPage, gotoReady, sleep } from './lib.mjs'
+
+const argv = process.argv.slice(2)
+const arg = (k, d) => {
+  const i = argv.indexOf(`--${k}`)
+  return i >= 0 ? argv[i + 1] : d
+}
+const OUT = arg('out', 'docs/readme-assets')
+const W = Number(arg('w', 1440))
+const H = Number(arg('h', 900))
+const FPS = Number(arg('fps', 12))
+const GIF_W = Number(arg('gifw', 960))
+
+const token = await ensureVisualUser()
+
+/** 找到示范产线的频道(seed-demo.mjs 建的) */
+async function demoChannels() {
+  const r = await api('GET', '/api/workshop/channels', { token })
+  const list = r.data?.channels ?? r.data ?? []
+  return Array.isArray(list) ? list : []
+}
+
+/* ─────────────────────────── 剧本 ─────────────────────────── */
+
+const STORIES = {
+  /** 01 · Agent 团队真实跑一次任务:派发 → 拆解 → 并行执行 → 三个视图收敛 */
+  agents: {
+    title: 'Agent 团队执行任务',
+    async run(page, play) {
+      const chs = await demoChannels()
+      const ch = chs.find(c => c.name === '熔温优化') ?? chs[0]
+      if (!ch) throw new Error('没有可用频道,先跑 scripts/ui/seed-demo.mjs')
+      const cid = ch.channelId ?? ch.id
+      // ⚠️ 路由参数是 **workspaceId**,不是 channelId(/workshop/w/:wsId 里
+      //    channelId 由活动工作区推导)。传 channelId 会落到空壳上。
+      const wsRes = await api('GET', '/api/workshop/workspaces', { token })
+      const wsList = wsRes.data?.workspaces ?? wsRes.data ?? []
+      const wid = (Array.isArray(wsList) ? wsList[0] : null)?.id
+      if (!wid) throw new Error('没有工作区,先跑 scripts/ui/seed-demo.mjs')
+
+      await gotoReady(page, `/workshop/w/${wid}`, { wait: 4500 })
+      await play(1500)
+
+      const goal = '分析 1 号挤出线的熔体温度趋势,给出把温控设定值下调 5°C 的依据与风险。'
+      // 用**和界面同一个 REST 入口**派发任务,而不是往 composer 里模拟打字:
+      // 富文本 composer 的首个 textarea 未必是它本体(踩过:录了 30 秒空时间线),
+      // 而"事件真的在流"才是这段 GIF 要证明的东西。
+      const sent = await api('POST', `/api/workshop/channels/${cid}/tasks`, {
+        token,
+        body: { title: goal, mode: 'goal', fromLabel: 'visual' },
+      })
+      if (sent.code !== 0) console.log('  ⚠ 派发失败:', JSON.stringify(sent).slice(0, 160))
+      await play(9000)
+
+      // 依次切到 Agent lanes / 任务板,展示"同一批事件的不同切面"
+      for (const tab of ['Agent lanes', '任务板', '时间线']) {
+        await page.evaluate((label) => {
+          const el = Array.from(document.querySelectorAll('button, .aw-seg button, [role="tab"]'))
+            .find(b => (b.textContent || '').trim() === label)
+          el?.click()
+        }, tab)
+        await play(tab === '任务板' ? 7000 : 6000)
+      }
+      await play(4000)
+    },
+  },
+
+  /** 02 · 数采实时链路:节点在线、读数跳动、趋势成形 */
+  daq: {
+    title: 'DAQ 实时采集',
+    async run(page, play) {
+      await gotoReady(page, '/daq', { wait: 4500 })
+      await play(6000)
+      // 展开「实时事件」流,展示消息在滚动
+      await page.evaluate(() => {
+        const els = Array.from(document.querySelectorAll('*'))
+        const t = els.find(e => e.children.length === 0 && (e.textContent || '').includes('实时事件'))
+        t?.scrollIntoView({ block: 'center' })
+      })
+      await play(7000)
+      await page.evaluate(() => window.scrollTo({ top: 0, behavior: 'smooth' }))
+      await play(3500)
+    },
+  },
+
+  /** 03 · 产线作业:节点卡片 + 展开一条产线看工艺链 */
+  dcw: {
+    title: '产线作业与写控制',
+    async run(page, play) {
+      await gotoReady(page, '/dcw', { wait: 4500 })
+      await play(4000)
+      await page.evaluate(() => window.scrollBy({ top: 260, behavior: 'smooth' }))
+      await play(4500)
+      await page.evaluate(() => window.scrollBy({ top: -260, behavior: 'smooth' }))
+      await play(3000)
+    },
+  },
+
+  /** 04 · 数字孪生:真实遥测驱动的 3D 产线 */
+  town: {
+    title: '三维数字孪生',
+    async run(page, play) {
+      await gotoReady(page, '/town', { wait: 9000 })
+      await play(9000)
+      // 缓慢平移视角(鼠标拖拽画布中心)
+      const box = await page.evaluate(() => {
+        const c = document.querySelector('canvas')
+        if (!c) return null
+        const r = c.getBoundingClientRect()
+        return { x: r.x + r.width / 2, y: r.y + r.height / 2 }
+      })
+      if (box) {
+        await page.mouse.move(box.x, box.y)
+        await page.mouse.down()
+        for (let i = 0; i < 24; i++) {
+          await page.mouse.move(box.x - i * 6, box.y - i * 1.2)
+          await play(60)
+        }
+        await page.mouse.up()
+      }
+      await play(8000)
+    },
+  },
+
+  /** 05 · 仪表盘:全局 KPI 与趋势 */
+  dashboard: {
+    title: '运行总览仪表盘',
+    async run(page, play) {
+      await gotoReady(page, '/', { wait: 5000 })
+      await play(8000)
+      await page.evaluate(() => window.scrollBy({ top: 420, behavior: 'smooth' }))
+      await play(7000)
+    },
+  },
+
+  /** 06 · 响应式:同一套界面在桌面 / 平板 / 手机上的形态 */
+  responsive: {
+    title: '自适应:桌面 / 平板 / 手机',
+    async run(page, play) {
+      await gotoReady(page, '/daq', { wait: 5000 })
+      await play(2500)
+      const steps = [
+        { w: 1024, h: 768, wait: 2000 },
+        { w: 768, h: 1024, wait: 2000 },
+        { w: 390, h: 844, wait: 2400 },
+      ]
+      for (const s of steps) {
+        await page.setViewport({ width: s.w, height: s.h, deviceScaleFactor: 1 })
+        await play(s.wait)
+      }
+      // 手机上拉开抽屉导航
+      await page.evaluate(() => {
+        document.querySelector('.collapse-btn')?.dispatchEvent(new MouseEvent('click', { bubbles: true }))
+      })
+      await play(3000)
+    },
+  },
+}
+
+// 剧本名 = 第一个**是已知剧本**的位置参数。
+// (不能只判"前一个参数不是 --flag":首位参数的前一个参数是 undefined,
+//  会被误判成"某个 flag 的值",于是永远解析不出剧本名 —— 实测踩过。)
+const storyName = argv.find(a => !a.startsWith('--') && Object.hasOwn(STORIES, a))
+
+if (argv.includes('--list') || !storyName || !STORIES[storyName]) {
+  console.log('可用剧本:')
+  for (const [k, v] of Object.entries(STORIES)) console.log(`  ${k.padEnd(12)} ${v.title}`)
+  process.exit(0)
+}
+
+/* ─────────────────────── 采集 + 合成 ─────────────────────── */
+
+const tmp = path.join('.e2e-shots', 'gif-frames', storyName)
+fs.rmSync(tmp, { recursive: true, force: true })
+fs.mkdirSync(tmp, { recursive: true })
+// 输出目录必须显式建:ffmpeg 不会替你 mkdir,它会以 "Could not open file" 失败,
+// 而 -loglevel error 下错误只出现在 stderr 末尾,很容易被误读成编码参数错误(实测踩过)。
+fs.mkdirSync(OUT, { recursive: true })
+
+const browser = await launch()
+const page = await openPage(browser, { token, dark: true, width: W, height: H, deviceScaleFactor: 1 })
+const errs = []
+page.on('pageerror', e => errs.push(String(e.message).slice(0, 200)))
+
+let n = 0
+let stopped = false
+/** 播放一段"时间":按 FPS 定频采样,长度 = ms */
+async function play(ms) {
+  const frames = Math.max(1, Math.round((ms / 1000) * FPS))
+  for (let i = 0; i < frames && !stopped; i++) {
+    try {
+      await page.screenshot({ path: path.join(tmp, `f${String(n++).padStart(5, '0')}.png`) })
+    }
+    catch { /* 过渡帧丢失可接受 */ }
+    await sleep(Math.round(1000 / FPS))
+  }
+}
+
+console.log(`▶ 录制「${STORIES[storyName].title}」…`)
+await STORIES[storyName].run(page, play)
+stopped = true
+await browser.close()
+console.log(`  帧数 ${n}`)
+
+const gif = path.join(OUT, `${storyName}.gif`)
+const vf = `fps=${FPS},scale=${GIF_W}:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=192:stats_mode=diff[p];[s1][p]paletteuse=dither=bayer:bayer_scale=3:diff_mode=rectangle`
+execFileSync('ffmpeg', ['-y', '-loglevel', 'error', '-i', path.join(tmp, 'f%05d.png'), '-vf', vf, '-loop', '0', gif], { stdio: 'inherit' })
+const size = fs.statSync(gif).size
+console.log(`✔ ${gif} (${(size / 1024 / 1024).toFixed(2)} MB, ${n} 帧)`)
+if (errs.length) console.log('  ⚠ page errors:', errs.slice(0, 4))

package/scripts/ui/seed-admin.mjs

@@ -0,0 +1,68 @@
+/**
+ * 给 admin 账号准备一套可看的演示数据(工作区 + 3 个频道 + 挂载)。
+ * 幂等:已存在就不重复建。admin 是文档里写的管理员账号(admin@awshop.local),
+ * 而演示工作区原本挂在另一个账号下 —— 不补的话 /town 与 /workshop 会是空态。
+ *
+ * ⚠️ 本文件的 api() 是**位置参数** (m, p, body, token);别照抄 lib.mjs 的
+ * options-object 写法 —— 混用会把 {body,token} 整体当成请求体序列化出去,
+ * 服务端 zod 校验失败但外层仍是 200,排查时极具迷惑性(已踩)。
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3021'
+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 })
+  const t = await r.text()
+  try {
+    return JSON.parse(t)
+  }
+  catch {
+    return { code: -1, message: 'HTTP ' + r.status }
+  }
+}
+const login = await api('POST', '/api/users/login', { email: 'admin@awshop.local', password: 'admin123' })
+const token = login.data.token
+console.log('admin:', login.data.user.name, login.data.user.role)
+
+const WANT = [
+  { name: '熔温优化', prompt: '分析熔体温度趋势并优化设定值:读取历史,统计与异常剔除,给出新设定值建议,走 HITL 审批后写入 PLC 并回读校验。', lead: 'melt-lead', workers: ['trend-analyst', 'setpoint-writer'] },
+  { name: '厚度扫描诊断', prompt: '厚度扫描仪多点剖面诊断:定位横向厚度偏差来源,给出模头螺栓调整建议。', lead: 'scan-lead', workers: ['profile-analyst'] },
+  { name: '配方调优', prompt: '配方参数寻优:在工艺窗口内搜索更优参数组合,记录每次试验并给出推荐版本。', lead: 'recipe-lead', workers: ['doe-runner'] },
+]
+
+let wsList = await api('GET', '/api/workshop/workspaces', null, token)
+let list = wsList.data ?? []
+let ws = list.find(w => w.name === '示范产线')
+if (!ws) {
+  const r = await api('POST', '/api/workshop/workspaces', { name: '示范产线' }, token)
+  ws = r.data
+}
+const wsId = ws?.id
+if (!wsId) throw new Error('工作区创建失败: ' + JSON.stringify(wsList).slice(0, 200))
+console.log('workspace:', wsId, ws.name)
+
+const chList = await api('GET', '/api/workshop/channels', null, token)
+const all = chList.data?.channels ?? chList.data ?? []
+for (const spec of WANT) {
+  let ch = (Array.isArray(all) ? all : []).find(c => c.name === spec.name)
+  if (!ch) {
+    const r = await api('POST', '/api/workshop/channels', {
+      name: spec.name,
+      scenarioPrompt: spec.prompt,
+      leadAgent: { name: spec.lead, harness: 'mock', config: { delayMs: 260, streamDemo: true } },
+    }, token)
+    ch = r.data
+    if (!ch) {
+      console.log('  建频道失败', spec.name, JSON.stringify(r).slice(0, 150))
+      continue
+    }
+    for (const w of spec.workers) {
+      await api('POST', `/api/workshop/channels/${ch.channelId ?? ch.id}/agents`, { name: w, harness: 'mock', role: 'worker', config: { delayMs: 300, streamDemo: true } }, token)
+    }
+  }
+  const cid = ch.channelId ?? ch.id
+  await api('POST', `/api/workshop/workspaces/${wsId}/channels/${cid}`, {}, token)
+  console.log('  挂载:', spec.name, cid)
+}
+const after = await api('GET', '/api/workshop/workspaces', null, token)
+console.log('workspaces now:', JSON.stringify(after.data).slice(0, 300))

package/scripts/ui/seed-demo.mjs

@@ -0,0 +1,83 @@
+/**
+ * 视觉走查用示范数据集 —— 用 visual 账号通过公开 REST 建一套「像真产线」的工作区:
+ * 工作区 + 3 个语义化频道(mock harness, 带 streamDemo 流式事件) + 一次真实派发。
+ *
+ * 为什么不复用仓库里已有的 43 个频道:它们是压测遗留的 team-ip16i7gy 之类机读名,
+ * 拿来当 README/GIF 的素材会让截图说不出故事。这里只新增,不改动既有数据。
+ */
+import { ensureVisualUser, api } from './lib.mjs'
+
+const token = await ensureVisualUser()
+
+const CHANNELS = [
+  {
+    name: '熔温优化',
+    scenarioPrompt: '分析熔体温度趋势并优化设定值:读取近 24h 历史,做统计与异常剔除,给出新设定值建议,走 HITL 审批后写入 PLC 并回读校验。',
+    lead: 'melt-lead',
+    workers: [
+      { name: 'trend-analyst', role: 'worker' },
+      { name: 'setpoint-writer', role: 'worker' },
+    ],
+    goal: '分析 1 号挤出线的熔体温度趋势,给出把温控设定值下调 5°C 的依据,并说明风险。',
+  },
+  {
+    name: '厚度扫描诊断',
+    scenarioPrompt: '厚度扫描仪的多点剖面数据诊断:定位横向厚度偏差来源,给出模头螺栓调整建议。',
+    lead: 'scan-lead',
+    workers: [{ name: 'profile-analyst', role: 'worker' }],
+    goal: '诊断 abw16t4v19 的横向厚度剖面偏差,指出偏差最大的点位。',
+  },
+  {
+    name: '配方调优',
+    scenarioPrompt: '配方参数寻优:在工艺窗口内搜索更优参数组合,记录每次试验并给出推荐版本。',
+    lead: 'recipe-lead',
+    workers: [{ name: 'doe-runner', role: 'worker' }],
+    goal: '在工艺窗口内搜索一组更优的牵引速度与冷却水温组合。',
+  },
+]
+
+const existing = await api('GET', '/api/workshop/workspaces', { token })
+const wsList = existing.data?.workspaces ?? existing.data ?? []
+let ws = Array.isArray(wsList) ? wsList.find(w => w.name === '示范产线') : null
+if (!ws) {
+  const r = await api('POST', '/api/workshop/workspaces', { body: { name: '示范产线' }, token })
+  ws = r.data
+}
+const wsId = ws?.id ?? ws?.workspaceId
+if (!wsId) throw new Error('workspace 创建失败: ' + JSON.stringify(existing).slice(0, 300))
+console.log('workspace:', wsId, ws?.name)
+
+const channels = []
+const chList = await api('GET', '/api/workshop/channels', { token })
+const all = chList.data?.channels ?? chList.data ?? []
+for (const spec of CHANNELS) {
+  let ch = (Array.isArray(all) ? all : []).find(c => c.name === spec.name)
+  if (!ch) {
+    const r = await api('POST', '/api/workshop/channels', {
+      body: {
+        name: spec.name,
+        scenarioPrompt: spec.scenarioPrompt,
+        leadAgent: { name: spec.lead, harness: 'mock', config: { delayMs: 260, streamDemo: true } },
+      },
+      token,
+    })
+    ch = r.data
+    if (!ch) {
+      console.log('channel fail', spec.name, JSON.stringify(r).slice(0, 200))
+      continue
+    }
+    const cid = ch.channelId ?? ch.id
+    for (const wk of spec.workers) {
+      await api('POST', `/api/workshop/channels/${cid}/agents`, {
+        body: { name: wk.name, harness: 'mock', role: wk.role, config: { delayMs: 300, streamDemo: true } },
+        token,
+      })
+    }
+  }
+  const cid = ch.channelId ?? ch.id
+  channels.push({ id: cid, name: spec.name, goal: spec.goal })
+  await api('POST', `/api/workshop/workspaces/${wsId}/channels/${cid}`, { token })
+  console.log('mounted channel:', spec.name, cid)
+}
+
+console.log(JSON.stringify({ wsId, channels }, null, 1))