agentworkshop 0.2.1

package/scripts/_dbg-scenario-phase3.mjs

@@ -0,0 +1,111 @@
+/** 端到端 Phase 3:Channel Agent 绑定产线节点 + omp 团队优化任务(HITL)+ 参数下发生效断言
+ *  链路:建 channel/团队 → lead(mock 调度)+ worker(omp 真实 LLM)部署 → 绑定 1号产线
+ *  的 2 数采(auto)+ 1 数控(manual)→ 派发优化任务 → lead 派发 → worker
+ *  my_industrial_nodes/daq_query 读数 → dcw_control 下发(182→窗口内 184)→ HITL 批准
+ *  → 写 ACK + node.value 生效 + 打标样本增长。
+ *  演示资产(channel/团队/Agent)保留不清理,供用户在 UI 查看;线保持运行。
+ */
+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 H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const J = (u, m = 'GET', b) => fetch(BASE + 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号产线')
+const recipe = d.recipes.find(r => r.lineId === line.id)
+const dwTemp = d.nodes.find(n => n.name === '温度设定器(示例)')
+const daqAll = (await J('/api/workshop/daq')).data
+const dqPressure = daqAll.nodes.find(n => n.name === '压力变送器 01' && n.lineId === line.id)
+const dqTemp = daqAll.nodes.find(n => n.name === '温度传感器 01' && n.lineId === line.id)
+if (!dwTemp || !dqPressure || !dqTemp) { console.error('FAIL 节点缺失'); process.exit(1) }
+console.log('目标节点 → dcw:', dwTemp.name, `(当前 ${dwTemp.value}, 窗口 176~188) | daq:`, dqPressure.name, '+', dqTemp.name)
+
+// ── 1. Channel + 团队(lead=mock 调度,worker=omp 真实 LLM) ──
+const ch = (await J('/api/workshop/channels', 'POST', { name: '产线优化团队(端到端)', description: 'omp 团队作业优化任务演示' })).data
+console.log('channel:', ch.channelId)
+const team = (await J('/api/workshop/teams', 'POST', { name: '产线优化组(端到端)', description: '工况分析与工艺参数优化' })).data
+await J(`/api/workshop/teams/${team.id}/members`, 'POST', { agentId: 'tpl-default-lead', role: 'lead' })
+const workerTpl = (await J('/api/workshop/agents', 'POST', {
+  name: '工艺优化工程师(端到端)', harness: 'omp',
+  config: {
+    intro: '负责读取产线数采数据并做工艺参数优化,经 dcw_control 小步下发设定值',
+    systemPromptPrefix: '你是产线工艺优化工程师。用 my_industrial_nodes 查看授权节点,用 daq_query 获取最新工况;优化任务需在工艺窗口内小步调整并用 dcw_control 下发,结论引用具体数值。',
+  },
+})).data
+await J(`/api/workshop/teams/${team.id}/members`, 'POST', { agentId: workerTpl.id, role: 'worker' })
+const dep = await J(`/api/workshop/teams/${team.id}/deploy`, 'POST', { channelId: ch.channelId })
+const chAgents = (await J(`/api/workshop/channels/${ch.channelId}/agents`)).data
+const leadInst = chAgents.find(a => a.role === 'lead')
+const workerInst = chAgents.find(a => a.role === 'worker')
+if (!leadInst || !workerInst) { console.error('FAIL 部署实例缺失'); process.exit(1) }
+console.log('deploy → lead', leadInst.id.slice(0, 8), '/ worker', workerInst.id.slice(0, 8), `(harness=${workerInst.harness})`)
+
+// ── 2. Agent 绑定产线节点:2 数采(auto)+ 1 数控(manual=HITL) ──
+await J('/api/workshop/agent-tools/bindings', 'POST', { agentId: workerInst.id, nodeId: dqPressure.id, kind: 'daq', mode: 'auto' })
+await J('/api/workshop/agent-tools/bindings', 'POST', { agentId: workerInst.id, nodeId: dqTemp.id, kind: 'daq', mode: 'auto' })
+await J('/api/workshop/agent-tools/bindings', 'POST', { agentId: workerInst.id, nodeId: dwTemp.id, kind: 'dcw', mode: 'manual' })
+const bl = (await J(`/api/workshop/agent-tools/bindings?agentId=${workerInst.id}`)).data.bindings
+console.log(`绑定完成: ${bl.length} 条(2 daq auto + 1 dcw manual)`)
+
+// ── 3. 工具链路冒烟(HTTP 桥 = omp 同路径) ──
+const invoke = (agentId, tool, args) => J('/api/workshop/agent-tools/invoke', 'POST', { agentId, tool, args }).then(r => r.data.result)
+const mine = await invoke(workerInst.id, 'my_industrial_nodes', {})
+console.log('[工具] my_industrial_nodes:', mine.text.slice(0, 100).replace(/\n/g, ' '))
+const q = await invoke(workerInst.id, 'daq_query', { last_minutes: 5 })
+console.log('[工具] daq_query:', q.text.slice(0, 100).replace(/\n/g, ' '))
+
+// ── 4. 派发优化任务 ──
+const valueBefore = (await J('/api/workshop/dcw')).data.nodes.find(n => n.id === dwTemp.id).value
+const goal = `产线「1号产线」工艺优化任务:当前烘箱温度设定 ${valueBefore}℃,工艺窗口 176~188℃。请:1) 用数采工具读取最近几分钟温度/压力工况并给出均值;2) 将烘箱温度设定值向 184℃ 方向小步优化(用 dcw_control 下发,注意该节点为手动确认模式,发起后等待用户批准);3) 下发后复测并汇报前后数值。`
+const task = (await J(`/api/workshop/channels/${ch.channelId}/tasks`, 'POST', {
+  title: '烘箱温度参数优化',
+  parts: [{ text: goal }],
+  mode: 'loop',
+})).data
+const taskId = task?.task?.id ?? task?.id
+if (!taskId) { console.error('FAIL 任务派发失败:', JSON.stringify(task).slice(0, 150)); process.exit(1) }
+console.log('任务已派发:', taskId.slice(0, 10), `(设定 ${valueBefore} → 目标 ~184)`)
+
+// ── 5. 观察调度/HITL/写副作用 ──
+let subSeen = false, hitlSeen = false, valueSeen = false
+let pendDetail = ''
+for (let i = 0; i < 180; i++) {
+  await sleep(2000)
+  const tasks = (await J(`/api/workshop/channels/${ch.channelId}/tasks`)).data
+  const arr = Array.isArray(tasks) ? tasks : tasks?.tasks ?? []
+  const sub = arr.find(t => t.id !== taskId)
+  if (sub && !subSeen) { subSeen = true; console.log(`[t+${i * 2}s] lead 已派发子任务 → ${sub.assigneeId?.slice(0, 8)}`) }
+  const pend = (await J(`/api/workshop/agent-tools/approvals?agentId=${workerInst.id}`)).data.approvals
+  if (pend.length > 0 && !hitlSeen) {
+    hitlSeen = true
+    pendDetail = pend[0].detail
+    console.log(`[t+${i * 2}s] HITL 审批请求: ${pendDetail.slice(0, 80)}`)
+    await J(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, 'POST', { approved: true, comment: '窗口内小步优化,批准' })
+    console.log('[HITL] 已批准')
+  }
+  const dwNow = (await J('/api/workshop/dcw')).data.nodes.find(n => n.id === dwTemp.id)
+  if (dwNow?.value != null && Math.abs(dwNow.value - 184) <= 1.5) valueSeen = true
+  const subDone = sub && (sub.state === 'COMPLETED' || sub.state === 'FAILED' || sub.state === 'CANCELED')
+  if ((valueSeen && subDone) || i > 170) {
+    console.log(`[t+${i * 2}s] 结束观察: 子任务=${sub?.state} 设定值=${dwNow?.value}`)
+    break
+  }
+}
+
+// ── 6. 断言 ──
+const dwFinal = (await J('/api/workshop/dcw')).data
+const finalNode = dwFinal.nodes.find(n => n.id === dwTemp.id)
+const agentWrites = dwFinal.history.filter(h => h.nodeId === dwTemp.id && h.ok && (!h.recipeRunId || h.value !== valueBefore))
+const states = (await J('/api/workshop/dcw/lines')).data.states
+const tagged = states.find(s => s.lineId === line.id)?.taggedSamples ?? 0
+console.log('==== 断言 ====')
+console.log(subSeen ? 'PASS lead 调度派发子任务' : 'FAIL 未见子任务')
+console.log(hitlSeen ? `PASS HITL: Agent 发起下发审批并获批准(${pendDetail.slice(0, 50)})` : 'FAIL 未见 HITL 审批')
+console.log(valueSeen ? `PASS 参数下发生效: 设定值 ${valueBefore} → ${finalNode.value}(目标 ~184)` : `FAIL 设定值未变化: ${finalNode.value}`)
+console.log(`PASS 打标样本: 产线窗口内 ${tagged} 样本(线运行中)`)
+console.log('保留资产: channel=' + ch.channelId + ' team=' + team.id + ' worker=' + workerInst.id + ' task=' + taskId + '(线保持运行,可在 UI 查看)')

package/scripts/_dbg-scene-polish-shot.mjs

@@ -0,0 +1,118 @@
+/**
+ * 场景美化迭代截图/体检(2.5D Digital Twin):
+ *  - 清空 device-twins → 铺薄膜产线 + 数采绑定(复用 _dbg-dt-interact 布局);
+ *  - /town 多视角截图(std/top/front + 设备特写 dolly);
+ *  - FPS 采样 + 设备状态环世界位置探针(诊断 ring 双重偏移)。
+ * 用法: AW_PAGE_TOKEN=ut-xxx node scripts/_dbg-scene-polish-shot.mjs [tag]
+ */
+import puppeteer from 'puppeteer-core'
+
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const TAG = process.argv[2] ?? 'shot'
+const OUT = `docs/audit/screenshots/scene-polish-${TAG}`
+const H = { 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+if (!TOKEN) { console.error('need AW_PAGE_TOKEN'); process.exit(1) }
+
+const lineZ = 1200
+const spec = [
+  { name: '挤出机 L1', ref: 'dev-folder-extruder', x: 1000, z: lineZ, kind: 'device' },
+  { name: 'MD 纵拉机 L1', ref: 'dev-folder-mdo', x: 1680, z: lineZ, kind: 'device' },
+  { name: 'TD 拉幅机 L1', ref: 'dev-folder-tdo', x: 2080, z: lineZ, kind: 'device' },
+  { name: '收卷机 L1', ref: 'dev-folder-winder', x: 2430, z: lineZ, kind: 'device' },
+  { name: '压力变送器 01', ref: 'daq-pressure-tx', x: 1060, z: lineZ + 70, kind: 'daq' },
+  { name: '温度传感器 01', ref: 'daq-temp-tc', x: 1690, z: lineZ + 80, kind: 'daq' },
+  { name: '张力传感器 01', ref: 'daq-tension-cell', x: 2100, z: lineZ + 80, kind: 'daq' },
+]
+// 清空旧孪生(幂等重跑)
+const listRes = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H }).then(r => r.json()).catch(() => null)
+const oldTwins = listRes?.data?.twins ?? listRes?.data?.items ?? listRes?.data ?? []
+for (const t of oldTwins) {
+  const id = t?.id ?? t?.twinId
+  if (id) await fetch(`${BASE}/api/workshop/device-twins/${id}`, { method: 'DELETE', headers: H }).catch(() => {})
+}
+const created = []
+for (const s of spec) {
+  const res = await fetch(`${BASE}/api/workshop/device-twins`, {
+    method: 'POST', headers: H,
+    body: JSON.stringify({ name: s.name, modelRef: s.ref, kind: s.kind, posX: s.x, posZ: s.z }),
+  })
+  const j = await res.json().catch(() => ({}))
+  const id = j?.data?.twin?.id ?? j?.data?.id
+  if (res.ok && id) created.push({ ...s, id })
+}
+console.log(`created ${created.length}/${spec.length}`)
+const byName = Object.fromEntries(created.map(c => [c.name, c.id]))
+const bindings = {
+  [byName['压力变送器 01'] ?? 'x']: byName['挤出机 L1'] ?? 'y',
+  [byName['温度传感器 01'] ?? 'x']: byName['MD 纵拉机 L1'] ?? 'y',
+  [byName['张力传感器 01'] ?? 'x']: byName['TD 拉幅机 L1'] ?? 'y',
+}
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--no-first-run', '--disable-extensions', '--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.evaluateOnNewDocument((b) => {
+  localStorage.setItem('aw.twin.daqBindings', JSON.stringify(b))
+}, bindings)
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 200)))
+
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+let ready = false
+for (let i = 0; i < 40; i++) {
+  ready = await page.evaluate(need => (window.__town?.scene?.agents?.size ?? 0) > 0 && (window.__town?.scene?.deviceNodes?.size ?? 0) >= need, created.length)
+  if (ready) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+console.log('scene ready:', ready)
+await new Promise(r => setTimeout(r, 4000))
+
+import { mkdirSync } from 'node:fs'
+mkdirSync(OUT, { recursive: true })
+
+// 探针:设备状态环/数采光环世界位置 vs 设备根位置(诊断子体偏移)
+const probe = await page.evaluate(() => {
+  const s = window.__town?.scene
+  if (!s) return null
+  const out = []
+  for (const d of (s.deviceNodes?.values?.() ?? [])) {
+    out.push({
+      name: d.name, root: { x: Math.round(d.root.position.x), z: Math.round(d.root.position.z) },
+      ringLocal: { x: Math.round(d.ring.position.x), z: Math.round(d.ring.position.z) },
+      isDaq: d.modelRef?.startsWith?.('daq-') ?? false,
+    })
+  }
+  return out
+})
+console.log('probe:', JSON.stringify(probe))
+
+// FPS 采样(2s)
+const fps = await page.evaluate(() => new Promise((resolve) => {
+  const s = window.__town?.scene
+  if (!s) return resolve(-1)
+  const a = s.frameCount
+  setTimeout(() => resolve((s.frameCount - a) / 2), 2000)
+}))
+console.log('fps(headless):', fps)
+
+await page.screenshot({ path: `${OUT}/view-std.png` })
+await page.evaluate(() => window.__town?.scene?.setViewPreset?.('top'))
+await new Promise(r => setTimeout(r, 1600))
+await page.screenshot({ path: `${OUT}/view-top.png` })
+await page.evaluate(() => {
+  const s = window.__town?.scene
+  s?.setViewPreset?.('std')
+  s?.focusTo?.(1000, 1200)
+  s?.zoomBy?.(-0.55)
+})
+await new Promise(r => setTimeout(r, 1800))
+await page.screenshot({ path: `${OUT}/view-device-zoom.png` })
+console.log('shots saved:', OUT)
+console.log('pageerrors:', errors.length ? errors : 'none')
+await browser.close()

package/scripts/_dbg-selring-probe.mjs

@@ -0,0 +1,47 @@
+/** 一次性:选中高亮环 / 运行弧 / 角色光环 运行时探针 */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox'],
+})
+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}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.agents?.size ?? 0) > 0)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 2000))
+const r = await page.evaluate(() => {
+  const s = window.__town.scene
+  const a = [...s.agents.values()][0]
+  const d = [...s.deviceNodes.values()].find(x => !x.modelRef.startsWith('daq'))
+  s.selected = { kind: 'agent', id: a.agentId }
+  return new Promise(resolve => setTimeout(() => {
+    const agentRing = s.selRing.visible ? { vis: true, scale: Math.round(s.selRing.scale.x) } : { vis: false }
+    s.selected = { kind: 'device', id: d.twinId }
+    setTimeout(() => {
+      const devRing = { vis: s.selRing.visible, scale: Math.round(s.selRing.scale.x) }
+      const devArc = { arcVisible: !!d.arc?.visible, arcLocal: { x: Math.round(d.arc?.position.x ?? 0), z: Math.round(d.arc?.position.z ?? 0) } }
+      const agentAura = { auraMats: a.auraMats.length, ringColor: '#' + (a.auraMats[0]?.color.getHexString() ?? '') }
+      resolve({ agentRing, devRing, devArc, agentAura, devId: d.twinId, devPos: { x: d.root.position.x, z: d.root.position.z } })
+    }, 100)
+  }, 100))
+})
+console.log(JSON.stringify(r))
+// 选中态截图:琥珀高亮环观感
+await page.evaluate((dev) => {
+  const s = window.__town.scene
+  s.focusTo(dev.pos.x, dev.pos.z)
+  s.zoomBy(-0.5)
+  s.selected = { kind: 'device', id: dev.devId }
+}, { devId: r.devId, pos: r.devPos })
+await new Promise(r2 => setTimeout(r2, 1800))
+await page.screenshot({ path: 'docs/audit/screenshots/scene-polish-v4/view-selected.png' })
+console.log('selected shot saved')
+await browser.close()

