agentworkshop 0.2.1

package/scripts/_dbg-orbit.mjs

@@ -0,0 +1,58 @@
+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 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: TOKEN, domain: '127.0.0.1', path: '/' })
+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)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 2500))
+const s0 = await page.evaluate(() => {
+  const s = window.__town.scene
+  return { yaw: +s.viewCur.yaw.toFixed(3), pitch: +s.viewCur.pitch.toFixed(3), r: Math.round(s.viewCur.radius) }
+})
+// 环绕:orbafitBy yaw +1.2 / pitch +0.3
+await page.evaluate(() => {
+  const s = window.__town.scene
+  for (let i = 0; i < 12; i++) s.orbitBy(8, -4)
+})
+await new Promise(r => setTimeout(r, 600))
+const s1 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const c = s.camera.position
+  return { yaw: +s.viewCur.yaw.toFixed(3), pitch: +s.viewCur.pitch.toFixed(3), camY: Math.round(c.y), camX: Math.round(c.x) }
+})
+console.log('orbit:', JSON.stringify({ before: s0, after: s1 }))
+// 预设:side
+await page.evaluate(() => {
+  window.__town.scene.setViewPreset('side')
+})
+await new Promise(r => setTimeout(r, 1600))
+const s2 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const c = s.camera.position
+  return { yaw: +s.viewCur.yaw.toFixed(2), camX: Math.round(c.x), camY: Math.round(c.y), camZ: Math.round(c.z) }
+})
+console.log('preset side:', JSON.stringify(s2))
+await page.screenshot({ path: 'docs/audit/screenshots/orbit-side.png' })
+// 中键平移:panByScreen 沿右向移动
+const s3 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const t0 = { ...s.getCameraTarget() }
+  s.panByScreen(80, 0)
+  const t1 = s.getCameraTarget()
+  return { dx: Math.round(t1.x - t0.x), dz: Math.round(t1.z - t0.z) }
+})
+console.log('pan right(80px):', JSON.stringify(s3))
+console.log('errors:', errors.slice(0, 4))
+await browser.close()

package/scripts/_dbg-panesplitter-fix-check.mjs

@@ -0,0 +1,62 @@
+/** 一次性:PaneSplitter 编译修复验证 —— /workshop 与工作台控制台均无编译错误 */
+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 token = login.data.token
+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()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: token, domain: '127.0.0.1', path: '/' })
+
+const issues = []
+page.on('console', (msg) => {
+  if (msg.type() === 'error') {
+    const text = msg.text()
+    if (/vue-devtools|Download the Vue Devtools/i.test(text)) return
+    issues.push(`[console.error] ${text.slice(0, 200)}`)
+  }
+})
+page.on('pageerror', (err) => issues.push(`[pageerror] ${String(err).slice(0, 250)}`))
+
+// 1) /workshop
+await page.goto(`${BASE}/workshop`, { waitUntil: 'networkidle0', timeout: 90000 })
+await new Promise(r => setTimeout(r, 4000))
+const overlay1 = await page.evaluate(() => !!document.querySelector('vite-error-overlay'))
+console.log('/workshop vite-error-overlay:', overlay1)
+await page.screenshot({ path: `${OUT}/fix-workshop.png` })
+
+// 2) 进入控制台(挂 MultiChannelView → PaneSplitter)
+const enter = await page.$('a, button')
+const link = await page.evaluate(() => {
+  const btns = [...document.querySelectorAll('button, a')]
+  const b = btns.find(x => /进入控制台/.test(x.innerText || ''))
+  return b ? true : false
+})
+if (link) {
+  await page.evaluate(() => {
+    const b = [...document.querySelectorAll('button, a')].find(x => /进入控制台/.test(x.innerText || ''))
+    b.click()
+  })
+  await new Promise(r => setTimeout(r, 6000))
+}
+const path2 = await page.evaluate(() => location.pathname)
+const overlay2 = await page.evaluate(() => !!document.querySelector('vite-error-overlay'))
+const splitter = await page.evaluate(() => document.querySelectorAll('.pane-splitter').length)
+console.log('after enter:', path2, '| vite-error-overlay:', overlay2, '| pane-splitter count:', splitter)
+await page.screenshot({ path: `${OUT}/fix-workshop-console.png` })
+
+console.log('console issues:', issues.length)
+issues.slice(0, 8).forEach(i => console.log(i))
+await browser.close()
+console.log('done')

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

