agentworkshop 0.7.33 → 0.7.37

package/scripts/test-town-scene-math.ts

@@ -1,169 +0,0 @@
-/**
- * TownSceneMath 纯函数单测(node + tsx 直跑,无浏览器依赖)
- *
- * 覆盖:
- *  1. 边界几何:椭圆/矩形线框点、normLayout 下限钳制
- *  2. clampToBoundary:椭圆内钳/矩形内钳/旋转边界/内缩 margin
- *  3. pointInBoundary:内部命中/外部排除/旋转边界
- *  4. boundaryExtremePoints:矩形四角与椭圆轴向四点(旋转)
- *  5. clampRangeToLayout:中心钳入 + 半径收缩进边界
- *  6. clampToAgentRange:椭圆/矩形/旋转/已在内不位移
- *  7. distToRangeBoundary:矩形边距与椭圆近似
- *  8. 身份色:hashHue 稳定性 / channelColorCss 同源
- *  9. town-behavior:stepToward 到达判定 / parseActionFromEnvelope 任务投递语义
- */
-import {
-  ARRIVE, AGENT_SPEED,
-  boundaryExtremePoints, boundaryPoints, bubbleDisplayMs, channelColorCss, channelColorNum,
-  clampRangeToLayout, clampToAgentRange, clampToBoundary, distToRangeBoundary,
-  hashHue, normLayout, pointInBoundary,
-} from '../shared/town-scene-math'
-import { parseActionFromEnvelope, stepToward } from '../shared/town-behavior'
-import type { AepEnvelope } from '../shared/workshop-protocol'
-
-let failures = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-const near = (a: number, b: number, eps = 1e-6): boolean => Math.abs(a - b) <= eps
-
-const round = (v: { x: number, z: number } | null): { x: number, z: number } | null =>
-  v ? { x: Math.round(v.x * 1e6) / 1e6, z: Math.round(v.z * 1e6) / 1e6 } : v
-
-// ---- 1. 边界几何 ----
-{
-  const pts = boundaryPoints('ellipse', 100, 60, 48)
-  check('ellipse points count', pts.length === 48)
-  check('ellipse radius X', near(pts[0][0], 100, 1e-9), `x=${pts[0][0]}`)
-  check('ellipse radius Z(90°)', near(pts[12][1], 60, 1e-6))
-  const rect = boundaryPoints('rect', 200, 100, 48)
-  check('rect points count', rect.length === 4)
-  check('rect corners use radius as half extent', rect.some(([x, z]) => near(x, 200) && near(z, 100)) && rect.some(([x, z]) => near(x, -200) && near(z, -100)))
-  const nl = normLayout({ channelId: 'c', x: 0, z: 0, radiusX: 10, radiusZ: 5, shape: 'ellipse', rotationY: 0 })
-  check('normLayout floor radiusX=60', nl.radiusX === 60 && nl.radiusZ === 40)
-}
-
-// ---- 2. clampToBoundary ----
-{
-  const l = { channelId: 'c', x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 0 }
-  check('ellipse inside unchanged', near(clampToBoundary(l, 20, 10).x, 20) && near(clampToBoundary(l, 20, 10).z, 10))
-  check('ellipse outside pulled-in', (() => {
-    const c = clampToBoundary(l, 1000, 0)
-    return near(c.x, 100) && near(c.z, 0, 1e-9)
-  })(), JSON.stringify(round(clampToBoundary(l, 1000, 0))))
-  check('ellipse diagonal clamp inside unit circle', (() => {
-    const c = clampToBoundary(l, 500, 300)
-    const nx = c.x / 100
-    const nz = c.z / 60
-    return near(nx * nx + nz * nz, 1, 1e-4)
-  })())
-  const r = { channelId: 'c', x: 0, z: 0, radiusX: 200, radiusZ: 100, shape: 'rect', rotationY: 0 }
-  check('rect clamp', near(clampToBoundary(r, 999, 999).x, 200) && near(clampToBoundary(r, 999, 999).z, 100))
-  check('rect margin', near(clampToBoundary(r, 999, 0, 16).x, 200 - 16))
-  const rot = { channelId: 'c', x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 90 }
-  const rotated = clampToBoundary(rot, -500, 0)
-  // 旋转 90°:椭圆短轴(Z=60)转到 X 轴 → 东侧最远 60
-  check('rotated boundary clamp(90°)', near(Math.abs(rotated.x), 60, 1e-6) && near(rotated.z, 0, 1e-6), JSON.stringify(round(rotated)))
-}
-
-// ---- 3. pointInBoundary ----
-{
-  const l = { channelId: 'c', x: 100, z: 100, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 0 }
-  check('inside true', pointInBoundary(l, 160, 130))
-  check('outside false', !pointInBoundary(l, 400, 100))
-  check('on edge true', pointInBoundary(l, 200, 100))
-  const rot = { channelId: 'c', x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 90 }
-  check('rotated: point on east axis(now 60) inside', pointInBoundary(rot, 60, 0))
-  // 旋转 90°:主轴(X=100)转到世界 Z 方向 → (0,60) 仍在内,(0,150) 越界在外
-  check('rotated: point on world-Z 60 inside', pointInBoundary(rot, 0, 60))
-  check('rotated: point beyond major axis outside', !pointInBoundary(rot, 0, 150))
-  const r = { channelId: 'c', x: 0, z: 0, radiusX: 200, radiusZ: 100, shape: 'rect' as const, rotationY: 0 }
-  check('rect edge uses full radius', pointInBoundary(r, 200, 100))
-  check('rect beyond full radius excluded', !pointInBoundary(r, 201, 0))
-}
-// ---- 4. boundaryExtremePoints ----
-{
-  const l = { x: 100, z: 100, radiusX: 200, radiusZ: 100, shape: 'rect' as const, rotationY: 0 }
-  const p = boundaryExtremePoints(l)
-  check('rect 4 corners use half extents', p.length === 4 && p.every(([x, z]) => near(Math.abs(x - 100), 200) && near(Math.abs(z - 100), 100)))
-  const e = boundaryExtremePoints({ x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse' as const, rotationY: 90 })
-  // 旋转 90°:轴向点互换
-  check('ellipse rotated axial swap', e.some(([x]) => near(x, 60)) && e.some(([, z]) => near(z, 100)))
-}
-
-// ---- 5. clampRangeToLayout ----
-{
-  const l = { channelId: 'c', x: 0, z: 0, radiusX: 200, radiusZ: 120, shape: 'ellipse', rotationY: 0 }
-  const big = clampRangeToLayout(l, { x: 0, z: 0, radiusX: 500, radiusZ: 300, shape: 'ellipse', rotationY: 0 })
-  const extreme = boundaryExtremePoints(big)
-  check('big range shrunk into layout', extreme.every(([x, z]) => pointInBoundary(l, x, z)), JSON.stringify(extreme))
-  const offCenter = clampRangeToLayout(l, { x: 900, z: 0, radiusX: 100, radiusZ: 80, shape: 'ellipse', rotationY: 0 })
-  check('off-center range center pulled in', near(offCenter.x, 200 - 20, 1e-6) && near(offCenter.z, 0, 1e-6))
-}
-
-// ---- 6. clampToAgentRange ----
-{
-  const r = { x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 0 }
-  check('agent range inside unchanged', near(clampToAgentRange(r, 10, 5).x, 10))
-  check('agent range east clamp', near(clampToAgentRange(r, 500, 0).x, 100))
-  const rr = { x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'rect', rotationY: 0 }
-  check('agent range rect clamp', near(clampToAgentRange(rr, 500, 500).x, 100) && near(clampToAgentRange(rr, 500, 500).z, 60))
-}
-
-// ---- 7. distToRangeBoundary ----
-{
-  const rr = { x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'rect', rotationY: 0 }
-  check('rect boundary distance on edge ~0', distToRangeBoundary(rr, 100, 0) < 1e-6)
-  check('rect inside distance to top', near(distToRangeBoundary(rr, 0, 50), 10, 1e-6))
-  const e = { x: 0, z: 0, radiusX: 100, radiusZ: 60, shape: 'ellipse', rotationY: 0 }
-  check('ellipse boundary distance ~0', distToRangeBoundary(e, 100, 0) < 0.5)
-}
-
-// ---- 8. 身份色 ----
-{
-  check('hashHue stable', hashHue('abc') === hashHue('abc'))
-  check('hashHue differs for diff input', hashHue('a') !== hashHue('b'))
-  check('channelColorCss matches hsl of hashHue', channelColorCss('c1') === `hsl(${Math.round(hashHue('c1'))}, 58%, 60%)`)
-  const n1 = channelColorNum('c1')
-  const n2 = channelColorNum('c1')
-  check('channelColorNum stable', n1 === n2, `0x${n1.toString(16)}`)
-  check('bubbleDisplayMs bounds', bubbleDisplayMs('') === 1400 && bubbleDisplayMs('x'.repeat(500)) === 3400)
-}
-
-// ---- 9. town-behavior ----
-{
-  const speed = AGENT_SPEED
-  const dt = 1 / 60
-  const far = 2000
-  const s1 = stepToward({ x: 0, y: 0 }, { x: far, y: 0 }, speed, dt)
-  check('stepToward moves speed·dt', near(s1.x, speed * dt, 1e-9) && !s1.arrived, `x=${s1.x}`)
-  const s2 = stepToward({ x: 0, y: 0 }, { x: ARRIVE - 1, y: 0 }, speed, dt)
-  check('stepToward arrives within ARRIVE', s2.arrived)
-  const s3 = stepToward({ x: 10, y: 0 }, { x: 0, y: 0 }, speed, dt)
-  check('stepToward direction left', s3.dir === 'left')
-  const s4 = stepToward({ x: 0, y: 0 }, { x: 10, y: 0 }, speed, dt)
-  check('stepToward direction right', s4.dir === 'right')
-  const s5 = stepToward({ x: 5, y: 0 }, { x: 5, y: 0 }, speed, dt)
-  check('stepToward same point arrived', s5.arrived && s5.dir === 'none')
-
-  const taskEnv = {
-    type: 'a2a.message',
-    channelId: 'ch1',
-    taskId: 't1',
-    payload: {
-      parts: [{ text: '修复样式' }],
-      metadata: { 'x-aw-from-agent': 'lead-1', 'x-aw-task-kind': 'assign', 'x-aw-task-id': 't1' },
-    },
-  } as AepEnvelope
-  const act = parseActionFromEnvelope(taskEnv, { resolveTaskAssignee: () => 'worker-1' })
-  check('parse task assign → kind=task + requireReply', act !== null && act.kind === 'task' && act.requireReply, act ? `${act.kind}/${act.taskKind}` : 'null')
-  check('parse task assign → toId via resolveTaskAssignee', act?.toId === 'worker-1')
-  check('parse task assign → text fallback', act?.text === '修复样式' || act?.text === '下发任务')
-
-  const noTarget = parseActionFromEnvelope({ type: 'a2a.message', channelId: 'ch1', payload: { parts: [], metadata: {} } } as AepEnvelope)
-  check('no target → null', noTarget === null)
-}
-
-console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILURES`)
-if (failures > 0) process.exitCode = 1

package/scripts/test-town-twin.mjs

@@ -1,121 +0,0 @@
-/**
- * 数字孪生垂直切片 E2E:
- *  - 3D 场景拖 dev 模型(device-3d)进场景 → 生成设备节点 + 落一个 DeviceTwin;
- *  - 状态环颜色随 twin.state 变化(idle→running→alarm);
- *  - MCP device.control 指令经 REST 控制端驱动 twin.state;
- *  - 动作绑定:hero-3d 角色在场景,支持状态切换。
- * 依赖:dev server(127.0.0.1:3000)+ Edge + puppeteer-core。
- */
-import puppeteer from 'puppeteer-core'
-import fs from 'node:fs'
-
-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-twin'
-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 = `tw-${Date.now().toString(36)}@test.local`
-  const reg = await api('POST', '/api/users/register', { body: { name: `tw-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' } })
-  if (!reg.data) {
-    console.error('REG FAIL')
-    process.exit(2)
-  }
-  const { token } = reg.data
-  const ch = await api('POST', '/api/workshop/channels', { body: { name: 'twin-ch', scenarioPrompt: 't', leadAgent: { name: 'lead', harness: 'mock' } }, token })
-  const cid = ch.data.channelId
-  await api('POST', `/api/workshop/channels/${cid}/agents`, { body: { name: 'w1', harness: 'mock', role: 'worker' }, token })
-  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'twin-ws' }, token })
-  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${cid}`, { 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)
-  await page.goto(`${BASE}/workshop/w/${ws.data.id}?view=town`, { waitUntil: 'domcontentloaded' })
-  // 等 3D 场景 ready(重试应对 401 抽风;token 传播后稳定)
-  let ok = false
-  for (let i = 0; i < 8 && !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('NOT READY')
-    process.exit(2)
-  }
-
-  // 断言:3D 场景就绪 + 有 agent
-  const st = await page.evaluate(() => ({ blocks: window.__town.scene.getDebugState().blocks, agents: window.__town.scene.getDebugState().agents.length, devices: window.__town.scene.getDeviceNodes?.().length }))
-  console.log('blocks:', st.blocks, 'agents:', st.agents, 'devices:', st.devices)
-
-  // 拖 dev 模型进场景(空地带)
-  await page.evaluate(() => window.__town.scene.dropModelOnWorld(1600, 1600, 'device-3d'))
-  await sleep(1500)
-  const devNodes = await page.evaluate(() => window.__town.scene.getDeviceNodes())
-  console.log('设备节点:', JSON.stringify(devNodes.map(d => ({ id: d.twinId, state: d.state, x: d.x, z: d.z }))))
-  const hasDevice = devNodes.length >= 1
-  const twinId = devNodes[0]?.twinId
-  console.log(`设备节点生成: ${hasDevice ? 'PASS' : 'FAIL'}`)
-
-  // twin 是否被 REST 创建(通过 list 查)
-  const twins = await api('GET', '/api/workshop/device-twins', { token })
-  const twinInApi = (twins.data?.twins ?? []).find(t => t.modelRef === 'device-3d')
-  console.log(`DeviceTwin 落库: ${twinInApi ? 'PASS' : 'CHECK'} (id=${twinInApi?.id})`)
-
-  // MCP 控制:power_on → running;telemetry 高温 → alarm
-  const tId = twinInApi?.id ?? twinId
-  if (tId) {
-    await api('POST', `/api/workshop/device-twins/${tId}/control`, { token, body: { command: 'power_on' } })
-    await sleep(500)
-    const afterCtrl = await api('GET', '/api/workshop/device-twins', { token })
-    const ctrlTwin = (afterCtrl.data?.twins ?? []).find(t => t.id === tId)
-    console.log(`MCP/控制 → state: ${ctrlTwin?.state} | ${ctrlTwin?.state === 'running' ? 'PASS' : 'CHECK'}`)
-    await api('POST', `/api/workshop/device-twins/${tId}/telemetry`, { token, body: { telemetry: { temperature: 95 } } })
-    await sleep(500)
-    const afterTele = await api('GET', '/api/workshop/device-twins', { token })
-    const alarmTwin = (afterTele.data?.twins ?? []).find(t => t.id === tId)
-    console.log(`遥测高温 → state: ${alarmTwin?.state} | ${alarmTwin?.state === 'alarm' ? 'PASS' : 'CHECK'}`)
-  }
-
-  // 让 DeviceTwinPanel 轮询刷新后截图(展示设备卡/遥测/控制)
-  await sleep(2500)
-  await page.screenshot({ path: `${OUT}/01-twin-device.png` })
-  const result = { hasDevice, twinInApi: !!twinInApi, stateRunning: twinInApi?.state === 'running' }
-  console.log('\nSUMMARY:', JSON.stringify(result))
-  console.log(hasDevice ? '\n==> TWIN OK' : '\n==> TWIN PARTIAL')
-  await browser.close()
-  process.exit(hasDevice ? 0 : 1)
-}
-main()
-  .catch((e) => {
-    console.error(e)
-    process.exit(2)
-  })

package/scripts/test-town-upload.mjs

@@ -1,89 +0,0 @@
-/**
- * 小镇·模型上传/绑定/删除 管线验证(纯 REST E2E,无需浏览器)。
- * 断言:上传落盘 → 列表可见 → 绑定 → config.modelRef 持久化 → 引删保护 → 解除绑定后删除。
- */
-import fs from 'node:fs'
-
-const BASE = 'http://127.0.0.1:3000'
-const api = async (m, ep, { body, token, form } = {}) => {
-  const headers = {}
-  if (token) headers.authorization = `Bearer ${token}`
-  let payload
-  if (form) {
-    payload = form
-  }
-  else {
-    headers['content-type'] = 'application/json'
-    payload = body ? JSON.stringify(body) : undefined
-  }
-  const res = await fetch(`${BASE}${ep}`, { method: m, headers, body: payload })
-  return res.json()
-}
-
-async function main() {
-  const email = `up-${Date.now().toString(36)}@test.local`
-  const reg = await api('POST', '/api/users/register', { body: { name: `up-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' } })
-  if (!reg.data) {
-    console.error('REG FAIL', JSON.stringify(reg))
-    process.exit(2)
-  }
-  const { token } = reg.data
-  await api('POST', '/api/workshop/workspaces', { body: { name: 'up-ws' }, token })
-  const ch = await api('POST', '/api/workshop/channels', { body: { name: 'up-ch', scenarioPrompt: 't', leadAgent: { name: 'lead', harness: 'mock' } }, token })
-  const cid = ch.data.channelId
-  const agent = await api('POST', `/api/workshop/channels/${cid}/agents`, { body: { name: 'w1', harness: 'mock', role: 'worker' }, token })
-  const aid = agent.data.id
-
-  // 1) 上传 knight.png(multipart)
-  const buf = fs.readFileSync('public/assets/game/character/knight.png')
-  const form = new FormData()
-  form.append('file', new Blob([buf], { type: 'image/png' }), 'knight.png')
-  form.append('name', '上传测试骑士')
-  form.append('kind', 'sheet')
-  form.append('frameWidth', '48')
-  form.append('frameHeight', '88')
-  form.append('frames', '4')
-  const up = await api('POST', '/api/workshop/assets/character', { token, form })
-  if (!up.data?.asset) {
-    console.error('UPLOAD FAIL', JSON.stringify(up))
-    process.exit(2)
-  }
-  const assetId = up.data.asset.id
-  console.log('upload id:', assetId)
-  const fileExists = fs.existsSync(`public${up.data.asset.file}`)
-  console.log(`上传落盘: ${fileExists ? 'PASS' : 'FAIL'}`)
-
-  // 2) GET 列表可见
-  const list1 = await api('GET', `/api/workshop/assets/character`, { token })
-  const visible = (list1.data?.assets ?? []).some(a => a.id === assetId)
-  console.log(`列表可见: ${visible ? 'PASS' : 'FAIL'}`)
-
-  // 3) 绑定到 agent → config.modelRef 持久化
-  const bind = await api('PATCH', `/api/workshop/channels/${cid}/agents/${aid}/model`, { token, body: { modelRef: assetId } })
-  console.log(`绑定: ${bind.data?.modelRef === assetId ? 'PASS' : 'FAIL'} (${bind.data?.modelRef})`)
-  const agents = await api('GET', `/api/workshop/channels/${cid}/agents`, { token })
-  const boundAgent = (agents.data ?? []).find(a => a.id === aid)
-  const modelRefPersisted = boundAgent?.config?.modelRef === assetId
-  console.log(`config.modelRef 持久化: ${modelRefPersisted ? 'PASS' : 'FAIL'}`)
-
-  // 4) 引删保护:仍被绑定 → used>0
-  const del1 = await api('DELETE', `/api/workshop/assets/character/${assetId}`, { token })
-  const protectedDel = del1.data?.used > 0
-  console.log(`引删保护(used>0): ${protectedDel ? 'PASS' : 'FAIL'} (used=${del1.data?.used})`)
-
-  // 5) 清空绑定后删除 → removed + 文件删
-  await api('PATCH', `/api/workshop/channels/${cid}/agents/${aid}/model`, { token, body: { modelRef: '' } })
-  const del2 = await api('DELETE', `/api/workshop/assets/character/${assetId}`, { token })
-  const fileGone = !fs.existsSync(`public${up.data.asset.file}`)
-  console.log(`解除绑定后删除: ${del2.data?.deleted ? 'PASS' : 'FAIL'} | 文件删: ${fileGone ? 'PASS' : 'FAIL'}`)
-
-  const allPass = fileExists && visible && bind.data?.modelRef === assetId && modelRefPersisted && protectedDel && del2.data?.deleted && fileGone
-  console.log('\nSUMMARY:', JSON.stringify({ fileExists, visible, modelRefPersisted, protectedDel, deleted: del2.data?.deleted, fileGone }))
-  console.log(allPass ? '\n==> ALL PASS' : '\n==> SOME FAIL')
-  process.exit(allPass ? 0 : 1)
-}
-main()
-  .catch((e) => {
-    console.error(e)
-    process.exit(2)
-  })