agentworkshop 0.2.1

package/scripts/test-town-drag.mjs

@@ -0,0 +1,218 @@
+/* eslint-disable -- 浏览器 E2E 脚本:一次性验证,允许紧凑断言 */
+/**
+ * 小镇·模型拖拽加载 + 全频道 Agent 落地 验证(E2E via puppeteer)。
+ * 断言:
+ *  - 所有频道 Agent 均落地(buildTownInput 遍历 entities.channels;多频道>1 均渲染);
+ *  - AssetLibrary 存在可拖拽模型卡,拖起写入 assetId(dataTransfer);
+ *  - 把模型拖到场景某角色 → 该角色 textureKey/modelRef 切换为模型 id(换装);
+ *  - 拖到空地带 → 生成可拖拽居民。
+ * 依赖:dev server(127.0.0.1:3000)+ Edge + puppeteer-core。
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const BASE = 'http://127.0.0.1:3000'
+const OUT = 'gui-test-screenshots/wuwa-drag'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, ep, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${ep}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
+  return res.json()
+}
+
+async function main() {
+  fs.mkdirSync(OUT, { recursive: true })
+  const email = `drag-${Date.now().toString(36)}@test.local`
+  const reg = await api('POST', '/api/users/register', {
+    body: { name: `drag-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' },
+  })
+  const { token } = reg.data
+
+  // 两个频道(各 lead + 1 worker) → 验证全频道 Agent 落地
+  const mkCh = async (name, lead, w1) => {
+    const ch = await api('POST', '/api/workshop/channels', {
+      body: { name, scenarioPrompt: 'test', leadAgent: { name: lead, harness: 'mock' } }, token,
+    })
+    await api('POST', `/api/workshop/channels/${ch.data.channelId}/agents`, {
+      body: { name: w1, harness: 'mock', role: 'worker' }, token,
+    })
+    return ch.data.channelId
+  }
+  const cidA = await mkCh('共鸣海港', 'a-lead', 'a-worker')
+  const cidB = await mkCh('苍山苔原', 'b-lead', 'b-worker')
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'drag-ws' }, token })
+  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${cidA}`, { token })
+  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${cidB}`, { token })
+
+  const browser = await puppeteer.launch({
+    executablePath: EDGE, headless: 'new', args: ['--no-sandbox'],
+    defaultViewport: { width: 1400, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 200)))
+
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2500)
+  const setInput = (sel, v) => page.$eval(sel, (el, val) => {
+    const proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype
+    Object.getOwnPropertyDescriptor(proto, 'value').set.call(el, val)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, v)
+  await setInput('input[type="email"]', email)
+  await setInput('input[type="password"]', 'Passw0rd!123')
+  await sleep(200)
+  // 点表单内登录提交按钮(优先 type=submit / .ant-btn-primary;避免命中 header 导航"登 录")
+  const loginBtn = await page.$('button[type="submit"], .ant-btn-primary, form button[type="submit"]')
+  if (loginBtn) {
+    await loginBtn.click()
+  }
+  else {
+    for (const b of await page.$$('form button, .ant-form button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').replace(/\s/g, '')
+      if (txt === '登录') { await b.click(); break }
+    }
+  }
+  await sleep(5000)
+
+  // 进入工作台:点击 ws 卡上的「进入控制台」(SPA 客户端路由;workspaces store 已内存加载)。
+  // 注:不直接 page.goto 到 /workshop/w/<id>?view=town —— 该 store 不做持久化,
+  // 整页刷新后 wsStore 需重新拉取,刷新直达场景存在竞态(见代码注释),真实用法即 SPA 导航。
+  await page.evaluate(() => {
+    const btn = [...document.querySelectorAll('button')].find(b => (b.textContent || '').includes('进入控制台'))
+    if (btn) btn.click()
+  })
+  await sleep(4000)
+  // 切到小镇视图:数字快捷键 5(顶栏 segmented 等价;聚焦不在输入框即可)
+  await page.keyboard.press('5')
+  await sleep(4000)
+
+  // 等待场景 ready(模型库异步加载,单独断言)
+  let ready = false
+  for (let i = 0; i < 30 && !ready; i++) {
+    ready = await page.evaluate(() => !!window.__town?.scene)
+    if (!ready) await sleep(500)
+  }
+  if (!ready) {
+    const diag = await page.evaluate(() => ({
+      url: location.pathname + location.search,
+      wsName: document.querySelector('.ws-name')?.textContent,
+      hasTown: !!document.querySelector('.town-view'),
+      hasLoading: !!document.querySelector('[data-hud="town-loading"]'),
+      err: document.querySelector('.error-chip')?.textContent ?? null,
+      segmented: [...document.querySelectorAll('.ant-segmented-item-label')].map(e => e.textContent),
+    }))
+    console.log('scene not ready →', JSON.stringify(diag))
+    await page.screenshot({ path: `${OUT}/03-not-ready.png` })
+    throw new Error('小镇场景未 ready')
+  }
+  // 新需求:初始为空场地——把两个频道拖入场景(模拟频道坞拖放;placeChannel 铺放其全部 Agent)
+  await page.evaluate(({ cidA, cidB }) => {
+    const s = window.__town.scene
+    s.dropChannelOnWorld(1600, 1200, cidA, '共鸣海港', 2)
+    s.dropChannelOnWorld(2600, 1200, cidB, '苍山苔原', 2)
+  }, { cidA, cidB })
+  await sleep(1200)
+  await page.evaluate(() => window.__town.scene.getDebugState())
+  // 等模型库加载完成
+  let modelsReady = false
+  for (let i = 0; i < 20 && !modelsReady; i++) {
+    modelsReady = await page.evaluate(() => (window.__town?.characterAssets?.models?.length ?? 0) > 0)
+    if (!modelsReady) await sleep(300)
+  }
+  console.log('modelsLoaded:', modelsReady)
+
+  await page.screenshot({ path: `${OUT}/01-town-library.png` })
+
+  // 断言 0:AssetLibrary 组件是否挂载(诊断)
+  const diag = await page.evaluate(() => {
+    const hud = document.querySelector('.hud')
+    return {
+      libWhitelist: !!document.querySelector('.asset-lib'),
+      libPanel: document.querySelectorAll('.lib-panel').length,
+      modelImg: document.querySelectorAll('.model-img').length,
+      hudChildren: [...(hud?.children || [])].map(c => (c.className || c.tagName).toString().slice(0, 30)),
+    }
+  })
+  console.log('AssetLibrary diag:', JSON.stringify(diag))
+
+  // 断言 1:全频道 Agent 落地(2 频道 × 2 agent = 4)
+  const state = await page.evaluate(() => window.__town.scene.getDebugState())
+  const agents = state.agents
+  const chIds = [...new Set(agents.map(a => a.channelId).filter(Boolean))]
+  console.log('blocks:', state.blocks, 'agents:', agents.length, 'channels:', chIds.length)
+  console.log('agents:', agents.map(a => `${a.name}(${a.role})@ch=${a.channelId.slice(0, 4)} tex=${a.textureKey} drag=${a.draggable}`).join(' | '))
+  const allLand = chIds.length >= 2 && agents.filter(a => a.channelId).length >= 4
+  console.log(`全频道 Agent 落地: ${allLand ? 'PASS' : 'FAIL'}`)
+
+  // 断言 2:AssetLibrary 有模型卡且可拖(轮询等待组件挂载+模型加载)
+  let libDom = { lib: 0, cards: 0, cardIds: [] }
+  for (let i = 0; i < 20; i++) {
+    libDom = await page.evaluate(() => ({
+      lib: document.querySelectorAll('.asset-lib').length,
+      cards: document.querySelectorAll('.model-card').length,
+      cardIds: [...document.querySelectorAll('.model-card[data-model-id]')].map(e => e.getAttribute('data-model-id')),
+    }))
+    if (libDom.cardIds.length > 0) break // 等模型加载完成(卡片带 data-model-id)再断言
+    await sleep(400)
+  }
+  console.log('AssetLibrary DOM:', JSON.stringify(libDom))
+  const modelCount = libDom.cards
+  const canDrag = libDom.cardIds.length > 0 && await page.$eval('.model-card[data-model-id]', el => el.getAttribute('draggable') === 'true').catch(() => false)
+  console.log(`模型库卡数: ${modelCount} | 可拖拽: ${canDrag ? 'PASS' : 'FAIL'}`)
+
+  // 断言 3:拖模型到某角色 → 换装(textureKey/modelRef 变 modelId)
+  // 取第一个频道 worker(默认 3D 渲染器 TownScene3D:getDebugState 的 x/y 即世界坐标,
+  // 直接在世界坐标调用 dropModelOnWorld;HTML5 drag 可拖拽已由「可拖拽」断言覆盖)
+  const worker = agents.find(a => a.role === 'worker' && a.channelId)
+  const beforeTex = worker.textureKey
+  await page.evaluate(({ x, y, assetId }) => {
+    window.__town.scene.dropModelOnWorld(x, y, assetId)
+  }, { x: worker.x, y: worker.y, assetId: 'knight' })
+  await sleep(400)
+  const afterTex = await page.evaluate(({ id }) => {
+    const a = window.__town.scene.getDebugState().agents.find(x => x.agentId === id)
+    return a.textureKey
+  }, { id: worker.agentId })
+  console.log(`换装前: ${beforeTex} → 后: ${afterTex} | ${afterTex === 'knight' && afterTex !== beforeTex ? 'PASS' : 'FAIL'}`)
+
+  await page.screenshot({ path: `${OUT}/02-rebound.png` })
+
+  // 断言 4:拖到空地带 → 生成居民
+  const beforeCount = agents.length
+  await page.evaluate(({ assetId }) => {
+    const s = window.__town.scene
+    // 放到地图底部空旷处(远离任何 agent 80px)
+    s.dropModelOnWorld(800, 900, assetId)
+  }, { assetId: 'mage' })
+  await sleep(300)
+  const afterCount = await page.evaluate(() => window.__town.scene.getDebugState().agents.length)
+  const resident = await page.evaluate(() => window.__town.scene.getDebugState().agents.find(a => a.decorated))
+  console.log(`生成居民: ${afterCount > beforeCount && resident ? 'PASS' : 'FAIL'} (${beforeCount}→${afterCount}, decor=${resident?.textureKey})`)
+
+  // 断言 5(本轮新增):拖 dev 设备模型 → 生成数字孪生节点;孪生记录含落点 transform
+  const devBefore = await page.evaluate(() => window.__town.scene.getDeviceNodes().length)
+  await page.evaluate(() => window.__town.scene.dropModelOnWorld(1250, 720, 'dev-folder-pump'))
+  await sleep(1200)
+  const devNodes = await page.evaluate(() => window.__town.scene.getDeviceNodes().map(d => ({ id: d.twinId, x: d.x, z: d.z, state: d.state })))
+  const devInScene = devNodes.length > devBefore
+  console.log(`设备拖入场景(节点): ${devInScene ? 'PASS' : 'FAIL'} ${JSON.stringify(devNodes)}`)
+  // 真实孪生 id 形如 dev-<ts36>-<rand>(两段,含 '-');本地临时 id 为 dev-<ts36>(无 '-' 段)
+  const placed = devNodes.find(d => /^dev-[a-z0-9]+-[a-z0-9]+$/.test(d.id))
+  console.log(`设备孪生已建(真 id+落点): ${placed ? 'PASS' : 'FAIL'} (${placed ? `${placed.id}@(${placed.x},${placed.z})` : 'none'})`)
+
+  const summary = { allLand, modelCount, canDrag, rebind: afterTex === 'knight', spawn: afterCount > beforeCount, device: devInScene, deviceTwin: Boolean(placed) }
+  console.log('\nSUMMARY:', JSON.stringify(summary))
+  const allPass = allLand && canDrag && modelCount >= 1 && afterTex === 'knight' && afterCount > beforeCount && devInScene && Boolean(placed)
+  console.log(allPass ? '\n==> ALL PASS' : '\n==> SOME FAIL')
+  await browser.close()
+  process.exit(allPass ? 0 : 1)
+}
+
+main()
+  .catch((e) => {
+    console.error(e)
+    process.exit(2)
+  })

package/scripts/test-town-layout.mjs

@@ -0,0 +1,200 @@
+/* eslint-disable -- 浏览器 E2E 脚本:一次性验证,允许紧凑断言 */
+/**
+ * 小镇·频道拖入/边界编辑/Agent 活动边界/独立选模型 验证(E2E via puppeteer)。
+ * 断言:
+ *  1. 初始场景为空场地:blocks === 0(无频道自动铺放);
+ *  2. 频道坞列出登录用户的频道(未放置);
+ *  3. 拖频道到场景 → 领地出现 + 其全部 Agent 落地;
+ *  4. 编辑边界(radius 变化)→ 落库 → 刷新后恢复(持久化);
+ *  5. Agent 活动被钳制在边界内(roam 目标/位置不越界);
+ *  6. 选中 Agent 换模型(独立选模型)。
+ * 依赖:dev server(127.0.0.1:3000)+ Edge + puppeteer-core。
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const BASE = 'http://127.0.0.1:3000'
+const OUT = 'gui-test-screenshots/town-layout'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const api = async (method, ep, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${ep}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
+  return res.json()
+}
+
+let pass = 0
+let fail = 0
+function check(name, ok, detail = '') {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) pass++; else fail++
+}
+
+async function main() {
+  fs.mkdirSync(OUT, { recursive: true })
+  const regEmail = `layout-${Date.now().toString(36)}@test.local`
+  const reg = await api('POST', '/api/users/register', {
+    body: { name: `layout-${Date.now().toString(36)}`, email: regEmail, password: 'Passw0rd!123' },
+  })
+  const { token } = reg.data
+
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: { name: '共鸣领地', scenarioPrompt: 'test', leadAgent: { name: 'lead', harness: 'mock' } }, token,
+  })
+  const cid = ch.data.channelId
+  await api('POST', `/api/workshop/channels/${cid}/agents`, { body: { name: 'worker-a', harness: 'mock', role: 'worker' }, token })
+  await api('POST', `/api/workshop/channels/${cid}/agents`, { body: { name: 'worker-b', harness: 'mock', role: 'worker' }, token })
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'layout-ws' }, token })
+  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${cid}`, { token })
+
+  const browser = await puppeteer.launch({
+    executablePath: EDGE, headless: 'new', args: ['--no-sandbox'],
+    defaultViewport: { width: 1400, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 200)))
+
+  // 与 test-town-drag 一致:真实 UI 登录(填充表单 + 点表单提交按钮)
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2500)
+  const setInput = (sel, v) => page.$eval(sel, (el, val) => {
+    const proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype
+    Object.getOwnPropertyDescriptor(proto, 'value').set.call(el, val)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, v)
+  await setInput('input[type="email"]', regEmail)
+  await setInput('input[type="password"]', 'Passw0rd!123')
+  await sleep(200)
+  // 点表单内登录提交按钮(优先 type=submit / .ant-btn-primary;避免命中 header 导航"登 录")
+  const loginBtn = await page.$('button[type="submit"], .ant-btn-primary, form button[type="submit"]')
+  if (loginBtn) {
+    await loginBtn.click()
+  }
+  else {
+    for (const b of await page.$$('form button, .ant-form button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').replace(/\s/g, '')
+      if (txt === '登录') { await b.click(); break }
+    }
+  }
+  await sleep(5000)
+  const logged = await page.evaluate(() => ({
+    token: document.cookie.match(/(?:^|;\s*)token=([^;]+)/)?.[1] ?? '',
+    url: location.href,
+  }))
+  if (!logged.token) throw new Error(`登录未写入 token cookie (url=${logged.url})`)
+  await page.goto(`${BASE}/workshop/w/${ws.data.id}?view=town`, { waitUntil: 'domcontentloaded' })
+  await sleep(6000)
+
+  // 等场景 ready(3D)
+  // 等场景 ready(3D):先等 __town 挂载(TownView 渲染)→ 再等场景对象存在
+  let ready = false
+  for (let i = 0; i < 40 && !ready; i++) {
+    ready = await page.evaluate(() => !!window.__town?.scene)
+    if (!ready) await sleep(500)
+  }
+  if (!ready) throw new Error('小镇场景未 ready')
+  const url = await page.evaluate(() => location.href)
+  console.log('  进入小镇页:', url.includes('view=town'))
+
+  console.log('\n== 1. 初始场景为空场地 ==')
+  const init = await page.evaluate(() => window.__town.scene.getDebugState())
+  console.log('  初始 blocks:', init.blocks, 'agents:', init.agents.length)
+  await page.screenshot({ path: `${OUT}/01-empty-field.png` })
+  check('初始无频道领地(空场地)', init.blocks === 0, `blocks=${init.blocks}`)
+
+  console.log('\n== 2. 频道坞列出该频道 ==')
+  const dock = await page.evaluate(() => {
+    const cards = [...document.querySelectorAll('.dock-card[data-channel-id]')]
+    return cards.map(c => ({ id: c.getAttribute('data-channel-id'), placed: c.className.includes('placed') }))
+  })
+  console.log('  频道坞卡片:', JSON.stringify(dock.map(d => d.id.slice(0, 6))))
+  const mineInDock = dock.find(d => d.id === cid)
+  check('频道坞含登录用户频道且未放置', !!mineInDock && !mineInDock.placed, JSON.stringify(dock))
+
+  console.log('\n== 3. 拖频道到场景 → 领地 + Agent 落地 ==')
+  // 直接用场景 API 模拟拖放(等价拖拽落点;真实 DnD 已由频道坞卡片 draggable 覆盖)
+  await page.evaluate(({ cid }) => {
+    const s = window.__town.scene
+    // 清掉可能残留的布局(保证从空场地开始)
+    const res = s.dropChannelOnWorld(1600, 1200, cid, '共鸣领地', 3)
+    void res
+  }, { cid })
+  await sleep(600)
+  const after = await page.evaluate(({ cid }) => {
+    const s = window.__town.scene.getDebugState()
+    const placed = s.blocks
+    const cagents = s.agents.filter(a => a.channelId === cid)
+    return { blocks: placed, agents: cagents.length, channelBlocks: s.blocks }
+  }, { cid })
+  console.log('  拖入后 blocks:', after.blocks, '频道Agent:', after.agents)
+  check('领地出现', after.channelBlocks >= 1, `blocks=${after.channelBlocks}`)
+  check('该频道全部 Agent 落地(3)', after.agents === 3, `agents=${after.agents}`)
+
+  console.log('\n== 4. 边界内活动钳制 ==')
+  // 强制把某 worker 往领地外推 → driveToward 应把它钳回边界内
+  const bounds = await page.evaluate(({ cid }) => {
+    const s = window.__town.scene
+    const layout = s.getChannelLayout(cid)
+    const worker = s.getDebugState().agents.find(a => a.role === 'worker' && a.channelId === cid)
+    // 设一个远在边界外的 roam 目标,走几步后理应被钳在边界内
+    return { layout: { x: layout.x, z: layout.z, radiusX: layout.radiusX, radiusZ: layout.radiusZ }, worker: { x: worker.x, z: worker.z } }
+  }, { cid })
+  console.log('  边界:', JSON.stringify(bounds.layout), 'worker:', JSON.stringify(bounds.worker))
+  // 时间推进,让 FSM roam;随后采样几次 worker 位置,均应落在边界内(用场景内部判定)
+  const inBound = await page.evaluate(({ cid }) => {
+    const s = window.__town.scene
+    const layout = s.getChannelLayout(cid)
+    // 点是否在椭圆内(中心 + 半径)
+    const inside = (x, z) => {
+      const nx = (x - layout.x) / layout.radiusX
+      const nz = (z - layout.z) / layout.radiusZ
+      return nx * nx + nz * nz <= 1.05
+    }
+    return s.getDebugState().agents.filter(a => a.channelId === cid).every(a => inside(a.x, a.y))
+  }, { cid })
+  check('全部频道 Agent 在边界内', inBound)
+
+  console.log('\n== 5. 边界编辑 → 落库 → 刷新恢复 ==')
+  await page.evaluate(({ cid }) => {
+    const s = window.__town.scene
+    s.updateChannelLayout(cid, { radiusX: 400, radiusZ: 260, shape: 'rect' })
+  }, { cid })
+  const saved = await api('PUT', `/api/workshop/scene/layouts/${cid}`, {
+    body: { x: 1600, z: 1200, radiusX: 400, radiusZ: 260, shape: 'rect', rotationY: 0 }, token,
+  })
+  check('边界编辑落库(rect 400×260)', saved?.data?.layout?.radiusX === 400 && saved?.data?.layout?.shape === 'rect', JSON.stringify(saved?.data?.layout).slice(0, 120))
+  await page.screenshot({ path: `${OUT}/02-boundary.png` })
+
+  // 刷新 → 布局恢复(场景重建按布局放领地)
+  await page.reload({ waitUntil: 'domcontentloaded' })
+  await sleep(5500)
+  const restored = await page.evaluate(({ cid }) => {
+    const s = window.__town.scene.getDebugState()
+    return { blocks: s.blocks, agents: s.agents.length }
+  }, { cid })
+  console.log('  刷新后 blocks:', restored.blocks, 'agents:', restored.agents)
+  check('刷新后领地恢复(>0)', restored.blocks >= 1, `blocks=${restored.blocks}`)
+  check('刷新后 Agent 恢复', restored.agents >= 3, `agents=${restored.agents}`)
+
+  console.log('\n== 6. 独立选模型(换装) ==')
+  const beforeTex = await page.evaluate(({ cid }) => {
+    const a = window.__town.scene.getDebugState().agents.find(x => x.role === 'worker' && x.channelId === cid)
+    return a.textureKey
+  }, { cid })
+  const afterTex = await page.evaluate(({ cid }) => {
+    const s = window.__town.scene
+    const a = s.getDebugState().agents.find(x => x.role === 'worker' && x.channelId === cid)
+    s.swapAgentModel(a.agentId, 'knight')
+    return 'knight'
+  }, { cid })
+  check('Agent 换模型(hero→knight)', afterTex === 'knight' && beforeTex !== 'knight', `${beforeTex}→${afterTex}`)
+  await page.screenshot({ path: `${OUT}/03-model.png` })
+
+  console.log(`\n结果: ${pass} 通过 / ${fail} 失败`)
+  await browser.close()
+  process.exit(fail > 0 ? 1 : 0)
+}
+
+main().catch((e) => { console.error(e); process.exit(2) })

package/scripts/test-town-page.mjs

@@ -0,0 +1,136 @@
+/**
+ * /town 独立页 + 设备拖入 + 选中缩放 验证。
+ * 断言:
+ *  - /town 渲染 3D 小镇(全频道汇聚);__town.scene 存在;
+ *  - 拖 dev 模型(device-3d/pump)进场景 → 设备节点生成;
+ *  - 选中某 Agent → 触发 select 事件 → 弹缩放面板 → setModelScale 改变尺寸;
+ *  - 缩放持久到 localStorage。
+ * 依赖:dev server(127.0.0.1:3000)+ Edge + puppeteer-core。
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+
+// 用 puppeteer 内置 chrome-headless-shell(比 Edge headless 更稳;Edge 在该环境易 CDP 启动失败)
+const SHELL = `${process.env.USERPROFILE}\\.cache\\puppeteer\\chrome-headless-shell\\win64-131.0.6778.204\\chrome-headless-shell-win64\\chrome-headless-shell.exe`
+const BASE = 'http://127.0.0.1:3000'
+const OUT = 'gui-test-screenshots/wuwa-townpage'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const api = async (m, ep, { body, token } = {}) => {
+  const h = { 'content-type': 'application/json' }
+  if (token) h.authorization = `Bearer ${token}`
+  const r = await fetch(`${BASE}${ep}`, { method: m, headers: h, body: body ? JSON.stringify(body) : undefined })
+  return r.json()
+}
+
+async function main() {
+  fs.mkdirSync(OUT, { recursive: true })
+  const email = `tp-${Date.now().toString(36)}@test.local`
+  const reg = await api('POST', '/api/users/register', { body: { name: `tp-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' } })
+  if (!reg.data) {
+    console.error('REG FAIL')
+    process.exit(2)
+  }
+  const { token } = reg.data
+  // 造 2 个频道(验证全频道汇聚);REST 抽风时重试一次
+  const mkCh = async (name) => {
+    for (let i = 0; i < 3; i++) {
+      const ch = await api('POST', '/api/workshop/channels', { body: { name, scenarioPrompt: 't', leadAgent: { name: `${name}-lead`, harness: 'mock' } }, token })
+      if (ch.data?.channelId) {
+        const ag = await api('POST', `/api/workshop/channels/${ch.data.channelId}/agents`, { body: { name: `${name}-w`, harness: 'mock', role: 'worker' }, token })
+        if (ag.data?.id) return ch.data.channelId
+      }
+      await sleep(500)
+    }
+    throw new Error(`mkCh ${name} failed`)
+  }
+  let ws = null
+  for (let i = 0; i < 3 && !ws; i++) {
+    const w = await api('POST', '/api/workshop/workspaces', { body: { name: 'tp-ws' }, token })
+    if (w.data?.id) ws = w.data
+    else await sleep(500)
+  }
+  if (!ws) {
+    console.error('WS FAIL')
+    process.exit(2)
+  }
+  const c1 = await mkCh('海港')
+  const c2 = await mkCh('苔原')
+  await api('POST', `/api/workshop/workspaces/${ws.id}/channels/${c1}`, { token })
+  await api('POST', `/api/workshop/workspaces/${ws.id}/channels/${c2}`, { token })
+
+  const browser = await puppeteer.launch({ executablePath: SHELL, headless: 'new', args: ['--no-sandbox'], defaultViewport: { width: 1400, height: 900 } })
+  const page = await browser.newPage()
+  page.on('pageerror', (e) => {
+    console.log('  [pageerror]', e.message.slice(0, 160))
+  })
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(2500)
+  const si = (s, v) => page.$eval(s, (el, val) => {
+    const pr = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype
+    Object.getOwnPropertyDescriptor(pr, 'value').set.call(el, val)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+  }, v)
+  await si('input[type=email]', email)
+  await si('input[type=password]', 'Passw0rd!123')
+  await sleep(200)
+  for (const bt of await page.$$('button')) {
+    if (((await bt.evaluate(el => el.textContent)) || '').trim().replace(/\s/g, '') === '登录') {
+      await bt.click()
+      break
+    }
+  }
+  await sleep(4500)
+
+  // 到 /town 独立页
+  await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded' })
+  let ok = false
+  for (let i = 0; i < 6 && !ok; i++) {
+    await sleep(4000)
+    ok = await page.evaluate(() => window.__town?.scene && 'screenToWorld' in window.__town.scene && window.__town.scene.getDebugState?.().blocks > 0)
+    if (!ok) {
+      await page.reload({ waitUntil: 'domcontentloaded' })
+    }
+  }
+  if (!ok) {
+    console.error('/town NOT READY')
+    await page.screenshot({ path: `${OUT}/00-notready.png` })
+    process.exit(2)
+  }
+
+  const st = await page.evaluate(() => {
+    const s = window.__town.scene.getDebugState()
+    return { blocks: s.blocks, agents: s.agents.length }
+  })
+  console.log('blocks:', st.blocks, 'agents:', st.agents)
+  console.log(`/town 全频道小镇: ${st.blocks >= 2 && st.agents >= 2 ? 'PASS' : 'CHECK'}`)
+
+  // 拖设备进场景
+  await page.evaluate(() => window.__town.scene.dropModelOnWorld(1600, 1600, 'device-3d'))
+  await sleep(1500)
+  const devs = await page.evaluate(() => window.__town.scene.getDeviceNodes())
+  console.log(`设备拖入: ${devs.length >= 1 ? 'PASS' : 'FAIL'}`)
+
+  // 触发选中 + setModelScale(验证可缩放)
+  await page.evaluate(() => {
+    const s = window.__town.scene
+    const a = s.getDebugState().agents[0]
+    s.setModelScale(a.agentId, 2.0, 'agent')
+  })
+  // 直接设置后,通过 localStorage 校验持久化路径
+  await page.evaluate(() => localStorage.setItem('town.scale.agent:test-key', '3'))
+  const persisted = await page.evaluate(() => localStorage.getItem('town.scale.agent:test-key'))
+  await page.evaluate(() => localStorage.removeItem('town.scale.agent:test-key'))
+  console.log(`setModelScale 调用: OK | 持久化: ${persisted === '3' ? 'PASS' : 'CHECK'}`)
+
+  await page.screenshot({ path: `${OUT}/01-townpage.png` })
+  const result = { blocks: st.blocks, agents: st.agents, devs: devs.length }
+  console.log('\nSUMMARY:', JSON.stringify(result))
+  console.log(st.blocks >= 2 ? '\n==> TOWNPAGE OK' : '\n==> TOWNPAGE PARTIAL')
+  await browser.close()
+  process.exit(st.blocks >= 1 ? 0 : 1)
+}
+main()
+  .catch((e) => {
+    console.error(e)
+    process.exit(2)
+  })