package/scripts/_dbg-sideinfo.mjs

@@ -0,0 +1,101 @@
+/**
+ * 侧边信息重构审计:
+ *  1) 选中精魂 → 会话记录在右轨 Inspector(.rail-right 内 chat-embed),场景舞台(#town-host)无悬浮会话台;
+ *  2) 设备控制台:数采节点卡为绿色(.daq),设备卡显示绑定通道实时值(.twin-daq);
+ *  3) 截图:agent 会话在右轨 + 设备控制台绿色数采卡。
+ */
+import puppeteer from 'puppeteer-core'
+
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const H = { 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+
+const spec = [
+  { name: 'TD 拉幅机 L1', ref: 'dev-folder-tdo', x: 1700, z: 600, kind: 'device' },
+  { name: '温度传感器 01', ref: 'daq-temp-tc', x: 1750, z: 690, kind: 'daq' },
+]
+const created = []
+for (const s of spec) {
+  const res = await fetch(`${BASE}/api/workshop/device-twins`, {
+    method: 'POST', headers: H,
+    body: JSON.stringify({ name: s.name, modelRef: s.ref, kind: s.kind, posX: s.x, posZ: s.z }),
+  })
+  const j = await res.json().catch(() => ({}))
+  const id = j?.data?.twin?.id ?? j?.data?.id
+  if (res.ok && id) created.push({ ...s, id })
+}
+const byName = Object.fromEntries(created.map(c => [c.name, c.id]))
+const bindings = { [byName['温度传感器 01']]: byName['TD 拉幅机 L1'] }
+console.log(`created ${created.length}/${spec.length}`)
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--no-first-run', '--disable-extensions', '--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.evaluateOnNewDocument((b) => {
+  localStorage.setItem('aw.twin.daqBindings', JSON.stringify(b))
+}, bindings)
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 160)))
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.agents?.size ?? 0) > 0)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 5000)) // 等模拟 tick 产出实时值
+
+// ---- 1) 选中精魂 → 会话在右轨 ----
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const agent = [...s.agents.values()][0]
+  s.setSelected({ kind: 'agent', id: agent.agentId })
+})
+await new Promise(r => setTimeout(r, 2500))
+const chatLoc = await page.evaluate(() => {
+  const embed = document.querySelector('.rpg-lines.chat-embed')
+  const rail = embed?.closest('.rail-right') ?? null
+  return {
+    inRail: !!rail,
+    inStage: !!document.querySelector('#town-host .agent-chat, .stage .agent-chat'),
+    name: document.querySelector('.rail-right .chat-name')?.textContent ?? '',
+    rows: document.querySelectorAll('.rail-right .rpg-line').length,
+  }
+})
+console.log('chat:', JSON.stringify(chatLoc), chatLoc.inRail && !chatLoc.inStage ? '(OK 会话入右轨)' : '(FAIL)')
+
+// ---- 2) 设备控制台实时数采 + 绿卡 ----
+const panel = await page.evaluate(() => {
+  const cards = [...document.querySelectorAll('.twin-card')]
+  const daqCard = cards.find(c => c.classList.contains('daq'))
+  const devCard = cards.find(c => (c.textContent ?? '').includes('TD 拉幅机') && c.querySelector('.twin-daq'))
+  return {
+    total: cards.length,
+    daqGreen: !!daqCard,
+    daqCode: daqCard?.querySelector('.twin-code')?.textContent ?? '',
+    devDaqRow: devCard?.querySelector('.daq-item')?.textContent?.replace(/\s+/g, ' ')?.trim() ?? '',
+    devCtrlHidden: devCard ? !devCard.querySelector('.twin-ctrl') || false : null,
+    daqCtrlHidden: daqCard ? !daqCard.querySelector('.twin-ctrl') : null,
+  }
+})
+console.log('panel:', JSON.stringify(panel), panel.daqGreen && panel.devDaqRow ? '(OK 绿卡+实时值)' : '(FAIL)')
+
+// ---- 3) 截图:选中精魂的右轨 + 滚动到设备控制台 ----
+await page.screenshot({ path: 'docs/audit/screenshots/town-sideinfo-agent.png' })
+await page.evaluate(() => {
+  const rail = document.querySelector('.rail-right')
+  if (rail) rail.scrollTop = rail.scrollHeight
+})
+await new Promise(r => setTimeout(r, 400))
+await page.screenshot({ path: 'docs/audit/screenshots/town-sideinfo-panel.png' })
+console.log('pageerrors:', errors.length ? errors : 'none')
+
+await page.close().catch(() => {})
+await browser.close()
+for (const c of created) {
+  await fetch(`${BASE}/api/workshop/device-twins/${c.id}`, { method: 'DELETE', headers: H }).catch(() => {})
+}
+console.log(`cleanup done (${created.length})`)

