agentworkshop 0.2.1

package/scripts/build-film-devices.mjs

@@ -0,0 +1,227 @@
+/**
+ * 薄膜双拉产线基础设备 GLB 生成器(一次性/可重复执行)。
+ *
+ * 依据设计稿 digital-twin.html 的程序化预制件(FACT.*)移植为独立 GLB 文件,
+ * 写入 public/assets/game/devices/ —— 设备库扫描 API 自动发现,拖入场景即实例化。
+ *
+ * 设备清单(挤出→流延→MD 纵拉→TD 横拉→收卷 + 辅助单元):
+ *   extruder 挤出机 / caster 流延冷却 / mdo MD 纵拉机 / tdo TD 拉幅机 /
+ *   winder 收卷机 / thickness-scanner 厚度扫描仪 / agv AGV 搬运车 / power-cabinet 配电柜
+ * (控制台 device-console.glb 与机械臂 device-robot-arm.glb 已存在,不在生成之列)
+ *
+ * 材质约定:LED 部件使用名为 LED 的自发光材质;屏幕为深青面板色。
+ * 运行:node scripts/build-film-devices.mjs
+ */
+import { writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import * as THREE from 'three'
+import { GLTFExporter } from 'three/examples/jsm/exporters/GLTFExporter.js'
+
+// Node 环境垫片:GLTFExporter 二进制导出仅用 FileReader 读 Blob(Node 24 原生 Blob)
+globalThis.FileReader = class {
+  readAsArrayBuffer(blob) {
+    blob.arrayBuffer().then((b) => {
+      this.result = b
+      this.onloadend()
+    })
+  }
+}
+
+const OUT_DIR = join(process.cwd(), 'public/assets/game/devices')
+
+/* ---------- 材质(设计稿 MAT.* 移植;屏幕用纯色代替 Canvas 贴图) ---------- */
+const std = (c, mt, rf) => new THREE.MeshStandardMaterial({ color: c, metalness: mt, roughness: rf })
+const MAT = {
+  steel: std(0x9fb2c8, 0.85, 0.32),
+  chrome: std(0xdfe8f2, 1, 0.14),
+  body: std(0x74869c, 0.35, 0.5),
+  body2: std(0x55647a, 0.4, 0.55),
+  dark: std(0x2b3442, 0.7, 0.45),
+  rubber: std(0x1a1f27, 0.2, 0.95),
+  copper: std(0xc57a45, 0.9, 0.35),
+  roll: std(0xe6ecf4, 0.15, 0.6),
+  glowCyan: new THREE.MeshBasicMaterial({ color: 0x53d6ff }),
+  screen: new THREE.MeshBasicMaterial({ color: 0x123246 }),
+}
+MAT.glowCyan.name = 'GLOW'
+MAT.screen.name = 'SCREEN'
+const ledMat = new THREE.MeshBasicMaterial({ color: 0x35e0a0 })
+ledMat.name = 'LED'
+
+/* ---------- 建模基元 ---------- */
+const B = (w, h, d, m) => new THREE.Mesh(new THREE.BoxGeometry(w, h, d), m)
+const Cyl = (rt, rb, h, m, seg = 24) => new THREE.Mesh(new THREE.CylinderGeometry(rt, rb, h, seg), m)
+const Sph = (r, m) => new THREE.Mesh(new THREE.SphereGeometry(r, 16, 12), m)
+const Tor = (r, t, m) => new THREE.Mesh(new THREE.TorusGeometry(r, t, 10, 32), m)
+const at = (m, x, y, z) => {
+  m.position.set(x, y, z)
+  return m
+}
+const grp = () => new THREE.Group()
+const led = (m) => {
+  m.material = ledMat
+  return m
+}
+
+/* ---------- 设备预制件(设计稿 FACT.* 1:1 移植) ---------- */
+const FACT = {}
+
+FACT.extruder = () => {
+  const g = grp()
+  g.add(at(B(4.4, 0.26, 1.7, MAT.dark), 0, 0.13, 0))
+  g.add(at(B(1.25, 1.15, 1.25, MAT.body2), -1.45, 0.85, 0))
+  const barrel = at(Cyl(0.38, 0.38, 3.2, MAT.steel), 0.35, 1.18, 0)
+  barrel.rotation.z = Math.PI / 2
+  g.add(barrel)
+  for (let i = 0; i < 4; i++) {
+    const h = Tor(0.43, 0.07, MAT.copper)
+    h.rotation.y = Math.PI / 2
+    g.add(at(h, -0.55 + i * 0.65, 1.18, 0))
+  }
+  g.add(at(Cyl(0.52, 0.2, 0.85, MAT.steel), -1.45, 2.1, 0))
+  g.add(at(B(0.55, 0.95, 0.95, MAT.body), 2.2, 1.15, 0))
+  g.add(at(Cyl(0.15, 0.15, 0.45, MAT.dark), 2.62, 1.15, 0))
+  g.add(at(B(0.75, 0.55, 0.1, MAT.dark), -1.45, 1.72, 0.68))
+  const scr = at(B(0.6, 0.36, 0.02, MAT.screen), -1.45, 1.74, 0.74)
+  scr.rotation.x = -0.08
+  g.add(scr)
+  g.add(led(at(B(0.5, 0.07, 0.07), -1.45, 2.02, 0.72)))
+  g.add(led(at(B(0.06, 0.06, 1.3), 1.3, 2.6, 0)))
+  return g
+}
+
+FACT.caster = () => {
+  const g = grp()
+  g.add(at(B(1.7, 0.26, 2.7, MAT.dark), 0, 0.13, 0))
+  for (const z of [-1.05, 1.05]) g.add(at(B(0.34, 2.35, 0.3, MAT.body2), 0, 1.3, z))
+  const roll = at(Cyl(1.12, 1.12, 2.1, MAT.chrome), 0, 1.62, 0)
+  roll.rotation.x = Math.PI / 2
+  g.add(roll)
+  const nip = at(Cyl(0.42, 0.42, 2.1, MAT.steel), 0.95, 2.9, 0)
+  nip.rotation.x = Math.PI / 2
+  g.add(nip)
+  g.add(at(B(0.8, 0.7, 0.8, MAT.body2), 1.25, 0.62, 1.15))
+  g.add(led(at(B(0.07, 0.07, 0.9), 0, 2.55, -1.02)))
+  return g
+}
+
+FACT.mdo = () => {
+  const g = grp()
+  for (const [x, z] of [[-2.5, -0.85], [2.5, -0.85], [-2.5, 0.85], [2.5, 0.85]]) {
+    g.add(at(B(0.28, 0.9, 0.28, MAT.dark), x, 0.45, z))
+  }
+  g.add(at(B(5.6, 2.3, 2.2, MAT.body), 0, 2.05, 0))
+  g.add(at(B(5.6, 0.18, 2.2, MAT.body2), 0, 3.29, 0))
+  for (const x of [-1.7, 0, 1.7]) {
+    for (const z of [-1.11, 1.11]) g.add(at(B(0.8, 0.9, 0.03, MAT.glowCyan), x, 2.0, z))
+  }
+  for (const x of [-1.8, 1.8]) g.add(at(Cyl(0.17, 0.17, 0.75, MAT.steel), x, 3.75, 0))
+  for (const x of [-3.15, 3.15]) {
+    g.add(at(B(0.55, 2.3, 2.35, MAT.dark), x, 1.15, 0))
+    for (const y of [1.15, 1.7, 2.25]) {
+      const r = at(Cyl(0.13, 0.13, 2.15, MAT.chrome), x, y, 0)
+      r.rotation.x = Math.PI / 2
+      g.add(r)
+    }
+  }
+  g.add(led(at(B(4.8, 0.06, 0.06), 0, 3.44, 1.12)))
+  return g
+}
+
+FACT.tdo = () => {
+  const g = grp()
+  for (const [x, z] of [[-2.8, -1.25], [2.8, -1.25], [-2.8, 1.25], [2.8, 1.25]]) {
+    g.add(at(B(0.3, 0.85, 0.3, MAT.dark), x, 0.42, z))
+  }
+  g.add(at(B(6.2, 2.1, 3.0, MAT.body), 0, 1.9, 0))
+  g.add(at(B(6.2, 0.22, 3.0, MAT.body2), 0, 3.06, 0))
+  for (const x of [-2.6, 0, 2.6]) g.add(at(Cyl(0.15, 0.15, 0.65, MAT.steel), x, 3.5, 0))
+  for (const z of [-1.53, 1.53]) g.add(at(B(5.4, 0.14, 0.04, MAT.glowCyan), 0, 1.85, z))
+  for (const z of [-1.38, 1.38]) {
+    g.add(at(B(6.7, 0.1, 0.16, MAT.steel), 0, 3.25, z))
+    for (let i = -2; i <= 2; i++) g.add(at(B(0.16, 0.18, 0.2, MAT.dark), i * 1.3, 3.4, z))
+  }
+  g.add(led(at(B(5.6, 0.06, 0.06), 0, 3.24, 1.53)))
+  return g
+}
+
+FACT.winder = () => {
+  const g = grp()
+  g.add(at(B(2.9, 0.3, 2.3, MAT.dark), 0, 0.15, 0))
+  for (const x of [-1, 1]) g.add(at(B(0.42, 2.25, 2.05, MAT.body2), x, 1.35, 0))
+  for (const x of [-1, 1]) {
+    const r = at(Cyl(1.02, 0.78, 1.5, MAT.roll), x, 1.95, 0)
+    r.rotation.x = Math.PI / 2
+    g.add(r)
+    g.add(at(Cyl(0.2, 0.2, 1.6, MAT.dark), x, 1.95, 0))
+  }
+  g.add(at(B(0.66, 0.95, 0.14, MAT.dark), 0, 1.5, 1.18))
+  g.add(at(B(0.56, 0.4, 0.02, MAT.screen), 0, 1.6, 1.26))
+  g.add(led(at(B(0.5, 0.06, 0.06), 0, 2.62, 0)))
+  return g
+}
+
+FACT.scanner = () => {
+  const g = grp()
+  g.add(at(B(2.8, 0.2, 1.0, MAT.dark), 0, 0.1, 0))
+  for (const x of [-1.15, 1.15]) g.add(at(B(0.24, 2.7, 0.5, MAT.steel), x, 1.5, 0))
+  g.add(at(B(2.75, 0.32, 0.55, MAT.steel), 0, 2.9, 0))
+  g.add(at(B(0.5, 0.62, 0.4, MAT.body), 0, 2.25, 0))
+  g.add(at(B(0.14, 0.1, 0.14, MAT.glowCyan), 0, 1.9, 0))
+  g.add(led(at(B(0.5, 0.06, 0.06), 0, 3.12, 0)))
+  return g
+}
+
+FACT.agv = () => {
+  const g = grp()
+  g.add(at(B(1.75, 0.5, 1.15, MAT.body2), 0, 0.42, 0))
+  g.add(at(B(1.5, 0.1, 0.95, MAT.dark), 0, 0.72, 0))
+  for (const [x, z] of [[-0.65, 0.45], [0.65, 0.45], [-0.65, -0.45], [0.65, -0.45]]) {
+    const w = at(Cyl(0.18, 0.18, 0.14, MAT.rubber), x, 0.2, z)
+    w.rotation.x = Math.PI / 2
+    g.add(w)
+  }
+  g.add(at(B(1.25, 0.09, 0.07, MAT.rubber), 0, 0.68, 0.56))
+  g.add(led(at(B(1.2, 0.07, 0.05), 0, 0.6, 0.58)))
+  g.add(at(B(0.1, 0.62, 0.1, MAT.steel), -0.6, 1.05, -0.3))
+  g.add(led(Sph(0.09), -0.6, 1.4, -0.3))
+  return g
+}
+
+FACT.cabinet = () => {
+  const g = grp()
+  g.add(at(B(1.22, 0.14, 0.92, MAT.dark), 0, 0.07, 0))
+  g.add(at(B(1.1, 2.2, 0.8, MAT.body2), 0, 1.24, 0))
+  g.add(at(B(1.0, 2.06, 0.03, MAT.body), 0, 1.24, 0.41))
+  for (const y of [0.5, 0.9, 1.3]) g.add(at(B(0.7, 0.03, 0.02, MAT.dark), 0, y + 0.62, 0.43))
+  g.add(led(Sph(0.05), 0.38, 2.1, 0.43))
+  return g
+}
+
+/* ---------- 导出清单:文件名 → 预制件(×34 统一放大,便于库内直观) ---------- */
+const EXPORTS = [
+  ['extruder.glb', FACT.extruder],
+  ['caster.glb', FACT.caster],
+  ['mdo.glb', FACT.mdo],
+  ['tdo.glb', FACT.tdo],
+  ['winder.glb', FACT.winder],
+  ['thickness-scanner.glb', FACT.scanner],
+  ['agv.glb', FACT.agv],
+  ['power-cabinet.glb', FACT.cabinet],
+]
+const S = 34
+
+const exporter = new GLTFExporter()
+for (const [file, build] of EXPORTS) {
+  const g = build()
+  g.scale.setScalar(S)
+  g.updateMatrixWorld(true)
+  const box = new THREE.Box3().setFromObject(g)
+  const h = box.max.y - box.min.y
+  const buf = await new Promise((resolve, reject) => {
+    exporter.parse(g, resolve, reject, { binary: true })
+  })
+  writeFileSync(join(OUT_DIR, file), Buffer.from(buf))
+  console.log(`OK ${file}  ${String(buf.byteLength).padStart(7)} B  建模高 ${h.toFixed(2)}(x34)`)
+}
+console.log('完成:薄膜双拉基础设备已写入 public/assets/game/devices/')

package/scripts/build-model-3d.mjs

@@ -0,0 +1,173 @@
+/**
+ * 内置 3D 角色模型生成器 —— 用 Three.js 搭一个低多边形「共鸣员工」并导出为 GLB。
+ * 产出:public/assets/game/character/hero-3d.glb(单文件,内嵌几何,无外部贴图)。
+ * 运行:node scripts/build-model-3d.mjs(或 pnpm game:build-model3d)。
+ */
+import { GLTFExporter } from 'three/examples/jsm/exporters/GLTFExporter.js'
+import * as THREE from 'three'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// GLTFExporter 依赖浏览器 FileReader;Node 环境用最小 polyfill 兜底。
+// 关键:GlbBlob/Blob → ArrayBuffer。Node 18+ 的 Blob 有 async arrayBuffer(),但
+// GLTFExporter 走同步 FileReader,因此用 Blob.arrayBuffer() 的 Promise 抓回实际 buffer。
+globalThis.FileReader = globalThis.FileReader || class {
+  result = null
+  onloadend = null
+  error = null
+  async readAsArrayBuffer(blob) {
+    try {
+      // blob 可能是 Buffer 或 Blob
+      if (blob && typeof blob.arrayBuffer === 'function') this.result = await blob.arrayBuffer()
+      else if (blob instanceof Uint8Array) this.result = blob.buffer
+      else this.result = Buffer.from(blob).buffer
+    }
+    catch (e) {
+      this.error = e
+    }
+    if (this.onloadend) this.onloadend()
+  }
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const OUT = path.resolve(__dirname, '../public/assets/game/character/hero-3d.glb')
+
+/** 建低多边形员工:发光核心 + 锥形长袍 + 头部 + 飘带头发 + 双臂 */
+function buildHero() {
+  const g = new THREE.Group()
+
+  // 材质(低饱和,场景会按频道色 tint 顶部环,模型本体用暖白/冷青)
+  const robeMat = new THREE.MeshStandardMaterial({ color: 0xd8ecec, roughness: 0.7, metalness: 0.1 })
+  const robeDeep = new THREE.MeshStandardMaterial({ color: 0x8fb7c4, roughness: 0.75, metalness: 0.1 })
+  const glowMat = new THREE.MeshStandardMaterial({ color: 0x9fe8d4, emissive: 0x66c9b4, emissiveIntensity: 0.9, roughness: 0.4 })
+  const skinMat = new THREE.MeshStandardMaterial({ color: 0xf0e0d0, roughness: 0.8 })
+  const hairMat = new THREE.MeshStandardMaterial({ color: 0x9adcea, roughness: 0.6 })
+  const trimMat = new THREE.MeshStandardMaterial({ color: 0xbfe8f0, emissive: 0x66c9b4, emissiveIntensity: 0.5, roughness: 0.5 })
+
+  // 长袍(锥形裙摆)
+  const robe = new THREE.Mesh(new THREE.CylinderGeometry(0.18, 0.34, 1.0, 8), robeMat)
+  robe.position.y = 0.5
+  robe.castShadow = true
+  g.add(robe)
+  // 下摆深色带
+  const hem = new THREE.Mesh(new THREE.CylinderGeometry(0.2, 0.36, 0.12, 8), robeDeep)
+  hem.position.y = 0.06
+  g.add(hem)
+  // 胸口发光核心
+  const core = new THREE.Mesh(new THREE.SphereGeometry(0.12, 8, 6), glowMat)
+  core.position.y = 0.86
+  g.add(core)
+  // 肩部胸甲(微光)
+  const chest = new THREE.Mesh(new THREE.CylinderGeometry(0.2, 0.14, 0.18, 8), trimMat)
+  chest.position.y = 0.86
+  chest.castShadow = true
+  g.add(chest)
+  // 头部
+  const head = new THREE.Mesh(new THREE.IcosahedronGeometry(0.16, 1), skinMat)
+  head.position.y = 1.12
+  head.castShadow = true
+  g.add(head)
+  // 后发/马尾
+  const hair = new THREE.Mesh(new THREE.ConeGeometry(0.18, 0.5, 6), hairMat)
+  hair.position.set(0.12, 1.02, -0.02)
+  hair.rotation.z = -0.5
+  g.add(hair)
+  // 双臂(斜向飘带)
+  for (const s of [-1, 1]) {
+    const arm = new THREE.Mesh(new THREE.CylinderGeometry(0.05, 0.08, 0.5, 5), trimMat)
+    arm.position.set(s * 0.28, 0.66, 0.02)
+    arm.rotation.z = s * 0.6
+    g.add(arm)
+  }
+  // 头顶饰品(发光角)
+  for (const s of [-1, 1]) {
+    const horn = new THREE.Mesh(new THREE.ConeGeometry(0.04, 0.2, 5), glowMat)
+    horn.position.set(s * 0.14, 1.26, 0.06)
+    horn.rotation.x = -0.2
+    g.add(horn)
+  }
+  // 脚底落点(指示锚点位置,0 高度)
+  const foot = new THREE.Mesh(new THREE.CircleGeometry(0.16, 16), glowMat)
+  foot.rotation.x = -Math.PI / 2
+  foot.position.y = 0.01
+  g.add(foot)
+
+  return g
+}
+
+const hero = buildHero()
+const exporter = new GLTFExporter()
+process.on('unhandledRejection', (e) => {
+  console.error('unhandledRejection:', e?.message || e)
+  process.exit(1)
+})
+writeGlb(hero, OUT)
+
+/** 数字孪生设备模型:低多边形工业泵(底座+机身+叶轮+管道),与 hero-3d 分开导出 */
+function buildDevice() {
+  const g = new THREE.Group()
+  const metal = new THREE.MeshStandardMaterial({ color: 0x8898a6, roughness: 0.5, metalness: 0.6 })
+  const dark = new THREE.MeshStandardMaterial({ color: 0x4a5a6a, roughness: 0.6, metalness: 0.4 })
+  const teal = new THREE.MeshStandardMaterial({ color: 0x5fb8a8, roughness: 0.5, metalness: 0.3 })
+  const warn = new THREE.MeshStandardMaterial({ color: 0xefb56a, roughness: 0.7 })
+
+  // 底座
+  const base = new THREE.Mesh(new THREE.BoxGeometry(3.2, 0.4, 2.0), metal)
+  base.position.y = 0.2
+  base.castShadow = true
+  g.add(base)
+  // 机身(立式圆柱泵体)
+  const body = new THREE.Mesh(new THREE.CylinderGeometry(0.7, 0.85, 2.2, 10), dark)
+  body.position.y = 1.4
+  body.castShadow = true
+  g.add(body)
+  // 叶轮罩(青色环)
+  const casing = new THREE.Mesh(new THREE.CylinderGeometry(0.95, 0.95, 0.5, 10), teal)
+  casing.position.y = 1.1
+  g.add(casing)
+  // 顶盖
+  const cap = new THREE.Mesh(new THREE.CylinderGeometry(0.55, 0.7, 0.4, 8), warn)
+  cap.position.y = 2.6
+  g.add(cap)
+  // 出水管(横管)
+  const pipeOut = new THREE.Mesh(new THREE.CylinderGeometry(0.32, 0.32, 1.6, 8), metal)
+  pipeOut.rotation.z = Math.PI / 2
+  pipeOut.position.set(1.2, 1.5, 0)
+  g.add(pipeOut)
+  // 进水管(竖管)
+  const pipeIn = new THREE.Mesh(new THREE.CylinderGeometry(0.3, 0.3, 1.4, 8), dark)
+  pipeIn.position.set(-0.9, 0.9, 0)
+  pipeIn.rotation.z = 0.2
+  g.add(pipeIn)
+  // 控制面板(方形示数屏,青色发光)
+  const panel = new THREE.Mesh(new THREE.BoxGeometry(0.5, 0.8, 0.15), teal)
+  panel.position.set(-1.0, 1.9, 0)
+  g.add(panel)
+  return g
+}
+
+const DEVICE_OUT = path.resolve(__dirname, '../public/assets/game/character/device-3d.glb')
+writeGlb(buildDevice(), DEVICE_OUT)
+
+function writeGlb(obj, out) {
+  exporter.parse(
+    obj,
+    (result) => {
+      if (typeof result === 'string') {
+        fs.writeFileSync(out, result, 'utf-8')
+      }
+      else {
+        const buf = Buffer.from(result)
+        fs.mkdirSync(path.dirname(out), { recursive: true })
+        fs.writeFileSync(out, buf)
+      }
+      console.log('GLB written to', out)
+    },
+    (err) => {
+      console.error('export error', err?.message || err)
+      process.exit(1)
+    },
+    { binary: true },
+  )
+}

package/scripts/build-player-sheet.mjs

@@ -0,0 +1,58 @@
+/**
+ * 将 public/assets/game/player/ 下的单帧 PNG 拼合为一张 4 方向 RPG spritesheet。
+ *
+ * 布局(帧尺寸 16x32):
+ *   行: down / left / right / up
+ *   列: idle + 4 帧行走循环
+ *
+ * 输出: public/assets/game/player-sheet.png (80x128)
+ * 用法: node scripts/build-player-sheet.mjs
+ */
+import { PNG } from 'pngjs'
+import { readFileSync, writeFileSync, existsSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const srcDir = resolve(root, 'public/assets/game/player')
+const outFile = resolve(root, 'public/assets/game/player-sheet.png')
+
+// 行序 -> 方向前缀,列序 -> 帧名
+const ROWS = [
+  { dir: 'front', frames: ['misa-front', 'misa-front-walk.000', 'misa-front-walk.001', 'misa-front-walk.002', 'misa-front-walk.003'] },
+  { dir: 'left', frames: ['misa-left', 'misa-left-walk.000', 'misa-left-walk.001', 'misa-left-walk.002', 'misa-left-walk.003'] },
+  { dir: 'right', frames: ['misa-right', 'misa-right-walk.000', 'misa-right-walk.001', 'misa-right-walk.002', 'misa-right-walk.003'] },
+  { dir: 'back', frames: ['misa-back', 'misa-back-walk.000', 'misa-back-walk.001', 'misa-back-walk.002', 'misa-back-walk.003'] },
+]
+
+const FW = 16
+const FH = 32
+const COLS = ROWS[0].frames.length
+const sheet = new PNG({ width: FW * COLS, height: FH * ROWS.length })
+
+for (let r = 0; r < ROWS.length; r++) {
+  for (let c = 0; c < COLS; c++) {
+    const name = ROWS[r].frames[c]
+    const file = resolve(srcDir, `${name}.png`)
+    if (!existsSync(file)) {
+      throw new Error(`缺少帧文件: ${file}`)
+    }
+    const png = PNG.sync.read(readFileSync(file))
+    if (png.width !== FW || png.height !== FH) {
+      throw new Error(`帧尺寸不符 ${name}: ${png.width}x${png.height}`)
+    }
+    for (let y = 0; y < FH; y++) {
+      for (let x = 0; x < FW; x++) {
+        const si = (y * png.width + x) * 4
+        const di = ((r * FH + y) * sheet.width + (c * FW + x)) * 4
+        sheet.data[di] = png.data[si]
+        sheet.data[di + 1] = png.data[si + 1]
+        sheet.data[di + 2] = png.data[si + 2]
+        sheet.data[di + 3] = png.data[si + 3]
+      }
+    }
+  }
+}
+
+writeFileSync(outFile, PNG.sync.write(sheet))
+console.log(`已生成 ${outFile} (${sheet.width}x${sheet.height})`)

package/scripts/build-world-map.mjs

@@ -0,0 +1,188 @@
+/**
+ * 大世界分层视差背景生成器 —— 3200×2400「共鸣城邦」世界。
+ * 产出 public/assets/game/wuwa/world-{far,middle,near}.png(三张分层 + 一张全景合图)。
+ *  - far:    远山天空(最远,移动最慢)
+ *  - middle: 中景城市剪影 + 绿植带
+ *  - near:   近景台地地面(可立足;街道/广场色调)
+ *  - world-map.jpg: 全景合成(供迷你地图缩略图)
+ * 依赖:pngjs。运行:node scripts/build-world-map.mjs
+ */
+import { PNG } from 'pngjs'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const OUT = path.resolve(__dirname, '../public/assets/game/wuwa')
+fs.mkdirSync(OUT, { recursive: true })
+
+const W = 3200
+const H = 2400
+const HORIZON = 1120
+
+const clamp = (v, a, b) => Math.max(a, Math.min(b, v))
+const mix = (c1, c2, t) => [c1[0] + (c2[0] - c1[0]) * t, c1[1] + (c2[1] - c1[1]) * t, c1[2] + (c2[2] - c1[2]) * t]
+const hex = h => [parseInt(h.slice(1, 3), 16), parseInt(h.slice(3, 5), 16), parseInt(h.slice(5, 7), 16)]
+
+class Surf {
+  constructor(w, h) {
+    this.w = w
+    this.h = h
+    this.png = new PNG({ width: w, height: h })
+    this.png.data.fill(0)
+  }
+
+  set(x, y, c, a) {
+    const i = (Math.round(y) * this.w + Math.round(x)) * 4
+    if (i < 0 || i + 3 >= this.png.data.length) return
+    this.png.data[i] = c[0]
+    this.png.data[i + 1] = c[1]
+    this.png.data[i + 2] = c[2]
+    this.png.data[i + 3] = a
+  }
+
+  blend(x, y, c, a) {
+    const i = (Math.round(y) * this.w + Math.round(x)) * 4
+    if (i < 0 || i + 3 >= this.png.data.length) return
+    const da = this.png.data[i + 3] / 255
+    const sa = clamp(a, 0, 1)
+    const outA = sa + da * (1 - sa)
+    if (outA <= 0) return
+    this.png.data[i] = Math.round((c[0] * sa + this.png.data[i] * da * (1 - sa)) / outA)
+    this.png.data[i + 1] = Math.round((c[1] * sa + this.png.data[i + 1] * da * (1 - sa)) / outA)
+    this.png.data[i + 2] = Math.round((c[2] * sa + this.png.data[i + 2] * da * (1 - sa)) / outA)
+    this.png.data[i + 3] = Math.round(outA * 255)
+  }
+
+  vg(y0, y1, cA, cB) {
+    for (let y = y0; y <= y1; y++)
+      for (let x = 0; x < this.w; x++) this.set(x, y, mix(cA, cB, clamp((y - y0) / (y1 - y0 || 1), 0, 1)), 255)
+  }
+
+  radial(cx, cy, r, c, intensity) {
+    for (let y = cy - r; y <= cy + r; y++)
+      for (let x = cx - r; x <= cx + r; x++) {
+        const d = Math.hypot(x - cx, y - cy)
+        const a = Math.pow(clamp(1 - d / r, 0, 1), 1.9) * intensity
+        if (a > 0.004) this.blend(x, y, c, a)
+      }
+  }
+
+  softCircle(cx, cy, r, c, alpha, feather = 0.4) {
+    for (let y = cy - r; y <= cy + r; y++)
+      for (let x = cx - r; x <= cx + r; x++) {
+        const d = Math.hypot(x - cx, y - cy)
+        const edge = (r - d) / (r * feather)
+        if (edge > 0) this.blend(x, y, c, clamp(edge, 0, 1) * alpha)
+      }
+  }
+
+  ridge(yBase, amp, color, alpha, seed, step) {
+    for (let x = step; x <= this.w; x += step) {
+      const h = amp * (0.4 + 0.6 * Math.abs(Math.sin((x + seed) * 0.006 + seed)))
+      for (let y = yBase - h; y < yBase; y++) this.blend(x, y, color, alpha)
+    }
+  }
+
+  fill(color) {
+    for (let i = 0; i < this.png.data.length; i += 4) {
+      this.png.data[i] = color[0]
+      this.png.data[i + 1] = color[1]
+      this.png.data[i + 2] = color[2]
+      this.png.data[i + 3] = 255
+    }
+  }
+
+  save(n) { fs.writeFileSync(path.join(OUT, n), PNG.sync.write(this.png)) }
+}
+
+// ---------- FAR: 远山天空 ----------
+const far = new Surf(W, H)
+far.fill(hex('#141a30'))
+far.vg(0, 500, hex('#181e38'), hex('#5a4a78'))
+far.vg(500, 900, hex('#5a4a78'), hex('#a06a8c'))
+far.vg(900, 1120, hex('#a06a8c'), hex('#f0c398'))
+// 星空
+for (let i = 0; i < 320; i++) far.softCircle((i * 173 + 61) % W, (i * 97 + 23) % 480, 1.4, [235, 235, 245], 0.5 + 0.4 * Math.abs(Math.sin(i * 1.7)))
+// 落日
+far.radial(2360, 1100, 300, hex('#ffd69a'), 0.5)
+far.radial(2360, 1100, 210, hex('#ffe6b8'), 0.55)
+far.radial(2360, 1100, 150, hex('#fff0cf'), 0.8)
+far.softCircle(2360, 1100, 90, hex('#fff4d8'), 0.95)
+// 远山两层
+far.ridge(HORIZON, 320, hex('#585f8c'), 0.9, 11, 10)
+far.ridge(HORIZON, 200, hex('#3f4c6e'), 0.82, 47, 9)
+// 山脚雾
+for (let y = HORIZON - 70; y < HORIZON; y += 2) {
+  const n = 0.05 + 0.05 * Math.abs(Math.sin(y * 0.02))
+  for (let x = 0; x < W; x += 3) far.blend(x, y, hex('#ced2e2'), n)
+}
+far.save('world-far.png')
+
+// ---------- MIDDLE: 中景城市剪影 + 绿植带 ----------
+const mid = new Surf(W, H)
+mid.fill(hex('#0e1524'))
+// 城市剪影(几何楼块,错落)
+for (let i = 0; i < 90; i++) {
+  const bw = 40 + (i * 37) % 90
+  const bh = 120 + (i * 53) % 220
+  const x = (i * 211 + 83) % W
+  const y = HORIZON
+  const c = mix(hex('#2a3350'), hex('#3f4c6e'), (i % 5) / 5)
+  for (let yy = y - bh; yy < y; yy++)
+    for (let xx = x; xx < Math.min(W, x + bw); xx++) mid.blend(xx, yy, c, 0.9)
+}
+// 楼宇窗户微光(随机暖点)
+for (let i = 0; i < 500; i++) {
+  const x = (i * 149 + 31) % W
+  const y = HORIZON - 40 - (i * 89) % 260
+  mid.blend(x, y, [235, 200, 150], 0.5 + 0.5 * Math.abs(Math.sin(i * 0.7)))
+}
+// 绿植带(城市与地面之间)
+for (let y = HORIZON; y < HORIZON + 90; y += 3) {
+  for (let x = 0; x < W; x += 4) {
+    const n = Math.abs(Math.sin(x * 0.01 + y * 0.02))
+    if (n > 0.5) mid.blend(x, y, mix(hex('#3a5a4a'), hex('#2a4a3c'), n), 0.7)
+  }
+}
+mid.save('world-middle.png')
+
+// ---------- NEAR: 近景台地地面(可立足) ----------
+const near = new Surf(W, H)
+near.vg(0, H, hex('#6d9a88'), hex('#3f6a5f'))
+// 台地亮斑
+for (let i = 0; i < 220; i++) {
+  const x = (i * 211 + 97) % W
+  const y = HORIZON + 90 + (i * 37 + 13) % (H - HORIZON - 120)
+  near.softCircle(x, y, 26 + (i * 7) % 30, hex('#a5ccb8'), 0.12)
+}
+// 苔藓/石面
+for (let i = 0; i < 2600; i++) {
+  const x = (i * 149 + 31) % W
+  const y = HORIZON + 80 + (i * 89 + 17) % (H - HORIZON - 100)
+  near.blend(x, y, hex('#4f7d72'), 0.25)
+  if (i % 3 === 0) near.blend(x + 2, y + 1, hex('#93c0aa'), 0.18)
+}
+// 共鸣光点
+for (let i = 0; i < 60; i++) {
+  const x = (i * 163 + 53) % W
+  const y = HORIZON + 120 + (i * 41 + 29) % (H - HORIZON - 180)
+  near.radial(x, y, 22, hex('#8fe8d4'), 0.5)
+  near.softCircle(x, y, 2.4, hex('#d8fff2'), 0.9)
+}
+// 四条环形大道(同心椭圆,暗示街区环绕核心)
+for (let ring = 0; ring < 4; ring++) {
+  const rx = 260 + ring * 260
+  const ry = 180 + ring * 200
+  for (let a = 0; a < 360; a += 0.5) {
+    const rad = a * Math.PI / 180
+    for (let w = -8; w <= 8; w += 2) {
+      const x = W / 2 + Math.cos(rad) * (rx + w)
+      const y = H + 160 + Math.sin(rad) * (ry + w * 0.6)
+      if (x > 0 && x < W && y > 0 && y < H) near.blend(x, y, hex('#b8d0bc'), 0.18)
+    }
+  }
+}
+near.save('world-near.png')
+
+console.log('World parallax layers written to', OUT, '->', ['world-far.png', 'world-middle.png', 'world-near.png'].join(', '))