agentworkshop 0.2.1

package/scripts/_dbg-console-audit.mjs

@@ -0,0 +1,61 @@
+/** 一次性:浏览器 console 错误/警告捕获(/daq 与 /town 全加载周期) */
+import puppeteer from 'puppeteer-core'
+
+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: 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c', domain: '127.0.0.1', path: '/' })
+
+const issues = []
+page.on('console', (msg) => {
+  const t = msg.type()
+  if (t === 'error' || t === 'warning') {
+    const text = msg.text()
+    // 已知无害来源:Vue devtools 提示 / Chrome 扩展缺失 / favicon 404
+    if (/vue-devtools|Download the Vue Devtools/i.test(text)) return
+    issues.push(`[${t}][${page.url().split('/').slice(-1)[0] || '/'}] ${text.slice(0, 180)}`)
+  }
+})
+page.on('pageerror', (err) => issues.push(`[pageerror] ${String(err).slice(0, 200)}`))
+
+await page.goto('http://127.0.0.1:3000/users', { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 4000))
+await page.goto('http://127.0.0.1:3000/workshop', { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 5000))
+await page.goto('http://127.0.0.1:3000/daq', { waitUntil: 'domcontentloaded', timeout: 90000 })
+await new Promise(r => setTimeout(r, 6000))
+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 new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 8000))
+
+const sceneState = await page.evaluate(() => {
+  const s = window.__town?.scene
+  if (!s) return { ready: false }
+  const daq = [...s.deviceNodes.values()].filter(d => (d.modelRef ?? '').startsWith('daq-'))
+  return {
+    ready: true,
+    devices: s.deviceNodes.size,
+    daqNodes: daq.length,
+    channels: s.blocks.size,
+    agents: s.agents.size,
+  }
+})
+console.log('scene:', JSON.stringify(sceneState))
+
+// 过滤后是否仍存在问题
+const errors = issues.filter(i => i.startsWith('[error') || i.startsWith('[pageerror]'))
+const warnings = issues.filter(i => i.startsWith('[warning'))
+console.log(`console errors: ${errors.length}, warnings: ${warnings.length}`)
+for (const e of errors) console.log('  E:', e)
+const warnSample = [...new Set(warnings.map(w => w.replace(/\d+/g, 'N')))].slice(0, 6)
+for (const w of warnSample) console.log('  W:', w)
+
+await browser.close()
+console.log(errors.length === 0 ? 'CONSOLE CLEAN (no errors)' : 'CONSOLE HAS ERRORS')

package/scripts/_dbg-console-probe.mjs

@@ -0,0 +1,23 @@
+/** 一次性:首页客户端报错捕获(pageerror + console.error) */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu'],
+})
+const page = await browser.newPage()
+const errors = []
+page.on('pageerror', (err) => {
+  errors.push(`[pageerror] ${String(err?.message ?? err).slice(0, 500)}`)
+})
+page.on('console', (msg) => {
+  if (msg.type() === 'error' || msg.type() === 'warning') {
+    errors.push(`[console.${msg.type()}] ${msg.text().slice(0, 400)}`)
+  }
+})
+await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 6000))
+console.log(errors.length ? errors.join('\n---\n') : '(no client errors)')
+await browser.close()

package/scripts/_dbg-context-inject-audit.mjs