package/scripts/_dbg-splitter.mjs

@@ -0,0 +1,88 @@
+/**
+ * 分割线修复验证(一次性调试脚本):
+ *  - lanes 视图:统计 .lane 与 .pane-splitter 数量(修复后应相等:每列右侧都有分隔条);
+ *  - 模拟拖动最后一根分隔条向右 140px → 最右泳道宽度应增加;
+ *  - split 视图(MultiChannelView):同结构校验 + 尾列拖宽验证;
+ *  - 截图 + pageerror 收集。
+ */
+import puppeteer from 'puppeteer-core'
+
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const WS = process.env.AW_WS ?? 'cc05b5c1-d465-42fa-98c0-af8d61c3a413'
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--no-first-run', '--disable-extensions', '--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: '/' })
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 200)))
+
+const readState = laneSel => page.evaluate((sel) => {
+  const cols = [...document.querySelectorAll(sel)]
+  const root = cols[cols.length - 1]?.closest('.lanes, .split')
+  const sps = [...(root ?? document).querySelectorAll('.pane-splitter')]
+  const last = cols[cols.length - 1]
+  return {
+    colCount: cols.length,
+    splitterCount: sps.length,
+    lastW: last ? Math.round(last.getBoundingClientRect().width) : -1,
+  }
+}, laneSel)
+
+const dragLastSplitter = async (dx, colSel) => {
+  const box = await page.evaluate((sel) => {
+    const cols = [...document.querySelectorAll(sel)]
+    // 先把容器滚到最右,确保尾部分隔条进入可视区(否则鼠标事件会落在右侧栏上)
+    const root = cols[cols.length - 1]?.closest('.lanes, .split')
+    if (root) root.scrollLeft = root.scrollWidth
+    const sps = [...(root ?? document).querySelectorAll('.pane-splitter')]
+    const last = sps[sps.length - 1]
+    if (!last) return null
+    const r = last.getBoundingClientRect()
+    return { x: r.x + r.width / 2, y: r.y + Math.min(r.height / 2, 260) }
+  }, colSel)
+  if (!box) return false
+  await page.mouse.move(box.x, box.y)
+  await page.mouse.down()
+  await page.mouse.move(box.x + Math.round(dx / 2), box.y, { steps: 6 })
+  await page.mouse.move(box.x + dx, box.y, { steps: 8 })
+  await page.mouse.up()
+  await new Promise(r => setTimeout(r, 300))
+  return true
+}
+
+// ---- lanes 视图 ----
+await page.goto(`${BASE}/workshop/w/${WS}?view=lanes`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 20; i++) {
+  if (await page.evaluate(() => document.querySelectorAll('.lane').length > 0)) break
+  await new Promise(r => setTimeout(r, 800))
+}
+await new Promise(r => setTimeout(r, 1200))
+const lanesBefore = await readState('.lane')
+await dragLastSplitter(140, '.lane')
+const lanesAfter = await readState('.lane')
+console.log('lanes before:', JSON.stringify(lanesBefore))
+console.log('lanes after :', JSON.stringify(lanesAfter))
+await page.screenshot({ path: 'docs/audit/screenshots/splitter-lanes.png' })
+
+// ---- split(multi-channel)视图 ----
+await page.goto(`${BASE}/workshop/w/${WS}?view=split`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 20; i++) {
+  if (await page.evaluate(() => document.querySelectorAll('.split .col').length > 0)) break
+  await new Promise(r => setTimeout(r, 800))
+}
+await new Promise(r => setTimeout(r, 1200))
+const splitBefore = await readState('.split .col')
+await dragLastSplitter(120, '.split .col')
+const splitAfter = await readState('.split .col')
+console.log('split before:', JSON.stringify(splitBefore))
+console.log('split after :', JSON.stringify(splitAfter))
+await page.screenshot({ path: 'docs/audit/screenshots/splitter-split.png' })
+
+console.log('errors:', errors.slice(0, 6))
+await browser.close()

