agentworkshop 0.7.23 → 0.7.27

package/package.json

@@ -1,148 +1,149 @@
-{
-  "name": "agentworkshop",
-  "version": "0.7.23",
-  "type": "module",
-  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
-  "license": "PolyForm-Noncommercial-1.0.0",
-  "exports": {
-    ".": {
-      "types": "./sdk/index.d.mts",
-      "default": "./sdk/index.mjs"
-    },
-    "./sdk": {
-      "types": "./sdk/index.d.mts",
-      "default": "./sdk/index.mjs"
-    },
-    "./sdk/client": {
-      "types": "./sdk/client.d.mts",
-      "default": "./sdk/client.mjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "aw": "bin/aw.mjs",
-    "agentworkshop": "bin/aw.mjs"
-  },
-  "files": [
-    ".output",
-    "bin",
-    "cli",
-    "sdk",
-    "app",
-    "server",
-    "shared",
-    "i18n",
-    "public",
-    "scripts",
-    ".AgentWorkShop/prompts",
-    "config.yml",
-    "nuxt.config.ts",
-    "tsconfig.json",
-    "uno.config.ts",
-    "docker-compose.yml",
-    ".env.example",
-    "README-zh.md",
-    "docs/cli.md",
-    "docs/plugins.md",
-    "docs/sdk.md",
-    "docs/tui.md",
-    "tui"
-  ],
-  "packageManager": "pnpm@11.9.0",
-  "engines": {
-    "node": ">=23.4.0"
-  },
-  "scripts": {
-    "dev": "node bin/aw.mjs dev",
-    "build": "node bin/aw.mjs build",
-    "start": "node bin/aw.mjs start",
-    "generate": "nuxt generate",
-    "preview": "node bin/aw.mjs start",
-    "cli": "node bin/aw.mjs",
-    "tui": "node tui/aw-tui.mjs",
-    "postinstall": "node scripts/home-bootstrap.mjs",
-    "prepublishOnly": "node bin/aw.mjs build",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "typecheck": "nuxt typecheck",
-    "prepare": "husky",
-    "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
-    "test:api-live": "node scripts/api-live-e2e.mjs",
-    "game:verify": "node scripts/verify-game.mjs",
-    "game:build-assets": "node scripts/build-player-sheet.mjs",
-    "game:build-wuwa": "node scripts/build-wuwa-assets.mjs",
-    "game:build-models": "node scripts/build-character-models.mjs",
-    "game:build-world": "node scripts/build-world-map.mjs",
-    "game:build-model3d": "node scripts/build-model-3d.mjs"
-  },
-  "lint-staged": {
-    "*.{js,mjs,cjs,ts,vue}": "eslint --fix"
-  },
-  "dependencies": {
-    "@ant-design-vue/nuxt": "^1.4.6",
-    "@ant-design/icons-vue": "^7.0.1",
-    "@earendil-works/pi-tui": "^0.84.4",
-    "@fontsource-variable/fraunces": "^5.3.0",
-    "@fontsource-variable/geist": "^5.3.0",
-    "@fontsource-variable/geist-mono": "^5.3.0",
-    "@fontsource-variable/inter": "^5.3.0",
-    "@fontsource/eb-garamond": "^5.3.0",
-    "@fontsource/ibm-plex-mono": "^5.3.0",
-    "@iconify-json/tabler": "^1.2.0",
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "@nuxtjs/i18n": "^9.0.0",
-    "@pinia/nuxt": "^0.11.0",
-    "@unocss/nuxt": "^66.0.0",
-    "@unocss/preset-attributify": "^66.0.0",
-    "@unocss/preset-icons": "^66.7.5",
-    "@unocss/preset-typography": "^66.0.0",
-    "@vueuse/core": "^13.0.0",
-    "@vueuse/nuxt": "^13.0.0",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/xterm": "^6.0.0",
-    "ant-design-vue": "^4.2.6",
-    "axios": "^1.7.9",
-    "echarts": "^5.6.0",
-    "h3": "2.0.1-rc.26",
-    "js-yaml": "^4.1.0",
-    "minio": "^8.0.7",
-    "modbus-serial": "^8.0.25",
-    "mqtt": "^5.15.2",
-    "node-opcua": "^2.178.0",
-    "nuxt": "^4.0.0",
-    "nuxt-auth-utils": "^0.5.0",
-    "pg": "^8.23.0",
-    "phaser": "^4.0.0",
-    "pinia": "^3.0.0",
-    "pinia-plugin-persistedstate": "^4.2.0",
-    "sqlite-vec": "^0.1.9",
-    "three": "^0.185.1",
-    "unocss": "^66.0.0",
-    "unplugin-icons": "^22.0.0",
-    "vue": "^3.5.13",
-    "vue-echarts": "^7.0.3",
-    "vue-router": "^4.5.0",
-    "zod": "^3.24.1"
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^19.6.1",
-    "@commitlint/config-conventional": "^19.6.0",
-    "@nuxt/eslint": "^1.0.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^26.2.0",
-    "@types/three": "^0.185.4",
-    "eslint": "^9.17.0",
-    "husky": "^9.1.7",
-    "lint-staged": "^15.3.0",
-    "pngjs": "^7.0.0",
-    "puppeteer-core": "^25.5.0",
-    "tsx": "^4.23.12",
-    "typescript": "^5.7.3",
-    "vue-tsc": "^3.3.10"
-  },
-  "pnpm": {
-    "ignoredBuiltDependencies": [
-      "@serialport/bindings-cpp"
-    ]
-  }
-}
+{
+  "name": "agentworkshop",
+  "version": "0.7.27",
+  "type": "module",
+  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "exports": {
+    ".": {
+      "types": "./sdk/index.d.mts",
+      "default": "./sdk/index.mjs"
+    },
+    "./sdk": {
+      "types": "./sdk/index.d.mts",
+      "default": "./sdk/index.mjs"
+    },
+    "./sdk/client": {
+      "types": "./sdk/client.d.mts",
+      "default": "./sdk/client.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "aw": "bin/aw.mjs",
+    "agentworkshop": "bin/aw.mjs"
+  },
+  "files": [
+    ".output",
+    "bin",
+    "cli",
+    "sdk",
+    "app",
+    "server",
+    "shared",
+    "i18n",
+    "public",
+    "scripts",
+    ".AgentWorkShop/prompts",
+    "server/plugins-builtin",
+    "config.yml",
+    "nuxt.config.ts",
+    "tsconfig.json",
+    "uno.config.ts",
+    "docker-compose.yml",
+    ".env.example",
+    "README-zh.md",
+    "docs/cli.md",
+    "docs/plugins.md",
+    "docs/sdk.md",
+    "docs/tui.md",
+    "tui"
+  ],
+  "packageManager": "pnpm@11.9.0",
+  "engines": {
+    "node": ">=23.4.0"
+  },
+  "scripts": {
+    "dev": "node bin/aw.mjs dev",
+    "build": "node bin/aw.mjs build",
+    "start": "node bin/aw.mjs start",
+    "generate": "nuxt generate",
+    "preview": "node bin/aw.mjs start",
+    "cli": "node bin/aw.mjs",
+    "tui": "node tui/aw-tui.mjs",
+    "postinstall": "node scripts/home-bootstrap.mjs",
+    "prepublishOnly": "node bin/aw.mjs build",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "nuxt typecheck",
+    "prepare": "husky",
+    "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
+    "test:api-live": "node scripts/api-live-e2e.mjs",
+    "game:verify": "node scripts/verify-game.mjs",
+    "game:build-assets": "node scripts/build-player-sheet.mjs",
+    "game:build-wuwa": "node scripts/build-wuwa-assets.mjs",
+    "game:build-models": "node scripts/build-character-models.mjs",
+    "game:build-world": "node scripts/build-world-map.mjs",
+    "game:build-model3d": "node scripts/build-model-3d.mjs"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts,vue}": "eslint --fix"
+  },
+  "dependencies": {
+    "@ant-design-vue/nuxt": "^1.4.6",
+    "@ant-design/icons-vue": "^7.0.1",
+    "@earendil-works/pi-tui": "^0.84.4",
+    "@fontsource-variable/fraunces": "^5.3.0",
+    "@fontsource-variable/geist": "^5.3.0",
+    "@fontsource-variable/geist-mono": "^5.3.0",
+    "@fontsource-variable/inter": "^5.3.0",
+    "@fontsource/eb-garamond": "^5.3.0",
+    "@fontsource/ibm-plex-mono": "^5.3.0",
+    "@iconify-json/tabler": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@nuxtjs/i18n": "^9.0.0",
+    "@pinia/nuxt": "^0.11.0",
+    "@unocss/nuxt": "^66.0.0",
+    "@unocss/preset-attributify": "^66.0.0",
+    "@unocss/preset-icons": "^66.7.5",
+    "@unocss/preset-typography": "^66.0.0",
+    "@vueuse/core": "^13.0.0",
+    "@vueuse/nuxt": "^13.0.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "ant-design-vue": "^4.2.6",
+    "axios": "^1.7.9",
+    "echarts": "^5.6.0",
+    "h3": "2.0.1-rc.26",
+    "js-yaml": "^4.1.0",
+    "minio": "^8.0.7",
+    "modbus-serial": "^8.0.25",
+    "mqtt": "^5.15.2",
+    "node-opcua": "^2.178.0",
+    "nuxt": "^4.0.0",
+    "nuxt-auth-utils": "^0.5.0",
+    "pg": "^8.23.0",
+    "phaser": "^4.0.0",
+    "pinia": "^3.0.0",
+    "pinia-plugin-persistedstate": "^4.2.0",
+    "sqlite-vec": "^0.1.9",
+    "three": "^0.185.1",
+    "unocss": "^66.0.0",
+    "unplugin-icons": "^22.0.0",
+    "vue": "^3.5.13",
+    "vue-echarts": "^7.0.3",
+    "vue-router": "^4.5.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.1",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@nuxt/eslint": "^1.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.2.0",
+    "@types/three": "^0.185.4",
+    "eslint": "^9.17.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.3.0",
+    "pngjs": "^7.0.0",
+    "puppeteer-core": "^25.5.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.7.3",
+    "vue-tsc": "^3.3.10"
+  },
+  "pnpm": {
+    "ignoredBuiltDependencies": [
+      "@serialport/bindings-cpp"
+    ]
+  }
+}

package/scripts/_dbg-cpu-profile.mjs

@@ -0,0 +1,53 @@
+/** CPU 热点剖析:/daq 与 /town 各采 12s CPU profile,输出 self-time Top20。 */
+import puppeteer from 'puppeteer-core'
+import { writeFileSync } from 'node:fs'
+
+const ROOT = process.argv[2] ?? 'http://127.0.0.1:3001'
+const OUT = process.argv[3] ?? '.e2e-shots/cpu-profile.json'
+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: 'perf-runner@awshop.io', password: 'Perf@Run2026' }) }).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: new URL(ROOT).hostname, path: '/' })
+
+const cdp = await page.createCDPSession()
+await cdp.send('Profiler.enable')
+await cdp.send('Profiler.setSamplingInterval', { interval: 500 })
+
+async function profile(path, warmMs, sampleMs) {
+  await page.goto(`${ROOT}${path}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+  await sleep(warmMs)
+  await cdp.send('Profiler.start')
+  await sleep(sampleMs)
+  const { profile: prof } = await cdp.send('Profiler.stop')
+  // self time 聚合
+  const nodesById = new Map(prof.nodes.map(n => [n.id, n]))
+  const self = new Map()
+  const total = prof.timeDeltas.reduce((a, b) => a + b, 0)
+  for (let i = 0; i < prof.samples.length; i++) {
+    const id = prof.samples[i]
+    const dt = prof.timeDeltas[i] ?? 0
+    self.set(id, (self.get(id) ?? 0) + dt)
+  }
+  const rows = [...self.entries()]
+    .map(([id, us]) => {
+      const n = nodesById.get(id)
+      const cf = n?.callFrame ?? {}
+      const url = (cf.url ?? '').replace(/^.*\/(_nuxt|node_modules)\//, '$1/')
+      return { fn: `${cf.functionName || '(anon)'} @ ${url}:${(cf.lineNumber ?? 0) + 1}`, selfMs: +(us / 1000).toFixed(1) }
+    })
+    .sort((a, b) => b.selfMs - a.selfMs)
+    .slice(0, 20)
+    .filter(r => r.selfMs >= 5)
+  return { path, totalMs: +(total / 1000).toFixed(0), top: rows }
+}
+
+const daq = await profile('/daq', 12000, 12000)
+console.log('==== /daq self-time Top:', JSON.stringify(daq, null, 1))
+const town = await profile('/town', 18000, 12000)
+console.log('==== /town self-time Top:', JSON.stringify(town, null, 1))
+writeFileSync(OUT, JSON.stringify({ daq, town }, null, 2))
+await browser.close()
+console.log('DONE ->', OUT)

package/scripts/_dbg-logs-ui-e2e.py

@@ -4,11 +4,12 @@
 #   3) 页头 aw-page-head 规范(标题30px + 描述间距)
 # 附带:daq/dcw 页按钮抽查截图。产物 → .e2e-shots/
 import json
+import os
 import sys
 from playwright.sync_api import sync_playwright
 
-BASE = 'http://127.0.0.1:3000'
-SHOT = '.e2e-shots'
+BASE = os.environ.get('BASE', 'http://127.0.0.1:3000')
+SHOT = os.environ.get('SHOT_PREFIX', '') or '.e2e-shots'
 passed = 0
 failed = 0
 

package/scripts/_dbg-render-perf.mjs

@@ -0,0 +1,142 @@
+/** 渲染性能基线/对比测量:/daq 与 /town 双页统一探针(前后对比同参同窗)。
+ *  用法:node scripts/_dbg-render-perf.mjs <base> <email> <pass> <outJson>
+ *  输出 JSON:{ daq:{...}, town:{...} } —— 供 plan 文档引用(证据化,非估算)。 */
+import puppeteer from 'puppeteer-core'
+import { writeFileSync } from 'node:fs'
+
+const ROOT = process.argv[2] ?? 'http://127.0.0.1:3001'
+const EMAIL = process.argv[3] ?? 'perf-runner@awshop.io'
+const PASS = process.argv[4] ?? 'Perf@Run2026'
+const OUT = process.argv[5] ?? '.e2e-shots/render-perf.json'
+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: EMAIL, password: PASS }) }).then(r => r.json())
+if (!login?.data?.token) { console.error('LOGIN FAIL', JSON.stringify(login)); process.exit(1) }
+
+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: new URL(ROOT).hostname, path: '/' })
+
+// 页面加载前注入:WS 帧计数(按 type)+ longtask + 事件循环延迟采样器
+await page.evaluateOnNewDocument(() => {
+  window.__perf = { ws: {}, longTasks: 0, longTotal: 0, loopDelays: [], heapSamples: [] }
+  try {
+    new PerformanceObserver((l) => {
+      for (const t of l.getEntries()) { window.__perf.longTasks++; window.__perf.longTotal += t.duration }
+    }).observe({ entryTypes: ['longtask'] })
+  } catch {}
+  const OrigWS = window.WebSocket
+  window.WebSocket = function (...args) {
+    const ws = new OrigWS(...args)
+    ws.addEventListener('message', (ev) => {
+      try {
+        const d = JSON.parse(String(ev.data))
+        const type = d?.type ?? d?.event ?? 'raw'
+        window.__perf.ws[type] = (window.__perf.ws[type] ?? 0) + 1
+      }
+      catch { window.__perf.ws.raw = (window.__perf.ws.raw ?? 0) + 1 }
+    })
+    return ws
+  }
+  window.WebSocket.prototype = OrigWS.prototype
+  ;['OPEN', 'CLOSED', 'CLOSING', 'CONNECTING'].forEach(k => { try { window.WebSocket[k] = OrigWS[k] } catch {} })
+  // 事件循环延迟:50ms 心跳,记录超出量
+  let last = performance.now()
+  setInterval(() => {
+    const now = performance.now()
+    window.__perf.loopDelays.push(now - last - 50)
+    last = now
+    try { window.__perf.heapSamples.push(Math.round(performance.memory.usedJSHeapSize / 1048576)) } catch {}
+  }, 50)
+})
+
+const summarize = (tag, warmMs, winMs) => page.evaluate(async ({ tag, warmMs, winMs }) => {
+  const pct = (arr, p) => arr.length ? +arr.slice().sort((a, b) => a - b)[Math.min(arr.length - 1, Math.floor(arr.length * p))].toFixed(1) : null
+  await new Promise(r => setTimeout(r, warmMs))
+  const p = window.__perf
+  const ws0 = JSON.stringify(p.ws)
+  const lt0 = p.longTasks
+  const ltT0 = p.longTotal
+  const d0 = p.loopDelays.length
+  const heap0 = p.heapSamples.length ? p.heapSamples[p.heapSamples.length - 1] : null
+  await new Promise(r => setTimeout(r, winMs))
+  const ws1 = JSON.parse(JSON.stringify(p.ws))
+  const ws0o = JSON.parse(ws0)
+  const delta = {}
+  for (const k of new Set([...Object.keys(ws1), ...Object.keys(ws0o)])) delta[k] = (ws1[k] ?? 0) - (ws0o[k] ?? 0)
+  const delays = p.loopDelays.slice(d0)
+  const heaps = p.heapSamples.slice(d0 ? Math.max(0, d0) : 0)
+  return {
+    tag,
+    windowMs: winMs,
+    wsDelta: delta,
+    longTasks: p.longTasks - lt0,
+    longTotalMs: Math.round(p.longTotal - ltT0),
+    loopAvg: +(delays.reduce((a, b) => a + b, 0) / Math.max(1, delays.length)).toFixed(1),
+    loopP95: pct(delays, 0.95),
+    loopMax: delays.length ? +Math.max(...delays).toFixed(0) : 0,
+    heapMB: heaps.length ? heaps[heaps.length - 1] : heap0,
+    heapPeakMB: heaps.length ? Math.max(...heaps) : null,
+  }
+}, { tag, warmMs, winMs })
+
+// ---------------- /daq ----------------
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+const daq = await summarize('daq', 12000, 10000)
+// SPA 挂载后采集(预热窗结束后 DOM 才是真实形态)
+const daqDom = await page.evaluate(() => ({
+  rows: document.querySelectorAll('.nodes-table tbody tr').length,
+  elements: document.getElementsByTagName('*').length,
+  svgPolylines: document.querySelectorAll('.nodes-table svg polyline').length,
+}))
+daq.rows = daqDom.rows
+daq.domElements = daqDom.elements
+daq.svgPolylines = daqDom.svgPolylines
+// DOM 变更批次(10s):表格重渲染频率的代理
+daq.domMutationBatches = await page.evaluate((winMs) => new Promise((resolve) => {
+  let batches = 0
+  let armed = false
+  const obs = new MutationObserver(() => { if (armed) batches++ })
+  obs.observe(document.querySelector('.nodes-table') ?? document.body, { childList: true, subtree: true, characterData: true, attributes: true })
+  setTimeout(() => { armed = true }, 500)
+  setTimeout(() => { obs.disconnect(); resolve(batches) }, winMs)
+}), 10000)
+
+// ---------------- /town ----------------
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(18000)
+const fpsSamples = []
+for (let i = 0; i < 6; i++) {
+  const fps = await page.evaluate(() => {
+    // 优先读场景仪表化(墙钟真实 fps);无 hook 时退回徽标正则(易混入相邻文本)
+    const st = window.__townStats
+    if (st) return st.fps
+    const m = document.body.textContent.match(/(\d+)\s*FPS/i)
+    return m ? Number(m[1]) : null
+  })
+  fpsSamples.push(fps)
+  await sleep(2000)
+}
+const dpr = await page.evaluate(() => {
+  const cv = document.querySelector('#town-host canvas')
+  if (!cv) return null
+  return { bufW: cv.width, cssW: cv.clientWidth, ratio: +(cv.width / cv.clientWidth).toFixed(2) }
+})
+const townDom = await page.evaluate(() => document.getElementsByTagName('*').length)
+const town = await summarize('town', 1000, 10000)
+town.fpsSamples = fpsSamples
+town.avgFps = +(fpsSamples.filter(v => v != null).reduce((a, b) => a + b, 0) / Math.max(1, fpsSamples.filter(v => v != null).length)).toFixed(1)
+town.dpr = dpr
+town.domElements = townDom
+town.statsHook = await page.evaluate(() => window.__townStats ? JSON.parse(JSON.stringify(window.__townStats)) : null)
+
+const result = { at: new Date().toISOString(), base: ROOT, daq, town }
+writeFileSync(OUT, JSON.stringify(result, null, 2))
+console.log(JSON.stringify(result, null, 2))
+await browser.close()
+console.log('DONE ->', OUT)

package/scripts/_dbg-render-regression.mjs

@@ -0,0 +1,130 @@
+/** 渲染优化功能回归:/daq 行渲染与交互、/daq/[id] 详情、/town 场景与模型预览、全局 smoke。
+ *  用法:node scripts/_dbg-render-regression.mjs [base] [email] [pass] */
+import puppeteer from 'puppeteer-core'
+import { writeFileSync } from 'node:fs'
+
+const ROOT = process.argv[2] ?? 'http://127.0.0.1:3001'
+const EMAIL = process.argv[3] ?? 'perf-runner@awshop.io'
+const PASS = process.argv[4] ?? 'Perf@Run2026'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const results = []
+const ok = (name, pass, detail = '') => {
+  results.push({ name, pass, detail })
+  console.log(`${pass ? '✔' : '✖'} ${name}${detail ? ' —— ' + detail : ''}`)
+}
+
+const login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: EMAIL, password: PASS }) }).then(r => r.json())
+if (!login?.data?.token) { console.error('LOGIN FAIL'); process.exit(1) }
+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: new URL(ROOT).hostname, path: '/' })
+const pageErrors = []
+page.on('pageerror', e => pageErrors.push(String(e).slice(0, 200)))
+
+// ---------- 1. /daq 行渲染完整性 ----------
+await page.goto(`${ROOT}/daq`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(12000)
+const daqStruct = await page.evaluate(() => {
+  const rows = document.querySelectorAll('.nodes-table tbody tr')
+  const polylines = document.querySelectorAll('.nodes-table svg polyline')
+  const limLines = document.querySelectorAll('.nodes-table svg line.lim')
+  const pills = document.querySelectorAll('.nodes-table .st-pill')
+  const valCells = [...document.querySelectorAll('.nodes-table .val')].slice(0, 5).map(c => c.textContent.trim())
+  const toggles = document.querySelectorAll('.nodes-table .node-toggle')
+  const links = document.querySelectorAll('.nodes-table .console-link')
+  const lineSelects = document.querySelectorAll('.nodes-table .line-sel:not(.dev-add)')
+  return { rows: rows.length, polylines: polylines.length, limLines: limLines.length, pills: pills.length, valCells, toggles: toggles.length, links: links.length, lineSelects: lineSelects.length }
+})
+ok('/daq 行数 227', daqStruct.rows === 227, `rows=${daqStruct.rows}`)
+ok('/daq 每行趋势折线', daqStruct.polylines === 227, `polylines=${daqStruct.polylines}`)
+ok('/daq 状态 pill 齐全', daqStruct.pills >= 227, `pills=${daqStruct.pills}`)
+ok('/daq 启停按钮齐全', daqStruct.toggles === 227, `toggles=${daqStruct.toggles}`)
+ok('/daq 控制台链接齐全', daqStruct.links === 227, `links=${daqStruct.links}`)
+ok('/daq 产线下拉齐全', daqStruct.lineSelects === 227, `selects=${daqStruct.lineSelects}`)
+ok('/daq 值列有数据', daqStruct.valCells.some(v => /\d/.test(v)), daqStruct.valCells[0])
+
+// ---------- 2. WS 实时收敛:值列随读数帧变化(优化后合批仍须驱动行更新) ----------
+const valChanges = await page.evaluate(() => new Promise((resolve) => {
+  const cells = [...document.querySelectorAll('.nodes-table .val')]
+  const texts = cells.map(c => c.textContent.trim())
+  setTimeout(() => {
+    const now = cells.map(c => c.textContent.trim())
+    let changed = 0
+    for (let i = 0; i < texts.length; i++) if (now[i] !== texts[i]) changed++
+    resolve(changed)
+  }, 8000)
+}))
+ok('/daq WS 读数驱动行更新(8s 内 ≥5 行变化)', valChanges >= 5, `changedRows=${valChanges}`)
+
+// ---------- 3. 筛选交互(行组件随筛选增减) ----------
+await page.type('.nodes-search input, input[placeholder]', '压力', { delay: 30 }).catch(() => {})
+await sleep(1500)
+const searchFiltered = await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length)
+ok('/daq 搜索筛选生效', searchFiltered > 0 && searchFiltered < 227, `rows=${searchFiltered}`)
+await page.evaluate(() => { location.hash = '' })
+// 清空搜索(全选删除)
+await page.keyboard.down('Control'); await page.keyboard.press('a'); await page.keyboard.up('Control'); await page.keyboard.press('Backspace')
+await sleep(1200)
+const afterClear = await page.evaluate(() => document.querySelectorAll('.nodes-table tbody tr').length)
+ok('/daq 清空搜索恢复全量', afterClear === 227, `rows=${afterClear}`)
+
+// ---------- 4. /daq/[id] 详情页(由行内控制台链接进入) ----------
+const detailHref = await page.evaluate(() => document.querySelector('.nodes-table .console-link')?.getAttribute('href'))
+await page.goto(`${ROOT}${detailHref}`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(6000)
+const detail = await page.evaluate(() => ({
+  bigVal: document.querySelector('.big-val')?.textContent?.trim() ?? '',
+  liveCanvas: !!document.querySelector('.live-canvas'),
+  histCanvas: !!document.querySelector('.hist-canvas'),
+  facts: document.querySelectorAll('.facts div').length,
+}))
+ok('/daq/[id] 大值卡渲染', /\d/.test(detail.bigVal), detail.bigVal.slice(0, 30))
+ok('/daq/[id] live 趋势画布存在', detail.liveCanvas)
+ok('/daq/[id] 历史画布存在', detail.histCanvas)
+ok('/daq/[id] 参数事实表渲染', detail.facts >= 5, `facts=${detail.facts}`)
+
+// ---------- 5. /town 场景 + 仪表化 + 模型预览 ----------
+await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await sleep(18000)
+const town1 = await page.evaluate(() => ({
+  canvas: !!document.querySelector('#town-host canvas'),
+  stats: window.__townStats ? { ...window.__townStats } : null,
+}))
+ok('/town 3D 画布挂载', town1.canvas)
+ok('/town 仪表化 __townStats 存在', !!town1.stats)
+ok('/town 场景实体(Agent/设备)', !!town1.stats && town1.stats.agents >= 12 && town1.stats.devices >= 30, `agents=${town1.stats?.agents} devices=${town1.stats?.devices}`)
+ok('/town 帧率 > 0(墙钟)', !!town1.stats && town1.stats.fps > 0, `fps=${town1.stats?.fps} rafHz=${town1.stats?.rafHz}`)
+ok('/town 60fps 预算生效', !!town1.stats && town1.stats.frameBudgetMs === 16.67, `frameBudgetMs=${town1.stats?.frameBudgetMs}`)
+const town2 = await page.evaluate(() => new Promise((resolve) => {
+  const s0 = JSON.stringify(window.__townStats)
+  setTimeout(() => resolve({ s0, s1: JSON.stringify(window.__townStats) }), 3000)
+}))
+ok('/town 仪表化持续更新', town2.s0 !== town2.s1)
+
+// 打开模型库抽屉(若存在入口按钮)→ 预览卡渲染不崩
+const libOpened = await page.evaluate(() => {
+  const btn = [...document.querySelectorAll('button, .hud-btn, [class*="lib"]')].find(b => /模型/.test(b.textContent ?? ''))
+  if (btn) { btn.click(); return true }
+  return false
+})
+if (libOpened) {
+  await sleep(4000)
+  const previews = await page.evaluate(() => document.querySelectorAll('.model-preview-3d canvas').length)
+  ok('/town 模型库打开且预览卡有画布', previews > 0, `previews=${previews}`)
+}
+await page.screenshot({ path: '.e2e-shots/regression-town.png' })
+
+// ---------- 6. 全局页面 smoke(200 + 无 pageerror) ----------
+for (const path of ['/workshop', '/dcw', '/logs', '/monitor', '/settings', '/users', '/permissions']) {
+  const resp = await page.goto(`${ROOT}${path}`, { waitUntil: 'domcontentloaded', timeout: 60000 }).then(r => r.status()).catch(() => 0)
+  await sleep(1500)
+  ok(`smoke ${path}`, resp === 200, `status=${resp}`)
+}
+
+ok('全程无 pageerror', pageErrors.length === 0, pageErrors.slice(0, 3).join(' | '))
+const failed = results.filter(r => !r.pass)
+writeFileSync('.e2e-shots/render-regression.json', JSON.stringify({ at: new Date().toISOString(), base: ROOT, passed: results.length - failed.length, failed: failed.length, results }, null, 2))
+console.log(`\n==== ${results.length - failed.length}/${results.length} PASS ====${failed.length ? ' FAILED: ' + failed.map(f => f.name).join(', ') : ''}`)
+await browser.close()
+process.exit(failed.length ? 1 : 0)