@@ -0,0 +1,231 @@
+/**
+ * 上下文注入探针:验证 AgentRuntime → omp Harness 的工业上下文/工具注入全链。
+ *
+ * Tier A(tsx 直读,确定性):OmpRpcAgentImpl.contextPrefix 组装断言 ——
+ *   场景 + 产线工况简报(产线/配方/工艺窗口/数采窗口/报警) + 调控作业环,
+ *   且未绑定 Agent 的 prefix 不含任何工业段(零硬编码泄漏)。
+ * Tier B(HTTP 工具面):my_industrial_nodes 语义卡(自定义模板 semantics 透出)
+ *   / daq_query line_id 过滤落实 / 越窗报警状态透出。
+ * Tier C(omp 实测):真实 harness 回合能否引用注入事实(任务文本零泄漏)。
+ *
+ * 运行:dev(3000) + modbus 模拟器(1502) 就绪后
+ *   npx tsx scripts/_dbg-context-inject-audit.mjs
+ */
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+let pass = 0
+const fails = []
+const ok = (m) => { pass++; console.log(`  PASS ${m}`) }
+const fail = (m) => { fails.push(m); console.error(`  FAIL ${m}`) }
+const assert = (cond, m) => (cond ? ok(m) : fail(m))
+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())
+const jdel = (u) => fetch(ROOT + u, { method: 'DELETE', headers: H }).then(r => r.json())
+const invoke = (agentId, tool, args) => jpost('/api/workshop/agent-tools/invoke', { agentId, tool, args }).then(r => r.data?.result?.text ?? JSON.stringify(r))
+
+// 唯一语义标记(自定义模板 semantics 的数据驱动证明:任何查表词典都不可能含它)
+const SEM_MARKER = 'PROBE-SEM-7741:熔体温度决定塑化均化质量,波动超过4℃将导致制品内应力超标'
+const LINE_NAME = '上下文探针线R7'
+const PROD_NAME = '探针产品P9'
+const RECIPE_NAME = '探针配方Q5'
+const PROBE_AGENT = 'probe-ctx-agent-7741'
+
+async function makeFixture() {
+  const twin = (await jpost('/api/workshop/device-twins', { name: '探针受控设备', modelRef: 'dev-folder-extruder', kind: 'device', posX: 4200, posZ: 900 })).data.twin
+  const line = (await jpost('/api/workshop/dcw/lines', { name: LINE_NAME })).data.line
+  const prod = (await jpost('/api/workshop/dcw/products', { name: PROD_NAME, lineId: line.id })).data.product
+  const dq = (await jpost('/api/workshop/daq', {
+    templateRef: 'daq-temp-tc', name: '探针-温度采集',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40003, dataType: 'float32', byteOrder: 'big' },
+    intervalMs: 400, lineId: line.id, deviceBindingId: twin.id,
+    semantics: SEM_MARKER,
+  })).data.node
+  const dw = (await jpost('/api/workshop/dcw', {
+    templateRef: 'dcw-temp-sp', name: '探针-温度设定',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: 1502, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big', engMin: 150, engMax: 200, rawMin: 0, rawMax: 2000 },
+    lineId: line.id, deviceBindingId: twin.id,
+    semantics: SEM_MARKER,
+  })).data.node
+  const rc = (await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: RECIPE_NAME,
+    params: [{ nodeId: dw.id, value: 180, min: 176, max: 188 }],
+    // 数采窗口故意设窄:真实温度 ~166~174 → 必然越限报警(验证报警透出)
+    daqWindows: [{ nodeId: dq.id, min: 100, max: 110 }],
+  })).data.recipe
+  await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  return { twin, line, prod, dq, dw, rc }
+}
+
+async function cleanupFixture(f) {
+  await jpost(`/api/workshop/dcw/lines/${f.line.id}/stop`, {}).catch(() => {})
+  await jdel(`/api/workshop/dcw/recipes/${f.rc.id}`).catch(() => {})
+  await jdel(`/api/workshop/daq/${f.dq.id}`).catch(() => {})
+  await jdel(`/api/workshop/dcw/${f.dw.id}`).catch(() => {})
+  await jdel(`/api/workshop/dcw/products/${f.prod.id}`).catch(() => {})
+  await jdel(`/api/workshop/dcw/lines/${f.line.id}`).catch(() => {})
+  await jdel(`/api/workshop/device-twins/${f.twin.id}`).catch(() => {})
+}
+
+/** 等待任务(或其子任务)完成并收集工件文本(轮询 channel 任务列表) */
+async function waitTaskArtifact(channelId, taskId, maxMs = 300_000) {
+  const deadline = Date.now() + maxMs
+  while (Date.now() < deadline) {
+    await sleep(4000)
+    const res = (await jget(`/api/workshop/channels/${channelId}/tasks`)).data
+    const tasks = Array.isArray(res) ? res : res?.tasks ?? []
+    if (tasks.length === 0) continue
+    const related = tasks.filter(t => t.id === taskId || t.parentId === taskId)
+    if (related.length === 0) continue
+    const allDone = related.every(t => ['COMPLETED', 'FAILED', 'CANCELED'].includes(t.state))
+    if (!allDone) continue
+    const text = related
+      .flatMap(t => (t.artifacts ?? []).map(a => (a.parts ?? []).map(p => p.text ?? '').join(' ')))
+      .join('\n')
+    if (related.some(t => t.state !== 'COMPLETED')) {
+      fail(`omp 任务非正常收口: ${related.map(t => `${t.title}=${t.state}`).join(',')}`)
+    }
+    return text
+  }
+  fail('omp 任务等待超时')
+  return ''
+}
+
+async function main() {
+  // 先建 fixture 再 import 服务模块:repo 单例在首次调用时读盘,
+  // 探针进程必须晚于数据创建(否则读到陈旧快照);产线活动批次是
+  // dev 进程运行时状态,探针进程永远不可见 —— 运行时相关断言全部由
+  // Tier C(真实 omp 回合)活体覆盖,这里只断言持久化数据面。
+  console.log('== fixture 创建(HTTP) ==')
+  const f = await makeFixture()
+  console.log(`[fixture] 产线 ${f.line.id} / 配方 ${f.rc.id} / 数控 ${f.dw.id} / 数采 ${f.dq.id}`)
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: PROBE_AGENT, nodeId: f.dw.id, kind: 'dcw', mode: 'manual' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: PROBE_AGENT, nodeId: f.dq.id, kind: 'daq', mode: 'auto' })
+
+  console.log('== Tier A: contextPrefix 组装(tsx 直读,持久化数据面) ==')
+  const [{ buildIndustrialContext, industrialLoopGuide }, { OmpRpcAgentImpl }] = await Promise.all([
+    import('../server/services/workshop/agents/industrial-context.ts'),
+    import('../server/services/workshop/agents/omp-agent.ts'),
+  ])
+
+  // 未绑定 Agent:任何工业段都不得出现(零硬编码)
+  assert(buildIndustrialContext('no-such-agent') === '', '未绑定 Agent:工况简报为空')
+  assert(industrialLoopGuide('no-such-agent') === '', '未绑定 Agent:作业环为空')
+  const bare = new OmpRpcAgentImpl({ agentId: 'no-such-agent', name: 'x', role: 'worker', channelId: 'c' })
+  const barePrefix = await bare.contextPrefix()
+  assert(!barePrefix.includes('产线工况简报') && !barePrefix.includes('工业调控作业环'), '未绑定 Agent prefix 不含工业段')
+  assert(barePrefix.includes('Scenario Brief'), '未绑定 Agent prefix 仍含场景段')
+
+  // 绑定 Agent:工况简报 + 作业环随绑定数据出现
+  const briefing = buildIndustrialContext(PROBE_AGENT)
+  assert(briefing.includes('产线工况简报'), '工况简报段存在')
+  assert(briefing.includes(LINE_NAME), `简报含产线名(${LINE_NAME})`)
+  assert(briefing.includes('工况:'), '简报含工况行(运行态由 Tier C 活体验证)')
+
+  const loop = industrialLoopGuide(PROBE_AGENT)
+  assert(loop.includes('工业调控作业环'), '作业环段存在')
+  assert(loop.includes('安全量程 ∩ 活动配方工艺窗口'), '作业环含窗口联锁纪律')
+  assert(loop.includes('等待用户批准'), 'manual 绑定 → 作业环含审批纪律')
+  assert(loop.includes('daq_query') && loop.includes('my_industrial_nodes') && loop.includes('dcw_control'), '作业环引用全部工业工具名')
+
+  const bound = new OmpRpcAgentImpl({ agentId: PROBE_AGENT, name: 'x', role: 'worker', channelId: 'c' })
+  const boundPrefix = await bound.contextPrefix()
+  const order = [
+    boundPrefix.indexOf('Scenario Brief'),
+    boundPrefix.indexOf('产线工况简报'),
+    boundPrefix.indexOf('工业调控作业环'),
+  ]
+  assert(order.every(i => i > 0) && order[0] < order[1] && order[1] < order[2], `prefix 段序:场景→工况→作业环 [${order}]`)
+  assert(boundPrefix.includes(LINE_NAME), 'prefix 携带产线事实')
+
+  console.log('== Tier B: 工具面语义(HTTP,含实时状态) ==')
+  // 报警透出:数采窗口故意收窄,线跑起来后真实温度必然越限
+  await sleep(3500)
+  const nodesCard = await invoke(PROBE_AGENT, 'my_industrial_nodes', {})
+  assert(nodesCard.includes(SEM_MARKER), '语义卡透出自定义 semantics 原文(节点级覆盖)')
+  assert(nodesCard.includes('[176, 188]') && nodesCard.includes('工艺窗口'), '语义卡含配方工艺窗口')
+  assert(nodesCard.includes('手动确认模式'), '语义卡标注 manual 模式')
+  assert(nodesCard.includes('状态 alarm'), '数采卡透出越窗报警状态(实时)')
+  // 报警简报行的活体验证放在 Tier C(T1 问题要求报告当前报警节点) ——
+  // 报警态是 dev 进程运行时状态,探针进程不可见
+
+  // daq_query:line_id 过滤落实
+  const q = await invoke(PROBE_AGENT, 'daq_query', { line_id: f.line.id, last_minutes: 5 })
+  assert(q.includes('探针-温度采集'), 'daq_query(line_id) 命中本线节点')
+  assert(q.includes('过滤条件') && q.includes(f.line.id), 'daq_query 结果标注 line_id 过滤')
+  const qMiss = await invoke(PROBE_AGENT, 'daq_query', { line_id: 'no-such-line' })
+  assert(qMiss.includes('没有归属产线'), 'daq_query(未知 line_id) 明确空集说明')
+  const qConflict = await invoke(PROBE_AGENT, 'daq_query', { node_id: f.dq.id, line_id: 'other-line' })
+  assert(qConflict.includes('过滤冲突'), 'daq_query(line_id 与 node_id 冲突) 显式报错')
+  const qData = await invoke(PROBE_AGENT, 'daq_query', { node_id: f.dq.id, last_minutes: 5 })
+  assert(qData.includes('工况判读'), 'daq_query 返回工况判读(窗口位置+同线设定联动)')
+
+  // ===== Tier C: omp harness 实测(真实回合引用注入事实;任务文本零工业信息) =====
+  let ch = null
+  let team = null
+  let tplWorker = null
+  const taskIds = []
+  console.log('== Tier C: omp harness 实测(真实回合引用注入事实) ==')
+  if (fails.length > 0) {
+    console.log('(Tier A/B 已有失败,跳过 omp 实测以免烧等待时间)')
+  }
+  else {
+    ch = (await jpost('/api/workshop/channels', { name: '上下文注入探针频道' })).data
+    team = (await jpost('/api/workshop/teams', { name: '上下文注入探针团队' })).data
+    await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: 'tpl-default-lead', role: 'lead' })
+    tplWorker = (await jpost('/api/workshop/agents', {
+      name: '探针工艺员', harness: 'omp',
+      config: { rpcMode: 'rpc', systemPromptPrefix: '你是产线工艺员,严格基于系统上下文与工具结果回答,不臆测。' },
+    })).data
+    await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: tplWorker.id, role: 'worker' })
+    await jpost(`/api/workshop/teams/${team.id}/deploy`, { channelId: ch.channelId })
+    const chAgents = (await jget(`/api/workshop/channels/${ch.channelId}/agents`)).data
+    const workerInst = chAgents.find(a => a.role === 'worker')
+    await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: f.dw.id, kind: 'dcw', mode: 'auto' })
+    await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: f.dq.id, kind: 'daq', mode: 'auto' })
+    console.log(`[omp] worker 实例 ${workerInst.id} 已部署并绑定`)
+
+    // T1:禁用工具 —— 答案只能来自 prompt 注入的工况简报/作业环
+    const t1 = (await jpost(`/api/workshop/channels/${ch.channelId}/tasks`, {
+      title: '工况感知自检',
+      parts: [{ text: '请把本题派发给绑定工业节点的团队成员作答(勿自行作答)。题目:不要调用任何工具,仅依据你系统上下文中自动注入的「产线工况简报」与「工业调控作业环」回答:1) 你所在产线名称;2) 活动配方名;3) 数控节点的配方工艺窗口数值区间;4) 逐字引用调控作业环第3步的决策纪律原文(含「安全量程」字样的整句);5) 简报是否列出了当前报警节点?若有,报告其名称与实时数值。逐项作答。' }],
+    })).data
+    taskIds.push(t1.task?.id ?? t1.id)
+    const r1 = await waitTaskArtifact(ch.channelId, taskIds[0])
+    assert(r1.includes('探针线R7'), 'omp 回合引用产线名(接受 LLM 缩写)')
+    assert(r1.includes(RECIPE_NAME), 'omp 回合引用配方名')
+    assert(r1.includes('176') || r1.includes('188'), 'omp 回合引用窗口数值')
+    assert(r1.includes('安全量程 ∩ 活动配方工艺窗口'), 'omp 回合逐字引用作业环纪律')
+    assert(r1.includes('探针-温度采集'), 'omp 回合引用当前报警节点(简报报警行活体验证)')
+
+    // T2:工具面 —— my_industrial_nodes 语义原文(自定义 semantics 全链)
+    const t2 = (await jpost(`/api/workshop/channels/${ch.channelId}/tasks`, {
+      title: '节点语义自检',
+      parts: [{ text: '请把本题派发给绑定工业节点的团队成员作答(勿自行作答)。题目:先调用 my_industrial_nodes 工具,然后回答:你绑定节点的「工艺语义/采集语义」原文是什么(以 PROBE-SEM 开头)?该节点的安全量程与当前活动配方窗口各是多少?' }],
+    })).data
+    taskIds.push(t2.task?.id ?? t2.id)
+    const r2 = await waitTaskArtifact(ch.channelId, taskIds[1])
+    assert(r2.includes('PROBE-SEM-7741'), 'omp 经工具引用自定义 semantics 原文')
+    assert(r2.includes('176') && (r2.includes('150') || r2.includes('200')), 'omp 经工具引用量程与窗口')
+  }
+
+  // ===== 清理(尽力) =====
+  if (ch) {
+    for (const tid of taskIds) await jpost(`/api/workshop/channels/${ch.channelId}/tasks/${tid}/cancel`, {}).catch(() => {})
+    await jdel(`/api/workshop/channels/${ch.channelId}`).catch(() => {})
+  }
+  if (team) await jdel(`/api/workshop/teams/${team.id}`).catch(() => {})
+  if (tplWorker) await jdel(`/api/workshop/agents/${tplWorker.id}`).catch(() => {})
+  const bl = (await jget(`/api/workshop/agent-tools/bindings?agentId=${PROBE_AGENT}`)).data.bindings ?? []
+  for (const b of bl) await jdel(`/api/workshop/agent-tools/bindings/${b.id}`).catch(() => {})
+  await cleanupFixture(f)
+
+  console.log(`\n===== 上下文注入探针: ${pass} PASS / ${fails.length} FAIL =====`)
+  if (fails.length) { fails.forEach(m => console.error(' -', m)); process.exitCode = 1 }
+  process.exit(process.exitCode ?? 0)
+}
+
+main().catch((e) => { console.error('探针异常:', e); process.exit(1) })