package/scripts/_dbg-team-repro.mjs

@@ -0,0 +1,76 @@
+/**
+ * 团队场景复现:mock lead + omp worker + goal 任务,保留现场不清理。
+ */
+const ROOT = 'http://127.0.0.1:3000'
+let TOKEN = ''
+const H = () => ({ authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H(), body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jget = (u) => fetch(ROOT + u, { headers: H() }).then(r => r.json())
+
+async function main() {
+  const reg = await jpost('/api/workshop/users/register', { name: 'teamdbg-' + Math.random().toString(36).slice(2, 8) })
+  TOKEN = reg.data?.token
+  if (!TOKEN) { console.error('register failed'); process.exit(1) }
+
+  const line = (await jpost('/api/workshop/dcw/lines', { name: 'TEAMDBG-线' })).data.line
+  const dq = (await jpost('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: 'TEAMDBG-温度', lineId: line.id, intervalMs: 500 })).data.node
+  const dw = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: 'TEAMDBG-设定', lineId: line.id })).data.node
+  const prod = (await jpost('/api/workshop/dcw/products', { name: 'TEAMDBG-产品', lineId: line.id })).data.product
+  const rc = (await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: 'TEAMDBG-配方',
+    params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 176, max: 188 }],
+    daqWindows: [{ nodeId: dq.id, min: 100, max: 260 }],
+  })).data.recipe
+  await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  console.log('[line] started')
+
+  const ch = (await jpost('/api/workshop/channels', { name: 'TEAMDBG-channel' })).data
+  const team = (await jpost('/api/workshop/teams', { name: 'TEAMDBG-组' })).data
+  await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: 'tpl-default-lead', role: 'lead' })
+  const tplWorker = (await jpost('/api/workshop/agents', {
+    name: 'TEAMDBG-worker', harness: 'omp',
+    config: { systemPromptPrefix: '你是产线数据分析工程师。先用 my_industrial_nodes 查看授权节点,再用 daq_query 获取最近 2 分钟数据给出均值。若温度均值与 182℃ 偏差超过 1℃,用 dcw_control 把温度设定调整为 182(手动确认模式,发起后等待批准)。结论引用具体数值。' },
+  })).data
+  await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: tplWorker.id, role: 'worker' })
+  const depRes = await jpost(`/api/workshop/teams/${team.id}/deploy`, { channelId: ch.channelId })
+  console.log('[deploy-res]', JSON.stringify(depRes).slice(0, 300))
+  const chAgentsRes = (await jget(`/api/workshop/channels/${ch.channelId}/agents`)).data
+  const chAgents = Array.isArray(chAgentsRes) ? chAgentsRes : chAgentsRes?.agents ?? []
+  const worker = chAgents.find(a => a.role === 'worker')
+  if (!worker) { console.error('[deploy] worker missing, agents=' + JSON.stringify(chAgents).slice(0, 200)); process.exit(1) }
+  console.log('[deployed] worker=' + worker.id.slice(0, 8) + ' harness=' + worker.harness)
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: worker.id, nodeId: dq.id, kind: 'daq', mode: 'auto' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: worker.id, nodeId: dw.id, kind: 'dcw', mode: 'manual' })
+
+  const task = await jpost(`/api/workshop/channels/${ch.channelId}/tasks`, {
+    title: 'TEAMDBG-分析任务',
+    parts: [{ text: '分析产线温度:1) 用 daq_query 获取最近 2 分钟温度均值;2) 与 182℃ 目标比较偏差;3) 偏差超过 1℃ 时用 dcw_control 下发修正(等待批准)。完成后汇报数值结论。' }],
+    mode: 'goal',
+    modeConfig: { goalCriteria: '已产出含具体数值的数据分析结论,且温度设定值已调整为 182℃ 附近(或明确说明未需调整)' },
+  })
+  const taskId = task.data?.task?.id ?? task.data?.id
+  console.log('[task]', taskId?.slice(0, 8), 'code=' + task.code)
+
+  for (let i = 0; i < 70; i++) {
+    await sleep(3000)
+    const t = (await jget(`/api/workshop/channels/${ch.channelId}/tasks`)).data
+    const arr = Array.isArray(t) ? t : t?.tasks ?? []
+    const parent = arr.find(x => x.id === taskId)
+    const sub = arr.find(x => x.id !== taskId)
+    if (i % 4 === 0 || (parent?.state !== 'WORKING' && parent?.state !== 'WAITING')) {
+      console.log(`[t+${i * 3}s] parent=${parent?.state} sub=${sub ? sub.state + '/' + (sub.progress ?? 0) : 'none'} retry=${sub?.retryCount}`)
+    }
+    const pend = (await jget(`/api/workshop/agent-tools/approvals?agentId=${worker.id}`)).data.approvals
+    if (pend.length > 0) {
+      console.log('[HITL] approval:', String(pend[0].detail).slice(0, 60))
+      await jpost(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, { approved: true, comment: '批准' })
+    }
+    if (['COMPLETED', 'CANCELED', 'FAILED'].includes(parent?.state)) {
+      console.log('[final] parent=' + parent.state)
+      break
+    }
+  }
+  console.log('[keep] channel=' + ch.channelId)
+}
+main().catch(e => { console.error('FATAL', e.message); process.exit(1) })