@@ -0,0 +1,25 @@
+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 agents = (await J(`/api/workshop/channels/52979e79-5592-46df-87eb-02658168f7ac/agents`)).data
+const worker = agents.find(a => a.role === 'worker')
+console.log('monitor worker:', worker.id.slice(0, 8))
+let hitl = false
+for (let i = 0; i < 220; i++) {
+  await sleep(2000)
+  const pend = (await J(`/api/workshop/agent-tools/approvals?agentId=${worker.id}`)).data.approvals
+  if (pend.length > 0) {
+    if (!hitl) { hitl = true; console.log(`[t+${i * 2}s] HITL 待审: ${pend[0].detail.slice(0, 70)}`) }
+    await J(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, 'POST', { approved: true, comment: '终验:批准' })
+    console.log('[HITL] 已批准')
+  }
+  const dw = (await J('/api/workshop/dcw')).data.nodes.find(n => n.name === '温度设定器(示例)')
+  if (Math.abs((dw.value ?? 0) - 185) < 0.01) { console.log(`[t+${i * 2}s] 设定值生效 = 185 ✓`); break }
+  if (i % 10 === 0) console.log(`[t+${i * 2}s] 设定值=${dw.value} pending=${pend.length}`)
+}
+const fin = (await J('/api/workshop/dcw')).data.nodes.find(n => n.name === '温度设定器(示例)')
+console.log(hitl ? 'HITL PASS' : 'HITL FAIL')
+console.log(Math.abs((fin.value ?? 0) - 185) < 0.01 ? 'WRITE PASS(=185)' : `WRITE CHECK(${fin.value})`)

package/scripts/_dbg-pop-clamp-verify.mjs

@@ -0,0 +1,77 @@
+/** 一次性:bind-pop 高度钳制验证 —— 弹层 top 不越出 Inspector 卡片顶缘 */
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3000'
+let TOKEN = ''
+const H = () => ({ 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+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())
+TOKEN = login.data.token
+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=2560,1271'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 2560, height: 1271 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+
+try {
+  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, 3500))
+
+  const segBtns = await page.$$('.nav-tabs .seg button')
+  await segBtns[1].click()
+  await new Promise(r => setTimeout(r, 600))
+  // 选中第一台设备(挤出机)
+  await page.evaluate(() => {
+    const dev = [...(window.__town.scene.getDeviceNodes?.() ?? [])][0]
+    if (dev) window.__town.scene.setSelected?.({ kind: 'device', id: dev.twinId })
+  })
+  await new Promise(r => setTimeout(r, 900))
+
+  const check = async (idx, name, shot) => {
+    const btn = (await page.$$('.bind-add-wrap .bind-add'))[idx]
+    await btn.evaluate(el => el.scrollIntoView({ block: 'center' }))
+    await new Promise(r => setTimeout(r, 300))
+    await btn.click()
+    await new Promise(r => setTimeout(r, 500))
+    const r = await page.evaluate(() => {
+      const pop = document.querySelector('.bind-pop')
+      const panel = pop?.closest('.panel')
+      if (!pop || !panel) return null
+      const pr = panel.getBoundingClientRect()
+      const por = pop.getBoundingClientRect()
+      return {
+        popTop: Math.round(por.top),
+        panelTop: Math.round(pr.top),
+        overshoot: Math.round(pr.top - por.top),
+        popBottom: Math.round(por.bottom),
+        popHeight: Math.round(por.height),
+        scrollable: pop.scrollHeight > pop.clientHeight,
+      }
+    })
+    console.log(`${name}:`, JSON.stringify(r), '| top 在面板内:', r && r.overshoot <= 0 ? 'OK' : 'OVERSHOOT')
+    await page.screenshot({ path: `${OUT}/${shot}` })
+    // 关闭
+    const btns = await page.$$('.bind-add-wrap .bind-add')
+    await btns[idx].click()
+    await new Promise(r => setTimeout(r, 300))
+  }
+
+  await check(0, 'T1 daq picker bounds', 'round4-daq-pop-clamped.png')
+  await check(1, 'T2 dcw picker bounds', 'round4-dcw-pop-clamped.png')
+}
+finally {
+  await browser.close()
+}
+console.log('round4 done')

