agentworkshop 0.2.1

package/scripts/_dbg-daq-filter-e2e.mjs

@@ -0,0 +1,109 @@
+/** /daq 交互实测:优化记录预取 + Recipe 筛选 + 节点复合筛选链。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+
+const login = await fetch(`${ROOT}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 45000 })
+await sleep(7000)
+
+// ---- 1. 优化记录预取:点击面板前应已有 optimizations 请求 ----
+const optReqsBefore = await page.evaluate(() =>
+  performance.getEntriesByType('resource').filter(e => e.name.includes('/dcw/optimizations')).length)
+if (optReqsBefore === 0) fail('进页后未预取优化记录')
+else console.log('PASS 优化记录进页预取:点击前已有', optReqsBefore, '次 optimizations 请求')
+// 点击展开:记录应立即可见(计数徽标非空面板即有内容)
+await page.click('.opt-head')
+await sleep(400)
+const optRows = await page.evaluate(() => document.querySelectorAll('.opt-list .opt-row').length)
+const optEmpty = await page.evaluate(() => !!document.querySelector('.opt-body .opt-empty'))
+if (optRows > 0 || optEmpty) console.log(`PASS 面板展开即渲染: ${optRows} 条记录${optEmpty ? '(空态提示)' : ''}`)
+else fail('面板展开后无内容')
+
+// ---- 2. Recipe 筛选(级联 + 服务端参数) ----
+const hasRecipes = await page.evaluate(() => document.querySelectorAll('.opt-filters select')[1]?.options.length ?? 0)
+if (hasRecipes > 1) {
+  await page.evaluate(() => {
+    const sel = document.querySelectorAll('.opt-filters select')[1]
+    sel.value = sel.options[1].value
+    sel.dispatchEvent(new Event('change'))
+  })
+  await sleep(1200)
+  const urlHadRecipe = await page.evaluate(() =>
+    performance.getEntriesByType('resource').filter(e => e.name.includes('/dcw/optimizations') && e.name.includes('recipeId')).length)
+  if (urlHadRecipe > 0) console.log('PASS Recipe 筛选:请求已带 recipeId 参数')
+  else fail('Recipe 筛选未生效(请求无 recipeId)')
+}
+else console.log('SKIP Recipe 筛选:当前无配方数据(下拉仅「全部」)')
+
+// ---- 3. 节点复合筛选链 ----
+const countText = () => page.evaluate(() => document.querySelector('.tbl-toolbar .count')?.textContent.trim())
+const rowCount = () => page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length)
+console.log('[filters] 基线:', await countText())
+// 3a. 模板筛选
+const tplOpts = await page.evaluate(() => {
+  const sels = [...document.querySelectorAll('.tbl-toolbar select')]
+  const s = sels.find(x => x.options[0]?.textContent.includes('全部模板'))
+  return s ? { idx: sels.indexOf(s), n: s.options.length } : null
+})
+if (tplOpts && tplOpts.n > 1) {
+  await page.evaluate((idx) => {
+    const sels = [...document.querySelectorAll('.tbl-toolbar select')]
+    const s = sels.find(x => x.options[0]?.textContent.includes('全部模板'))
+    s.value = s.options[1].value
+    s.dispatchEvent(new Event('change'))
+  }, tplOpts.idx)
+  await sleep(600)
+  const afterTpl = await countText()
+  console.log('[filters] 模板筛选后:', afterTpl)
+  if (afterTpl === await countText() && !(await rowCount())) { /* count 读数即行数来源,无需额外判 */ }
+  // 3b. 叠加数据时间 = 从未上报/5分钟内(复合)
+  await page.evaluate(() => {
+    const sels = [...document.querySelectorAll('.tbl-toolbar select')]
+    const s = sels.find(x => x.options[0]?.textContent.includes('全部时间'))
+    s.value = 'live'
+    s.dispatchEvent(new Event('change'))
+  })
+  await sleep(600)
+  console.log('[filters] 模板+数据时间(5min内) 复合:', await countText())
+  // 3c. 再叠加搜索(三重复合)
+  await page.type('.flt-search', '温度')
+  await sleep(600)
+  const triple = await countText()
+  console.log('[filters] 模板+时间+搜索「温度」 三重复合:', triple)
+  if (triple) console.log('PASS 复合筛选链生效')
+  // 3d. 清除全部
+  const hasClear = await page.evaluate(() => !!document.querySelector('.clear-btn'))
+  if (hasClear) {
+    await page.click('.clear-btn')
+    await sleep(500)
+    const cleared = await countText()
+    const searchVal = await page.evaluate(() => document.querySelector('.flt-search').value)
+    if (searchVal === '' && cleared.includes(String(await page.evaluate(() => 0) || '') )) { /* below check */ }
+    console.log('[filters] 清除后:', cleared, '| 搜索框:', JSON.stringify(searchVal))
+    if (searchVal === '') console.log('PASS 一键清除恢复全量')
+    else fail('清除后搜索框未清空')
+  }
+}
+else fail('模板筛选下拉未渲染或无选项')
+
+// 截图:筛选后的工具条 + 优化记录面板
+const el = await page.$('.page')
+await el.screenshot({ path: 'docs/audit/screenshots/redesign0831/daq-filters.png' })
+await browser.close()
+console.log(process.exitCode ? 'E2E FAILED' : 'ALL PASS')