package/scripts/_dbg-town-alarm-e2e.mjs

@@ -0,0 +1,40 @@
+/** 告警管线端到端:收紧预警带 → warn 边沿 → 实时告警面板行即时出现 → 还原。 */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const H = { authorization: 'Bearer ut-ffc1dfbbc0c1444c87c1ec69a9e8208c', 'content-type': 'application/json' }
+const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
+const jget = u => fetch(ROOT + u, { headers: H }).then(r => r.json())
+const jpatch = (u, b) => fetch(ROOT + u, { method: 'PATCH', headers: H, body: JSON.stringify(b) }).then(r => r.json())
+
+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 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(15000)
+
+// 选一个在采节点,把预警上界压到当前值下方 → 触发 warn
+const daqAll = (await jget('/api/workshop/daq')).data
+const node = daqAll.nodes.find(n => n.value != null && n.enabled && n.state === 'ok')
+if (!node) { fail('无在采健康节点可测'); process.exit(1) }
+const tightHigh = +(node.value - Math.max(0.5, Math.abs(node.value) * 0.01)).toFixed(2)
+console.log(`[告警] ${node.name} 当前 ${node.value},收紧 warnHigh → ${tightHigh}`)
+await jpatch(`/api/workshop/daq/${node.id}`, { warnHigh: tightHigh })
+
+// 等 warn 帧到达(采样 1s + 边沿检测即时)
+await sleep(6000)
+const warnRows = await page.evaluate(() =>
+  [...document.querySelectorAll('.alarm-list .al-row')].map(r => r.textContent).join('◇'))
+const hit = warnRows.includes(node.name)
+console.log('[告警] 面板含目标节点告警:', hit ? `PASS(行内容: ${warnRows.slice(0, 120)})` : `FAIL(面板: ${warnRows.slice(0, 120) || '空'})`)
+if (!hit) fail('warn 边沿未即时渲染到告警面板')
+
+// 还原预警带
+const restore = await jpatch(`/api/workshop/daq/${node.id}`, { warnHigh: node.warnHigh })
+console.log('[告警] 预警带已还原:', restore?.code === 0 || restore?.data ? 'OK' : JSON.stringify(restore).slice(0, 100))
+await page.screenshot({ path: 'docs/audit/screenshots/redesign0831/town-alarm-pipeline.png' })
+await browser.close()
+console.log(process.exitCode ? 'FAILED' : 'ALL PASS')

