agentworkshop 0.2.1

package/scripts/_dbg-dcw-examples.mjs

@@ -0,0 +1,81 @@
+/** 一次性:创建产线示例(产品/Recipe/mock PLC 节点)+ 越窗联锁验证 */
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const j = (r) => r.json()
+const post = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b) }).then(j)
+const get = (u) => fetch(ROOT + u, { headers: H }).then(j)
+
+// ===== 1. 产品 ×2 =====
+const { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fxA = await makeLineFixture(ROOT, H, '1号产线')
+const fxB = await makeLineFixture(ROOT, H, '2号产线')
+const pA = (await post('/api/workshop/dcw/products', { name: '0.8mm 光学膜', description: '高端光学级 PET 膜(示例产品 A)', lineId: fxA.line.id })).data.product
+const pB = (await post('/api/workshop/dcw/products', { name: '12μm 离型膜', description: '薄型离型保护膜(示例产品 B)', lineId: fxB.line.id })).data.product
+console.log('products:', pA.id, pA.name, '|', pB.id, pB.name)
+
+// ===== 2. mock PLC 节点(数采 + 智控),绑定到已有设备 =====
+const twins = (await get('/api/workshop/device-twins')).data.twins.filter(t => t.kind !== 'daq' && typeof t.posX === 'number')
+const dev = twins[0]
+console.log('bind target:', dev?.name)
+const nodes = {}
+const mk = [
+  ['daq', 'daq-temp-tc', '温度传感器(示例)', dev?.id, fxA.line.id],
+  ['daq', 'daq-pressure-tx', '熔体压力变送器(示例)', dev?.id, fxB.line.id],
+  ['dcw', 'dcw-temp-sp', '温度设定器(示例)', dev?.id, fxA.line.id],
+  ['dcw', 'dcw-temp-sp', '温度设定器·2号线(示例)', dev?.id, fxB.line.id],
+  ['dcw', 'dcw-pressure-sp', '压力设定器(示例)', dev?.id, fxA.line.id],
+]
+for (const [kind, tpl, name, deviceId, lineId] of mk) {
+  const base = kind === 'daq' ? '/api/workshop/daq' : '/api/workshop/dcw'
+  // 每线独立节点(产线隔离:配方参数只能引用本线节点);场景光晕 1号蓝/2号黄
+  const r = await post(base, { templateRef: tpl, name, posX: 600 + Math.random() * 400, posZ: 1500 + Math.random() * 300, deviceBindingId: deviceId ?? null, lineId })
+  const n = r.data?.node
+  if (!n) { console.error('FAIL create node', tpl, JSON.stringify(r).slice(0, 120)); process.exit(1) }
+  if (name.includes('2号线')) nodes[`${tpl}-2`] = n
+  else nodes[tpl] = n
+  console.log('node:', kind, n.templateRef, n.id, '| domain', n.min, '~', n.max, n.unit)
+}
+
+// ===== 3. Recipe(各自工艺窗口;value 必须在自身窗口内) =====
+const rA = (await post('/api/workshop/dcw/recipes', {
+  productId: pA.id,
+  name: 'A-标准工艺',
+  description: '光学膜标准批次:温度窗口收紧到 ±5℃',
+  params: [
+    { templateRef: 'dcw-temp-sp', nodeId: nodes['dcw-temp-sp'].id, value: 182, min: 176, max: 188 },
+    { templateRef: 'dcw-pressure-sp', nodeId: nodes['dcw-pressure-sp'].id, value: 0.92, min: 0.85, max: 1.0 },
+  ],
+})).data.recipe
+const rB = (await post('/api/workshop/dcw/recipes', {
+  productId: pB.id,
+  name: 'B-低温工艺',
+  description: '离型膜低温批次:与 A 产品窗口完全不同(产品隔离)',
+  params: [
+    { templateRef: 'dcw-temp-sp', nodeId: nodes['dcw-temp-sp-2'].id, value: 162, min: 156, max: 170 },
+  ],
+})).data.recipe
+if (!rA || !rB) { console.error('FAIL: recipes'); process.exit(1) }
+console.log('recipes:', rA.id, rA.name, JSON.stringify(rA.params), '|', rB.id, rB.name)
+
+// ===== 4. 越窗联锁验证:开跑 A,写 195(节点全局 150~200 内、配方上限 188 外)→ 拒绝 =====
+const startA = await fxA.start(rA.id)
+console.log('line A:', startA.data?.line?.active, startA.data?.line?.recipeName)
+const wIn = await post(`/api/workshop/dcw/${nodes['dcw-temp-sp'].id}/write`, { value: 180 })
+console.log('write 180 (in window):', wIn.data?.outcome?.ok)
+const wOut = await post(`/api/workshop/dcw/${nodes['dcw-temp-sp'].id}/write`, { value: 195 })
+console.log('write 195 (over recipe max 188):', wOut.code, '|', (wOut.message ?? '').slice(0, 70))
+let pass = true
+if (wIn.data?.outcome?.ok !== true) { console.error('FAIL: in-window write failed'); pass = false }
+if (wOut.code !== 'VALIDATION_ERROR') { console.error('FAIL: over-window write accepted'); pass = false }
+// 切到 B 再写 195 → 仍拒(B 窗口 156~170);写 165 → 成功(在 A 下会被拒的值)
+const startB = await fxA.stop()
+await fxB.start(rB.id)
+// B 线联锁作用于 2号线的温度节点(产线隔离:A 线节点不受 B 配方约束)
+const wB1 = await post(`/api/workshop/dcw/${nodes['dcw-temp-sp-2'].id}/write`, { value: 195 })
+const wB2 = await post(`/api/workshop/dcw/${nodes['dcw-temp-sp-2'].id}/write`, { value: 165 })
+console.log('recipe B: write 195 →', wB1.code, '| write 165 →', wB2.data?.outcome?.ok ? 'OK' : 'FAIL')
+if (wB1.code === 'VALIDATION_ERROR' && wB2.data?.outcome?.ok) console.log('PASS recipe switch changes interlock window')
+else { console.error('FAIL: recipe-B interlock wrong'); pass = false }
+await fxB.stop()
+console.log(pass ? 'EXAMPLES + INTERLOCK ALL PASS' : 'FAILED')

package/scripts/_dbg-dcw-light-shot.mjs

@@ -0,0 +1,19 @@
+/** 一次性:浅色模式 dcw 页复现截图 */
+import puppeteer from 'puppeteer-core'
+const TOKEN = 'ut-3b8495cf61b34bd4b3c0e02fc242fc66'
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1920,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 1 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+await page.evaluateOnNewDocument(() => {
+  localStorage.setItem('app', JSON.stringify({ isDark: false, sidebarCollapsed: false, accent: null }))
+})
+await page.goto('http://127.0.0.1:3000/dcw', { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 8000))
+await page.screenshot({ path: 'docs/audit/screenshots/huashu-survey2/light-dcw-before.png' })
+console.log('shot light dcw')
+await browser.close()

package/scripts/_dbg-dcw-line-audit.mjs

@@ -0,0 +1,107 @@
+/** 一次性:产线运营全链路审计(mock 自定义模板/节点绑定/实时读数/设参/开跑门控/逐样本打标/产品隔离查询/停止) */
+const TOKEN = process.env.DAQ_TOKEN ?? 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = (process.env.DAQ_BASE ?? 'http://127.0.0.1:3000')
+const DCW = ROOT + '/api/workshop/dcw'
+const DAQ = ROOT + '/api/workshop/daq'
+const DEV = ROOT + '/api/workshop/device-twins'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const jpost = (u, b) => fetch(u, { method: 'POST', headers: H, body: JSON.stringify(b) }).then(r => r.json())
+const jdel = (u) => fetch(u, { method: 'DELETE', headers: H }).then(r => r.json())
+
+// ===== 1. mock 自定义模板(数采 + 智控) =====
+const daqTpl = (await jpost(DAQ + '/templates', { name: '线审计-厚度', unit: 'um', min: 30, max: 60, decimals: 1, icon: 'gateway', ch: '膜厚' })).data.template
+const dcwTpl = (await jpost(DCW + '/templates', { name: '线审计-厚度设定', unit: 'um', min: 30, max: 60, decimals: 1, icon: 'gateway', ch: '膜厚设定' })).data.template
+console.log('templates:', daqTpl?.key, dcwTpl?.key)
+if (!daqTpl || !dcwTpl) { console.error('FAIL: create templates'); process.exit(1) }
+
+// ===== 1.5 产线夹具(节点挂线;逐产线门控) =====
+const { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fx = await makeLineFixture(ROOT, H, '线审计产线A')
+
+// ===== 2. 节点 + 设备绑定(mock 驱动) =====
+const devList = (await fetch(DEV, { headers: H }).then(r => r.json())).data?.twins ?? []
+const dev = devList.find(t => t.kind !== 'daq' && typeof t.posX === 'number')
+if (!dev) { console.error('FAIL: no device twin for binding'); process.exit(1) }
+const dq = (await jpost(DAQ, { templateRef: `daq-${daqTpl.key}`, name: '线审计-厚度通道', intervalMs: 500, posX: dev.posX + 40, posZ: dev.posZ + 40, lineId: fx.line.id })).data.node
+const dw = (await jpost(DCW, { templateRef: `dcw-${dcwTpl.key}`, name: '线审计-厚度设定', posX: dev.posX - 40, posZ: dev.posZ - 40 })).data.node
+await jpost(`${DAQ}/${dq.id}/bind`, { deviceId: dev.id })
+await jpost(`${DCW}/${dw.id}/bind`, { deviceId: dev.id })
+const daqNode = (await fetch(DAQ, { headers: H }).then(r => r.json())).data.nodes.find(n => n.id === dq.id)
+const dcwNode = (await fetch(DCW, { headers: H }).then(r => r.json())).data.nodes.find(n => n.id === dw.id)
+console.log('bound:', daqNode?.deviceBindingId === dev.id, dcwNode?.deviceBindingId === dev.id)
+if (daqNode?.deviceBindingId === dev.id && dcwNode?.deviceBindingId === dev.id) console.log('PASS daq+dcw nodes bound to same device')
+else fail('bind failed')
+
+// ===== 3. 设参(mock;写控制不受产线门控) =====
+const w = await jpost(`${DCW}/${dw.id}/write`, { value: 45 })
+if (w.data?.outcome?.ok) console.log('PASS set control param 45um (mock PLC ACK)')
+else fail(`write failed: ${JSON.stringify(w).slice(0, 100)}`)
+
+// ===== 4. 产品/配方 + 开跑门控(逐产线) =====
+const prod = (await jpost(DCW + '/products', { name: '线审计产品A', description: '隔离验证', lineId: fx.line.id })).data.product
+const rc = (await jpost(DCW + '/recipes', { productId: prod.id, name: '线审计配方', params: [{ templateRef: `dcw-${dcwTpl.key}`, nodeId: dw.id, value: 45 }] })).data.recipe
+// 4.1 未知配方开跑 → 404
+const g1 = await fx.start('rc-nonexist')
+if (g1.code === 'NOT_FOUND') console.log('PASS start gating: unknown recipe rejected')
+else fail(`gating unknown recipe: ${g1.code}`)
+// 4.2 空参数配方 → 400
+const rcEmpty = (await jpost(DCW + '/recipes', { productId: prod.id, name: '空参数配方', params: [] })).data.recipe
+const g2 = await fx.start(rcEmpty.id)
+if (g2.code === 'VALIDATION_ERROR') console.log('PASS start gating: recipe without params rejected ——', (g2.message ?? '').slice(0, 24))
+else fail(`gating empty recipe: ${g2.code}`)
+
+// ===== 5. 开跑:参数下发 + 窗口打标 =====
+const st = await fx.start(rc.id)
+console.log('line start:', st.data?.run?.id, '| recipe applied:', JSON.stringify(st.data?.run?.results?.[0]?.ok))
+if (st.data?.line?.active && st.data?.run?.results?.[0]?.ok === true) console.log('PASS line started with recipe applied')
+else fail(`line start wrong: ${JSON.stringify(st).slice(0, 160)}`)
+// 重复开跑 → 409
+const again = await fx.start(rc.id)
+if (again.code === 'CONFLICT') console.log('PASS double-start rejected (409)')
+else fail(`double start: ${again.code}`)
+
+await sleep(3500) // 收集打标样本(500ms 通道)
+// 实时读数(产线开跑后;门控语义:配方驱动采集)
+const live = (await fetch(DAQ, { headers: H }).then(r => r.json())).data.nodes.find(n => n.id === dq.id)
+console.log('live value:', live?.value, live?.state)
+if (live?.value != null && live?.state !== 'offline') console.log('PASS real-time daq reading flowing (recipe-driven)')
+else fail('no live reading while line active')
+
+// ===== 6. 逐样本打标验证:按产品+配方+参数查询,数据必须归属本产品 =====
+const q = await fetch(`${DCW}/line/query?productId=${prod.id}&recipeId=${rc.id}&paramKey=${daqTpl.key}&from=${Date.now() - 60_000}&to=${Date.now()}&bucketMs=1000`, { headers: H }).then(r => r.json())
+const ch = q.data?.channels?.find(c => c.nodeId === dq.id)
+console.log(`tagged query: channels=${q.data?.channels?.length}, points on target=${ch?.points?.length}`)
+if ((ch?.points?.length ?? 0) > 0) console.log('PASS tagged samples queryable by product+recipe+param')
+else fail(`tagged query empty: ${JSON.stringify(q).slice(0, 160)}`)
+
+// 6.2 换一个不存在的产品查询 → 空(隔离)
+const q2 = await fetch(`${DCW}/line/query?productId=pd-nonexist&from=${Date.now() - 60_000}&to=${Date.now()}`, { headers: H }).then(r => r.json())
+if ((q2.data?.channels ?? []).length === 0) console.log('PASS isolation: other product sees no data')
+else fail(`isolation broken: ${q2.data.channels.length} channels leaked`)
+
+// ===== 7. 停止:窗口封闭,新样本不再打标 =====
+const sp = await fx.stop()
+if (sp.data?.run?.endedAt) console.log('PASS line stopped, run sealed:', sp.data.run.endedAt)
+else fail('stop failed')
+await sleep(1600)
+const q3 = await fetch(`${DCW}/line/query?productId=${prod.id}&from=${Date.now() - 120_000}&to=${Date.now()}&bucketMs=1000`, { headers: H }).then(r => r.json())
+const pts3 = q3.data?.channels?.find(c => c.nodeId === dq.id)?.points ?? []
+const lastAt = pts3.length ? Math.max(...pts3.map(p => p.at)) : 0
+const stopAt = Date.parse(sp.data.run.endedAt)
+if (lastAt <= stopAt + 1500) console.log(`PASS post-stop samples untagged (last tagged ${lastAt - stopAt}ms before/at stop)`)
+else fail(`samples tagged after stop: +${lastAt - stopAt}ms`)
+
+// ===== 清理 =====
+await jdel(`${DAQ}/${dq.id}`)
+await jdel(`${DCW}/${dw.id}`)
+await jdel(`${DCW}/recipes/${rc.id}`)
+await jdel(`${DCW}/recipes/${rcEmpty.id}`)
+await jdel(`${DCW}/products/${prod.id}`)
+await jdel(`${DAQ}/templates/${daqTpl.key}`)
+await jdel(`${DCW}/templates/${dcwTpl.key}`)
+await fx.cleanup()
+console.log('cleanup done')
+console.log(process.exitCode ? 'AUDIT FAILED' : 'AUDIT ALL PASS')
+process.exit(process.exitCode ?? 0)

package/scripts/_dbg-dcw-pause-tpl-audit.mjs

@@ -0,0 +1,161 @@
+/**
+ * 一次性审计:控制暂停门控 + 自定义控制模板(产线管理界面新功能全链路)。
+ *
+ * A. 自定义模板:POST /dcw/templates 创建 → GET /dcw 载荷可见(向导下拉数据源)
+ *    → 从自定义模板建节点继承域(单位/量程/小数位)。
+ * B. 节点级控制暂停:PATCH enabled → 写拒绝(409「当前节点暂停」)→ 配方下发部分失败
+ *    隔离 → 恢复后写 ACK;WS dcw.node.changed 状态同步帧断言。
+ * C. 网关全局暂停(暂停全部控制):stop → 写/配方/开跑全拒绝(「控制网关已暂停」)
+ *    → start 恢复。收尾恢复 running=true 并清理全部夹具。
+ */
+const TOKEN = process.env.DAQ_TOKEN ?? 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = process.env.DAQ_BASE ?? 'http://127.0.0.1:3000'
+const DCW = ROOT + '/api/workshop/dcw'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const jget = (u) => fetch(ROOT + u, { headers: H }).then(r => r.json())
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jpatch = (u, b) => fetch(ROOT + u, { method: 'PATCH', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jdel = (u) => fetch(ROOT + u, { method: 'DELETE', headers: H }).then(r => r.json())
+const SFX = Math.random().toString(36).slice(2, 7)
+
+// ===== 0. 健康检查 =====
+const health = await jget('/api/workshop/dcw')
+if (health.code !== 0) { console.error('FAIL: dev server / dcw api 不可达:', health.message); process.exit(1) }
+console.log('PASS dcw api reachable; nodes:', health.data.nodes.length)
+
+// ===== 1. 自定义控制模板:创建 → 目录可见 =====
+const tplName = `暂停审计-扭矩设定-${SFX}`
+const tplRes = await jpost('/api/workshop/dcw/templates', {
+  name: tplName, ch: '主轴扭矩', code: `SPindle · T-${SFX}`, unit: 'N·m',
+  min: 10, max: 50, decimals: 1, icon: 'encoder', semantics: '审计夹具:主轴扭矩设定,调整需小步幅。',
+})
+const tpl = tplRes.data?.template
+if (tpl && tpl.key.startsWith('cw-') && tpl.builtin === false) console.log('PASS custom template created:', tpl.key)
+else { console.error('FAIL create template:', JSON.stringify(tplRes).slice(0, 160)); process.exit(1) }
+const dir = await jget('/api/workshop/dcw')
+const tplInDir = dir.data.templates.find(t => t.key === tpl.key)
+if (tplInDir) console.log('PASS custom template in directory (向导下拉数据源)')
+else fail('custom template missing from directory payload')
+
+// ===== 2. 从自定义模板建节点(未挂线,避开产线联锁) =====
+const nodeRes = await jpost('/api/workshop/dcw', { templateRef: `dcw-${tpl.key}`, name: `暂停审计-扭矩节点-${SFX}` })
+const node = nodeRes.data?.node
+if (node && node.min === 10 && node.max === 50 && node.unit === 'N·m' && node.decimals === 1 && node.enabled === true) {
+  console.log('PASS node created from custom template (domain inherited, enabled default)')
+} else { fail(`node domain wrong: ${JSON.stringify(nodeRes).slice(0, 200)}`); process.exit(1) }
+
+// ===== 3. 启用态写 → ACK =====
+const w1 = await jpost(`/api/workshop/dcw/${node.id}/write`, { value: 30 })
+if (w1.data?.outcome?.ok === true) console.log('PASS write ACK while enabled (value 30 N·m)')
+else fail(`baseline write failed: ${JSON.stringify(w1).slice(0, 160)}`)
+
+// ===== 4. 暂停节点:PATCH enabled=false → 状态同步 offline =====
+await jpatch(`/api/workshop/dcw/${node.id}`, { enabled: false })
+let view = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === node.id)
+if (view?.enabled === false && view?.state === 'offline') console.log('PASS paused: enabled=false, state=offline (REST 权威)')
+else fail(`pause state wrong: ${JSON.stringify(view && { enabled: view.enabled, state: view.state })}`)
+
+// ===== 5. 暂停态写 → 409「当前节点暂停」 =====
+const w2 = await jpost(`/api/workshop/dcw/${node.id}/write`, { value: 31 })
+if (w2.code === 'CONFLICT' && (w2.message ?? '').includes('当前节点暂停')) {
+  console.log('PASS paused write rejected 409 「当前节点暂停」')
+} else fail(`paused write not gated: ${JSON.stringify(w2).slice(0, 160)}`)
+
+// ===== 6. 配方下发路径:暂停节点参数记失败不阻塞其余(部分失败隔离) =====
+const prod = (await jpost('/api/workshop/dcw/products', { name: `暂停审计产品-${SFX}` })).data?.product
+const rc = (await jpost('/api/workshop/dcw/recipes', { productId: prod.id, name: `暂停审计配方-${SFX}`, params: [{ nodeId: node.id, value: 32 }] })).data?.recipe
+const apply1 = await jpost(`/api/workshop/dcw/recipes/${rc.id}/apply`)
+const r0 = apply1.data?.run?.results?.[0]
+if (r0 && r0.ok === false && (r0.message ?? '').includes('当前节点暂停') && r0.nodeId === node.id) {
+  console.log('PASS recipe apply: paused node param failed with 「当前节点暂停」(isolated)')
+} else fail(`recipe gating wrong: ${JSON.stringify(apply1).slice(0, 200)}`)
+
+// ===== 7. 恢复控制 → 状态回待机,写恢复 ACK =====
+await jpatch(`/api/workshop/dcw/${node.id}`, { enabled: true })
+view = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === node.id)
+const w3 = await jpost(`/api/workshop/dcw/${node.id}/write`, { value: 33 })
+if (view?.enabled === true && view?.state !== 'offline' && w3.data?.outcome?.ok === true) {
+  console.log('PASS resumed: state back (idle/ok), write ACK again')
+} else fail(`resume wrong: state=${view?.state}, write=${JSON.stringify(w3).slice(0, 120)}`)
+
+// ===== 8. WS 状态同步:dcw.node.changed 帧直推 enabled 变更 =====
+const chans = (await jget('/api/workshop/channels')).data ?? []
+const chanId = chans[0]?.id
+if (chanId) {
+  const ws = new WebSocket(`ws://127.0.0.1:3000/api/workshop/ws?channelId=${chanId}&token=${TOKEN}`)
+  const frames = []
+  ws.onmessage = (ev) => { try { frames.push(JSON.parse(String(ev.data))) } catch { /* 忽略 */ } }
+  await new Promise((res, rej) => {
+    ws.onopen = res
+    ws.onerror = () => rej(new Error('ws connect failed'))
+    setTimeout(() => rej(new Error('ws open timeout')), 8000)
+  })
+  await sleep(600) // 等快照对齐
+  await jpatch(`/api/workshop/dcw/${node.id}`, { enabled: false })
+  let gotPause = false
+  for (let i = 0; i < 20 && !gotPause; i++) {
+    await sleep(250)
+    gotPause = frames.some(f => f.type === 'dcw.node.changed' && f.payload?.node?.id === node.id && f.payload?.node?.enabled === false)
+  }
+  await jpatch(`/api/workshop/dcw/${node.id}`, { enabled: true })
+  let gotResume = false
+  for (let i = 0; i < 20 && !gotResume; i++) {
+    await sleep(250)
+    gotResume = frames.some(f => f.type === 'dcw.node.changed' && f.payload?.node?.id === node.id && f.payload?.node?.enabled === true)
+  }
+  ws.close()
+  if (gotPause && gotResume) console.log('PASS WS sync: dcw.node.changed frames pushed enabled=false/true')
+  else fail(`WS sync frames missing: pause=${gotPause} resume=${gotResume}`)
+} else {
+  console.log('SKIP WS sync assertion(无可见 channel);REST 权威态已在第 4/7 步断言')
+}
+
+// ===== 9. 网关全局暂停(暂停全部控制) =====
+let ctl = (await jpost('/api/workshop/dcw/controller', { action: 'stop' })).data?.controller
+if (ctl?.running === false && ctl?.nodesOnline === 0) console.log('PASS gateway stopped: running=false, nodesOnline=0')
+else fail(`gateway stop wrong: ${JSON.stringify(ctl)}`)
+const w4 = await jpost(`/api/workshop/dcw/${node.id}/write`, { value: 34 })
+if (w4.code === 'CONFLICT' && (w4.message ?? '').includes('控制网关已暂停')) {
+  console.log('PASS gateway-paused write rejected (暂停全部控制现在真正拦截下发)')
+} else fail(`gateway write gate wrong: ${JSON.stringify(w4).slice(0, 160)}`)
+const apply2 = await jpost(`/api/workshop/dcw/recipes/${rc.id}/apply`)
+const r1 = apply2.data?.run?.results?.[0]
+if (r1 && r1.ok === false && (r1.message ?? '').includes('控制网关已暂停')) {
+  console.log('PASS gateway-paused recipe apply rejected')
+} else fail(`gateway recipe gate wrong: ${JSON.stringify(apply2).slice(0, 200)}`)
+
+// ===== 10. 网关暂停时开跑门控 =====
+const { makeLineFixture } = await import('./_lib-dcw-line.mjs')
+const fx = await makeLineFixture(ROOT, H, `暂停审计线-${SFX}`)
+const prod2 = (await jpost('/api/workshop/dcw/products', { name: `暂停审计产品B-${SFX}`, lineId: fx.line.id })).data?.product
+const rc2 = (await jpost('/api/workshop/dcw/recipes', { productId: prod2.id, name: `暂停审计配方B-${SFX}`, params: [{ nodeId: node.id, value: 35 }] })).data?.recipe
+const g1 = await fx.start(rc2.id)
+if (g1.code === 'CONFLICT' && (g1.message ?? '').includes('控制网关已暂停')) {
+  console.log('PASS line start gated while gateway paused')
+} else fail(`line start gate wrong: ${JSON.stringify(g1).slice(0, 160)}`)
+await fx.cleanup()
+
+// ===== 11. 恢复全部控制 → 写恢复 ACK =====
+ctl = (await jpost('/api/workshop/dcw/controller', { action: 'start' })).data?.controller
+view = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === node.id)
+const w5 = await jpost(`/api/workshop/dcw/${node.id}/write`, { value: 36 })
+if (ctl?.running === true && view?.state !== 'offline' && w5.data?.outcome?.ok === true) {
+  console.log('PASS gateway resumed: enabled node back online, write ACK')
+} else fail(`gateway resume wrong: ${JSON.stringify({ ctl, state: view?.state, w: w5.message ?? w5.data?.outcome?.message }).slice(0, 200)}`)
+
+// ===== 清理:夹具全删 + 网关确保 running =====
+await jdel(`/api/workshop/dcw/recipes/${rc.id}`)
+await jdel(`/api/workshop/dcw/products/${prod.id}`)
+await jdel(`/api/workshop/dcw/${node.id}`)
+await jdel(`/api/workshop/dcw/templates/${tpl.key}`)
+const after = await jget('/api/workshop/dcw')
+const cleaned = !after.data.templates.some(t => t.key === tpl.key) && !after.data.nodes.some(n => n.id === node.id)
+if (cleaned) console.log('PASS cleanup: fixtures removed')
+else fail('cleanup incomplete')
+const finalCtl = after.data.controller
+if (finalCtl.running === true) console.log('PASS final: gateway running=true (环境还原)')
+else { await jpost('/api/workshop/dcw/controller', { action: 'start' }); fail('gateway was left stopped — restored') }
+
+console.log(process.exitCode ? '\n=== AUDIT FAILED ===' : '\n=== ALL PASS ===')

package/scripts/_dbg-dcw-pause-ui.mjs

@@ -0,0 +1,175 @@
+/**
+ * 一次性审计:产线详情页(/dcw/{id})新增 UI 端到端。
+ * ①「添加控制模板」button → Modal 填表创建自定义模板 → 成功提示 + chips 出现
+ *   → 「添加控制节点」向导自动选中新模板(数据源同 store)。
+ * ② 节点行「控制」开关:暂停 → 行转已暂停 + 下发禁用 + 服务端 enabled=false
+ *   → 恢复 → 控制中 + 可写。截图留档,清理夹具。
+ */
+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 SFX = Math.random().toString(36).slice(2, 7)
+const TPL_NAME = `UI审计模板-${SFX}`
+const fail = (msg) => { console.error('FAIL:', msg); process.exitCode = 1 }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+// 选一条控制节点最多的产线(保证节点表有行可验开关)
+const lines = (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H }).then(r => r.json())).data
+const nodeCountByLine = new Map()
+for (const n of lines.nodes) nodeCountByLine.set(n.lineId, (nodeCountByLine.get(n.lineId) ?? 0) + 1)
+const target = lines.lines
+  .map(l => ({ id: l.id, name: l.name, nodes: nodeCountByLine.get(l.id) ?? 0 }))
+  .sort((a, b) => b.nodes - a.nodes)[0]
+if (!target || target.nodes === 0) { console.error('FAIL: 没有带控制节点的产线可验'); process.exit(1) }
+console.log('target line:', target.name, `(${target.nodes} nodes)`)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1200 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/dcw/${target.id}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(4000)
+
+// ===== 1. 「添加控制模板」按钮存在 → 点击开弹窗(hydration 就绪前重试) =====
+let modalUp = false
+for (let i = 0; i < 8 && !modalUp; i++) {
+  const clicked = await page.evaluate(() => {
+    const b = [...document.querySelectorAll('button')].find(x => x.textContent.includes('添加控制模板'))
+    if (!b) return false
+    b.click()
+    return true
+  })
+  if (!clicked) { await sleep(800); continue }
+  await sleep(500)
+  modalUp = await page.evaluate(() => {
+    const m = document.querySelector('.modal')
+    return !!m && m.textContent.includes('添加控制节点模板') && m.textContent.includes('新建自定义模板')
+  })
+  if (!modalUp) await sleep(600)
+}
+if (modalUp) console.log('PASS 添加控制模板 modal opened')
+else { fail('template modal did not open'); await page.screenshot({ path: 'docs/audit/screenshots/dcw-pause-ui-fail.png' }); await browser.close(); process.exit(1) }
+
+// ===== 2. 填表创建自定义模板 =====
+await page.evaluate((name) => {
+  const modal = document.querySelector('.modal')
+  const grid = modal.querySelector('.f-grid.tpl-form')
+  const inputs = [...grid.querySelectorAll('input.inp')]
+  const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set
+  const set = (el, v) => { setter.call(el, String(v)); el.dispatchEvent(new Event('input', { bubbles: true })) }
+  set(inputs[0], name) // 名称
+  set(inputs[1], '测试扭矩') // 参数语义
+  set(inputs[2], `SPINDLE · T-${name.slice(-5)}`) // 位号代号
+  set(inputs[3], 'N·m') // 单位
+  set(inputs[4], '10') // 量程下限
+  set(inputs[5], '50') // 量程上限
+  set(inputs[6], '1') // 小数位
+}, TPL_NAME)
+await sleep(250) // v-model nextTick(输入+点击分两拍)
+await page.evaluate(() => {
+  const m = document.querySelector('.modal')
+  ;[...m.querySelectorAll('button')].find(b => b.textContent.includes('创建模板'))?.click()
+})
+await sleep(900)
+const created = await page.evaluate((name) => {
+  const m = document.querySelector('.modal')
+  return {
+    okBanner: m.querySelector('.banner.good')?.textContent ?? '',
+    chip: [...m.querySelectorAll('.tpl-chip')].some(c => c.textContent.includes(name) && c.textContent.includes('自定义')),
+  }
+}, TPL_NAME)
+if (created.okBanner.includes(TPL_NAME) && created.okBanner.includes('已创建')) console.log('PASS template created with success banner')
+else fail(`creation banner wrong: "${created.okBanner.trim()}"`)
+if (created.chip) console.log('PASS new template visible in modal chips (自定义 tag)')
+else fail('new template chip missing')
+await page.screenshot({ path: 'docs/audit/screenshots/dcw-pause-ui-tpl-modal.png' })
+
+// ===== 3. 向导自动选中新模板 =====
+await page.evaluate(() => {
+  const m = document.querySelector('.modal')
+  ;[...m.querySelectorAll('button')].find(b => b.textContent.trim() === '关闭')?.click()
+})
+await sleep(300)
+const wizardSel = await page.evaluate((name) => {
+  ;[...document.querySelectorAll('button')].find(x => x.textContent.includes('添加控制节点') && !x.textContent.includes('模板'))?.click()
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      const m = document.querySelector('.modal')
+      const sel = m?.querySelector('.f-grid select.inp')
+      resolve(sel ? sel.selectedOptions[0]?.textContent ?? '' : '(no modal)')
+    }, 400)
+  })
+}, TPL_NAME)
+if (wizardSel.includes(TPL_NAME)) console.log('PASS add-node wizard auto-selected the new template')
+else fail(`wizard selection wrong: "${wizardSel.trim()}"`)
+await page.evaluate(() => document.querySelector('.modal-mask')?.click())
+await sleep(300)
+
+// ===== 4. 节点「控制」开关:暂停 → 已暂停 + 下发禁用 + 服务端同步 =====
+const toggle1 = await page.evaluate(() => {
+  const rows = [...document.querySelectorAll('.nodes-table tbody tr')].filter(r => r.querySelector('.ctrl-toggle'))
+  const row = rows[0]
+  if (!row) return null
+  const before = row.querySelector('.ctrl-toggle').textContent.trim()
+  row.querySelector('.ctrl-toggle').click()
+  return { before, rowIndex: 0, lineNodeCount: rows.length }
+})
+if (!toggle1) { fail('no node row with ctrl-toggle found'); await browser.close(); process.exit(1) }
+await sleep(800)
+const afterPause = await page.evaluate(() => {
+  const row = [...document.querySelectorAll('.nodes-table tbody tr')].find(r => r.querySelector('.ctrl-toggle'))
+  return {
+    btn: row.querySelector('.ctrl-toggle').textContent.trim(),
+    pill: row.querySelector('.st-pill')?.textContent.trim() ?? '',
+    inputDisabled: row.querySelector('.write-inp')?.disabled ?? null,
+    writeBtnDisabled: row.querySelector('.write-btn')?.disabled ?? null,
+  }
+})
+// 行序 = store 序 = 本产线 API 节点序(行内 id 是 slice(0,8) 截断展示,不能反查)
+const lineNodesApi = (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H }).then(r => r.json())).data.nodes
+  .filter(n => n.lineId === target.id)
+const serverView = lineNodesApi[toggle1.rowIndex]
+if (toggle1.before === '控制中' && afterPause.btn === '已暂停' && afterPause.pill === '已暂停'
+  && afterPause.inputDisabled === true && afterPause.writeBtnDisabled === true
+  && serverView?.enabled === false && serverView?.state === 'offline') {
+  console.log('PASS node paused: toggle=已暂停, pill=已暂停, 下发禁用, server enabled=false/offline (状态同步)')
+} else {
+  fail(`pause toggle wrong: ${JSON.stringify({ toggle1, afterPause, server: serverView && { enabled: serverView.enabled, state: serverView.state } })}`)
+}
+await page.screenshot({ path: 'docs/audit/screenshots/dcw-pause-ui-node-paused.png' })
+
+// ===== 5. 恢复控制 → 控制中 + 可写 =====
+await page.evaluate(() => {
+  const row = [...document.querySelectorAll('.nodes-table tbody tr')].find(r => r.querySelector('.ctrl-toggle'))
+  row.querySelector('.ctrl-toggle').click()
+})
+await sleep(800)
+const afterResume = await page.evaluate(() => {
+  const row = [...document.querySelectorAll('.nodes-table tbody tr')].find(r => r.querySelector('.ctrl-toggle'))
+  return {
+    btn: row.querySelector('.ctrl-toggle').textContent.trim(),
+    inputDisabled: row.querySelector('.write-inp')?.disabled ?? null,
+  }
+})
+const serverView2 = lineNodesApi[toggle1.rowIndex]
+const serverView2Fresh = (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H }).then(r => r.json())).data.nodes
+  .find(n => n.id === serverView2?.id)
+if (afterResume.btn === '控制中' && afterResume.inputDisabled === false && serverView2Fresh?.enabled === true) {
+  console.log('PASS node resumed: toggle=控制中, 下发可用, server enabled=true')
+} else fail(`resume wrong: ${JSON.stringify({ afterResume, server: serverView2Fresh && { enabled: serverView2Fresh.enabled } })}`)
+
+// ===== 清理:删除 UI 创建的模板 =====
+const dir = (await fetch(`${ROOT}/api/workshop/dcw`, { headers: H }).then(r => r.json())).data
+const tpl = dir.templates.find(t => t.name === TPL_NAME)
+if (tpl) {
+  await fetch(`${ROOT}/api/workshop/dcw/templates/${tpl.key}`, { method: 'DELETE', headers: H })
+  console.log('cleanup: template removed')
+}
+await browser.close()
+console.log(process.exitCode ? '\n=== UI AUDIT FAILED ===' : '\n=== UI ALL PASS ===')

