agentworkshop 0.7.34 → 0.7.38

package/scripts/_audit/probe-binding.mjs

@@ -1,103 +1,114 @@
-/**
- * 定点探针:为什么「绑定成功后 dcw_control 仍报未绑定」?
- * 只构造最小夹具(channel + agent + dcw 节点),逐步打印服务端状态。
- * 只读观测 + 最小必要写入;跑完自行清理。
- */
-const BASE = process.argv[2] ?? 'http://127.0.0.1:3111'
-const TAG = Math.random().toString(36).slice(2, 7)
-
-async function api(method, path, { body, token } = {}) {
-  const res = await fetch(`${BASE}${path}`, {
-    method,
-    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
-    body: body === undefined ? undefined : JSON.stringify(body),
-  })
-  const text = await res.text()
-  let data
-  try { data = JSON.parse(text) } catch { data = text }
-  // 统一拆包:{code,message,data:{...}} → payload
-  const payload = data && typeof data === 'object' && 'data' in data ? data.data : data
-  return { status: res.status, data: payload, raw: data, message: data?.message, code: data?.code, headers: res.headers }
-}
-
-const log = (...a) => console.log(...a)
-
-// 1) 账号(全新实例 → admin)
-const setup = await api('GET', '/api/users/setup-status')
-log('setup-status:', JSON.stringify(setup.data))
-const reg = await api('POST', '/api/users/register', { body: { name: `probe-${TAG}`, email: `probe-${TAG}@w.local`, password: 'ProbePass!2026' } })
-log('register 原始返回:', reg.status, JSON.stringify(reg.data)?.slice(0, 400))
-let token = reg.data?.token ?? reg.data?.data?.token
-if (!token) {
-  const lg = await api('POST', '/api/users/login', { body: { email: `probe-${TAG}@w.local`, password: 'ProbePass!2026' } })
-  log('login 回退:', lg.status, JSON.stringify(lg.data)?.slice(0, 300))
-  token = lg.data?.token ?? lg.data?.data?.token
-}
-log('token?', Boolean(token))
-if (!token) { log('无法取得 token,退出'); process.exit(1) }
-const me = await api('GET', '/api/workshop/users/me', { token })
-log('me:', JSON.stringify(me.data))
-
-// 2) 产线 + 数控模板 + 数控节点
-const line = await api('POST', '/api/workshop/dcw/lines', { body: { name: `probe-line-${TAG}` }, token })
-log('line:', line.status, JSON.stringify(line.data)?.slice(0, 200))
-const lineId = line.data?.line?.id ?? line.data?.id
-
-const tpl = await api('POST', '/api/workshop/dcw/templates', { body: { key: `cw-probe-${TAG}`, name: `probe-${TAG}`, ch: '温度', unit: '℃', min: 0, max: 300, decimals: 1 }, token })
-log('dcw template:', tpl.status, JSON.stringify(tpl.data)?.slice(0, 200))
-const tplKey = tpl.data?.template?.key
-log('  服务端分配 templateKey =', tplKey)
-
-const node = await api('POST', '/api/workshop/dcw', {
-  body: { name: `probe-node-${TAG}`, lineId, templateRef: tplKey, driver: 'mock', unit: '℃', min: 0, max: 300, decimals: 1, holdIntervalMs: 0 },
-  token,
-})
-log('dcw node:', node.status, JSON.stringify(node.data)?.slice(0, 260))
-const nodeId = node.data?.node?.id ?? node.data?.id
-if (!nodeId) { log('建节点失败,退出'); process.exit(1) }
-
-// 3) channel + agent 模板 + 入队
-const ch = await api('POST', '/api/workshop/channels', { body: { name: `probe-ch-${TAG}` }, token })
-const channelId = ch.data?.channelId ?? ch.data?.id
-log('channel:', ch.status, channelId)
-
-const agentTpl = await api('POST', '/api/workshop/agents', { body: { name: `probe-agent-${TAG}`, harness: 'opencode', config: {} }, token })
-const templateId = agentTpl.data?.id
-log('agent 模板 id (=templateId):', templateId, 'status:', agentTpl.status)
-
-const join = await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: { agentId: templateId, role: 'worker' }, token })
-const instanceId = join.data?.id
-log('入队返回 id (=instanceId):', instanceId, 'status:', join.status)
-log('  ⚠ templateId !== instanceId ?', templateId !== instanceId)
-
-// 4) 用 instanceId 绑定
-const bind = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instanceId, nodeId, kind: 'dcw', mode: 'auto' }, token })
-log('bind(instanceId):', bind.status, JSON.stringify(bind.data)?.slice(0, 300))
-const bindingAgentId = bind.data?.binding?.agentId
-log('  ⚠ 服务端存下的 agentId =', bindingAgentId)
-log('  ⚠ 与 instanceId 相同 ?', bindingAgentId === instanceId, '| 与 templateId 相同 ?', bindingAgentId === templateId)
-
-// 5) 直读绑定表
-const listInst = await api('GET', `/api/workshop/agent-tools/bindings?agentId=${instanceId}`, { token })
-log('GET bindings?agentId=instanceId:', listInst.status, JSON.stringify(listInst.data)?.slice(0, 300))
-const listTpl = await api('GET', `/api/workshop/agent-tools/bindings?agentId=${templateId}`, { token })
-log('GET bindings?agentId=templateId:', listTpl.status, JSON.stringify(listTpl.data)?.slice(0, 300))
-
-// 6) 关键:工具调用用哪个 id?
-const haveRec = (await api('GET', '/api/workshop/dcw/optimizations', { token })).data
-log('optimizations 原始:', JSON.stringify(haveRec)?.slice(0, 300))
-for (const [label, id] of [['instanceId', instanceId], ['templateId', templateId]]) {
-  const inv = await api('POST', '/api/workshop/agent-tools/invoke', {
-    body: { agentId: id, tool: 'my_industrial_nodes', args: {} }, token,
-  })
-  log(`invoke my_industrial_nodes @${label}:`, inv.status, String(inv.data?.result?.text ?? JSON.stringify(inv.data)).slice(0, 200))
-  const ctl = await api('POST', '/api/workshop/agent-tools/invoke', {
-    body: { agentId: id, tool: 'dcw_control', args: { node_id: nodeId, value: 100, hypothesis: 'probe' } }, token,
-  })
-  log(`invoke dcw_control @${label}:`, ctl.status, String(ctl.data?.result?.text ?? JSON.stringify(ctl.data)).slice(0, 220))
-}
-
-// 7) 清理
-await api('DELETE', `/api/workshop/agent-tools/bindings/${bind.data?.binding?.id}`, { token })
-await api('DELETE', `/api/workshop/dcw/${nodeId}`, { token })
-log('清理完成')
+/**
+ * 定点探针:为什么「绑定成功后 dcw_control 仍报未绑定」?
+ * 只构造最小夹具(channel + agent + dcw 节点),逐步打印服务端状态。
+ * 只读观测 + 最小必要写入;跑完自行清理。
+ */
+const BASE = process.argv[2] ?? 'http://127.0.0.1:3111'
+const TAG = Math.random().toString(36).slice(2, 7)
+
+async function api(method, path, { body, token } = {}) {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  })
+  const text = await res.text()
+  let data
+  try {
+    data = JSON.parse(text)
+  }
+  catch { data = text }
+  // 统一拆包:{code,message,data:{...}} → payload
+  const payload = data && typeof data === 'object' && 'data' in data ? data.data : data
+  return { status: res.status, data: payload, raw: data, message: data?.message, code: data?.code, headers: res.headers }
+}
+
+const log = (...a) => console.log(...a)
+
+// 1) 账号:优先用显式管理员登录(空实例首位注册也是 admin)
+const ADMIN_EMAIL = process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local'
+const ADMIN_PASS = process.env.AW_ADMIN_PASS ?? 'admin123'
+let token = process.env.AW_PROBE_TOKEN ?? ''
+if (!token) {
+  const lg = await api('POST', '/api/users/login', { body: { email: ADMIN_EMAIL, password: ADMIN_PASS } })
+  token = lg.data?.token
+  log('login:', lg.status, 'role=', lg.data?.user?.role, 'token?', Boolean(token))
+}
+if (!token) {
+  const reg = await api('POST', '/api/users/register', { body: { name: `probe-${TAG}`, email: `probe-${TAG}@w.local`, password: 'ProbePass!2026' } })
+  token = reg.data?.token
+  log('fallback register:', reg.status, 'role=', reg.data?.user?.role)
+}
+if (!token) {
+  log('无法取得 token,退出')
+  process.exit(1)
+}
+const me = await api('GET', '/api/workshop/users/me', { token })
+log('me:', JSON.stringify(me.data))
+
+// 2) 产线 + 数控模板 + 数控节点
+const line = await api('POST', '/api/workshop/dcw/lines', { body: { name: `probe-line-${TAG}` }, token })
+log('line:', line.status, JSON.stringify(line.data)?.slice(0, 200))
+const lineId = line.data?.line?.id ?? line.data?.id
+
+const tpl = await api('POST', '/api/workshop/dcw/templates', { body: { key: `cw-probe-${TAG}`, name: `probe-${TAG}`, ch: '温度', unit: '℃', min: 0, max: 300, decimals: 1 }, token })
+log('dcw template:', tpl.status, JSON.stringify(tpl.data)?.slice(0, 200))
+const tplKey = tpl.data?.template?.key
+log('  服务端分配 templateKey =', tplKey)
+
+const node = await api('POST', '/api/workshop/dcw', {
+  body: { name: `probe-node-${TAG}`, lineId, templateRef: tplKey, driver: 'mock', unit: '℃', min: 0, max: 300, decimals: 1, holdIntervalMs: 0 },
+  token,
+})
+log('dcw node:', node.status, JSON.stringify(node.data)?.slice(0, 260))
+const nodeId = node.data?.node?.id ?? node.data?.id
+if (!nodeId) {
+  log('建节点失败,退出')
+  process.exit(1)
+}
+
+// 3) channel + agent 模板 + 入队
+const ch = await api('POST', '/api/workshop/channels', { body: { name: `probe-ch-${TAG}` }, token })
+const channelId = ch.data?.channelId ?? ch.data?.id
+log('channel:', ch.status, channelId)
+
+const agentTpl = await api('POST', '/api/workshop/agents', { body: { name: `probe-agent-${TAG}`, harness: 'opencode', config: {} }, token })
+const templateId = agentTpl.data?.id
+log('agent 模板 id (=templateId):', templateId, 'status:', agentTpl.status)
+
+const join = await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: { agentId: templateId, role: 'worker' }, token })
+const instanceId = join.data?.id
+log('入队返回 id (=instanceId):', instanceId, 'status:', join.status)
+log('  ⚠ templateId !== instanceId ?', templateId !== instanceId)
+
+// 4) 用 instanceId 绑定
+const bind = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: instanceId, nodeId, kind: 'dcw', mode: 'auto' }, token })
+log('bind(instanceId):', bind.status, JSON.stringify(bind.data)?.slice(0, 300))
+const bindingAgentId = bind.data?.binding?.agentId
+log('  ⚠ 服务端存下的 agentId =', bindingAgentId)
+log('  ⚠ 与 instanceId 相同 ?', bindingAgentId === instanceId, '| 与 templateId 相同 ?', bindingAgentId === templateId)
+
+// 5) 直读绑定表
+const listInst = await api('GET', `/api/workshop/agent-tools/bindings?agentId=${instanceId}`, { token })
+log('GET bindings?agentId=instanceId:', listInst.status, JSON.stringify(listInst.data)?.slice(0, 300))
+const listTpl = await api('GET', `/api/workshop/agent-tools/bindings?agentId=${templateId}`, { token })
+log('GET bindings?agentId=templateId:', listTpl.status, JSON.stringify(listTpl.data)?.slice(0, 300))
+
+// 6) 关键:工具调用用哪个 id?
+const haveRec = (await api('GET', '/api/workshop/dcw/optimizations', { token })).data
+log('optimizations 原始:', JSON.stringify(haveRec)?.slice(0, 300))
+for (const [label, id] of [['instanceId', instanceId], ['templateId', templateId]]) {
+  const inv = await api('POST', '/api/workshop/agent-tools/invoke', {
+    body: { agentId: id, tool: 'my_industrial_nodes', args: {} }, token,
+  })
+  log(`invoke my_industrial_nodes @${label}:`, inv.status, String(inv.data?.result?.text ?? JSON.stringify(inv.data)).slice(0, 200))
+  const ctl = await api('POST', '/api/workshop/agent-tools/invoke', {
+    body: { agentId: id, tool: 'dcw_control', args: { node_id: nodeId, value: 100, hypothesis: 'probe' } }, token,
+  })
+  log(`invoke dcw_control @${label}:`, ctl.status, String(ctl.data?.result?.text ?? JSON.stringify(ctl.data)).slice(0, 220))
+}
+
+// 7) 清理
+await api('DELETE', `/api/workshop/agent-tools/bindings/${bind.data?.binding?.id}`, { token })
+await api('DELETE', `/api/workshop/dcw/${nodeId}`, { token })
+log('清理完成')