package/scripts/_dbg-crash-recovery.mjs

@@ -0,0 +1,143 @@
+/** 端到端:崩溃恢复 + state 驱动初始化 + WS 客户端自动重连
+ *  ① 1号产线开跑,确认数采采样(produced 增长)
+ *  ② 浏览器打开 /workshop:ws-dot=live
+ *  ③ 强杀服务进程(taskkill //F,模拟突然崩溃)
+ *  ④ 断言 ws-dot 转红(客户端感知断线)
+ *  ⑤ 脚本自行重启服务(detached,存活于脚本退出后)
+ *  ⑥ 断言:活动产线窗口从 line-runs.json 恢复(active=true,无需人工重开)
+ *     → 数采门控自动续采样(produced 恢复增长)
+ *  ⑦ 断言 ws-dot 回到 live(客户端自动重连 + 快照对齐)
+ *  ⑧ /town 场景值仍在实时渲染(最终截图)
+ */
+import puppeteer from 'puppeteer-core'
+import { execSync, spawn } from 'node:child_process'
+
+const BASE = 'http://127.0.0.1:3000'
+const LINE = 'ln-af002514'
+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 fails = []
+const okIf = (m, c) => { if (c) console.log(`PASS ${m}`); else { console.log(`FAIL ${m}`); fails.push(m) } }
+
+const killServer = () => {
+  const out = execSync('netstat -ano | findstr ":3000" | findstr "LISTENING"', { shell: 'cmd.exe' }).toString()
+  const pids = [...new Set(out.split('\n').map(l => l.trim().split(/\s+/).pop()).filter(Boolean))]
+  for (const pid of pids) {
+    try { execSync(`taskkill /PID ${pid} /F`, { shell: 'cmd.exe', stdio: 'ignore' }) } catch { /* 已退出 */ }
+  }
+  return pids.length
+}
+const startServer = () => {
+  // Windows 下 npx 是 cmd 脚本:必须经 cmd.exe /c 派生;detached 使其存活于本脚本退出后
+  const child = spawn('cmd.exe', ['/c', 'npx', 'nuxt', 'dev', '--host', '127.0.0.1', '--port', '3000'], {
+    cwd: 'D:/codes/ABO/AgentWorkShop',
+    detached: true,
+    stdio: 'ignore',
+    env: { ...process.env, NO_PROXY: '127.0.0.1,localhost', no_proxy: '127.0.0.1,localhost' },
+  })
+  child.unref()
+}
+const waitUp = async (timeoutMs) => {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    try {
+      const r = await fetch(`${BASE}/`, { signal: AbortSignal.timeout(2000) })
+      if (r.ok) return true
+    }
+    catch { /* 未就绪 */ }
+    await sleep(1500)
+  }
+  return false
+}
+
+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: login.data.token, domain: '127.0.0.1', path: '/' })
+
+try {
+  // ── ① 产线开跑 + 数采确认 ──
+  const d = (await J('/api/workshop/dcw')).data
+  const lineState = d.lineStates?.find(s => s.lineId === LINE)
+  if (!lineState?.active) {
+    const recipe = d.recipes.find(r => r.lineId === LINE && r.name === 'A-标准工艺')
+    const st = await J(`/api/workshop/dcw/lines/${LINE}/start`, 'POST', { recipeId: recipe.id })
+    if (!st.data?.line?.active) { console.error('FAIL 开跑失败'); process.exit(1) }
+  }
+  const p0 = (await J('/api/workshop/daq')).data.meta.produced
+  await sleep(4000)
+  const p1 = (await J('/api/workshop/daq')).data.meta.produced
+  okIf(`① 崩溃前采样中: produced ${p0} → ${p1}`, p1 > p0)
+
+  // ── ② 浏览器打开 /workshop,ws-dot=live ──
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  for (let i = 0; i < 40; i++) {
+    if (await page.evaluate(() => !!document.querySelector('.ws-dot.live'))) break
+    await new Promise(r => setTimeout(r, 1000))
+  }
+  okIf('② ws-dot=live(连接正常)', await page.evaluate(() => !!document.querySelector('.ws-dot.live')))
+
+  // ── ③ 强杀(突然崩溃模拟) ──
+  const killed = killServer()
+  console.log(`③ CRASH: 强杀 ${killed} 个服务进程`)
+  await sleep(1500)
+
+  // ── ④ 客户端感知断线 ──
+  let sawDown = false
+  for (let i = 0; i < 30; i++) {
+    if (await page.evaluate(() => !!document.querySelector('.ws-dot.down'))) { sawDown = true; break }
+    await sleep(1000)
+  }
+  okIf('④ ws-dot 转红(客户端诚实感知断线)', sawDown)
+
+  // ── ⑤ 重启服务(detached;存活于本脚本退出后) ──
+  console.log('⑤ 重启服务…')
+  startServer()
+  okIf('⑤ 服务重启完成(≤120s)', await waitUp(120_000))
+
+  // ── ⑥ 恢复断言:活动窗口从磁盘恢复,无需人工重开 ──
+  const d2 = (await J('/api/workshop/dcw')).data
+  const restored = d2.lineStates?.find(s => s.lineId === LINE)
+  okIf(`⑥ 活动产线窗口已恢复: active=${restored?.active}(state 驱动初始化)`, restored?.active === true)
+
+  // ── ⑦ 数采门控自动续采样 ──
+  const q1 = (await J('/api/workshop/daq')).data.meta.produced
+  await sleep(5000)
+  const q2 = (await J('/api/workshop/daq')).data.meta.produced
+  okIf(`⑦ 数采自动续采: produced ${q1} → ${q2}`, q2 > q1)
+  const liveNode = (await J('/api/workshop/daq')).data.nodes.find(n => n.lineId === LINE && n.value != null)
+  okIf(`⑦ 线内节点实时值: ${liveNode?.name}=${liveNode?.value} ${liveNode?.unit} (${liveNode?.state})`, liveNode?.value != null)
+
+  // ── ⑧ ws-dot 回到 live(自动重连 + 对齐) ──
+  let backLive = false
+  for (let i = 0; i < 60; i++) {
+    if (await page.evaluate(() => !!document.querySelector('.ws-dot.live'))) { backLive = true; break }
+    await sleep(1500)
+    if (i === 10) await page.reload({ waitUntil: 'domcontentloaded' }).catch(() => {})
+  }
+  okIf('⑧ ws-dot 回到 live(客户端自动重连)', backLive)
+
+  await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  for (let i = 0; i < 45; i++) {
+    if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+    await new Promise(r => setTimeout(r, 1000))
+  }
+  await new Promise(r => setTimeout(r, 4000))
+  await page.screenshot({ path: 'docs/audit/screenshots/ui-polish-0831/crash-recovery-town.png' })
+  console.log('⑧ /town 恢复后截图完成')
+}
+finally {
+  await browser.close()
+}
+console.log(fails.length ? `CRASH-RECOVERY FAILED(${fails.length})` : 'CRASH-RECOVERY ALL PASS')
+process.exit(fails.length ? 1 : 0)