package/scripts/_dbg-preset-e2e.mjs

@@ -0,0 +1,116 @@
+/**
+ * Preset(工业场景 Channel 模板)E2E:
+ * 1. 内置工业场景模板补种存在(涂布/挤出),场景 prompt 含场景/分工/纪律三要素
+ * 2. instantiate → channel 场景落库 + 成员装配(lead+工艺+数据)
+ * 3. 场景注入管道:channel.scenarioPrompt = 模板值(instantiated channel 逐字携带)
+ * 4. omp 活体:worker 依据注入场景回答(质量目标 ±2% 等仅存在于 preset 的事实)
+ * 运行:dev(3000) 就绪后 node scripts/_dbg-preset-e2e.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 TEMPLATES = [
+  { id: 'chtpl-preset-optical-film', keys: ['光学薄膜涂布产线', '团队分工', '作业纪律', '生产主管', '工艺工程师', '数据分析师', '±2%'] },
+  { id: 'chtpl-preset-extrusion', keys: ['挤出流延产线', '团队分工', '作业纪律', '熔体压力', '数据分析师', '±3%'] },
+]
+
+async function main() {
+  console.log('== 1. 内置工业场景模板(补种幂等) ==')
+  const list = (await jget('/api/workshop/channel-templates')).data
+  const items = Array.isArray(list) ? list : list?.templates ?? []
+  for (const want of TEMPLATES) {
+    const t = items.find(x => x.id === want.id)
+    if (!t) { fail(`模板缺失: ${want.id}`); continue }
+    assert(t.isBuiltin === true && t.visibility === 'public', `${t.name}: 内置公共(owner NULL/public)`)
+    for (const k of want.keys) {
+      assert((t.scenarioPrompt || '').includes(k), `${t.name}: 场景含「${k}」`)
+    }
+    const members = Array.isArray(t.members) ? t.members : []
+    assert(members.length === 3, `${t.name}: 成员=3(lead+工艺+数据), 实际 ${members.length}`)
+    const workers = members.filter(m => m.role === 'worker')
+    assert(workers.length === 2 && workers.every(m => m.inline?.harness === 'omp'), `${t.name}: 2 个内联 omp worker(带专长)`)
+  }
+
+  console.log('== 2. instantiate → channel 场景落库 + 成员装配 ==')
+  const tplFull = items.find(x => x.id === TEMPLATES[0].id)
+  const inst = await jpost(`/api/workshop/channel-templates/${TEMPLATES[0].id}/instantiate`, { name: '涂布产线优化组(Preset E2E)' })
+  const channelId = inst.data?.channelId
+  if (!channelId) { fail(`实例化失败: ${JSON.stringify(inst).slice(0, 150)}`); process.exit(1) }
+  assert(inst.data.agentCount === 3, `实例化装配 3 成员(实际 ${inst.data.agentCount})`)
+  try {
+    const chList = (await jget('/api/workshop/channels')).data
+    const ch = (Array.isArray(chList) ? chList : chList?.channels ?? []).find(c => c.id === channelId)
+    assert(!!ch, '实例化 channel 存在')
+    assert(ch.scenarioPrompt === tplFull.scenarioPrompt, 'channel.scenarioPrompt 逐字携带模板场景(注入源就位)')
+    const agents = (await jget(`/api/workshop/channels/${channelId}/agents`)).data
+    const arr = Array.isArray(agents) ? agents : agents?.agents ?? []
+    assert(arr.length === 3, `channel 成员 3(实际 ${arr.length})`)
+    const lead = arr.find(a => a.role === 'lead')
+    assert(!!lead, 'lead 就位(tpl-default-lead)')
+    const workerNames = arr.filter(a => a.role === 'worker').map(a => a.name).sort().join('/')
+    assert(workerNames.includes('工艺工程师') && workerNames.includes('数据分析师'), `worker 名册: ${workerNames}`)
+
+    console.log('== 3. 场景注入验证(contextPrefix 组装面) ==')
+    // factory 组装 config.scenarioPrompt ← channel.scenarioPrompt(manager.ts 组装逻辑,已由既有 E2E 覆盖);
+    // 这里做 tsx 直读的同源断言:OmpRpcAgentImpl 携带场景 config 时 prefix 含场景三要素
+    const { OmpRpcAgentImpl } = await import('../server/services/workshop/agents/omp-agent.ts')
+    const sim = new OmpRpcAgentImpl({ agentId: 'preset-probe-x', name: '工艺工程师', role: 'worker', channelId, scenarioPrompt: tplFull.scenarioPrompt })
+    const prefix = await sim.contextPrefix()
+    assert(prefix.includes('Scenario Brief') && prefix.includes('光学薄膜涂布产线'), 'omp 首段注入场景 preset')
+    assert(prefix.includes('±2%') && prefix.includes('作业纪律'), '场景质量目标与纪律进入 prompt')
+    const at = prefix.indexOf('Scenario Brief')
+    const rosterAt = prefix.indexOf('## Your Team')
+    assert(at >= 0 && (rosterAt === -1 || at < rosterAt), '场景段位于名册之前(最高优先级;探针无 workspace 时名册段缺省)')
+
+    console.log('== 4. omp 活体:worker 引用仅存在于 preset 的事实 ==')
+    // worker(内联模板实例)未获得任何其他场景信息;回答质量目标只能来自注入的场景段
+    const task = (await jpost(`/api/workshop/channels/${channelId}/tasks`, {
+      title: '场景认知自检',
+      parts: [{ text: '请把本题派发给任一 worker 成员作答(勿自行作答)。题目:不要调用任何工具,仅依据你系统上下文中的「Scenario Brief/产线场景」回答:1) 本团队服务的产线名称与产品;2) 涂层厚度均匀性的质量目标数值;3) 团队三个角色各自的职责(一句话/角色);4) 作业纪律的第一条。逐项作答。' }],
+    })).data
+    const taskId = task.task?.id ?? task.id
+    const artifact = await waitTaskArtifact(channelId, taskId)
+    assert(artifact.includes('涂布'), 'omp 引用产线场景(涂布)')
+    assert(artifact.includes('2%'), 'omp 引用质量目标 ±2%(仅存在于 preset)')
+    assert(artifact.includes('主管') || artifact.includes('lead'), 'omp 复述 lead 职责')
+    assert(artifact.includes('数据先行') || artifact.includes('先看数'), 'omp 复述作业纪律')
+  }
+  finally {
+    await jdel(`/api/workshop/channels/${channelId}`).catch(() => {})
+  }
+
+  console.log(`\n===== Preset E2E: ${pass} PASS / ${fails.length} FAIL =====`)
+  if (fails.length) { fails.forEach(m => console.error(' -', m)); process.exitCode = 1 }
+  process.exit(process.exitCode ?? 0)
+}
+
+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 ?? []
+    const related = tasks.filter(t => t.id === taskId || t.parentId === taskId)
+    if (related.length === 0) continue
+    if (!related.every(t => ['COMPLETED', 'FAILED', 'CANCELED'].includes(t.state))) 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 ''
+}
+
+main().catch((e) => { console.error('FATAL:', e.message); process.exit(1) })

package/scripts/_dbg-preview-console.mjs

@@ -0,0 +1,28 @@
+/** 一次性:preview 控制台报错捕获(WebGL/着色器错误) */
+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 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()
+const errors = []
+page.on('console', (m) => {
+  if (['error', 'warning'].includes(m.type())) errors.push(`[${m.type()}] ${m.text().slice(0, 300)}`)
+})
+page.on('pageerror', e => errors.push(`[pageerror] ${String(e).slice(0, 300)}`))
+await page.setViewport({ width: 1600, height: 1200 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 12000))
+const uniq = [...new Set(errors)]
+console.log(uniq.length ? uniq.join('\n') : '(no console errors)')
+await browser.close()

