agentworkshop 0.7.24 → 0.7.33

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)

package/scripts/_dbg-resolve-probe.ts

@@ -0,0 +1,6 @@
+/** resolveOnPath 探针:验证增强 PATH 下 cursor-agent 可解析 */
+import { resolveOnPath } from '../server/services/workshop/agents/adapters/line-spawn'
+
+for (const cmd of ['cursor-agent', 'gemini', 'goose', 'copilot', 'crush', 'qwen']) {
+  console.log(`${cmd} => ${resolveOnPath(cmd) ?? 'NOT FOUND'}`)
+}

package/scripts/_dbg-restart-persist.mjs

@@ -18,7 +18,7 @@ if (!ready) { console.error('dev 未就绪'); process.exit(1) }
 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }),
 }).then(r => r.json())
 const H = { 'authorization': `Bearer ${login.data.token}`, 'content-type': 'application/json' }
 

package/scripts/_dbg-sc001-dispatch.mjs

@@ -5,7 +5,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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))

package/scripts/_dbg-scenario-final-shot.mjs

@@ -1,7 +1,7 @@
 /** 最终场景截图:控制台 SET=183(Agent 优化后)+ 全景实时 */
 import puppeteer from 'puppeteer-core'
 const BASE = 'http://127.0.0.1:3000'
-const login = await fetch(`${BASE}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }) }).then(r => r.json())
+const login = await fetch(`${BASE}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }) }).then(r => r.json())
 const OUT = 'docs/audit/screenshots/ui-polish-0831'
 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()

package/scripts/_dbg-scenario-phase-e2.mjs

@@ -9,7 +9,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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))

package/scripts/_dbg-scenario-phase-e3.mjs

@@ -6,7 +6,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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))

package/scripts/_dbg-scenario-phase1.mjs

@@ -7,7 +7,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }),
 }).then(r => r.json())
 const H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
 const J = (u, m = 'GET', b) => fetch(BASE + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())

package/scripts/_dbg-scenario-phase2.mjs

@@ -10,7 +10,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }),
 }).then(r => r.json())
 const OUT = 'docs/audit/screenshots/ui-polish-0831'
 

package/scripts/_dbg-scenario-phase3-monitor.mjs

@@ -3,7 +3,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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))

package/scripts/_dbg-scenario-phase3.mjs

@@ -9,7 +9,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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))

package/scripts/_dbg-settings-draft-probe.mjs

