agentworkshop 0.2.1

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

@@ -0,0 +1,169 @@
+/**
+ * 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

@@ -0,0 +1,121 @@
+/**
+ * 数字孪生垂直切片 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

@@ -0,0 +1,89 @@
+/**
+ * 小镇·模型上传/绑定/删除 管线验证(纯 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)
+  })