package/scripts/_dbg-crop-shot.mjs

@@ -0,0 +1,16 @@
+/** 裁剪截图细节区域(puppeteer 加载 PNG 后按 clip 截图)。 */
+import puppeteer from 'puppeteer-core'
+
+const [, , src, out, x, y, w, h] = process.argv
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1920, height: 1400, deviceScaleFactor: 2 })
+await page.goto(`file:///${src.replace(/\\/g, '/')}`)
+await new Promise(r => setTimeout(r, 800))
+await page.screenshot({ path: out, clip: { x: +x, y: +y, width: +w, height: +h } })
+await browser.close()
+console.log('crop ok')

package/scripts/_dbg-daq-acc-probe.mjs

@@ -0,0 +1,24 @@
+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()
+const errors = []
+page.on('console', m => { if (m.type() === 'error') errors.push(m.text().slice(0, 140)) })
+page.on('pageerror', e => errors.push(`PAGEERROR: ${String(e).slice(0, 140)}`))
+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)
+console.log('v-if 还是 class 切换? body 在收起态是否存在于 DOM:', await page.evaluate(() => !!document.querySelector('.opt-body')))
+await page.click('.opt-head')
+await sleep(600)
+console.log('chevron.open:', await page.evaluate(() => document.querySelector('.opt-chevron')?.classList.contains('open')))
+console.log('body.open:', await page.evaluate(() => document.querySelector('.opt-body')?.classList.contains('open')))
+console.log('body 高度:', await page.evaluate(() => document.querySelector('.opt-body')?.getBoundingClientRect().height))
+console.log('body maxHeight computed:', await page.evaluate(() => getComputedStyle(document.querySelector('.opt-body')).maxHeight))
+console.log('body 可见内容行数:', await page.evaluate(() => document.querySelectorAll('.opt-list .opt-row').length))
+console.log('errors:', errors.length ? errors.slice(0, 3) : 'none')
+await browser.close()
+console.log('DONE')