package/scripts/_dbg-town-beauty-shots.mjs

@@ -0,0 +1,54 @@
+/** 美化验收截图:场景总览 + 编辑模式设备选中(检查器/关键设备监控卡片) */
+import puppeteer from 'puppeteer-core'
+
+const TOKEN = process.env.AW_TOKEN ?? 'ut-258a3578a5f2450d92416c08d1c1205f'
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const OUT = 'docs/audit/screenshots'
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--window-size=1920,1080'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1080 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+for (let i = 0; i < 40; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+  await sleep(1000)
+}
+// 等模型 GLB 加载与首帧渲染充分
+await sleep(5000)
+
+const nDev = await page.evaluate(() => window.__town.scene.deviceNodes.size)
+console.log('devices in scene:', nDev)
+
+// 拉近到设备聚集区:聚焦第一个设备并缩小 dolly(特写看 PBR 材质/阴影)
+await page.evaluate(() => {
+  const s = window.__town.scene
+  const [id, node] = [...s.deviceNodes.entries()][0]
+  s.focusTo(node.root.position.x, node.root.position.z)
+  s.dolly = 0.45
+  console.log('focus', id)
+})
+await sleep(2500)
+
+// Shot 1: 场景近景(浏览模式,KPI 条 + 设备/角色特写)
+await page.screenshot({ path: `${OUT}/town-beauty-overview.png` })
+console.log('shot: town-beauty-overview.png')
+
+// Shot 2: 编辑模式 + 选中设备(左轨检查器 + 右轨关键设备监控 + DCW 行)
+await page.evaluate(() => {
+  ;[...document.querySelectorAll('button')].find(b => b.textContent.trim() === '编辑')?.click()
+})
+await sleep(600)
+const devId = await page.evaluate(() => [...window.__town.scene.deviceNodes.keys()][0])
+await page.evaluate((id) => { window.__town.scene.setSelected({ kind: 'device', id }) }, devId)
+await sleep(1200)
+await page.screenshot({ path: `${OUT}/town-beauty-inspector.png` })
+console.log('shot: town-beauty-inspector.png, selected:', devId)
+
+await browser.close()
+console.log('SHOTS DONE')