@@ -0,0 +1,39 @@
+import puppeteer from 'puppeteer-core'
+const BASE = 'http://127.0.0.1:3001'
+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 b = await puppeteer.launch({ executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', headless: 'new', args: ['--no-sandbox', '--disable-gpu'] })
+const p = await b.newPage(); await p.setViewport({ width: 1600, height: 1000 })
+await p.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+
+const read = async (tag) => {
+  await p.evaluate(() => { const t = [...document.querySelectorAll('button,div,span')].find(el => el.textContent?.trim() === '运行配置'); t?.click() })
+  await new Promise(r => setTimeout(r, 2500))
+  const v = await p.evaluate(() => {
+    const pick = label => {
+      const row = [...document.querySelectorAll('.rt-row')].find(el => el.querySelector('.rt-title')?.textContent?.includes(label))
+      return row?.querySelector('.ant-input-number-input')?.value ?? null
+    }
+    return { sampling: pick('节点采样默认间隔'), publish: pick('WS 下发默认间隔'), display: pick('趋势图刷新间隔') }
+  })
+  console.log(tag, JSON.stringify(v))
+}
+
+// A: 冷启动直连 /settings(store 在页面挂载后才加载 → 可能正常)
+await p.goto(`${BASE}/settings`, { waitUntil: 'domcontentloaded' })
+await new Promise(r => setTimeout(r, 3000))
+await read('A 直连/settings:')
+
+// B: 先访问别的页面(store 已加载),再进 /settings
+await p.goto(`${BASE}/dashboard`, { waitUntil: 'domcontentloaded' }).catch(() => {})
+await p.goto(`${BASE}/`, { waitUntil: 'domcontentloaded' })
+await new Promise(r => setTimeout(r, 3000))
+await p.goto(`${BASE}/settings`, { waitUntil: 'domcontentloaded' })
+await new Promise(r => setTimeout(r, 3000))
+await read('B 先逛别页再进:')
+
+// C: 直接在 /settings 上整页刷新
+await p.reload({ waitUntil: 'domcontentloaded' })
+await new Promise(r => setTimeout(r, 3000))
+await read('C 就地刷新:  ')
+
+await b.close()

package/scripts/_dbg-settings-probe.mjs

@@ -0,0 +1,33 @@
+import puppeteer from 'puppeteer-core'
+const BASE = 'http://127.0.0.1:3001'
+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 b = await puppeteer.launch({ executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', headless: 'new', args: ['--no-sandbox', '--disable-gpu'] })
+const p = await b.newPage(); await p.setViewport({ width: 1600, height: 1000 })
+await p.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await p.goto(`${BASE}/settings`, { waitUntil: 'domcontentloaded' }); await new Promise(r => setTimeout(r, 2500))
+await p.evaluate(() => { const t = [...document.querySelectorAll('button,div,span')].find(el => el.textContent?.trim() === '运行配置'); t?.click() })
+await new Promise(r => setTimeout(r, 3500))
+await p.evaluate(() => {
+  const row = [...document.querySelectorAll('.rt-row')].find(el => el.querySelector('.rt-title')?.textContent?.includes('WS 下发默认间隔'))
+  row?.scrollIntoView({ block: 'center' })
+})
+await new Promise(r => setTimeout(r, 800))
+await p.screenshot({ path: '.e2e-shots/rowstyle-settings-runtime.png' })
+const out = await p.evaluate(() => {
+  const pick = label => {
+    const row = [...document.querySelectorAll('.rt-row')].find(el => el.querySelector('.rt-title')?.textContent?.includes(label))
+    const inp = row?.querySelector('.ant-input-number-input') ?? row?.querySelector('input')
+    return inp ? { value: inp.value, attrs: [...inp.attributes].map(a => `${a.name}=${a.value}`).join(' ') } : null
+  }
+  return {
+    rows: document.querySelectorAll('.rt-row').length,
+    sampling: pick('节点采样默认间隔'),
+    samplingMin: pick('节点采样下限'),
+    publish: pick('WS 下发默认间隔'),
+    publishMin: pick('WS 下发下限'),
+    display: pick('趋势图刷新间隔'),
+    displayMin: pick('趋势图刷新下限'),
+  }
+})
+console.log(JSON.stringify(out, null, 1))
+await b.close()

package/scripts/_dbg-task-cancel-probe.mjs

@@ -0,0 +1,66 @@
+/** 任务 CANCELED 现行探针:复刻 live-line S5 夹具(无清理),500ms 粒度记录任务状态迁移,
+ *  终态非 COMPLETED 时导出 events/messages/task 现场,定位取消者。 */
+const BASE = process.argv[2] ?? 'http://127.0.0.1:3001'
+const TAG = process.argv[3] ?? `cp${Math.random().toString(36).slice(2, 6)}`
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const login = await fetch(`${BASE}/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 token = login.data.token
+const api = async (method, path, { body } = {}) => {
+  const res = await fetch(`${BASE}${path}`, { method, headers: { 'content-type': 'application/json', authorization: `Bearer ${token}` }, body: body === undefined ? undefined : JSON.stringify(body), signal: AbortSignal.timeout(60_000) })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+const chRes = await api('POST', '/api/workshop/channels', { body: { name: `probe-${TAG}`, leadAgent: { name: `lead-${TAG}`, harness: 'mock', config: { delayMs: 60 } } } })
+if (!chRes.data?.channelId) { console.error('channel create failed:', JSON.stringify(chRes).slice(0, 300)); process.exit(1) }
+const ch = chRes.data
+console.log('channel:', ch.channelId)
+const tplRes = await api('POST', '/api/workshop/agents', { body: { name: `op-${TAG}`, harness: 'omp', config: { provider: 'zhipu-coding-plan', model: 'glm-5.3-flash', systemPromptPrefix: '你是产线操作员:严格按步骤执行,完成后立即调用 complete_task。' } } })
+const tpl = tplRes.data?.id ? tplRes.data : tplRes.data?.agent ?? tplRes.data
+if (!tpl?.id) { console.error('agent create failed:', JSON.stringify(tplRes).slice(0, 300)); process.exit(1) }
+const joinRes = await api('POST', `/api/workshop/channels/${ch.channelId}/agents`, { body: { agentId: tpl.id, role: 'worker' } })
+const join = joinRes.data
+if (!join?.data?.id && !join?.id) { console.error('join failed:', JSON.stringify(joinRes).slice(0, 300)); process.exit(1) }
+const instId = join.data?.id ?? join.id
+console.log('worker joined:', instId?.slice(0, 8))
+
+const t1Res = await api('POST', `/api/workshop/channels/${ch.channelId}/tasks`, {
+  body: {
+    title: `probe-${TAG}`,
+    parts: [{ text: `两步作业:1) dcw_line_context 查看当前产线上下文;2. 完成后调用 complete_task,交付原样包含一行 PROBE-OK。` }],
+    assigneeId: instId,
+  },
+})
+if (!t1Res.data) { console.error('task create failed:', JSON.stringify(t1Res).slice(0, 300)); process.exit(1) }
+const taskId = t1Res.data?.task?.id ?? t1Res.data?.id
+console.log('task:', taskId)
+
+const t0 = Date.now()
+let last = ''
+let terminal = null
+while (Date.now() - t0 < 5 * 60_000) {
+  await sleep(500)
+  const t = (await api('GET', `/api/workshop/channels/${ch.channelId}/tasks`)).data
+  const row = (Array.isArray(t) ? t : t.tasks ?? []).find(x => x.id === taskId)
+  const st = row?.state ?? '?'
+  if (st !== last) {
+    console.log(`+${((Date.now() - t0) / 1000).toFixed(1)}s state: ${last || '(new)'} -> ${st} (progress=${row?.progress ?? '-'})`)
+    last = st
+    if (['COMPLETED', 'FAILED', 'CANCELED'].includes(st)) { terminal = st; break }
+  }
+}
+console.log('terminal:', terminal)
+if (terminal && terminal !== 'COMPLETED') {
+  const events = await api('GET', `/api/workshop/channels/${ch.channelId}/events?limit=200`)
+  const msgs = await api('GET', `/api/workshop/channels/${ch.channelId}/messages?limit=100`)
+  const ev = JSON.stringify(events.data ?? events)
+  const interesting = ev.match(/\{[^{}]*[Tt]ransition[^{}]*\}|\{[^{}]*cancel[^{}]*\}/g) ?? []
+  console.log('== transition-ish events:', interesting.slice(0, 6))
+  const mlist = (msgs.data?.messages ?? msgs.data ?? [])
+  for (const m of mlist.slice(-8)) {
+    const text = (m.parts ?? []).map(p => p.text ?? '').join(' ').replace(/\s+/g, ' ').slice(0, 220)
+    console.log(`msg[${m.role}] task=${(m.taskId ?? '').slice(0, 8)} meta=${JSON.stringify(m.metadata ?? {}).slice(0, 120)}`)
+    console.log('   ', text)
+  }
+}
+console.log('channel kept for inspection:', ch.channelId)

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

@@ -8,7 +8,7 @@ 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 })

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

@@ -5,7 +5,7 @@ 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' }),
+  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }),
 }).then(r => r.json())
 await page0(login.data.token)
 

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

@@ -8,7 +8,7 @@ const fail = m => { console.error('FAIL:', m); process.exitCode = 1 }
 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 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 = []

package/scripts/_dbg-town-gate.mjs

@@ -3,7 +3,7 @@ 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 })

package/scripts/_dbg-town-ins-probe.mjs

@@ -1,7 +1,7 @@
 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 })

package/scripts/_dbg-town-perf.mjs

@@ -3,7 +3,7 @@ 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 = []

package/scripts/_dbg-town-realtime.mjs

@@ -3,7 +3,7 @@ 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 login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? '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 = []

package/scripts/_dbg-town-shot.py

@@ -0,0 +1,25 @@
+import asyncio, os
+from playwright.async_api import async_playwright
+
+BASE = os.environ.get('AW_BASE', 'http://127.0.0.1:3000')
+
+async def main():
+    async with async_playwright() as p:
+        browser = await p.chromium.launch()
+        page = await browser.new_page(viewport={'width': 1600, 'height': 1000})
+        await page.goto(BASE + '/workshop', wait_until='domcontentloaded', timeout=120000)
+        await page.wait_for_selector('input[placeholder="邮箱 / 用户名"]', timeout=90000)
+        await page.wait_for_timeout(4000)
+        await page.get_by_placeholder('邮箱 / 用户名').click(timeout=8000)
+        await page.get_by_placeholder('邮箱 / 用户名').fill('admin', timeout=8000)
+        await page.locator('input[type="password"]').first.click(timeout=8000)
+        await page.locator('input[type="password"]').first.fill('admin123', timeout=8000)
+        await page.get_by_role('button', name='登 录').click(timeout=8000)
+        await page.wait_for_timeout(3500)
+        await page.goto(BASE + '/town', wait_until='domcontentloaded', timeout=120000)
+        await page.wait_for_timeout(45000)  # 等 three.js 场景构建与首帧渲染
+        await page.screenshot(path='.e2e-shots/town-render.png', full_page=False)
+        print('[town] screenshot saved')
+        await browser.close()
+
+asyncio.run(main())