package/scripts/_dbg-daq-attrib.mjs

@@ -0,0 +1,34 @@
+/** 归因实验:断网后主线程占用是否消失(区分 轮询churn vs 静态渲染成本)。 */
+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 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(15000)
+console.log('rows rendered:', await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length))
+
+// 5s 在线基线
+const on = await page.evaluate(() => new Promise((resolve) => {
+  const t = { lt: 0, tot: 0 }
+  const po = new PerformanceObserver((l) => { for (const e of l.getEntries()) { t.lt++; t.tot += e.duration } })
+  po.observe({ entryTypes: ['longtask'] })
+  setTimeout(() => { po.disconnect(); resolve({ lt: t.lt, tot: Math.round(t.tot) }) }, 5000)
+}))
+
+// 断网(轮询失败 + WS 断)后 5s
+await page.setOfflineMode(true)
+await sleep(1500)
+const off = await page.evaluate(() => new Promise((resolve) => {
+  const t = { lt: 0, tot: 0 }
+  const po = new PerformanceObserver((l) => { for (const e of l.getEntries()) { t.lt++; t.tot += e.duration } })
+  po.observe({ entryTypes: ['longtask'] })
+  setTimeout(() => { po.disconnect(); resolve({ lt: t.lt, tot: Math.round(t.tot) }) }, 5000)
+}))
+console.log('在线 5s:', JSON.stringify(on), '| 断网 5s:', JSON.stringify(off))
+await browser.close()
+console.log('DONE')