package/scripts/_audit/review-fix-verify.mjs

@@ -0,0 +1,158 @@
+/**
+ * 评审问题修复验收 —— 逐条复测 UI 评审报告里的实测项。
+ * 每条断言都对应报告里的一个具体发现,用同一套判据复测(不是"看起来好了")。
+ *
+ * 用法:node scripts/_audit/review-fix-verify.mjs [base]
+ */
+import { existsSync, mkdirSync } from 'node:fs'
+import { join } from 'node:path'
+import puppeteer from 'puppeteer-core'
+
+const BASE = (process.argv[2] ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+const OUT = process.argv.find(a => a.startsWith('--out='))?.slice(6) ?? 'D:\\codes\\ABO\\AgentWorkShop\\.e2e-shots\\design-review'
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+const EXEC = existsSync(EDGE) ? EDGE : CHROME
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+let pass = 0
+const fails = []
+const ok = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`  ✔ ${name}${detail ? ` — ${detail}` : ''}`) }
+  else { fails.push(name); console.log(`  ✘ ${name}${detail ? ` — ${detail}` : ''}`) }
+}
+
+async function main() {
+  mkdirSync(OUT, { recursive: true })
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox', '--hide-scrollbars'], defaultViewport: { width: 1680, height: 1050 } })
+  const lg = 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()).catch(() => null)
+  const token = lg?.data?.token ?? ''
+
+  for (const theme of ['light', 'dark']) {
+    const ctx = await browser.createBrowserContext()
+    const page = await ctx.newPage()
+    const seed = t => page.evaluate((th, tok) => {
+      document.cookie = `token=${encodeURIComponent(tok)}; path=/`
+      document.cookie = `aw-theme=${th}; path=/`
+      localStorage.setItem('app', JSON.stringify({ isDark: th === 'dark', sidebarCollapsed: false, accent: '', themeTouched: true }))
+    }, t, token)
+
+    console.log(`\n=== ${theme} ===`)
+    await page.goto(`${BASE}/daq`, { waitUntil: 'domcontentloaded' })
+    await seed(theme)
+    await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle2' })
+    await sleep(900)
+
+    // ① 焦点环不再破坏形状语言(pill 聚焦后仍是药丸)
+    const pill = await page.evaluate(() => {
+      const el = document.querySelector('.aw-pill') || document.querySelector('.line-pill')
+      if (!el) return null
+      el.focus()
+      const cs = getComputedStyle(el)
+      return { radius: cs.borderRadius, outline: cs.outlineColor, offset: cs.outlineOffset }
+    })
+    ok('聚焦药丸不被压成方角(border-radius 保持)', pill != null && !/^1px/.test(pill.radius), `radius=${pill?.radius}`)
+    ok('焦点环用独立配色(--focus-ring,非墨色)', pill != null && !/41,\s*37,\s*36/.test(pill.outline), `outline=${pill?.outline}`)
+
+    // ② 模态盖得住侧栏 + Esc 可关
+    const modalBtn = await page.evaluate(() => {
+      const btns = [...document.querySelectorAll('button, .aw-pill, .line-pill')]
+      const b = btns.find(x => /添加|新建|add/i.test(x.textContent ?? ''))
+      if (b) { b.click(); return b.textContent.trim().slice(0, 20) }
+      return null
+    })
+    if (modalBtn) {
+      await sleep(500)
+      const covered = await page.evaluate(() => {
+        const mask = document.querySelector('.modal-mask')
+        if (!mask) return { open: false }
+        // 侧栏区域取样点:遮罩是否真的盖在上面
+        const el = document.elementFromPoint(120, 500)
+        return { open: true, topEl: el?.className?.toString?.() ?? el?.tagName ?? '' }
+      })
+      ok('模态已打开', covered.open, modalBtn)
+      if (covered.open) {
+        ok('遮罩盖住侧栏(elementFromPoint 命中遮罩而非侧栏菜单)',
+          !/menu-item|ant-menu/.test(covered.topEl), `top=${covered.topEl}`)
+        await page.keyboard.press('Escape')
+        await sleep(500)
+        const stillOpen = await page.evaluate(() => Boolean(document.querySelector('.modal-mask')))
+        ok('Esc 可关闭模态', !stillOpen)
+      }
+    }
+    else {
+      ok('模态按钮可定位', false, '未找到"添加/新建"按钮')
+    }
+
+    // ③ 趋势空态:无采样时给明确文案,而不是空图
+    await page.goto(`${BASE}/`, { waitUntil: 'networkidle2' })
+    await sleep(1200)
+    const trend = await page.evaluate(() => {
+      const chart = document.querySelector('.chart.h280 canvas')
+      const empty = document.querySelector('.aw-empty.h280')
+      return { hasCanvas: Boolean(chart), hasEmpty: Boolean(empty), emptyText: (empty?.textContent ?? '').trim().slice(0, 60) }
+    })
+    ok('趋势区要么有图要么有空态(不留裸空图)', trend.hasCanvas || trend.hasEmpty,
+      `canvas=${trend.hasCanvas} empty=${trend.hasEmpty}`)
+    if (trend.hasEmpty) ok('空态文案说明采样门控原因', /开跑|批次/.test(trend.emptyText), trend.emptyText)
+
+    // ④ /aml 非冷启动进入不丢主题、不掉到折叠线以下
+    await page.goto(`${BASE}/dcw`, { waitUntil: 'networkidle2' })
+    await sleep(400)
+    await page.goto(`${BASE}/aml`, { waitUntil: 'networkidle2' })
+    // 轮询等待布局收敛:同时区分"永久错位"与"水合期瞬时位移"(CLS)
+    let settledMs = -1
+    const t0 = Date.now()
+    let last = null
+    while (Date.now() - t0 < 4000) {
+      last = await page.evaluate(() => {
+        const main = document.querySelector('.app-main')
+        const layout = document.querySelector('.app-layout')
+        const sider = document.querySelector('.app-sider')
+        return {
+          isDark: document.documentElement.classList.contains('dark'),
+          hasSider: Boolean(document.querySelector('.ant-layout-has-sider')),
+          layoutDir: layout ? getComputedStyle(layout).flexDirection : '',
+          mainTop: Math.round(main?.getBoundingClientRect().top ?? -1),
+          siderTop: Math.round(sider?.getBoundingClientRect().top ?? -1),
+          siderLeft: Math.round(sider?.getBoundingClientRect().left ?? -1),
+          contentTop: Math.round(document.querySelector('.app-content')?.getBoundingClientRect().top ?? -1),
+          docH: document.documentElement.scrollHeight,
+          viewport: window.innerHeight,
+        }
+      })
+      // 判据只要求"内容起点在视口内"(即没被推到折叠线以下)。
+      // 刻意**不**约束 docH:有内容的页面本来就该可以滚动(docH 1255 > vh 1050 是正常的),
+      // 早先顺手加上 docH<=vh+60 把正常页面也判成失败 —— 断言写过头同样是 bug。
+      if (last.contentTop >= 0 && last.contentTop < last.viewport && last.mainTop < last.viewport) {
+        settledMs = Date.now() - t0
+        break
+      }
+      await sleep(120)
+    }
+    const aml = last
+    ok('/aml 二次进入仍保持暗色主题', theme === 'light' ? !aml.isDark : aml.isDark,
+      `html.dark=${aml.isDark} (期望 ${theme === 'dark'})`)
+    ok('/aml 保留 ant-layout-has-sider(横向布局)', aml.hasSider)
+    ok('/aml 内容未掉到折叠线以下(或已收敛)', settledMs >= 0,
+      `收敛=${settledMs}ms contentTop=${aml.contentTop} docH=${aml.docH} vh=${aml.viewport} `
+      + `layoutDir=${aml.layoutDir} mainTop=${aml.mainTop} siderTop=${aml.siderTop} siderLeft=${aml.siderLeft}`)
+
+    // 截图存档
+    await page.screenshot({ path: join(OUT, `fix-verify-${theme}-aml.png`) })
+    await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle2' })
+    await sleep(900)
+    await page.screenshot({ path: join(OUT, `fix-verify-${theme}-daq.png`) })
+    await ctx.close()
+  }
+
+  await browser.close()
+  console.log(`\n结果:${pass} 通过 / ${fails.length} 失败`)
+  if (fails.length) console.log(fails.join('\n'))
+  process.exit(fails.length === 0 ? 0 : 1)
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/scripts/_audit/seed-demo.mjs