package/scripts/_dbg-preview-minrepro.mjs

@@ -0,0 +1,156 @@
+/** 一次性:preview 最小复现 —— rig 渲染器 + 独立场景渲染 mdo.glb,逐步排查 */
+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 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()
+page.on('console', m => console.log('[page]', m.text().slice(0, 200)))
+await page.setViewport({ width: 1600, height: 1200 })
+await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 9000))
+
+const out = await page.evaluate(async () => {
+  const dbg = globalThis.__pvDebug
+  const rig = globalThis.__previewRig
+  if (!dbg || !rig) return { error: 'handles missing' }
+  const { THREE, GLTFLoader } = dbg
+
+  const gltf = await new Promise((res, rej) => new GLTFLoader().load('/assets/game/devices/mdo.glb', res, undefined, rej))
+  const obj = gltf.scene
+
+  // 原始包围盒(scale 前)
+  const box = new THREE.Box3().setFromObject(obj)
+  const size = box.getSize(new THREE.Vector3())
+
+  // 居中缩放(同组件逻辑)
+  const max = Math.max(size.x, size.y, size.z) || 1
+  obj.position.x -= box.min.x + size.x / 2
+  obj.position.y -= box.min.y + size.y / 2
+  obj.position.z -= box.min.z + size.z / 2
+  obj.scale.setScalar(2 / max)
+
+  const scene = new THREE.Scene()
+  scene.add(obj)
+  scene.add(new THREE.HemisphereLight(0xffffff, 0x333333, 1.5))
+  const dl = new THREE.DirectionalLight(0xffffff, 2.5)
+  dl.position.set(3, 4, 2)
+  scene.add(dl)
+  const cam = new THREE.PerspectiveCamera(38, 150 / 76, 0.1, 100)
+  cam.position.set(2.4, 1.8, 3.1)
+  cam.lookAt(0, 0, 0)
+
+  const cv = document.createElement('canvas')
+  cv.width = 150; cv.height = 76
+  const ctx = cv.getContext('2d')
+  const count = () => { const d = ctx.getImageData(0, 0, 150, 76).data; let l = 0; for (let i = 3; i < d.length; i += 4) if (d[i] > 8) l++; return l }
+
+  rig.renderer.setSize(150, 76, false)
+  rig.renderer.render(scene, cam)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const p1 = count()
+  rig.renderer.render(scene, cam)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const p2 = count()
+
+  // 环境光贴图(组件用了 PMREM 环境;这里不设,若能画出 = 环境所致)
+  // A) 清屏色判定:不渲染模型,只 clear 成洋红 → drawImage 后画布应有大量像素
+  rig.renderer.setClearColor(0xff00ff, 1)
+  rig.renderer.clear()
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const clearColorPx = count()
+
+  // B) 正视相机 + 缩小模型(0.5 单位)再渲染
+  obj.scale.setScalar(0.5 / max)
+  cam.position.set(0, 0, 6)
+  cam.lookAt(0, 0, 0)
+  rig.renderer.render(scene, cam)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const p3 = count()
+  rig.renderer.render(scene, cam)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const p4 = count()
+  rig.renderer.setClearColor(0x000000, 0)
+
+  // C) 项目包围盒到屏幕
+  const box2 = new THREE.Box3().setFromObject(obj)
+  const proj = []
+  for (const [cx, cy, cz] of [[box2.min.x, box2.min.y, box2.min.z], [box2.max.x, box2.max.y, box2.max.z], [box2.min.x, box2.max.y, box2.max.z]]) {
+    const v = new THREE.Vector3(cx, cy, cz).project(cam)
+    proj.push([+v.x.toFixed(2), +v.y.toFixed(2), +v.z.toFixed(3)])
+  }
+  // D) mesh 二分:逐 mesh 单独渲染(其余 visible=false),找出可见者
+  const meshes = []
+  obj.traverse((c) => { if (c.isMesh) meshes.push(c) })
+  const per = []
+  for (const m of meshes) {
+    for (const o of meshes) o.visible = o === m
+    rig.renderer.render(scene, cam)
+    ctx.clearRect(0, 0, 150, 76)
+    ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+    per.push(count())
+  }
+  for (const o of meshes) o.visible = true
+  // E) 对照:device-console 同管线
+  const g2 = await new Promise((res, rej) => new GLTFLoader().load('/assets/game/devices/device-console.glb', res, undefined, rej))
+  const o2 = g2.scene
+  const b2 = new THREE.Box3().setFromObject(o2)
+  const s2 = b2.getSize(new THREE.Vector3())
+  const max2 = Math.max(s2.x, s2.y, s2.z) || 1
+  o2.position.x -= b2.min.x + s2.x / 2
+  o2.position.y -= b2.min.y + s2.y / 2
+  o2.position.z -= b2.min.z + s2.z / 2
+  o2.scale.setScalar(2 / max2)
+  const scene2 = new THREE.Scene()
+  scene2.add(o2)
+  scene.add(new THREE.HemisphereLight(0xffffff, 0x333333, 1.5))
+  const dl2 = new THREE.DirectionalLight(0xffffff, 2.5)
+  dl2.position.set(3, 4, 2)
+  scene2.add(dl2)
+  const cam2 = new THREE.PerspectiveCamera(38, 150 / 76, 0.1, 100)
+  cam2.position.set(2.4, 1.8, 3.1)
+  cam2.lookAt(0, 0, 0)
+  rig.renderer.render(scene2, cam2)
+  ctx.clearRect(0, 0, 150, 76)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const consolePx = count()
+  // F) DoubleSide 判定:绕向反转假设
+  for (const m of meshes) { if (m.material) m.material = m.material.clone(), m.material.side = THREE.DoubleSide }
+  rig.renderer.render(scene, cam)
+  ctx.clearRect(0, 0, 150, 76)
+  ctx.drawImage(rig.renderer.domElement, 0, 0, 150, 76)
+  const doubleSidePx = count()
+  // G) mesh 级诊断:世界包围盒/索引/材质
+  const diag = meshes.slice(0, 4).map((m) => {
+    const b = new THREE.Box3().setFromObject(m)
+    const sz = b.getSize(new THREE.Vector3())
+    return {
+      idx: m.geometry.index?.count ?? null,
+      posCount: m.geometry.attributes.position?.count ?? 0,
+      drawRange: m.geometry.drawRange?.count ?? null,
+      mat: m.material?.type ?? '?',
+      transparent: m.material?.transparent ?? false,
+      opacity: m.material?.opacity,
+      worldSize: [+sz.x.toFixed(3), +sz.y.toFixed(3), +sz.z.toFixed(3)],
+      worldCenter: [+((b.min.x + b.max.x) / 2).toFixed(2), +((b.min.y + b.max.y) / 2).toFixed(2), +((b.min.z + b.max.z) / 2).toFixed(2)],
+    }
+  })
+  return {
+    diag, doubleSidePx, mdoIsoPx: p1, consoleIsoPx: consolePx,
+    mdoMeshCount: meshes.length,
+    mdoPerMeshPx: per,
+    visibleMeshes: per.filter(x => x > 50).length,
+  }
+})
+console.log(JSON.stringify(out))
+await browser.close()