package/scripts/_dbg-dcw-scene.mjs

@@ -0,0 +1,72 @@
+/** 一次性:Town 智控节点场景挂载 + 设定值联动验证(REST 建 dcw 节点 → 场景实例 → 设定值变化) */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1200'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1200 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+await page.goto('http://127.0.0.1:3000/town', { waitUntil: 'domcontentloaded', timeout: 90000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+  await sleep(1000)
+}
+await sleep(3000)
+const before = await page.evaluate(() => window.__town.scene.deviceNodes.size)
+console.log('scene devices before:', before)
+
+// REST 创建 2 个智控节点(带落点)→ townBus dcw.node.changed / 签名 watch 收敛
+const made = []
+for (const tpl of ['temp-sp', 'speed-sp']) {
+  const r = await fetch('http://127.0.0.1:3000/api/workshop/dcw', {
+    method: 'POST',
+    headers: H,
+    body: JSON.stringify({ templateRef: `dcw-${tpl}`, posX: 800 + made.length * 130, posZ: 1500 }),
+  }).then(x => x.json())
+  if (r.data?.node) made.push(r.data.node)
+  await sleep(1200) // 等 WS 帧/签名 watch 收敛
+}
+const afterCreate = await page.evaluate(() => {
+  const s = window.__town.scene
+  const dcw = [...s.deviceNodes.values()].filter(d => (d.modelRef ?? '').startsWith('dcw-'))
+  return { total: s.deviceNodes.size, dcw: dcw.length, ids: dcw.map(d => d.twinId) }
+})
+console.log('after create:', JSON.stringify(afterCreate))
+// 场景可能已有持久化 dcw 节点(示例等用户数据)→ 只要求新建节点全部挂载
+if (made.every(m => afterCreate.ids.includes(m.id))) {
+  console.log(`PASS ${made.length} dcw nodes mounted in town scene`)
+}
+else fail(`dcw scene mount wrong: ${JSON.stringify(afterCreate)}`)
+
+// 设定值下发 → dcw.written 帧 → 场景节点 value 收敛(telemetry.value)
+await fetch(`http://127.0.0.1:3000/api/workshop/dcw/${made[0].id}/write`, {
+  method: 'POST', headers: H, body: JSON.stringify({ value: 185 }),
+})
+await sleep(2000)
+const setVal = await page.evaluate((id) => {
+  const s = window.__town.scene
+  const d = [...s.deviceNodes.values()].find(x => x.twinId === id)
+  return d?.telemetry?.value ?? null
+}, made[0].id)
+console.log('scene telemetry.value after write:', setVal)
+if (setVal === 185) console.log('PASS setpoint write reflected in scene node telemetry')
+else fail(`setpoint not reflected: ${setVal}`)
+
+// 清理
+for (const n of made) await fetch(`http://127.0.0.1:3000/api/workshop/dcw/${n.id}`, { method: 'DELETE', headers: H })
+await sleep(1500)
+const cleaned = await page.evaluate(id => ![...window.__town.scene.deviceNodes.values()].some(d => d.twinId === id), made[0].id)
+if (cleaned) console.log('PASS dcw node removal converges in scene')
+else fail('dcw node not removed from scene')
+
+await page.screenshot({ path: 'docs/audit/screenshots/town-dcw.png' })
+await browser.close()
+console.log(process.exitCode ? 'AUDIT FAILED' : 'AUDIT ALL PASS')

package/scripts/_dbg-dcw-shot2.mjs

@@ -0,0 +1,14 @@
+import puppeteer from 'puppeteer-core'
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+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}/dcw`, { waitUntil: 'domcontentloaded', timeout: 45000 })
+await sleep(6000)
+const el = await page.$('.page')
+await el.screenshot({ path: 'docs/audit/screenshots/redesign0831/dcw-filter2.png' })
+await browser.close()
+console.log('DONE')