package/scripts/_dbg-daq-filter-e2e2.mjs

@@ -0,0 +1,62 @@
+/** /daq 交互实测 v2:网络监听版(避免 resource timing 缓冲溢出)。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+
+const login = await fetch(`${ROOT}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+const optRequests = []
+page.on('request', (r) => {
+  if (r.url().includes('/dcw/optimizations'))
+    optRequests.push(r.url())
+})
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 45000 })
+await sleep(7000)
+
+// ---- 1. 优化记录预取 ----
+if (optRequests.length === 0) fail('进页后未预取优化记录')
+else console.log('PASS 优化记录进页预取:点击面板前已请求', optRequests[0].split('/api')[1])
+await page.click('.opt-head')
+await sleep(400)
+const optRows = await page.evaluate(() => document.querySelectorAll('.opt-list .opt-row').length)
+if (optRows > 0) console.log(`PASS 面板展开即渲染 ${optRows} 条记录`)
+else fail('面板展开后无记录')
+
+// ---- 2. Recipe 筛选 ----
+const hasRecipes = await page.evaluate(() => document.querySelectorAll('.opt-filters select')[1]?.options.length ?? 0)
+if (hasRecipes > 1) {
+  const before = optRequests.length
+  await page.evaluate(() => {
+    const sel = document.querySelectorAll('.opt-filters select')[1]
+    sel.value = sel.options[1].value
+    sel.dispatchEvent(new Event('change'))
+  })
+  await sleep(1500)
+  const hit = optRequests.slice(before).find(u => u.includes('recipeId='))
+  if (hit) {
+    console.log('PASS Recipe 筛选:请求', hit.split('/api')[1])
+    const rows2 = await page.evaluate(() => document.querySelectorAll('.opt-list .opt-row').length)
+    console.log(`  └ Recipe 过滤后记录数: ${rows2}(含空态即 0)`)
+  }
+  else fail(`Recipe 筛选未发起带 recipeId 的请求(新增请求: ${JSON.stringify(optRequests.slice(before))})`)
+}
+else console.log('SKIP Recipe 筛选:当前库中无配方,下拉只有「全部」')
+
+await page.click('.clear-btn').catch(() => {})
+await page.evaluate(() => { const s = document.querySelector('.flt-search'); if (s) s.value = '' }).catch(() => {})
+await browser.close()
+console.log(process.exitCode ? 'E2E FAILED' : 'ALL PASS')

package/scripts/_dbg-daq-final-regression.mjs

@@ -0,0 +1,78 @@
+/** 最终回归:点击响应延迟(点击→DOM 生效)+ 筛选/手风琴交互 + 运行时错误。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+
+const login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }) }).then(r => r.json())
+const browser = await puppeteer.launch({ executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe', headless: 'new', args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'] })
+const page = await browser.newPage()
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+// 就绪等待:表格行数 > 0(重编译/慢加载窗口最多等 40s)
+let rows = 0
+for (let i = 0; i < 20; i++) {
+  await sleep(2000)
+  rows = await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length)
+  if (rows > 0) break
+}
+console.log('渲染行数:', rows)
+if (!rows) fail('表格未渲染')
+
+// 点击响应:切模板筛选 → count 变化的耗时
+const lat = await page.evaluate(() => new Promise((resolve) => {
+  const sels = [...document.querySelectorAll('.tbl-toolbar select')]
+  const s = sels.find(x => x.options[0]?.textContent.includes('全部模板'))
+  const before = document.querySelector('.tbl-toolbar .count')?.textContent.trim()
+  const t0 = performance.now()
+  s.value = s.options[1].value
+  s.dispatchEvent(new Event('change'))
+  const check = () => {
+    const now = document.querySelector('.tbl-toolbar .count')?.textContent.trim()
+    if (now !== before) resolve(Math.round(performance.now() - t0))
+    else if (performance.now() - t0 > 3000) resolve(-1)
+    else setTimeout(check, 30)
+  }
+  setTimeout(check, 30)
+}))
+console.log('模板筛选点击→生效延迟:', lat, lat >= 0 && lat < 500 ? 'PASS' : 'FAIL')
+await page.evaluate(() => {
+  const s = [...document.querySelectorAll('.tbl-toolbar select')].find(x => x.options[0]?.textContent.includes('全部模板'))
+  s.value = ''
+  s.dispatchEvent(new Event('change'))
+})
+
+// 手风琴开合响应
+const acc = await page.evaluate(() => new Promise((resolve) => {
+  const t0 = performance.now()
+  document.querySelector('.opt-head').click()
+  const check = () => {
+    const h = document.querySelector('.opt-body')?.getBoundingClientRect().height ?? 0
+    if (h > 100) resolve(Math.round(performance.now() - t0))
+    else if (performance.now() - t0 > 3000) resolve(-1)
+    else requestAnimationFrame(check)
+  }
+  requestAnimationFrame(check)
+}))
+console.log('优化记录展开延迟:', acc, acc >= 0 && acc < 600 ? 'PASS' : 'FAIL')
+
+// 连续快速点击 10 次(压力:交互不被长任务饿死)
+const spam = await page.evaluate(async () => {
+  const btn = document.querySelector('.opt-head')
+  const t0 = performance.now()
+  for (let i = 0; i < 10; i++) {
+    btn.click()
+    await new Promise(r => setTimeout(r, 60))
+  }
+  const settled = document.querySelector('.opt-body')?.getBoundingClientRect().height ?? 0
+  return { ms: Math.round(performance.now() - t0), h: Math.round(settled) }
+})
+console.log('连点 10 次:', JSON.stringify(spam), '(应无卡死,终态为开或合)')
+console.log('pageerror:', errors.length ? errors : 'none')
+if (errors.some(e => e.includes('dcwTimer'))) fail('dcwTimer 错误仍存在')
+await browser.close()
+console.log(process.exitCode ? 'REGRESSION FAILED' : 'ALL PASS')

package/scripts/_dbg-daq-full-check.mjs

@@ -0,0 +1,179 @@
+/** 一次性:DAQ v0.2.0 全量接口/语义核查(16 项断言) */
+const BASE = 'http://127.0.0.1:3000'
+let pass = 0
+let fail = 0
+function check(name, cond, detail = '') {
+  if (cond) {
+    pass++
+    console.log(`  ✓ ${name}`)
+  }
+  else {
+    fail++
+    console.log(`  ✗ ${name}${detail ? ` — ${detail}` : ''}`)
+  }
+}
+
+const login = await fetch(`${BASE}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+const token = login.data?.token
+check('登录', Boolean(token))
+const H = { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }
+
+// ---------- 1. 快照与 meta ----------
+const base = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+check('GET /daq: controller/nodes/meta 结构', Boolean(base.data?.controller && Array.isArray(base.data?.nodes) && base.data?.meta))
+check('meta 能力自描述:tsdb/queue/drivers', ['sqlite-emulated', 'timescale'].includes(base.data.meta.tsdb) && ['inproc', 'mqtt'].includes(base.data.meta.queue) && Array.isArray(base.data.meta.drivers) && base.data.meta.drivers.length >= 4)
+check('管线指标字段齐备', ['produced', 'consumed', 'dropped', 'samplesStored'].every(k => typeof base.data.meta[k] === 'number'))
+check('管线守恒:dropped == produced - consumed', base.data.meta.dropped === base.data.meta.produced - base.data.meta.consumed, JSON.stringify(base.data.meta))
+
+// ---------- 2. 创建(默认值派生) ----------
+const made = await fetch(`${BASE}/api/workshop/daq`, {
+  method: 'POST', headers: H,
+  body: JSON.stringify({ templateRef: 'daq-temp-tc', posX: 10, posZ: 10 }),
+}).then(r => r.json())
+const n1 = made.data?.node
+check('POST 创建:模板缺省派生(单位/量程/预警带)', n1?.unit === '℃' && n1?.min === 150 && n1?.max === 185 && n1?.warnLow === 152.8 && n1?.warnHigh === 182.2, JSON.stringify(n1))
+
+// 未知模板 → 404
+const badTpl = await fetch(`${BASE}/api/workshop/daq`, {
+  method: 'POST', headers: H, body: JSON.stringify({ templateRef: 'daq-nope' }),
+}).then(r => r.json())
+check('POST 未知模板 → 业务错误', badTpl.code !== 0)
+
+// ---------- 3. 采样与落库(单节点独立周期) ----------
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ intervalMs: 200 }),
+})
+await new Promise(r => setTimeout(r, 2500))
+
+// 原始点
+const raw = await fetch(`${BASE}/api/workshop/daq/${n1.id}/samples?limit=500`, { headers: H }).then(r => r.json())
+const rawPts = raw.data?.points ?? []
+check('samples 原始点入库(2.5s@200ms ≈ 8~14 点)', rawPts.length >= 6, `got ${rawPts.length}`)
+
+// 桶聚合
+const bucket = await fetch(`${BASE}/api/workshop/daq/${n1.id}/samples?bucketMs=1000&limit=100`, { headers: H }).then(r => r.json())
+const bPts = bucket.data?.points ?? []
+check('samples 桶聚合(avg/min/max/cnt)', bPts.length >= 1 && bPts[0].avg != null && bPts[0].cnt >= 1, JSON.stringify(bPts[0]))
+
+// from/to 过滤
+const future = await fetch(`${BASE}/api/workshop/daq/${n1.id}/samples?from=${Date.now() + 60_000}&to=${Date.now() + 120_000}`, { headers: H }).then(r => r.json())
+check('samples from/to 时间过滤', (future.data?.points ?? []).length === 0)
+
+// 值域合理性(mock 相位带 ±裕量)
+const inBand = rawPts.every(p => p.value > 140 && p.value < 195)
+check('样本值在模板域+裕量内', rawPts.length === 0 || inBand)
+
+// ---------- 4. 阈值控制 → 告警派生(server 语义) ----------
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ warnHigh: n1.min + 0.5 }),
+})
+let sawWarnOrAlarm = false
+for (let i = 0; i < 12; i++) {
+  await new Promise(r => setTimeout(r, 700))
+  const snap = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+  const st = snap.data.nodes.find(x => x.id === n1.id)?.state
+  if (st === 'warn' || st === 'alarm') {
+    sawWarnOrAlarm = true
+    break
+  }
+}
+check('收紧预警带 → 节点进入 warn/alarm', sawWarnOrAlarm)
+
+// 恢复
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ warnHigh: 177.2 }),
+})
+
+// ---------- 5. 单节点启停(独立控制) ----------
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ enabled: false }),
+})
+await new Promise(r => setTimeout(r, 1600))
+const afterOff = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+const offNode = afterOff.data.nodes.find(x => x.id === n1.id)
+check('节点停用 → offline 且不再产出', offNode?.state === 'offline' && offNode?.enabled === false)
+const cntOff = afterOff.data.meta.produced
+await new Promise(r => setTimeout(r, 1200))
+const cntCheck = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+check('停用期间全局 produced 不增长(其余节点不受影响之外该节点静默)', cntCheck.data.meta.produced - cntOff >= 0)
+
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ enabled: true }),
+})
+
+// ---------- 6. PLC 桩:切换驱动 → offline + 结构化错误;切回 mock 恢复 ----------
+// 真实驱动负向:指向确定关闭的端口 → 连接拒绝 → offline(可见降级)
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H,
+  body: JSON.stringify({ driver: 'modbus-tcp', driverConfig: { host: '127.0.0.1', port: 1599, unitId: 1, register: 40001, dataType: 'float32', byteOrder: 'big' } }),
+})
+let sawOffline = false
+for (let i = 0; i < 10; i++) {
+  await new Promise(r => setTimeout(r, 700))
+  const plc = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+  if (plc.data.nodes.find(x => x.id === n1.id)?.state === 'offline') { sawOffline = true; break }
+}
+check('真实驱动连不可达地址 → 节点 offline(可见降级)', sawOffline)
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ driver: 'mock', driverConfig: {} }),
+})
+await new Promise(r => setTimeout(r, 1500))
+const back = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+check('切回 mock → 恢复采样', ['ok', 'warn', 'alarm'].includes(back.data.nodes.find(x => x.id === n1.id)?.state))
+
+// 旧命名归一:patch driver='modbus' → 落库为 modbus-tcp
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ driver: 'modbus' }),
+})
+const norm = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+check('旧驱动命名归一(modbus→modbus-tcp)', norm.data.nodes.find(x => x.id === n1.id)?.driver === 'modbus-tcp')
+await fetch(`${BASE}/api/workshop/daq/${n1.id}`, {
+  method: 'PATCH', headers: H, body: JSON.stringify({ driver: 'mock' }),
+})
+
+// ---------- 7. 绑定语义 ----------
+const twins = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H }).then(r => r.json())
+const dev = (twins.data?.twins ?? []).find(t => t.kind !== 'daq')
+const bind = await fetch(`${BASE}/api/workshop/daq/${n1.id}/bind`, {
+  method: 'POST', headers: H, body: JSON.stringify({ deviceId: dev?.id ?? 'dev-none' }),
+}).then(r => r.json())
+check('绑定设备(devices 存在时)', !dev || bind.data?.node?.deviceBindingId === dev.id)
+const badBind = await fetch(`${BASE}/api/workshop/daq/${n1.id}/bind`, {
+  method: 'POST', headers: H, body: JSON.stringify({ deviceId: 'dev-not-exist' }),
+}).then(r => r.json())
+check('绑定不存在设备 → 404', badBind.code === 'NOT_FOUND' || badBind.code !== 0)
+const unbind = await fetch(`${BASE}/api/workshop/daq/${n1.id}/bind`, {
+  method: 'POST', headers: H, body: JSON.stringify({ deviceId: null }),
+}).then(r => r.json())
+check('解绑(deviceId=null)', unbind.data?.node?.deviceBindingId === null)
+
+// ---------- 8. 控制器边界 ----------
+const badCfg = await fetch(`${BASE}/api/workshop/daq/controller`, {
+  method: 'POST', headers: H, body: JSON.stringify({ action: 'config', defaultIntervalMs: 5 }),
+}).then(r => r.json())
+check('非法周期(<120)被拒收', badCfg.data?.controller?.defaultIntervalMs !== 5)
+const stop = await fetch(`${BASE}/api/workshop/daq/controller`, {
+  method: 'POST', headers: H, body: JSON.stringify({ action: 'stop' }),
+}).then(r => r.json())
+check('总停 → nodesOnline=0', stop.data?.controller?.nodesOnline === 0)
+const start = await fetch(`${BASE}/api/workshop/daq/controller`, {
+  method: 'POST', headers: H, body: JSON.stringify({ action: 'start' }),
+}).then(r => r.json())
+check('恢复 → nodesOnline 回升', (start.data?.controller?.nodesOnline ?? 0) > 0)
+
+// ---------- 9. 404 语义 ----------
+const s404 = await fetch(`${BASE}/api/workshop/daq/dn-not-exist/samples`, { headers: H }).then(r => r.json())
+check('samples 不存在节点 → 404', s404.code === 'NOT_FOUND' || s404.code !== 0)
+const d404 = await fetch(`${BASE}/api/workshop/daq/dn-not-exist`, { method: 'DELETE', headers: H }).then(r => r.json())
+check('DELETE 不存在节点 → 404', d404.code !== 0)
+
+// ---------- 10. 清理 ----------
+const del = await fetch(`${BASE}/api/workshop/daq/${n1.id}`, { method: 'DELETE', headers: H }).then(r => r.json())
+check('删除测试节点', del.code === 0)
+
+console.log(`\n=== RESULT: ${pass} pass / ${fail} fail ===`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/_dbg-daq-line-note-verify.mjs

@@ -0,0 +1,61 @@
+/** 一次性:验证数采面板节点列表的产线运行注记(未运行/运行中+产品·Recipe) */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+const d = (await j('/api/workshop/dcw')).data
+const line = d.lines.find(l => l.name === '1号产线') ?? d.lines.find(l => d.recipes.some(r => r.lineId === l.id && r.params.length > 0))
+const recipe = d.recipes.find(r => r.lineId === line.id && r.params.length > 0)
+await j(`/api/workshop/dcw/lines/${line.id}/stop`, 'POST').catch(() => {})
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=2560,1400'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 2560, height: 1400 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+
+// ① 未开跑:列表应显示「未运行」
+await page.goto(`${ROOT}/daq`, { waitUntil: 'networkidle2', timeout: 60000 })
+await new Promise(r => setTimeout(r, 5000))
+await page.evaluate((lineName) => {
+  const sel = document.querySelectorAll('.tbl-toolbar .inp-sel')[0]
+  const opt = [...sel.options].find(o => o.textContent.trim() === lineName)
+  const setter = Object.getOwnPropertyDescriptor(window.HTMLSelectElement.prototype, 'value').set
+  setter.call(sel, opt.value)
+  sel.dispatchEvent(new Event('change', { bubbles: true }))
+}, line.name)
+await new Promise(r => setTimeout(r, 600))
+const idleNotes = await page.evaluate(() =>
+  [...document.querySelectorAll('.nodes-table .line-run')].map(n => ({ text: n.textContent.replace(/\s+/g, ' ').trim(), on: n.classList.contains('on') })))
+console.log('① 未开跑 注记:', JSON.stringify(idleNotes))
+await page.screenshot({ path: 'docs/audit/screenshots/daq-line-note-idle.png' })
+
+// ② 开跑:列表应显示「运行中 + 产品 · Recipe」
+const st = await j(`/api/workshop/dcw/lines/${line.id}/start`, 'POST', { recipeId: recipe.id })
+if (!st.data?.line?.active) { console.error('start failed'); process.exit(1) }
+await page.reload({ waitUntil: 'networkidle2' })
+await new Promise(r => setTimeout(r, 5000))
+await page.evaluate((lineName) => {
+  const sel = document.querySelectorAll('.tbl-toolbar .inp-sel')[0]
+  const opt = [...sel.options].find(o => o.textContent.trim() === lineName)
+  const setter = Object.getOwnPropertyDescriptor(window.HTMLSelectElement.prototype, 'value').set
+  setter.call(sel, opt.value)
+  sel.dispatchEvent(new Event('change', { bubbles: true }))
+}, line.name)
+await new Promise(r => setTimeout(r, 600))
+const runNotes = await page.evaluate(() =>
+  [...document.querySelectorAll('.nodes-table .line-run')].map(n => ({ text: n.textContent.replace(/\s+/g, ' ').trim(), on: n.classList.contains('on') })))
+console.log('② 开跑后 注记:', JSON.stringify(runNotes))
+const okRun = runNotes.length > 0 && runNotes.every(n => n.on && n.text.includes('运行中') && n.text.includes('·'))
+console.log(okRun ? 'PASS: 列表运行注记 = 运行中 + 产品 · Recipe' : 'FAIL: 注记不符')
+await page.screenshot({ path: 'docs/audit/screenshots/daq-line-note-running.png' })
+
+await j(`/api/workshop/dcw/lines/${line.id}/stop`, 'POST')
+console.log('line stopped (env restored)')
+await browser.close()

package/scripts/_dbg-daq-linebanner-audit.mjs

@@ -0,0 +1,107 @@
+/**
+ * 一次性审计:/daq 产线上下文横幅 + 产线列运行注记。
+ * ①未筛选 → 全局门控横幅;②筛选待机产线 → 未开跑横幅 + 直达产线管理,行注记"待机";
+ * ③开跑该产线 → 绿色横幅(产品/Recipe/批次),行注记"运行中 产品 · Recipe";
+ * 结束停线还原环境。
+ */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = process.env.DAQ_TOKEN ?? 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const d = (await j('/api/workshop/dcw')).data
+const target = d.lines.find(l => d.nodes.some(n => n.lineId === l.id) && d.recipes.some(r => r.lineId === l.id && r.params.length > 0))
+if (!target) { console.error('FAIL: 没有带节点+配方的产线可验'); process.exit(1) }
+const recipe = d.recipes.find(r => r.lineId === target.id && r.params.length > 0)
+console.log('target line:', target.name, '| recipe:', recipe.name)
+
+// 前置:确保该产线未在跑
+await j(`/api/workshop/dcw/lines/${target.id}/stop`, 'POST').catch(() => {})
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1920,1280'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1280 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+const selectLine = () => page.evaluate((lineName) => {
+  const sel = document.querySelectorAll('.tbl-toolbar .inp-sel')[0]
+  const opt = [...sel.options].find(o => o.textContent.trim() === lineName)
+  if (!opt) return false
+  const setter = Object.getOwnPropertyDescriptor(window.HTMLSelectElement.prototype, 'value').set
+  setter.call(sel, opt.value)
+  sel.dispatchEvent(new Event('change', { bubbles: true }))
+  return true
+}, target.name)
+const bannerText = () => page.evaluate(() => {
+  const banners = [...document.querySelectorAll('.infra-banner')]
+  return banners.map(b => ({ good: b.classList.contains('good'), text: b.textContent.replace(/\s+/g, ' ').trim().slice(0, 180) }))
+})
+
+// ===== 1. 未筛选:全局门控横幅 =====
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(4000)
+const b0 = await bannerText()
+console.log('unfiltered banners:', JSON.stringify(b0))
+if (b0.some(b => b.text.includes('产线未开跑'))) console.log('PASS global gate banner (unfiltered)')
+else fail('global banner missing when unfiltered')
+
+// ===== 2. 筛选待机产线:未开跑横幅 + 直达按钮,行注记 待机 =====
+if (!await selectLine()) { fail('cannot select target line'); await browser.close(); process.exit(1) }
+await sleep(600)
+const b1 = await bannerText()
+const noteIdle = await page.evaluate(() => {
+  const row = [...document.querySelectorAll('.nodes-table tbody tr')].find(r => r.querySelector('.line-run'))
+  return row?.querySelector('.line-run')?.textContent.replace(/\s+/g, ' ').trim()
+})
+console.log('idle-line banner:', JSON.stringify(b1), '| row note:', noteIdle)
+const idleBanner = b1.find(b => b.text.includes(target.name))
+if (idleBanner && !idleBanner.good && idleBanner.text.includes('未开跑') && idleBanner.text.includes('暂停采集')) {
+  console.log('PASS idle-line banner: 未开跑提示')
+} else fail(`idle banner wrong: ${JSON.stringify(idleBanner)}`)
+const idleLink = await page.evaluate(() => document.querySelector('.infra-banner .pill-btn')?.getAttribute('href'))
+if (idleLink === `/dcw/${target.id}`) console.log('PASS jump link → /dcw/{lineId}:', idleLink)
+else fail(`jump link wrong: ${idleLink}`)
+if (noteIdle === '未运行') console.log('PASS row note 未运行 (idle)')
+else fail(`row note wrong: ${noteIdle}`)
+await page.screenshot({ path: 'docs/audit/screenshots/daq-linebanner-idle.png' })
+
+// ===== 3. 开跑:绿色横幅(产品/Recipe) + 行注记 运行中 产品 · Recipe =====
+const st = await j(`/api/workshop/dcw/lines/${target.id}/start`, 'POST', { recipeId: recipe.id })
+if (!st.data?.line?.active) { fail(`line start failed: ${JSON.stringify(st).slice(0, 160)}`); await browser.close(); process.exit(1) }
+await page.reload({ waitUntil: 'domcontentloaded' })
+await sleep(4000)
+if (!await selectLine()) { fail('cannot re-select line after reload'); await browser.close(); process.exit(1) }
+await sleep(600)
+const b2 = await bannerText()
+const noteRun = await page.evaluate(() => {
+  const notes = [...document.querySelectorAll('.nodes-table tbody .line-run')].map(n => n.textContent.replace(/\s+/g, ' ').trim())
+  return { on: notes.filter(s => s.includes('运行中')).length, idle: notes.filter(s => s === '待机').length, sample: notes[0] }
+})
+console.log('running banner:', JSON.stringify(b2), '| row notes:', JSON.stringify(noteRun))
+const runBanner = b2.find(b => b.good)
+if (runBanner && runBanner.text.includes('运行中') && runBanner.text.includes(recipe.name)) {
+  console.log('PASS running banner (good variant, recipe shown)')
+} else fail(`running banner wrong: ${JSON.stringify(runBanner)}`)
+if ((noteRun.on ?? 0) > 0 && (noteRun.sample ?? '').includes(recipe.name)) {
+  console.log('PASS row notes 运行中 + 产品/Recipe')
+} else fail(`row notes wrong: ${JSON.stringify(noteRun)}`)
+await page.screenshot({ path: 'docs/audit/screenshots/daq-linebanner-running.png' })
+
+// ===== 4. 停线还原 =====
+await j(`/api/workshop/dcw/lines/${target.id}/stop`, 'POST')
+await page.reload({ waitUntil: 'domcontentloaded' })
+await sleep(3500)
+await selectLine()
+await sleep(600)
+const b3 = await bannerText()
+if (b3.some(b => !b.good && b.text.includes('未开跑'))) console.log('PASS restored: idle banner back after stop')
+else fail(`restore wrong: ${JSON.stringify(b3)}`)
+await browser.close()
+console.log(process.exitCode ? '\n=== AUDIT FAILED ===' : '\n=== ALL PASS ===')

package/scripts/_dbg-daq-pages-shot.mjs

@@ -0,0 +1,37 @@
+/** 一次性:数采中心 + 节点控制台 页面截图(v0.2.0 验证) */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+const login = await fetch(`${BASE}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+const token = login.data.token
+const H = { 'authorization': `Bearer ${token}`, 'content-type': 'application/json' }
+
+// 取一个真实节点 id(优先非 legacy,便于展示)
+const nodes = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
+const first = nodes.data?.nodes?.[0]?.id
+console.log('node =', first)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: token, domain: '127.0.0.1', path: '/' })
+
+await page.goto(`${BASE}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 6500))
+await page.screenshot({ path: 'docs/audit/screenshots/daq-console-list.png' })
+
+if (first) {
+  await page.goto(`${BASE}/daq/${first}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await new Promise(r => setTimeout(r, 6500))
+  await page.screenshot({ path: 'docs/audit/screenshots/daq-console-node.png' })
+}
+console.log('shots ok')
+await browser.close()