webwallgl 1.0.0-beta1 → 1.0.0

package/webwallgl.mjs

@@ -995,6 +995,7 @@ function parseScene(sceneJson, project) {
       // anchor 是盒子相对 origin 的锚点（同 image alignment 枚举，外加 "none"）。
       // 本机 563 个文字层：none 237 / 缺省 301 / center 20 —— none 与缺省都按 center 处理
       // （WE 对象缺省对齐就是 center；显式 center 的挂件与时钟层行为一致）。
+      // 2780710296 实验过默认改 top：竖直阶梯对了，但会平移其它壁纸文字相对图元的位置，已回滚。
       textAnchor: typeof o.anchor === "string" && o.anchor !== "none" ? o.anchor : "center",
       textMaxwidth: parseNum(o.maxwidth, 0),
       textMaxrows: parseNum(o.maxrows, 0),
@@ -2425,6 +2426,45 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
         }
       }
     }
+    {
+      const inVecN = /* @__PURE__ */ new Map();
+      const declRe = /^\s*in\s+(?:highp|mediump|lowp\s+)?(vec[34])\s+([A-Za-z_]\w*)\s*;/gm;
+      let dm;
+      while ((dm = declRe.exec(code)) !== null) inVecN.set(dm[2], Number(dm[1].slice(3)));
+      const localVecN = new Map(inVecN);
+      const locRe = /\b(vec[34])\s+([A-Za-z_]\w*)\s*[=;]/g;
+      while ((dm = locRe.exec(code)) !== null) {
+        if (!localVecN.has(dm[2])) localVecN.set(dm[2], Number(dm[1].slice(3)));
+      }
+      if (localVecN.size > 0) {
+        const swizzleUvArg = (arg) => {
+          const t = arg.trim();
+          if (!t) return arg;
+          const bare = /^([A-Za-z_]\w*)$/.exec(t);
+          if (bare && localVecN.has(bare[1])) return bare[1] + ".xy";
+          const bin = /^([A-Za-z_]\w*)(\s*[+\-].+)$/.exec(t);
+          if (bin && localVecN.has(bin[1])) return "(" + bin[1] + ".xy" + bin[2] + ")";
+          return arg;
+        };
+        for (const fn of ["textureLod", "texture"]) {
+          code = rewriteCall(code, fn, (inner) => {
+            const args = splitArgs(inner);
+            if (args.length >= 2) args[1] = swizzleUvArg(args[1]);
+            return fn + "(" + args.join(", ") + ")";
+          });
+        }
+      }
+      if (inVecN.size > 0) {
+        code = code.split("\n").map((line) => {
+          if (!/\bvec2\s+[A-Za-z_]\w*\s*=/.test(line)) return line;
+          let out = line;
+          for (const name of inVecN.keys()) {
+            out = out.replace(new RegExp("\\b" + name + "\\b(?!\\s*[.\\w])", "g"), name + ".xy");
+          }
+          return out;
+        }).join("\n");
+      }
+    }
     const written = /* @__PURE__ */ new Set();
     const inNames = /* @__PURE__ */ new Set();
     {
@@ -2720,7 +2760,8 @@ function compile(gl, type, src) {
   return s;
 }
 function parseVec3Local(s) {
-  const p = String(s).trim().split(/\s+/).map(Number);
+  if (s !== null && typeof s === "object" && "value" in s) s = s.value;
+  const p = String(s ?? "").trim().split(/\s+/).map(Number);
   return [p[0] || 0, p[1] || 0, p[2] || 0];
 }
 function makeTexture(gl, rgba, width, height, bitmap = null) {
@@ -3269,7 +3310,11 @@ function createRenderer(canvas, opts = {}) {
       }
     }
     const key = shaderName + "|" + JSON.stringify(effectiveCombos);
-    if (progCache.has(key)) return progCache.get(key);
+    if (progCache.has(key)) {
+      const hit = progCache.get(key);
+      if (hit === null) throw new Error("shader=" + shaderName + " 编译失败（已缓存）");
+      return hit;
+    }
     for (let attempt = 0; attempt < 4; attempt++) {
       const missing = /* @__PURE__ */ new Set();
       const resolver = (file) => {
@@ -3284,6 +3329,7 @@ function createRenderer(canvas, opts = {}) {
         try {
           prog = linkProgram(gl, vertGlsl, fragGlsl);
         } catch (e) {
+          progCache.set(key, null);
           throw new Error("shader=" + shaderName + " " + (e && e.message));
         }
         const uni = /* @__PURE__ */ new Map();
@@ -4477,7 +4523,10 @@ function createRenderer(canvas, opts = {}) {
       try {
         progEntry = await getEffectProgram(mp.shader, combos, mergedTex);
       } catch (e) {
-        console.warn("[we-scene] 跳过效果（pass 编译失败）:", mp.shader, e && e.message || e);
+        const msg = e && e.message || String(e);
+        if (!/已缓存/.test(msg)) {
+          console.warn("[we-scene] 跳过效果（pass 编译失败）:", mp.shader, msg);
+        }
         failedEffects.add(eff2);
         continue;
       }
@@ -4827,6 +4876,7 @@ layout(location=1) in vec3 a_pos;         // 实例中心（投影空间世界
 layout(location=2) in vec2 a_sizeRot;     // x=size(像素) y=rot(弧度)
 layout(location=3) in vec4 a_color;       // rgb + alpha
 layout(location=4) in vec3 a_stretchFrame; // xy=非等比拉伸 z=帧序号
+layout(location=5) in vec2 a_vrange;      // 段两端沿贴图 v 的取值（rope 连线用；普通精灵 0..1）
 uniform mat4 u_mvp;
 // 序列帧 uv 变换表（TEXS 帧矩形归一化后的 offset/scale），最多 128 帧
 // （matrix spritesheet 72 有 71 帧，旧上限 64 会丢末尾字符）
@@ -4844,7 +4894,8 @@ void main(){
   gl_Position = u_mvp * vec4(a_pos.xy + rotated, a_pos.z, 1.0);
   // quad 角 → 贴图 uv。世界 y 已翻转到投影空间（y 向下），故 quad 的 +y 角
   // 对应屏幕上方，应采样纹理顶行 v=1（与 renderer.js 的 layerQuadVerts 同约定）。
-  vec2 uv = a_corner + 0.5;
+  // a_vrange 让 rope 段两端各取自己的 v（沿绳连续渐变）；普通精灵是 (0,1) 恒等。
+  vec2 uv = vec2(a_corner.x + 0.5, mix(a_vrange.x, a_vrange.y, a_corner.y + 0.5));
   if (u_frameCount > 0) {
     // 帧矩形以左上为原点（TEXS 是 top-down 像素坐标），故先把 v 翻成 top-down
     int fi = int(a_stretchFrame.z);
@@ -4918,7 +4969,7 @@ void main(){
   gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 8, 0);
   gl.vertexAttribDivisor(0, 0);
   gl.bindBuffer(gl.ARRAY_BUFFER, vbuf);
-  const S = 48;
+  const S = 56;
   gl.enableVertexAttribArray(1);
   gl.vertexAttribPointer(1, 3, gl.FLOAT, false, S, 0);
   gl.vertexAttribDivisor(1, 1);
@@ -4931,6 +4982,9 @@ void main(){
   gl.enableVertexAttribArray(4);
   gl.vertexAttribPointer(4, 3, gl.FLOAT, false, S, 36);
   gl.vertexAttribDivisor(4, 1);
+  gl.enableVertexAttribArray(5);
+  gl.vertexAttribPointer(5, 2, gl.FLOAT, false, S, 48);
+  gl.vertexAttribDivisor(5, 1);
   gl.bindVertexArray(null);
   return {
     prog: {
@@ -4982,6 +5036,20 @@ function spriteTrailRotation(dx, dy) {
 function particleInstanceSegs(trailCfg, trailSegments) {
   return trailCfg && trailCfg.kind === "ropetrail" ? Math.max(1, trailSegments || 1) : 1;
 }
+function ropeTrailHistoryCount(cfg) {
+  if (!cfg || cfg.kind !== "ropetrail") return 1;
+  const segs = Math.round(Number(cfg.segments) || 0);
+  if (segs >= 2) return Math.min(32, segs);
+  return 8;
+}
+function ropeTrailDuration(cfg) {
+  if (!cfg || cfg.kind !== "ropetrail") return 0;
+  const L = Number(cfg.length);
+  return Number.isFinite(L) && L > 0 ? L : 0.2;
+}
+function ropeParticleV(p) {
+  return p.life > 0 ? p.age / p.life : 0;
+}
 class Particle {
   constructor() {
     this.alive = false;
@@ -5010,6 +5078,8 @@ class Particle {
     this.turbSpeed = 0;
     this.turbPhase = 0;
     this.trail = null;
+    this.trailClock = 0;
+    this.seq = 0;
   }
 }
 class ParticleSystem {
@@ -5070,6 +5140,9 @@ class ParticleSystem {
     this._followParent = null;
     this._followMode = null;
     this._followOffset = [0, 0, 0];
+    this.ropeRenderer = null;
+    this._seq = 0;
+    this._ropeOrder = [];
     this._ov = {};
     this._applyOverride();
     this.startTime = Math.max(0, Math.min(30, num(this.model.starttime, 0)));
@@ -5346,24 +5419,34 @@ class ParticleSystem {
       const kind = r && r.name || "sprite";
       return {
         kind,
-        length: num(r && r.length, kind === "spritetrail" ? 0.1 : 0),
+        length: num(r && r.length, kind === "spritetrail" ? 0.1 : kind === "ropetrail" ? 0.2 : 0),
         maxLength: num(r && r.maxlength, 0),
         minLength: num(r && r.minlength, 0),
         subdivision: num(r && r.subdivision, 1),
+        // Rope Trail 段数（官方 `segments`）；与 spritetrail 的 maxlength 无关
+        segments: num(r && r.segments, 0),
         orientation: r && r.orientation || null
       };
     });
     if (omitted && !this.renderers.length) {
-      this.renderers = [{ kind: "sprite", length: 0, maxLength: 0, minLength: 0, subdivision: 1, orientation: null }];
+      this.renderers = [{ kind: "sprite", length: 0, maxLength: 0, minLength: 0, subdivision: 1, segments: 0, orientation: null }];
     }
     const tr = this.renderers.find((r) => r.kind === "spritetrail" || r.kind === "ropetrail");
     this.trailCfg = tr || null;
     this.trailSegments = 1;
+    this.trailDuration = 0;
+    this.trailSampleDt = 0;
     if (tr && tr.kind === "ropetrail") {
-      const segs = Math.max(2, Math.min(16, Math.round(tr.maxLength || tr.subdivision || 6)));
+      const segs = ropeTrailHistoryCount(tr);
       this.trailSegments = segs;
-      for (const p of this.pool) p.trail = new Float32Array(segs * 3);
+      this.trailDuration = ropeTrailDuration(tr);
+      this.trailSampleDt = this.trailDuration / Math.max(1, segs - 1);
+      for (const p of this.pool) {
+        p.trail = new Float32Array(segs * 3);
+        p.trailClock = 0;
+      }
     }
+    this.ropeRenderer = this.renderers.find((r) => r.kind === "rope") || null;
   }
   setModel(model) {
     this.model = model;
@@ -5494,6 +5577,7 @@ class ParticleSystem {
     p.rotVel = 0;
     p.vx = p.vy = p.vz = 0;
     p.frame = 0;
+    p.seq = this._seq++;
     const o = em.origin;
     if (em.kind === "box") {
       const d = em.distanceMax || [0, 0, 0];
@@ -5640,6 +5724,7 @@ class ParticleSystem {
         p.trail[i + 1] = p.y;
         p.trail[i + 2] = p.z;
       }
+      p.trailClock = 0;
     }
   }
   // ---------- 每粒子更新 ----------
@@ -5790,10 +5875,20 @@ class ParticleSystem {
     }
     if (p.trail) {
       const tr = p.trail;
-      for (let i = tr.length - 3; i >= 3; i -= 3) {
-        tr[i] = tr[i - 3];
-        tr[i + 1] = tr[i - 2];
-        tr[i + 2] = tr[i - 1];
+      const step = this.trailSampleDt;
+      if (step > 0) {
+        p.trailClock = (p.trailClock || 0) + dt;
+        let shifts = 0;
+        const cap = this.trailSegments || 8;
+        while (p.trailClock >= step && shifts < cap) {
+          p.trailClock -= step;
+          shifts++;
+          for (let i = tr.length - 3; i >= 3; i -= 3) {
+            tr[i] = tr[i - 3];
+            tr[i + 1] = tr[i - 2];
+            tr[i + 2] = tr[i - 1];
+          }
+        }
       }
       tr[0] = p.x;
       tr[1] = p.y;
@@ -5888,13 +5983,22 @@ class ParticleSystem {
     if (!this._prog) this._buildProgram(gl);
     const trail = this.trailCfg && this.trailCfg.kind === "ropetrail" ? this.trailCfg : null;
     const spriteTrail = this.trailCfg && this.trailCfg.kind === "spritetrail" ? this.trailCfg : null;
+    const rope = this.ropeRenderer;
     const segs = particleInstanceSegs(this.trailCfg, this.trailSegments);
-    const STRIDE = 12;
+    const STRIDE = 14;
     const pool = this.pool;
+    let order = null;
+    if (rope) {
+      order = this._ropeOrder;
+      order.length = 0;
+      for (let i = 0; i < pool.length; i++) if (pool[i].alive) order.push(pool[i]);
+      order.sort((a, b) => a.seq - b.seq);
+    }
     let live = 0;
-    for (let i = 0; i < pool.length; i++) if (pool[i].alive) live++;
-    if (live === 0) return;
-    const instCount = live * segs;
+    if (order) live = order.length;
+    else for (let i = 0; i < pool.length; i++) if (pool[i].alive) live++;
+    if (live === 0 || rope && live < 2) return;
+    const instCount = rope ? live - 1 : live * segs;
     const need = instCount * STRIDE;
     if (!this._data || this._data.length < need) this._data = new Float32Array(Math.max(need, 1024));
     const data = this._data;
@@ -5914,7 +6018,34 @@ class ParticleSystem {
       const py = ly * sy;
       return [ox + px * cos - py * sin, projH - (oy + px * sin + py * cos)];
     };
-    for (let i = 0; i < pool.length; i++) {
+    if (rope) {
+      for (let i = 0; i + 1 < live; i++) {
+        const a = order[i];
+        const b = order[i + 1];
+        const wa = toWorld(a.x, a.y);
+        const wb = toWorld(b.x, b.y);
+        const dx = wb[0] - wa[0];
+        const dy = wb[1] - wa[1];
+        const dist = Math.hypot(dx, dy);
+        const width2 = (Math.abs(a.size) + Math.abs(b.size)) * 0.5 * sysScale;
+        if (!(width2 > 0)) continue;
+        data[k++] = (wa[0] + wb[0]) * 0.5;
+        data[k++] = (wa[1] + wb[1]) * 0.5;
+        data[k++] = 0;
+        data[k++] = width2;
+        data[k++] = Math.atan2(-dx, dy);
+        data[k++] = (a.r + b.r) * 0.5 * bright;
+        data[k++] = (a.g + b.g) * 0.5 * bright;
+        data[k++] = (a.b + b.b) * 0.5 * bright;
+        data[k++] = (a.alpha + b.alpha) * 0.5;
+        data[k++] = 1;
+        data[k++] = dist / width2;
+        data[k++] = 0;
+        data[k++] = ropeParticleV(a);
+        data[k++] = ropeParticleV(b);
+      }
+    }
+    for (let i = 0; i < pool.length && !rope; i++) {
       const p = pool[i];
       if (!p.alive) continue;
       for (let s = 0; s < segs; s++) {
@@ -5922,18 +6053,53 @@ class ParticleSystem {
         let ly = p.y;
         let segAlpha = 1;
         let segSize = 1;
+        let rot = p.rot;
+        let instStretchX = stretchX;
+        let instStretchY = stretchY;
+        let wx;
+        let wy;
         if (trail && p.trail) {
           lx = p.trail[s * 3];
           ly = p.trail[s * 3 + 1];
           const t = segs > 1 ? s / (segs - 1) : 0;
           segAlpha = 1 - t;
           segSize = 1 - t * 0.55;
+          let tdx = 0;
+          let tdy = 0;
+          if (s + 1 < segs) {
+            tdx = p.trail[s * 3] - p.trail[(s + 1) * 3];
+            tdy = p.trail[s * 3 + 1] - p.trail[(s + 1) * 3 + 1];
+          } else if (s > 0) {
+            tdx = p.trail[(s - 1) * 3] - p.trail[s * 3];
+            tdy = p.trail[(s - 1) * 3 + 1] - p.trail[s * 3 + 1];
+          } else {
+            tdx = p.vx;
+            tdy = p.vy;
+          }
+          const w0 = toWorld(lx, ly);
+          const w1 = toWorld(lx - tdx, ly - tdy);
+          const dx = w0[0] - w1[0];
+          const dy = w0[1] - w1[1];
+          const dist = Math.hypot(dx, dy);
+          const base = Math.max(1e-3, Math.abs(p.size) * sysScale * segSize);
+          if (dist > 1e-3) {
+            rot = spriteTrailRotation(dx, dy);
+            wx = (w0[0] + w1[0]) * 0.5;
+            wy = (w0[1] + w1[1]) * 0.5;
+            instStretchY = Math.max(stretchY, dist / base);
+          } else {
+            wx = w0[0];
+            wy = w0[1];
+          }
+        } else {
+          const w = toWorld(lx, ly);
+          wx = w[0];
+          wy = w[1];
         }
-        const w = toWorld(lx, ly);
-        let rot = p.rot;
-        let instStretchX = stretchX;
-        let instStretchY = stretchY;
         if (spriteTrail) {
+          const w = toWorld(p.x, p.y);
+          wx = w[0];
+          wy = w[1];
           const w1 = toWorld(p.x + p.vx, p.y + p.vy);
           rot = spriteTrailRotation(w1[0] - w[0], w1[1] - w[1]);
           const factor = spriteTrailLengthFactor(
@@ -5944,8 +6110,8 @@ class ParticleSystem {
           );
           instStretchY = stretchY * factor;
         }
-        data[k++] = w[0];
-        data[k++] = w[1];
+        data[k++] = wx;
+        data[k++] = wy;
         data[k++] = 0;
         data[k++] = Math.abs(p.size) * sysScale * segSize;
         data[k++] = rot;
@@ -5956,6 +6122,8 @@ class ParticleSystem {
         data[k++] = instStretchX;
         data[k++] = instStretchY;
         data[k++] = p.frame;
+        data[k++] = 0;
+        data[k++] = 1;
       }
     }
     const prog = this._prog;
@@ -6089,6 +6257,9 @@ const particlesMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.define
   particleInstanceSegs,
   particlePassRefract,
   rgbaIsBlankWhite,
+  ropeParticleV,
+  ropeTrailDuration,
+  ropeTrailHistoryCount,
   spriteTrailLengthFactor,
   spriteTrailRotation
 }, Symbol.toStringTag, { value: "Module" }));
@@ -6194,7 +6365,7 @@ function spikyStar(size, points, len, sharp, coreR) {
   return { width: size, height: size, rgba };
 }
 function beam(w, h, coreWidth, fadeBoth, peak) {
-  const pk = peak === void 0 ? 0.55 : peak;
+  const pk = 0.55;
   const rgba = new Uint8Array(w * h * 4);
   for (let y = 0; y < h; y++) {
     const ty = y / (h - 1);
@@ -6207,6 +6378,41 @@ function beam(w, h, coreWidth, fadeBoth, peak) {
   }
   return { width: w, height: h, rgba };
 }
+const RAIN_FRAMES = 4;
+function rainStreak(w, h, tiltDeg, corePx, peak) {
+  const pk = peak === void 0 ? 0.85 : peak;
+  const rgba = new Uint8Array(w * h * 4);
+  const fh = h / RAIN_FRAMES;
+  const rng = mulberry32$1(335009);
+  const tilt = Math.tan(tiltDeg * Math.PI / 180);
+  const cx = w / 2;
+  for (let f = 0; f < RAIN_FRAMES; f++) {
+    const peakF = pk * (0.8 + rng() * 0.35);
+    const coreF = corePx * (0.85 + rng() * 0.5);
+    const ph = (rng() - 0.5) * w * 0.12;
+    for (let y = 0; y < fh; y++) {
+      const ty = y / (fh - 1);
+      const lineX = cx + ph + (fh - 1) * tilt / 2 - (fh - 1) * tilt * ty;
+      const vy = gauss(ty - 0.5, 0.27);
+      for (let x = 0; x < w; x++) {
+        const d = Math.abs(x + 0.5 - lineX);
+        const g = Math.exp(-(d * d) / (coreF * coreF));
+        const a = g * vy * peakF;
+        if (a < 4e-3) continue;
+        writeWhite(rgba, ((f * fh + y) * w + x) * 4, a);
+      }
+    }
+  }
+  return { width: w, height: h, rgba };
+}
+function builtinParticleFrames(name) {
+  if (name === "particle/nature/rain1" || name === "particle/nature/rain2") {
+    const list = [];
+    for (let i = 0; i < RAIN_FRAMES; i++) list.push({ ou: 0, ov: i / RAIN_FRAMES, su: 1, sv: 1 / RAIN_FRAMES });
+    return list;
+  }
+  return null;
+}
 function ring(size, radius, thickness) {
   const rgba = new Uint8Array(size * size * 4);
   const half = size / 2;
@@ -6887,8 +7093,8 @@ const BUILDERS = {
   // 水滴（原生 64×256 → 128×512）：竖长泪滴
   "particle/drop": () => teardrop(128, 512),
   // 雨丝（原生 64×256 → 128×512）：细长条，两端渐隐
-  "particle/nature/rain1": () => beam(128, 512, 0.16, true, 0.6),
-  "particle/nature/rain2": () => beam(128, 512, 0.24, true, 0.55),
+  "particle/nature/rain1": () => rainStreak(128, 512, 10, 1, 0.78),
+  "particle/nature/rain2": () => rainStreak(128, 512, 10, 1.6, 0.66),
   // 雨滴 sheet（原生 128×256 → 256×512，2×4 格）：每格一颗上圆下尖小水滴
   "particle/water/rain_drops_sheet": () => dropSheet(256, 512, 2, 4),
   // 雾（原生 256 → 512）：絮状 fBm，弱遮罩铺满；三张不同尺度/种子
@@ -7006,6 +7212,7 @@ function isBuiltinParticleTextureName(name) {
 const particleTexMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   buildBuiltinParticleTexture,
+  builtinParticleFrames,
   isBuiltinParticleTextureName,
   listBuiltinParticleTextureNames,
   particleNormalNameForAlbedo,
@@ -7623,6 +7830,10 @@ function applyAttachmentBindOrigins(layers) {
       c.origin[0] += d[0];
       c.origin[1] += d[1];
     }
+    layer.parallaxDepth = parent.parallaxDepth ? parent.parallaxDepth.slice() : null;
+    for (const c of desc) {
+      c.parallaxDepth = layer.parallaxDepth ? layer.parallaxDepth.slice() : null;
+    }
     follows.push({
       layer,
       parent,
@@ -7930,10 +8141,12 @@ function layoutText(content, opts, measure) {
   const totalH = lines.length * lineHeight;
   const halign = opts.halign || "center";
   const valign = opts.valign || "center";
-  const y0 = valign === "top" ? pad : valign === "bottom" ? Math.max(pad, boxH - pad - totalH) : (boxH - totalH) / 2;
+  const midX = boxW / 2;
+  const midY = boxH / 2;
+  const y0 = valign === "top" ? midY : valign === "bottom" ? midY - totalH : (boxH - totalH) / 2;
   const out = lines.map((text, i) => {
     const w = widths[i];
-    const x = halign === "left" ? pad : halign === "right" ? Math.max(pad, boxW - pad - w) : (boxW - w) / 2;
+    const x = halign === "left" ? midX : halign === "right" ? midX - w : (boxW - w) / 2;
     return { text, width: w, x, y: y0 + i * lineHeight };
   });
   return { lines: out, lineHeight, totalH, truncated, boxW, boxH };
@@ -8308,6 +8521,11 @@ function propValue(v) {
   if (v !== null && typeof v === "object" && "value" in v) return v.value;
   return v;
 }
+function engineCanvasSize(cs) {
+  const src = cs || { width: 1920, height: 1080 };
+  if (src.x !== void 0 && src.y !== void 0) return src;
+  return { x: src.width, y: src.height, width: src.width, height: src.height };
+}
 function evalTextScript(script, scriptprops, opts = {}) {
   if (typeof script !== "string" || script.length === 0) return null;
   const body = scriptToFunctionBody(script);
@@ -8349,7 +8567,7 @@ function evalTextScript(script, scriptprops, opts = {}) {
     },
     frametime: 1 / 60,
     runtime: 0,
-    canvasSize: opts.canvasSize || { width: 1920, height: 1080 },
+    canvasSize: engineCanvasSize(opts.canvasSize),
     // [we-scene patch] engine.screenResolution（全库 10 处 / 2 壁纸）：
     // 屏幕**像素**尺寸，脚本用它把 input.cursorScreenPosition 归一化
     // （3791967416 除它得 [0,1]；3509243656 减半屏得 [-1,1]）。
@@ -9299,7 +9517,7 @@ function evalObjectScript(script, scriptprops, opts = {}) {
     },
     frametime: 1 / 60,
     runtime: 0,
-    canvasSize: opts.canvasSize || { width: 1920, height: 1080 },
+    canvasSize: engineCanvasSize(opts.canvasSize),
     screenResolution: opts.screenResolution || { x: 1920, y: 1080 },
     timeOfDay: typeof opts.timeOfDay === "number" ? opts.timeOfDay : 0,
     userProperties: opts.userProperties || {},
@@ -9734,7 +9952,7 @@ function createEngineTimers(host = {}, opts = {}) {
     cancel.handle = state.handle;
     return cancel;
   }
-  function setInterval(fn, ms) {
+  function setInterval2(fn, ms) {
     if (typeof fn !== "function") return makeCancel({ fired: true, handle: null }, null);
     const state = { fired: false, handle: null };
     const cancel = makeCancel(state, clearI);
@@ -9750,7 +9968,7 @@ function createEngineTimers(host = {}, opts = {}) {
     }
     if (clearT && h != null) clearT(h);
   }
-  function clearInterval(h) {
+  function clearInterval2(h) {
     if (typeof h === "function") {
       h();
       return;
@@ -9763,9 +9981,9 @@ function createEngineTimers(host = {}, opts = {}) {
   }
   return {
     setTimeout,
-    setInterval,
+    setInterval: setInterval2,
     clearTimeout,
-    clearInterval,
+    clearInterval: clearInterval2,
     dispose,
     /** 测试与诊断用：尚未触发且未取消的定时器数 */
     pendingCount: () => pending.size
@@ -9815,11 +10033,11 @@ function createSimulatedAudio(seed = 20260830) {
   const patterns = makePatterns(rand2);
   const phases = new Float32Array(64);
   for (let i = 0; i < 64; i++) phases[i] = rand2() * 64;
-  const BANDS = 64;
-  const rawL = new Float32Array(BANDS);
-  const rawR = new Float32Array(BANDS);
-  const left64 = new Float32Array(BANDS);
-  const right64 = new Float32Array(BANDS);
+  const BANDS2 = 64;
+  const rawL = new Float32Array(BANDS2);
+  const rawR = new Float32Array(BANDS2);
+  const left64 = new Float32Array(BANDS2);
+  const right64 = new Float32Array(BANDS2);
   const left32 = new Float32Array(32);
   const right32 = new Float32Array(32);
   const left16 = new Float32Array(16);
@@ -9836,7 +10054,7 @@ function createSimulatedAudio(seed = 20260830) {
     /** 渲染器诊断：当前是否处于「静音段」 */
     silent: false
   };
-  function downsample(dst, src) {
+  function downsample2(dst, src) {
     const g = src.length / dst.length;
     for (let i = 0; i < dst.length; i++) {
       let s = 0;
@@ -9863,8 +10081,8 @@ function createSimulatedAudio(seed = 20260830) {
     const hatV = patterns.hat[i16] * hitEnv * drumGate;
     const riser = buildup > 0 ? Math.pow(buildup, 3) * (0.4 + 0.6 * Math.abs(vnoise(step * 2, 7))) : 0;
     let levelSum = 0;
-    for (let i = 0; i < BANDS; i++) {
-      const fq = i / BANDS;
+    for (let i = 0; i < BANDS2; i++) {
+      const fq = i / BANDS2;
       const tilt = Math.pow(1 - fq * 0.85, 1.6);
       let v = midGate * (0.5 + 0.3 * vnoise(beat * 0.5 + phases[i] * 0.05, i % 8));
       v *= 0.35 + 0.65 * fq;
@@ -9888,10 +10106,10 @@ function createSimulatedAudio(seed = 20260830) {
     }
     left64.set(rawL);
     right64.set(rawR);
-    downsample(left32, rawL);
-    downsample(right32, rawR);
-    downsample(left16, rawL);
-    downsample(right16, rawR);
+    downsample2(left32, rawL);
+    downsample2(right32, rawR);
+    downsample2(left16, rawL);
+    downsample2(right16, rawR);
     snapshot.level = Math.min(1, levelSum / (48 * 1.2));
     snapshot.silent = silent;
     return snapshot;
@@ -9900,7 +10118,7 @@ function createSimulatedAudio(seed = 20260830) {
     update,
     snapshot,
     /** 频段基数 */
-    bands: BANDS
+    bands: BANDS2
   };
 }
 function fillAudioBuffers(views, snapshot) {
@@ -9922,7 +10140,7 @@ function fillOne(dst, src64) {
     dst[i] = s / (i1 - i0);
   }
 }
-const MEDIA_PLAYBACK = { STOPPED: 0, PLAYING: 1, PAUSED: 2 };
+const MEDIA_PLAYBACK$1 = { STOPPED: 0, PLAYING: 1, PAUSED: 2 };
 class MediaVec3 {
   constructor(x, y, z) {
     this.x = Number(x) || 0;
@@ -10047,7 +10265,7 @@ function createSimulatedMedia(seed = 20260901) {
   const cycle = tracks.reduce((s, t) => s + t.duration + GAP, 0);
   const snapshot = {
     hasMedia: false,
-    state: MEDIA_PLAYBACK.STOPPED,
+    state: MEDIA_PLAYBACK$1.STOPPED,
     title: "",
     artist: "",
     album: "",
@@ -10114,10 +10332,10 @@ function createSimulatedMedia(seed = 20260901) {
     snapshot.duration = tr.duration;
     snapshot.position = pos;
     const frac = tr.duration > 0 ? pos / tr.duration : 0;
-    if (held) snapshot.state = MEDIA_PLAYBACK.PAUSED;
-    else if (inGap) snapshot.state = MEDIA_PLAYBACK.STOPPED;
-    else if (frac > 0.7 && frac < 0.76) snapshot.state = MEDIA_PLAYBACK.PAUSED;
-    else snapshot.state = MEDIA_PLAYBACK.PLAYING;
+    if (held) snapshot.state = MEDIA_PLAYBACK$1.PAUSED;
+    else if (inGap) snapshot.state = MEDIA_PLAYBACK$1.STOPPED;
+    else if (frac > 0.7 && frac < 0.76) snapshot.state = MEDIA_PLAYBACK$1.PAUSED;
+    else snapshot.state = MEDIA_PLAYBACK$1.PLAYING;
     snapshot.hasThumbnail = !inGap;
     const c = tr.colors;
     snapshot.primaryColor = new MediaVec3(c.primary[0], c.primary[1], c.primary[2]);
@@ -10156,7 +10374,7 @@ function createSimulatedMedia(seed = 20260901) {
     if (held) return snapshot;
     holdT = lastWall + seekOffset;
     held = true;
-    snapshot.state = MEDIA_PLAYBACK.PAUSED;
+    snapshot.state = MEDIA_PLAYBACK$1.PAUSED;
     return snapshot;
   }
   function play() {
@@ -10173,7 +10391,7 @@ function createSimulatedMedia(seed = 20260901) {
     snapshot,
     tracks,
     cycle,
-    MEDIA_PLAYBACK,
+    MEDIA_PLAYBACK: MEDIA_PLAYBACK$1,
     skipNext,
     skipPrevious,
     play,
@@ -10281,7 +10499,7 @@ function cloneMediaSnapshot(s) {
 }
 const mediaMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  MEDIA_PLAYBACK,
+  MEDIA_PLAYBACK: MEDIA_PLAYBACK$1,
   cloneMediaSnapshot,
   createSimulatedMedia,
   diffMediaEvents,
@@ -11145,6 +11363,382 @@ const SKIP_TEXT = false;
 const SKIP_PARTICLES = false;
 const SKIP_SCENE_EFFECTS = false;
 const TEXT_EM_SCALE = 4;
+const BANDS = 64;
+const MEDIA_PLAYBACK = { STOPPED: 0 };
+function zeroBands() {
+  return {
+    left64: new Float32Array(BANDS),
+    right64: new Float32Array(BANDS),
+    left32: new Float32Array(32),
+    right32: new Float32Array(32),
+    left16: new Float32Array(16),
+    right16: new Float32Array(16),
+    level: 0,
+    silent: true
+  };
+}
+function downsample(dst, src64) {
+  const g = src64.length / dst.length;
+  for (let i = 0; i < dst.length; i++) {
+    let s = 0;
+    const i0 = Math.floor(i * g);
+    const i1 = Math.max(i0 + 1, Math.floor((i + 1) * g));
+    for (let j = i0; j < i1; j++) s += src64[j];
+    dst[i] = s / (i1 - i0);
+  }
+}
+function fillFromByteFreq(out, bytes, sampleRate) {
+  const n = bytes.length;
+  const nyquist = sampleRate * 0.5;
+  const fMin = 20;
+  const fMax = Math.min(2e4, nyquist);
+  let levelSum = 0;
+  for (let b = 0; b < BANDS; b++) {
+    const t0 = b / BANDS;
+    const t1 = (b + 1) / BANDS;
+    const loHz = fMin * Math.pow(fMax / fMin, t0);
+    const hiHz = fMin * Math.pow(fMax / fMin, t1);
+    const i0 = Math.max(0, Math.floor(loHz / nyquist * n));
+    const i1 = Math.min(n, Math.max(i0 + 1, Math.ceil(hiHz / nyquist * n)));
+    let s = 0;
+    for (let i = i0; i < i1; i++) s += bytes[i] / 255;
+    const v = Math.min(1, s / (i1 - i0) * 1.35);
+    out.left64[b] = v;
+    out.right64[b] = v;
+    if (b < 48) levelSum += v;
+  }
+  downsample(out.left32, out.left64);
+  downsample(out.right32, out.right64);
+  downsample(out.left16, out.left64);
+  downsample(out.right16, out.right64);
+  out.level = Math.min(1, levelSum / (48 * 1.2));
+  out.silent = out.level < 0.02;
+}
+function hashHue(s) {
+  let h = 2166136261;
+  for (let i = 0; i < s.length; i++) {
+    h ^= s.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return (h >>> 0) % 360;
+}
+function hslToRgb(h, sat, light) {
+  const s = sat / 100;
+  const l = light / 100;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const hp = h / 60;
+  const x = c * (1 - Math.abs(hp % 2 - 1));
+  let r = 0, g = 0, b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];
+  else if (hp < 2) [r, g, b] = [x, c, 0];
+  else if (hp < 3) [r, g, b] = [0, c, x];
+  else if (hp < 4) [r, g, b] = [0, x, c];
+  else if (hp < 5) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+  const m = l - c / 2;
+  return [r + m, g + m, b + m];
+}
+function applyPalette(snap, seed) {
+  const hue = hashHue(seed || "empty");
+  const [pr, pg, pb] = hslToRgb(hue, 72, 48);
+  const [sr, sg, sb] = hslToRgb((hue + 40) % 360, 55, 28);
+  const [tr, tg, tb] = hslToRgb((hue + 20) % 360, 70, 72);
+  snap.primaryColor = media.mediaVec3(pr, pg, pb);
+  snap.secondaryColor = media.mediaVec3(sr, sg, sb);
+  snap.tertiaryColor = media.mediaVec3(tr, tg, tb);
+  snap.textColor = media.mediaVec3(0.98, 0.98, 1);
+  snap.highContrastColor = media.mediaVec3(1, 1, 1);
+  snap.hasThumbnail = !!seed;
+}
+function sampleArtworkPalette(img, w, h) {
+  const c = document.createElement("canvas");
+  c.width = 32;
+  c.height = 32;
+  const ctx = c.getContext("2d", { willReadFrequently: true });
+  if (!ctx) return null;
+  ctx.drawImage(img, 0, 0, w, h, 0, 0, 32, 32);
+  const data = ctx.getImageData(0, 0, 32, 32).data;
+  let r = 0, g = 0, b = 0, n = 0;
+  let br = 0, bg = 0, bb = 0, best = -1;
+  for (let i = 0; i < data.length; i += 4) {
+    const pr = data[i] / 255, pg = data[i + 1] / 255, pb = data[i + 2] / 255;
+    r += pr;
+    g += pg;
+    b += pb;
+    n++;
+    const mx = Math.max(pr, pg, pb), mn = Math.min(pr, pg, pb);
+    const sat = mx - mn;
+    const lum = 0.2126 * pr + 0.7152 * pg + 0.0722 * pb;
+    const score = sat * 1.4 + (lum > 0.15 && lum < 0.85 ? 0.3 : 0);
+    if (score > best) {
+      best = score;
+      br = pr;
+      bg = pg;
+      bb = pb;
+    }
+  }
+  if (!n) return null;
+  const primary = [br, bg, bb];
+  const secondary = [r / n * 0.55, g / n * 0.55, b / n * 0.55];
+  const tertiary = [
+    Math.min(1, primary[0] * 0.45 + 0.55),
+    Math.min(1, primary[1] * 0.45 + 0.55),
+    Math.min(1, primary[2] * 0.45 + 0.55)
+  ];
+  return { primary, secondary, tertiary };
+}
+function rasterizeArtwork(img, srcW, srcH, size = 512) {
+  const c = document.createElement("canvas");
+  c.width = size;
+  c.height = size;
+  const ctx = c.getContext("2d");
+  const scale = Math.max(size / Math.max(1, srcW), size / Math.max(1, srcH));
+  const dw = srcW * scale;
+  const dh = srcH * scale;
+  ctx.fillStyle = "#000";
+  ctx.fillRect(0, 0, size, size);
+  ctx.drawImage(img, (size - dw) / 2, (size - dh) / 2, dw, dh);
+  const id = ctx.getImageData(0, 0, size, size);
+  return { width: size, height: size, rgba: new Uint8Array(id.data) };
+}
+function emptyMediaSnapshot() {
+  return {
+    hasMedia: false,
+    state: MEDIA_PLAYBACK.STOPPED,
+    title: "",
+    artist: "",
+    album: "",
+    albumArtist: "",
+    position: 0,
+    duration: 0,
+    hasThumbnail: false,
+    primaryColor: media.mediaVec3(0, 0, 0),
+    secondaryColor: media.mediaVec3(0, 0, 0),
+    tertiaryColor: media.mediaVec3(0, 0, 0),
+    textColor: media.mediaVec3(1, 1, 1),
+    highContrastColor: media.mediaVec3(1, 1, 1),
+    trackIndex: -1,
+    lyrics: [],
+    lyricLine: "",
+    lyricIndex: -1
+  };
+}
+async function openMicAnalyser() {
+  if (!navigator.mediaDevices?.getUserMedia) return null;
+  try {
+    const stream = await navigator.mediaDevices.getUserMedia({
+      audio: {
+        echoCancellation: false,
+        noiseSuppression: false,
+        autoGainControl: false
+      },
+      video: false
+    });
+    const ctx = new AudioContext();
+    const src = ctx.createMediaStreamSource(stream);
+    const analyser = ctx.createAnalyser();
+    analyser.fftSize = 2048;
+    analyser.smoothingTimeConstant = 0.8;
+    src.connect(analyser);
+    if (ctx.state === "suspended") await ctx.resume().catch(() => {
+    });
+    return { ctx, stream, analyser, buf: new Uint8Array(analyser.frequencyBinCount) };
+  } catch {
+    return null;
+  }
+}
+async function startLiveSystem(opts) {
+  const origin = opts?.origin ?? (typeof location !== "undefined" ? location.origin : "");
+  const onArtwork = opts?.onArtwork;
+  const audioSnap = zeroBands();
+  const mediaSnap = emptyMediaSnapshot();
+  const winSnap = { app: "", title: "", url: "", index: 0 };
+  let audioMode = "off";
+  let mediaMode = "offline";
+  let windowMode = "offline";
+  let trackKey = "";
+  let hasArtwork = false;
+  let lastArtworkKey = "";
+  const mic = await openMicAnalyser();
+  if (mic) audioMode = "mic";
+  else if (!navigator.mediaDevices?.getUserMedia) audioMode = "unavailable";
+  else audioMode = "denied";
+  let es = null;
+  let pollTimer = null;
+  let disposed = false;
+  const requestArtwork = (key, title, artist) => {
+    if (!origin || !onArtwork || !hasArtwork) return;
+    if (lastArtworkKey === key) return;
+    lastArtworkKey = key;
+    onArtwork({
+      url: `${origin}/api/system/artwork?k=${encodeURIComponent(key)}&_=${Date.now()}`,
+      trackKey: key,
+      title,
+      artist
+    });
+  };
+  const applyMediaPayload = (m) => {
+    if (!m || !m.hasMedia) {
+      mediaSnap.hasMedia = false;
+      mediaSnap.state = MEDIA_PLAYBACK.STOPPED;
+      mediaSnap.title = "";
+      mediaSnap.artist = "";
+      mediaSnap.album = "";
+      mediaSnap.albumArtist = "";
+      mediaSnap.position = 0;
+      mediaSnap.duration = 0;
+      mediaSnap.hasThumbnail = false;
+      mediaSnap.trackIndex = -1;
+      mediaMode = m ? "empty" : "offline";
+      trackKey = "";
+      hasArtwork = false;
+      lastArtworkKey = "";
+      return;
+    }
+    mediaMode = "live";
+    mediaSnap.hasMedia = true;
+    mediaSnap.state = Number(m.state) === 2 ? 2 : Number(m.state) === 1 ? 1 : 0;
+    mediaSnap.title = String(m.title ?? "");
+    mediaSnap.artist = String(m.artist ?? "");
+    mediaSnap.album = String(m.album ?? "");
+    mediaSnap.albumArtist = String(m.albumArtist ?? m.artist ?? "");
+    mediaSnap.position = Number(m.position) || 0;
+    mediaSnap.duration = Number(m.duration) || 0;
+    hasArtwork = m.hasArtwork === true;
+    const key = `${mediaSnap.title}|${mediaSnap.artist}|${mediaSnap.album}`;
+    if (key !== trackKey) {
+      trackKey = key;
+      lastArtworkKey = "";
+      mediaSnap.trackIndex = mediaSnap.trackIndex + 1 | 0;
+      applyPalette(mediaSnap, key);
+      requestArtwork(key, mediaSnap.title, mediaSnap.artist);
+    } else {
+      requestArtwork(key, mediaSnap.title, mediaSnap.artist);
+    }
+  };
+  const applyWindowPayload = (w) => {
+    if (!w) {
+      windowMode = "offline";
+      return;
+    }
+    winSnap.app = String(w.app ?? "");
+    winSnap.title = String(w.title ?? "");
+    winSnap.url = String(w.url ?? "");
+    windowMode = winSnap.app || winSnap.title ? "live" : "empty";
+  };
+  const pollOnce = async () => {
+    if (!origin || disposed) return;
+    try {
+      const [mr, wr] = await Promise.all([
+        fetch(`${origin}/api/system/media`, { cache: "no-store" }),
+        fetch(`${origin}/api/system/window`, { cache: "no-store" })
+      ]);
+      if (mr.ok) {
+        const j = await mr.json();
+        applyMediaPayload(j);
+      } else {
+        mediaMode = "offline";
+      }
+      if (wr.ok) {
+        applyWindowPayload(await wr.json());
+      }
+    } catch {
+      mediaMode = mediaMode === "live" ? "live" : "offline";
+      windowMode = windowMode === "live" ? "live" : "offline";
+    }
+  };
+  if (origin) {
+    await pollOnce();
+    pollTimer = setInterval(() => void pollOnce(), 1e3);
+    try {
+      es = new EventSource(`${origin}/api/system/stream`);
+      es.onmessage = (ev) => {
+        if (disposed) return;
+        try {
+          const data = JSON.parse(ev.data);
+          applyMediaPayload(data.media);
+          applyWindowPayload(data.window);
+        } catch {
+        }
+      };
+    } catch {
+    }
+  }
+  const postControl = (action) => {
+    if (!origin || disposed) return;
+    void fetch(`${origin}/api/system/media-control`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ action })
+    }).then(async (r) => {
+      if (!r.ok) return null;
+      return r.json();
+    }).then((j) => {
+      if (j && typeof j === "object") applyMediaPayload(j);
+      void pollOnce();
+    }).catch(() => {
+      void pollOnce();
+    });
+  };
+  return {
+    audio: {
+      snapshot: audioSnap,
+      pump: () => {
+        if (!mic || disposed) {
+          audioSnap.level = 0;
+          audioSnap.silent = true;
+          return;
+        }
+        mic.analyser.getByteFrequencyData(mic.buf);
+        fillFromByteFreq(audioSnap, mic.buf, mic.ctx.sampleRate || 48e3);
+      }
+    },
+    media: {
+      snapshot: mediaSnap,
+      pump: () => {
+      },
+      skipNext: () => postControl("skipNext"),
+      skipPrevious: () => postControl("skipPrevious"),
+      play: () => postControl("play"),
+      pause: () => postControl("pause"),
+      playPause: () => postControl("playPause")
+    },
+    windowTitle: {
+      snapshot: winSnap,
+      pump: () => {
+      }
+    },
+    status: () => ({
+      audio: audioMode,
+      media: mediaMode,
+      window: windowMode,
+      title: mediaSnap.title,
+      artist: mediaSnap.artist,
+      app: winSnap.app,
+      windowTitle: winSnap.title,
+      hasArtwork
+    }),
+    dispose: () => {
+      disposed = true;
+      if (pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+      }
+      try {
+        es?.close();
+      } catch {
+      }
+      es = null;
+      if (mic) {
+        try {
+          mic.stream.getTracks().forEach((t) => t.stop());
+          void mic.ctx.close();
+        } catch {
+        }
+      }
+    }
+  };
+}
 const WE_SHADER_HEADERS = {
   "common.h": `// WE common.h（重建子集，供 we-scene 浏览器渲染）
 #define M_PI 3.14159265359
@@ -11417,10 +12011,18 @@ mat3 squareToQuad(vec2 p0, vec2 p1, vec2 p2, vec2 p3) {
     float d = p1.y - p0.y + g * p1.y;
     float e = p3.y - p0.y + h * p3.y;
     float f = p0.y;
-    // 行向量约定：[u v 1] * M
-    return mat3(a, d, g,
-                b, e, h,
-                c, f, 1.0);
+    // 调用点一律是 mul(vec3(uv,1), inverse(本函数结果))，hlsl2glsl 把它转写成
+    // transpose(xform) * vec3(uv,1)。要让屏幕点 s 得到 texCoord = S⁻¹·s（S 为
+    // Heckbert 正向矩阵 [[a,b,c],[d,e,f],[g,h,1]]，单位方→四边形），必须
+    // xform = inverse(本函数结果) 满足 transpose(xform)·s = S⁻¹·s，
+    // 即本函数返回 S 的**转置**：mat3 列主序构造为 (a,d,g)(b,e,h)(c,f,1) 的转置
+    // = (a,b,c)(d,e,f)(g,h,1)。排布差一个转置，perspective/水波等全部错位——
+    // 3174556087 的音谱柱被贴到窗户侧边竖排（应为贴下窗沿横排）实测确认。
+    // 2026-09-05 数值模拟：旧排布 transpose(S⁻¹)·corner 与正确 S⁻¹·corner 逐项不同，
+    // 可见区塌缩成一条斜带；新排布后中心 (0.5,0.5) → (0.478,0.511) ∈ [0,1]²。
+    return mat3(a, b, c,
+                d, e, f,
+                g, h, 1.0);
 }
 `,
   // WE common_blur.h（重建）。blurNa 的权重不是估算的 —— 壁纸 1444077782 里存着
@@ -11550,6 +12152,66 @@ vec3 DecompressNormal(vec4 tex) {
   "common_vertex.h": `// WE common_vertex.h（重建：空占位，见 headers.ts 注释）
 `
 };
+function sanitizeFontForBrowser(src) {
+  if (!src || src.length < 12) return src;
+  const b0 = src[0], b1 = src[1], b2 = src[2], b3 = src[3];
+  const isTtf = b0 === 0 && b1 === 1 && b2 === 0 && b3 === 0;
+  const isOtto = b0 === 79 && b1 === 84 && b2 === 84 && b3 === 79;
+  if (!isTtf && !isOtto) return src;
+  const out = Uint8Array.from(src);
+  const dv = new DataView(out.buffer, out.byteOffset, out.byteLength);
+  const numTables = dv.getUint16(4);
+  if (numTables <= 0 || 12 + numTables * 16 > out.length) return src;
+  let cmapEntry = -1;
+  let cmapOffset = 0;
+  let cmapLength = 0;
+  for (let i = 0; i < numTables; i++) {
+    const e = 12 + i * 16;
+    const tag = String.fromCharCode(out[e], out[e + 1], out[e + 2], out[e + 3]);
+    if (tag === "cmap") {
+      cmapEntry = e;
+      cmapOffset = dv.getUint32(e + 8);
+      cmapLength = dv.getUint32(e + 12);
+      break;
+    }
+  }
+  if (cmapEntry < 0 || cmapOffset + cmapLength > out.length) return src;
+  let changed = false;
+  const numEnc = dv.getUint16(cmapOffset + 2);
+  for (let i = 0; i < numEnc; i++) {
+    const rec = cmapOffset + 4 + i * 8;
+    const soff = dv.getUint32(rec + 4);
+    const abs = cmapOffset + soff;
+    if (abs + 14 > out.length) continue;
+    if (dv.getUint16(abs) !== 4) continue;
+    const segCountX2 = dv.getUint16(abs + 6);
+    const segCount = segCountX2 >>> 1;
+    if (segCount < 1) continue;
+    const expSearch = 2 * Math.pow(2, Math.floor(Math.log2(segCount)));
+    const expSel = Math.floor(Math.log2(segCount));
+    const expShift = segCountX2 - expSearch;
+    const curSearch = dv.getUint16(abs + 8);
+    const curSel = dv.getUint16(abs + 10);
+    const curShift = dv.getUint16(abs + 12);
+    if (curSearch === expSearch && curSel === expSel && curShift === expShift) continue;
+    dv.setUint16(abs + 8, expSearch);
+    dv.setUint16(abs + 10, expSel);
+    dv.setUint16(abs + 12, expShift);
+    changed = true;
+  }
+  if (!changed) return src;
+  let sum = 0;
+  const end = cmapOffset + cmapLength;
+  for (let p = cmapOffset; p < end; p += 4) {
+    const b02 = out[p] || 0;
+    const b12 = p + 1 < end ? out[p + 1] : 0;
+    const b22 = p + 2 < end ? out[p + 2] : 0;
+    const b32 = p + 3 < end ? out[p + 3] : 0;
+    sum = sum + (b02 << 24 | b12 << 16 | b22 << 8 | b32) >>> 0;
+  }
+  dv.setUint32(cmapEntry + 4, sum);
+  return out;
+}
 const SYSTEM_FONT_FAMILIES = {
   systemfont_segoe: "'Segoe UI', 'Helvetica Neue', Arial, sans-serif",
   systemfont_arial: "Arial, 'Helvetica Neue', sans-serif",
@@ -11751,6 +12413,22 @@ function mountScene(rt, cfg) {
       if (disposed) return;
       const supportsAudioProcessing = project?.general?.supportsaudioprocessing !== false;
       const simAudio = createSimulatedAudio();
+      const simMedia = media.createSimulatedMedia();
+      const simWindow = system.createSimulatedWindowTitle();
+      let live = null;
+      const liveHold = {
+        mediaDriver: null,
+        lastSnap: {
+          get: () => null,
+          setHasThumbnail: () => {
+          }
+        }
+      };
+      const audioDriverRef = {
+        current: null
+      };
+      let mediaDriver = simMedia;
+      let windowDriver = simWindow;
       const audioSim = { enabled: supportsAudioProcessing };
       const zero = (n) => new Float32Array(n);
       const SILENT_AUDIO = {
@@ -11763,32 +12441,45 @@ function mountScene(rt, cfg) {
         level: 0,
         silent: true
       };
-      renderer.setAudioProvider(() => audioSim.enabled ? simAudio.snapshot : SILENT_AUDIO);
+      renderer.setAudioProvider(() => {
+        if (!audioSim.enabled) return SILENT_AUDIO;
+        return audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot;
+      });
       const audioViews = /* @__PURE__ */ new Map();
       window.__audioStats = () => ({
         enabled: audioSim.enabled,
-        level: audioSim.enabled ? Math.round(simAudio.snapshot.level * 1e3) / 1e3 : 0,
-        silent: audioSim.enabled ? simAudio.snapshot.silent : true,
-        bass: audioSim.enabled ? Math.round(simAudio.snapshot.left64[2] * 1e3) / 1e3 : 0
+        live: !!audioDriverRef.current,
+        level: audioSim.enabled ? Math.round((audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot).level * 1e3) / 1e3 : 0,
+        silent: audioSim.enabled ? (audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot).silent : true,
+        bass: audioSim.enabled ? Math.round((audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot).left64[2] * 1e3) / 1e3 : 0
       });
       window.__audioMute = (on) => {
         audioSim.enabled = !on;
         return audioSim.enabled;
       };
-      reportDiag(rt, cfg, `audio: simulated stream, supportsaudioprocessing=${supportsAudioProcessing}`);
-      const simMedia = media.createSimulatedMedia();
-      const simWindow = system.createSimulatedWindowTitle();
+      reportDiag(
+        rt,
+        cfg,
+        `audio: ${audioDriverRef.current ? "live mic" : "simulated"} stream, supportsaudioprocessing=${supportsAudioProcessing}`
+      );
       const shortcuts = system.createShortcutHandler((name) => {
         reportDiag(rt, cfg, `openUserShortcut: ${name}`);
       });
       const mediaSim = { enabled: true, override: null };
       const mediaHooks = [];
       let lastMediaSnap = null;
+      liveHold.lastSnap = {
+        get: () => lastMediaSnap,
+        setHasThumbnail: (v) => {
+          if (lastMediaSnap) lastMediaSnap.hasThumbnail = v;
+        }
+      };
+      const mediaSnapshot = () => mediaDriver.snapshot;
       const registerMediaHook = (sb) => {
         if (!sb || !sb.hasMediaHook || mediaHooks.includes(sb)) return;
         mediaHooks.push(sb);
-        if (!simMedia.snapshot.hasMedia) return;
-        for (const { name, event } of media.diffMediaEvents(null, simMedia.snapshot)) {
+        if (!mediaSnapshot().hasMedia) return;
+        for (const { name, event } of media.diffMediaEvents(null, mediaSnapshot())) {
           try {
             sb.callMedia(name, event);
           } catch {
@@ -11797,26 +12488,27 @@ function mountScene(rt, cfg) {
       };
       window.__mediaStats = () => ({
         enabled: mediaSim.enabled,
+        live: !!live,
         hooks: mediaHooks.length,
-        title: simMedia.snapshot.title,
-        artist: simMedia.snapshot.artist,
-        album: simMedia.snapshot.album,
-        state: simMedia.snapshot.state,
-        position: Math.round(simMedia.snapshot.position),
-        duration: simMedia.snapshot.duration,
-        hasThumbnail: simMedia.snapshot.hasThumbnail,
-        lyric: simMedia.snapshot.lyricLine,
-        primaryColor: simMedia.snapshot.primaryColor ? [simMedia.snapshot.primaryColor.x, simMedia.snapshot.primaryColor.y, simMedia.snapshot.primaryColor.z] : null
+        title: mediaSnapshot().title,
+        artist: mediaSnapshot().artist,
+        album: mediaSnapshot().album,
+        state: mediaSnapshot().state,
+        position: Math.round(mediaSnapshot().position),
+        duration: mediaSnapshot().duration,
+        hasThumbnail: mediaSnapshot().hasThumbnail,
+        lyric: mediaSnapshot().lyricLine,
+        primaryColor: mediaSnapshot().primaryColor ? [mediaSnapshot().primaryColor.x, mediaSnapshot().primaryColor.y, mediaSnapshot().primaryColor.z] : null
       });
       window.__mediaSet = (patch) => {
-        Object.assign(simMedia.snapshot, patch || {});
-        const evts = media.diffMediaEvents(lastMediaSnap, simMedia.snapshot);
+        Object.assign(mediaSnapshot(), patch || {});
+        const evts = media.diffMediaEvents(lastMediaSnap, mediaSnapshot());
         for (const { name, event } of evts) for (const sb of mediaHooks) sb.callMedia(name, event);
-        lastMediaSnap = media.cloneMediaSnapshot(simMedia.snapshot);
+        lastMediaSnap = media.cloneMediaSnapshot(mediaSnapshot());
         return window.__mediaStats();
       };
       const dispatchMediaNow = () => {
-        const evts = media.diffMediaEvents(lastMediaSnap, simMedia.snapshot);
+        const evts = media.diffMediaEvents(lastMediaSnap, mediaSnapshot());
         for (const { name, event } of evts) {
           for (const sb of mediaHooks) {
             try {
@@ -11825,42 +12517,50 @@ function mountScene(rt, cfg) {
             }
           }
         }
-        lastMediaSnap = media.cloneMediaSnapshot(simMedia.snapshot);
+        lastMediaSnap = media.cloneMediaSnapshot(mediaSnapshot());
       };
       const mediaControl = {
-        snapshot: simMedia.snapshot,
+        get snapshot() {
+          return mediaSnapshot();
+        },
         skipNext: () => {
-          simMedia.skipNext();
+          mediaDriver.skipNext();
           dispatchMediaNow();
-          return simMedia.snapshot;
+          return mediaSnapshot();
         },
         skipPrevious: () => {
-          simMedia.skipPrevious();
+          mediaDriver.skipPrevious();
           dispatchMediaNow();
-          return simMedia.snapshot;
+          return mediaSnapshot();
         },
         play: () => {
-          simMedia.play();
+          mediaDriver.play();
           dispatchMediaNow();
-          return simMedia.snapshot;
+          return mediaSnapshot();
         },
         pause: () => {
-          simMedia.pause();
+          mediaDriver.pause();
           dispatchMediaNow();
-          return simMedia.snapshot;
+          return mediaSnapshot();
         },
         playPause: () => {
-          simMedia.playPause();
+          mediaDriver.playPause();
           dispatchMediaNow();
-          return simMedia.snapshot;
+          return mediaSnapshot();
         }
       };
       window.__mediaControl = mediaControl;
       window.__system = {
         media: mediaControl,
-        windowTitle: simWindow.snapshot,
-        shortcuts: shortcuts.last
+        windowTitle: windowDriver.snapshot,
+        shortcuts: shortcuts.last,
+        live: null
       };
+      window.__liveSystem = () => ({
+        audio: "off",
+        media: "offline",
+        window: "offline"
+      });
       const pointerSrc = pointerLib.createPointerSource(
         cfg.canvas ? {
           target: cfg.canvas,
@@ -11964,6 +12664,118 @@ function mountScene(rt, cfg) {
           textures.set("$mediaPreviousThumbnail", mkThumb(tracks[tracks.length - 1]));
         }
       }
+      if (cfg.liveSystem) {
+        try {
+          const uploadLiveArtwork = async (info) => {
+            try {
+              const res = await fetch(info.url, { cache: "no-store" });
+              if (!res.ok) return;
+              const blob = await res.blob();
+              const bmp = await createImageBitmap(blob);
+              const raster = rasterizeArtwork(bmp, bmp.width, bmp.height, 512);
+              const palette = sampleArtworkPalette(bmp, bmp.width, bmp.height);
+              bmp.close?.();
+              const cur = textures.get("$mediaThumbnail");
+              if (cur) textures.set("$mediaPreviousThumbnail", cur);
+              const gl = renderer.gl;
+              const existing = textures.get("$mediaThumbnail");
+              if (existing?.glTex) {
+                gl.bindTexture(gl.TEXTURE_2D, existing.glTex);
+                gl.texImage2D(
+                  gl.TEXTURE_2D,
+                  0,
+                  gl.RGBA,
+                  raster.width,
+                  raster.height,
+                  0,
+                  gl.RGBA,
+                  gl.UNSIGNED_BYTE,
+                  raster.rgba
+                );
+                existing.width = raster.width;
+                existing.height = raster.height;
+                existing.mips = [raster];
+              } else {
+                textures.set("$mediaThumbnail", {
+                  glTex: rnd.makeTextureMip(gl, [raster], false),
+                  width: raster.width,
+                  height: raster.height,
+                  rg88: false,
+                  mips: [raster],
+                  generated: true
+                });
+              }
+              const snap = mediaDriver.snapshot;
+              if (palette) {
+                snap.primaryColor = media.mediaVec3(...palette.primary);
+                snap.secondaryColor = media.mediaVec3(...palette.secondary);
+                snap.tertiaryColor = media.mediaVec3(...palette.tertiary);
+                snap.textColor = media.mediaVec3(0.98, 0.98, 1);
+                snap.highContrastColor = media.mediaVec3(1, 1, 1);
+              }
+              snap.hasThumbnail = true;
+              liveHold.lastSnap.setHasThumbnail(false);
+              reportDiag(rt, cfg, `liveSystem: artwork ${info.title || info.trackKey}`);
+            } catch (e) {
+              reportDiag(
+                rt,
+                cfg,
+                `liveSystem: artwork 失败 (${e instanceof Error ? e.message : e})`
+              );
+            }
+          };
+          live = await startLiveSystem({
+            origin: location.origin,
+            onArtwork: (info) => {
+              void uploadLiveArtwork(info);
+            }
+          });
+          mediaDriver = live.media;
+          windowDriver = live.windowTitle;
+          liveHold.mediaDriver = live.media;
+          if (live.status().audio === "mic") audioDriverRef.current = live.audio;
+          if (mediaDriver.snapshot.hasMedia) {
+            for (const { name, event } of media.diffMediaEvents(null, mediaDriver.snapshot)) {
+              for (const sb of mediaHooks) {
+                try {
+                  sb.callMedia(name, event);
+                } catch {
+                }
+              }
+            }
+            lastMediaSnap = media.cloneMediaSnapshot(mediaDriver.snapshot);
+          }
+          const st = live.status();
+          reportDiag(
+            rt,
+            cfg,
+            `liveSystem: audio=${st.audio} media=${st.media} window=${st.window}` + (st.title ? ` title="${st.title}"` : "") + (st.hasArtwork ? " artwork=1" : "")
+          );
+          reportDiag(
+            rt,
+            cfg,
+            `audio: ${audioDriverRef.current ? "live mic" : "simulated"} stream, supportsaudioprocessing=${supportsAudioProcessing}`
+          );
+          window.__system = {
+            media: mediaControl,
+            windowTitle: windowDriver.snapshot,
+            shortcuts: shortcuts.last,
+            live: () => live.status()
+          };
+          window.__liveSystem = () => live.status();
+        } catch (e) {
+          reportDiag(rt, cfg, `liveSystem: 启动失败，回退模拟源 (${e instanceof Error ? e.message : e})`);
+          live = null;
+        }
+      }
+      {
+        const prevCleanup = particleCleanup;
+        particleCleanup = () => {
+          prevCleanup?.();
+          live?.dispose();
+          live = null;
+        };
+      }
       const texInflight = /* @__PURE__ */ new Map();
       const loadTexInner = async (name) => {
         if (textures.has(name)) return textures.get(name);
@@ -12155,6 +12967,13 @@ function mountScene(rt, cfg) {
             model = JSON.parse(readText(modelEntry));
           }
           scn.applySolidFromModel(layer, model);
+          const instUt = layer.srcObject?.instance?.usertextures;
+          const instUtName = instUt?.[0] && typeof instUt[0].name === "string" && instUt[0].name.startsWith("$") ? instUt[0].name : null;
+          const instBoundTex = instUtName && textures.has(instUtName) ? instUtName : null;
+          if (instBoundTex) {
+            layer.textureName = instBoundTex;
+            layer.solid = false;
+          }
           if (model && typeof model === "object" && "width" in model && "height" in model) {
             const m = model;
             if ((layer.size?.[0] || 0) === 0 && (layer.size?.[1] || 0) === 0 && m.width > 0 && m.height > 0) {
@@ -12195,7 +13014,7 @@ function mountScene(rt, cfg) {
             texJobs.push(
               loadTex(tn).then((entry) => {
                 if (!entry) return;
-                if (si === 0) {
+                if (si === 0 && !instBoundTex) {
                   layer.textureName = tn;
                   loadedTex++;
                   if (entry.videoCtl) layer.videoCtl = entry.videoCtl;
@@ -12266,7 +13085,10 @@ function mountScene(rt, cfg) {
           height: gen.height,
           rg88: false,
           mips: [gen],
-          generated: true
+          generated: true,
+          // 内置贴图的帧表（rain1/rain2 的 1×4 图集）：randomframe 预设依赖它
+          // 随机取帧，缺了就整图采样画出超长丝（1823900922）。
+          frames: ptex.builtinParticleFrames(name) ?? void 0
         };
         textures.set(name, entry);
         builtinTexCount++;
@@ -12472,8 +13294,8 @@ function mountScene(rt, cfg) {
           if (particleDiagFrame < 2) {
             particleDiagFrame++;
             if (particleDiagFrame === 2) {
-              const live = particleSystems.reduce((s, ps) => s + ps.liveCount(), 0);
-              reportDiag(rt, cfg, `particles live: ${live} across ${particleSystems.length} systems`);
+              const live2 = particleSystems.reduce((s, ps) => s + ps.liveCount(), 0);
+              reportDiag(rt, cfg, `particles live: ${live2} across ${particleSystems.length} systems`);
             }
           }
         },
@@ -12492,7 +13314,7 @@ function mountScene(rt, cfg) {
         `particles: ${particleSystems.length} systems, ${builtinTexCount} builtin tex generated`
       );
       window.__particleStats = () => particleSystems.map((ps) => {
-        let live = 0;
+        let live2 = 0;
         let minX = Infinity;
         let maxX = -Infinity;
         let minY = Infinity;
@@ -12501,7 +13323,7 @@ function mountScene(rt, cfg) {
         let maxS = -Infinity;
         for (const p of ps.pool) {
           if (!p.alive) continue;
-          live++;
+          live2++;
           const px = ps.originX + p.x * ps.scaleX;
           const py = ps.originY + p.y * ps.scaleY;
           if (px < minX) minX = px;
@@ -12513,13 +13335,13 @@ function mountScene(rt, cfg) {
           if (s > maxS) maxS = s;
         }
         return {
-          live,
+          live: live2,
           max: ps.maxCount,
           blend: ps.blend,
           renderer: ps.renderers.map((r) => r.kind).join("+"),
           origin: [Math.round(ps.originX), Math.round(ps.originY)],
-          bbox: live ? [Math.round(minX), Math.round(minY), Math.round(maxX), Math.round(maxY)] : null,
-          size: live ? [Math.round(minS), Math.round(maxS)] : null
+          bbox: live2 ? [Math.round(minX), Math.round(minY), Math.round(maxX), Math.round(maxY)] : null,
+          size: live2 ? [Math.round(minS), Math.round(maxS)] : null
         };
       });
       window.__particleToggle = (on, onlyIndex) => {
@@ -12685,8 +13507,11 @@ function mountScene(rt, cfg) {
           try {
             const fe = pkg.getEntry(parsedPkg, fp);
             if (!fe) continue;
+            const bytes = sanitizeFontForBrowser(
+              fe instanceof Uint8Array ? fe : new Uint8Array(fe)
+            );
             const fam = "wefont_" + fp.split("/").pop().replace(/[^a-zA-Z0-9]/g, "_");
-            const url = URL.createObjectURL(new Blob([fe]));
+            const url = URL.createObjectURL(new Blob([bytes]));
             const ff = new FontFace(fam, `url(${url})`);
             await ff.load();
             document.fonts.add(ff);
@@ -12730,7 +13555,7 @@ function mountScene(rt, cfg) {
                 // 与对象/效果开关/常量/general 统一走 engineTimers（P1-1）。
                 ...timerOpts,
                 mediaControl,
-                windowTitle: simWindow.snapshot,
+                windowTitle: windowDriver.snapshot,
                 openUserShortcut: shortcuts.openUserShortcut,
                 getLayerText: (name) => textLayerText.get(name),
                 onError: (e) => {
@@ -12978,7 +13803,7 @@ function mountScene(rt, cfg) {
             return clone;
           },
           mediaControl,
-          windowTitle: simWindow.snapshot,
+          windowTitle: windowDriver.snapshot,
           openUserShortcut: shortcuts.openUserShortcut,
           isScreensaver: false
         };
@@ -13005,8 +13830,8 @@ function mountScene(rt, cfg) {
               const ctrl = anim.createAnimation(def.animation);
               ctrl.field = field;
               ctrl.baseValue = def.value;
-              const live = layer[field];
-              ctrl.baseNumeric = Array.isArray(live) ? live.slice() : live;
+              const live2 = layer[field];
+              ctrl.baseNumeric = Array.isArray(live2) ? live2.slice() : live2;
               layer.animationList.push(ctrl);
               if (ctrl.name) layer.animations[ctrl.name] = ctrl;
               animRuns.push({ layer, field, ctrl });
@@ -13223,8 +14048,10 @@ function mountScene(rt, cfg) {
           const t = (now - start - pauseAccum) / 1e3;
           inputView.update(pointerSrc.state);
           if (mediaSim.enabled) {
-            simMedia.update(t);
-            const evts = media.diffMediaEvents(lastMediaSnap, simMedia.snapshot);
+            if (live?.media) live.media.pump();
+            else simMedia.update(t);
+            const snap = mediaSnapshot();
+            const evts = media.diffMediaEvents(lastMediaSnap, snap);
             if (evts.length) {
               for (const { name, event } of evts) {
                 for (const sb of mediaHooks) {
@@ -13232,10 +14059,11 @@ function mountScene(rt, cfg) {
                   sb.callMedia(name, event);
                 }
               }
-              lastMediaSnap = media.cloneMediaSnapshot(simMedia.snapshot);
+              lastMediaSnap = media.cloneMediaSnapshot(snap);
             }
           }
-          simWindow.update(t);
+          if (live?.windowTitle) live.windowTitle.pump();
+          else simWindow.update(t);
           for (const run of animRuns) {
             run.ctrl.advance(interval / 1e3);
             const field = run.field;
@@ -13303,8 +14131,12 @@ function mountScene(rt, cfg) {
           }
           if (visibilityDirty) recomputeVisibility();
           if (audioSim.enabled) {
-            simAudio.update(t);
-            fillAudioBuffers(audioViews, simAudio.snapshot);
+            if (audioDriverRef.current) audioDriverRef.current.pump();
+            else simAudio.update(t);
+            fillAudioBuffers(
+              audioViews,
+              audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot
+            );
           }
           if (attachFollows.length) {
             mdl.followAttachments(attachFollows, t, getBoneOverrides);