@@ -0,0 +1,165 @@
+/**
+ * 视觉走查夹具(demo data seeder)—— 给设计评审准备"有内容的界面"。
+ *
+ * 为什么需要它:空态只能验证排版骨架,验证不了**信息密度 / 表格节奏 / 图表色序 / 玻璃层次**
+ * ——那些恰恰是设计评审要判的东西。所以这里建一套**最小但真实**的工业夹具:
+ * 产线 → 产品 → 配方 → 数采节点(scalar/vector/image)→ 数控节点 → 开采集 → 跑一个批次,
+ * 让仪表盘/数采/数控三页都有活数据。全部走真实 REST,不写库、不造假字段。
+ *
+ * 用法:node scripts/_audit/seed-demo.mjs [base]
+ */
+const BASE = (process.argv[2] ?? process.env.AW_BASE ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+const ADMIN_EMAIL = process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local'
+const ADMIN_PASS = process.env.AW_ADMIN_PASS ?? 'admin123'
+
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let token = ''
+let pass = 0
+const fail = []
+const ok = (name, cond, detail = '') => {
+  if (cond) {
+    pass++
+    console.log(`  ✔ ${name}${detail ? ` — ${detail}` : ''}`)
+  }
+  else {
+    fail.push(name)
+    console.log(`  ✘ ${name}${detail ? ` — ${detail}` : ''}`)
+  }
+}
+
+async function api(method, path, body) {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  })
+  const json = await res.json().catch(() => null)
+  return { status: res.status, data: json?.data, code: json?.code, message: json?.message }
+}
+
+async function main() {
+  console.log(`\n=== 视觉走查夹具 @ ${BASE} ===`)
+
+  // 1. 管理员(空实例首位注册即 admin;已有则登录)
+  const setup = await api('GET', '/api/users/setup-status')
+  if (setup.data?.needsSetup) {
+    const reg = await api('POST', '/api/users/register', { name: 'admin', email: ADMIN_EMAIL, password: ADMIN_PASS })
+    token = reg.data?.token ?? ''
+    ok('注册管理员(空实例首位)', Boolean(token), `role=${reg.data?.user?.role}`)
+  }
+  else {
+    const lg = await api('POST', '/api/users/login', { email: ADMIN_EMAIL, password: ADMIN_PASS })
+    token = lg.data?.token ?? ''
+    ok('登录管理员', Boolean(token), lg.message ?? '')
+    if (!token) {
+      const reg = await api('POST', '/api/users/register', { name: `demo-${Date.now().toString(36)}`, email: `demo-${Date.now().toString(36)}@awshop.local`, password: 'admin123' })
+      token = reg.data?.token ?? ''
+      console.log(`    ⚠ 已知管理员不存在,改用新账号(role=${reg.data?.user?.role},非 admin 时部分页面会 403)`)
+    }
+  }
+  if (!token) {
+    console.error('无法取得 token,退出')
+    process.exit(1)
+  }
+
+  const suffix = Date.now().toString(36).slice(-5)
+
+  // 2. 产线 / 产品 / 配方
+  const line = await api('POST', '/api/workshop/dcw/lines', { name: `热轧一线 · ${suffix}` })
+  const lineId = line.data?.line?.id
+  ok('产线', Boolean(lineId), lineId)
+
+  const product = await api('POST', '/api/workshop/dcw/products', { lineId, name: `低碳钢板 Q235 · ${suffix}` })
+  const productId = product.data?.product?.id
+  ok('产品', Boolean(productId), productId)
+
+  const dcwTpl = await api('POST', '/api/workshop/dcw/templates', {
+    key: `cw-demo-${suffix}`, name: '炉温设定', ch: '烘箱温度', unit: '℃', min: 120, max: 260, decimals: 1,
+  })
+  const dcwTplKey = dcwTpl.data?.template?.key
+  ok('数控模板', Boolean(dcwTplKey), dcwTplKey)
+
+  const mkDcw = async (name) => {
+    const r = await api('POST', '/api/workshop/dcw', {
+      name, templateRef: dcwTplKey, driver: 'mock', unit: '℃', min: 120, max: 260, decimals: 1, lineId, holdIntervalMs: 0,
+    })
+    return r.data?.node?.id
+  }
+  const dw1 = await mkDcw('一段炉温')
+  const dw2 = await mkDcw('二段炉温')
+  ok('数控节点 ×2', Boolean(dw1 && dw2), `${dw1} / ${dw2}`)
+
+  const recipe = await api('POST', '/api/workshop/dcw/recipes', {
+    productId,
+    name: `Q235 标准工艺 · ${suffix}`,
+    description: '夹具配方',
+    params: [
+      { nodeId: dw1, value: 190, min: 175, max: 205 },
+      { nodeId: dw2, value: 205, min: 190, max: 225 },
+    ],
+  })
+  const recipeId = recipe.data?.recipe?.id
+  ok('配方(2 参数)', Boolean(recipeId), recipeId)
+
+  // 3. 数采节点:scalar / vector / image(覆盖三种信号形态 → 三种图表与帧形态)
+  const mkDaq = async (label, body) => {
+    const r = await api('POST', '/api/workshop/daq', { driver: 'mock', lineId, intervalMs: 1000, publishIntervalMs: 0, ...body })
+    ok(`数采节点 ${label}`, Boolean(r.data?.node?.id), r.data?.node?.id ?? r.message)
+    return r.data?.node?.id
+  }
+  const dnTemp = await mkDaq('scalar 炉温', { name: `炉温测温 · ${suffix}`, templateRef: 'daq-temp-tc' })
+  const dnPress = await mkDaq('scalar 压力', { name: `出口压力 · ${suffix}`, templateRef: 'daq-pressure-tx' })
+  const dnProf = await mkDaq('vector 轮廓', { name: `测厚轮廓 · ${suffix}`, templateRef: 'daq-thickness-scan' })
+  const dnTension = await mkDaq('scalar 张力', { name: `膜张力 · ${suffix}`, templateRef: 'daq-tension-cell' })
+  const dnSpeed = await mkDaq('scalar 速度', { name: `产线速度 · ${suffix}`, templateRef: 'daq-line-encoder' })
+  const dnCcd = await mkDaq('image CCD', { name: `表面相机 · ${suffix}`, templateRef: 'daq-ccd-image' })
+  const DAQ_NODES = [dnTemp, dnPress, dnProf, dnTension, dnSpeed, dnCcd].filter(Boolean)
+
+  // 4. 启动采集(网关 + 逐节点),让仪表盘/数采页有实时值
+  await api('POST', '/api/workshop/daq/gateway/start', {})
+  for (const id of DAQ_NODES) {
+    await api('POST', `/api/workshop/daq/${id}/enable`, {})
+    await api('POST', `/api/workshop/daq/${id}/start`, {})
+  }
+  ok('数采网关已启动', true, `${DAQ_NODES.length} 个节点在采`)
+
+  // 5. 跑一个批次(激活批次窗口 → 仪表盘"当前批次"与 DCW 联锁有内容)
+  if (recipeId) {
+    const start = await api('POST', `/api/workshop/dcw/lines/${lineId}/start`, { recipeId })
+    ok('产线开跑', start.status === 200, start.message ?? '')
+  }
+
+  // 让采样攒够样本(图表才有曲线,不是单点)
+  console.log('  · 采集样本中(22s)…')
+  await sleep(22_000)
+
+  // 6. 数控写入若干次 → 参数账本/回退账本/优化记录有历史
+  for (const [id, v] of [[dw1, 188], [dw1, 191], [dw2, 203], [dw2, 207]]) {
+    if (id) await api('POST', `/api/workshop/dcw/${id}/write`, { value: v })
+    await sleep(400)
+  }
+  ok('数控写入历史已生成', true)
+
+  // 7. 停线并停采集(留下已落库的数据,不让夹具持续占用 CPU)
+  await api('POST', `/api/workshop/dcw/lines/${lineId}/stop`, {})
+  for (const id of DAQ_NODES) {
+    await api('POST', `/api/workshop/daq/${id}/stop`, {})
+  }
+
+  // 8. 一个 channel + agent(控制台页需要)
+  const ch = await api('POST', '/api/workshop/channels', {
+    name: `产线值守 · ${suffix}`,
+    scenarioPrompt: '监视热轧一线温度与压力,异常时给出处置建议。',
+    leadAgent: { name: '值班长', harness: 'mock', config: { delayMs: 400 } },
+  })
+  const channelId = ch.data?.channelId ?? ch.data?.id
+  ok('channel + lead agent', Boolean(channelId), channelId)
+
+  console.log(`\n夹具完成:${pass} 项就绪${fail.length ? `,${fail.length} 项失败(${fail.join('、')})` : ''}`)
+  console.log(`提示:仪表盘/数采/数控三页现在有活数据;其余页面无需夹具。`)
+}
+
+main().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})