package/scripts/_dbg-preview-pixels.mjs

@@ -0,0 +1,93 @@
+/** 一次性:preview 深度验证 —— rig 内部状态 + 每卡 canvas 像素 */
+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 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: login.data.token, domain: '127.0.0.1', path: '/' })
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+await new Promise(r => setTimeout(r, 12000))
+
+const out = await page.evaluate(() => {
+  const rig = globalThis.__previewRig
+  const info = rig
+    ? {
+        slots: rig.slots.size,
+        drawCalls: rig.renderer.info.render.calls,
+        triangles: rig.renderer.info.render.triangles,
+        canvasW: rig.renderer.domElement.width,
+        canvasH: rig.renderer.domElement.height,
+        perSlot: [...rig.slots].map((s) => {
+          let tris = 0, visible = 0, geomEmpty = 0
+          if (s.group) s.group.traverse((c) => {
+            if (c.isMesh) {
+              const g = c.geometry
+              const pos = g?.attributes?.position
+              if (!pos || pos.count < 3) geomEmpty++
+              else tris += (g.index ? g.index.count : pos.count) / 3
+              if (c.visible !== false) visible++
+            }
+          })
+          return {
+            w: s.w, h: s.h, meshCount: (() => { let n = 0; s.group?.traverse((c) => { if (c.isMesh) n++ }); return n })(),
+            tris: Math.round(tris), visible, geomEmpty,
+            canvasPx: (() => { const d = s.ctx.getImageData(0, 0, Math.min(s.w, 400), Math.min(s.h, 200)).data; let lit = 0; for (let i = 3; i < d.length; i += 4) if (d[i] > 8) lit++; return lit })(),
+          }
+        }),
+      }
+    : null
+  // 手动渲染第 0 槽(agv,空白)对照:loop 之外的 render + drawImage
+  const s0 = [...rig.slots][0]
+  const before = (() => { const d = s0.ctx.getImageData(0, 0, s0.w, s0.h).data; let l = 0; for (let i = 3; i < d.length; i += 4) if (d[i] > 8) l++; return l })()
+  rig.renderer.setSize(s0.w, s0.h, false)
+  rig.renderer.render(s0.scene, s0.camera)
+  s0.ctx.drawImage(rig.renderer.domElement, 0, 0, s0.w, s0.h)
+  const after = (() => { const d = s0.ctx.getImageData(0, 0, s0.w, s0.h).data; let l = 0; for (let i = 3; i < d.length; i += 4) if (d[i] > 8) l++; return l })()
+  info.manualTest = { slot0Before: before, slot0AfterManualRender: after }
+  // 世界包围盒(fitObject 缩放是否退化)
+  const bb = new (Object.getPrototypeOf(s0.group).constructor)().setFromObject ? null : null
+  try {
+    s0.group.updateWorldMatrix(true, true)
+    const bx = new s0.group.children[0].Box3() ? null : null
+  }
+  catch {}
+  // 用 three 全局?页面无 THREE;借助 rig 之外方式:直接数学遍历
+  const pts = []
+  s0.group.traverse((c) => {
+    if (c.isMesh) {
+      const pos = c.geometry.attributes.position
+      const m = c.matrixWorld
+      const v = [0, 0, 0]
+      for (let i = 0; i < pos.count; i += Math.max(1, Math.floor(pos.count / 7))) {
+        v[0] = pos.getX(i); v[1] = pos.getY(i); v[2] = pos.getZ(i)
+        const wx = m[0] * v[0] + m[4] * v[1] + m[8] * v[2] + m[12]
+        const wy = m[1] * v[0] + m[5] * v[1] + m[9] * v[2] + m[13]
+        const wz = m[2] * v[0] + m[6] * v[1] + m[10] * v[2] + m[14]
+        pts.push([wx, wy, wz])
+      }
+    }
+  })
+  if (pts.length) {
+    const mins = [Infinity, Infinity, Infinity], maxs = [-Infinity, -Infinity, -Infinity]
+    for (const p of pts) for (let k = 0; k < 3; k++) { mins[k] = Math.min(mins[k], p[k]); maxs[k] = Math.max(maxs[k], p[k]) }
+    info.slot0WorldBox = { mins: mins.map(x => +x.toFixed(2)), maxs: maxs.map(x => +x.toFixed(2)) }
+  }
+  // 连续第二遍(排除首帧着色器编译)
+  rig.renderer.render(s0.scene, s0.camera)
+  s0.ctx.drawImage(rig.renderer.domElement, 0, 0, s0.w, s0.h)
+  info.manualTest.slot0SecondRender = (() => { const d = s0.ctx.getImageData(0, 0, s0.w, s0.h).data; let l = 0; for (let i = 3; i < d.length; i += 4) if (d[i] > 8) l++; return l })()
+  return info
+})
+console.log(JSON.stringify(out, null, 1).slice(0, 3000))
+await browser.close()