webwallgl 1.0.0-beta1 → 1.1.0

package/webwallgl.mjs

@@ -29,7 +29,20 @@ function createRuntime(opts) {
   window.__blockContextMenu = (doc) => doc.addEventListener("contextmenu", block, true);
 })();
 function clear(rt) {
-  if (rt.wrap) rt.wrap.innerHTML = "";
+  if (rt.iframe) {
+    try {
+      rt.iframe.contentWindow?.location.replace("about:blank");
+    } catch {
+    }
+  }
+  if (rt.wrap) {
+    rt.wrap.innerHTML = "";
+  } else if (rt.iframe?.isConnected) {
+    try {
+      rt.iframe.remove();
+    } catch {
+    }
+  }
   if (rt.raf !== void 0) cancelAnimationFrame(rt.raf);
   rt.raf = void 0;
   for (const p of rt.videoPairs ?? []) p.destroy();
@@ -37,6 +50,7 @@ function clear(rt) {
   if (rt.sceneCleanup) rt.sceneCleanup();
   rt.sceneCleanup = void 0;
   rt.sceneCtl = void 0;
+  rt.pointerCtl = void 0;
   if (rt.renderer) {
     rt.renderer.dispose?.();
     rt.renderer = void 0;
@@ -120,7 +134,7 @@ function reportDiag(rt, cfg, msg) {
   } catch {
   }
   try {
-    const origin = cfg.mediaBase ? new URL(cfg.mediaBase).origin : "";
+    const origin = cfg.mediaBase ? new URL(cfg.mediaBase, window.location.href).origin : "";
     if (origin) {
       const img = new Image();
       img.src = `${origin}/diag?msg=${encodeURIComponent(`scene ${cfg.src ?? "?"}: ${msg.slice(0, 500)}`)}`;
@@ -863,6 +877,31 @@ function parseNum(v, dflt) {
   }
   return dflt;
 }
+function isRenderInert(o) {
+  if (!o) return false;
+  return !o.image && !o.model && !o.particle && o.text == null && !o.size;
+}
+function composeChildTransform(parentWorld, childLocal, parentScalePropagates) {
+  const pscale = parentScalePropagates ? parentWorld.scale : [1, 1, 1];
+  const ca = (parentWorld.angles[2] || 0) * Math.PI / 180;
+  const cos = Math.cos(ca);
+  const sin = Math.sin(ca);
+  const ox = childLocal.origin[0] * pscale[0];
+  const oy = childLocal.origin[1] * pscale[1];
+  return {
+    origin: [
+      parentWorld.origin[0] + ox * cos - oy * sin,
+      parentWorld.origin[1] + ox * sin + oy * cos,
+      parentWorld.origin[2] + (childLocal.origin[2] || 0)
+    ],
+    scale: [
+      pscale[0] * childLocal.scale[0],
+      pscale[1] * childLocal.scale[1],
+      pscale[2] * childLocal.scale[2]
+    ],
+    angles: [childLocal.angles[0], childLocal.angles[1], (parentWorld.angles[2] || 0) + childLocal.angles[2]]
+  };
+}
 function parseScene(sceneJson, project) {
   const properties = project && project.general && project.general.properties || {};
   const objects = sceneJson.objects || [];
@@ -879,6 +918,11 @@ function parseScene(sceneJson, project) {
     scale: parseVec3(o.scale || "1 1 1"),
     angles: parseVec3(o.angles || "0 0 0")
   }));
+  const localSnapshot = local.map((c) => ({
+    origin: c.origin.slice(),
+    scale: c.scale.slice(),
+    angles: c.angles.slice()
+  }));
   for (let pass = 0; pass < 8; pass++) {
     let changed = false;
     for (const c of local) {
@@ -892,20 +936,11 @@ function parseScene(sceneJson, project) {
       const pr = objects[pIdx];
       const prs = pr.scale;
       const runtimeBound = prs !== null && typeof prs === "object" && (typeof prs.script === "string" || prs.user !== void 0);
-      const renderInert = !pr.image && !pr.model && !pr.particle && pr.text == null && !pr.size;
-      const pscale = runtimeBound && renderInert ? [1, 1, 1] : pc.scale;
-      const ca = pc.angles[2] * Math.PI / 180;
-      const cos = Math.cos(ca);
-      const sin = Math.sin(ca);
-      const ox = c.origin[0] * pscale[0];
-      const oy = c.origin[1] * pscale[1];
-      c.origin[0] = pc.origin[0] + ox * cos - oy * sin;
-      c.origin[1] = pc.origin[1] + ox * sin + oy * cos;
-      c.origin[2] = pc.origin[2] + c.origin[2];
-      c.angles[2] = pc.angles[2] + c.angles[2];
-      c.scale[0] = pscale[0] * c.scale[0];
-      c.scale[1] = pscale[1] * c.scale[1];
-      c.scale[2] = pscale[2] * c.scale[2];
+      const propagateScale = !(runtimeBound && isRenderInert(pr));
+      const w = composeChildTransform(pc, c, propagateScale);
+      c.origin = w.origin;
+      c.scale = w.scale;
+      c.angles = w.angles;
       c.parent = null;
       changed = true;
     }
@@ -995,6 +1030,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),
@@ -1124,6 +1160,18 @@ function parseScene(sceneJson, project) {
       origin: layerOrigin,
       scale: world.scale,
       angles: world.angles,
+      // [we-scene patch] 父级相对变换（WE 场景图的真实语义）。origin/scale/angles
+      // 上的脚本与关键帧动画一律在这层空间收发，再由 recomposeWorld 合成回上面的
+      // world 三件套。渲染 / hittest / getTransformMatrix 仍只读 world，不受影响。
+      // isPostProcess 层的 world 被强制成整幅画布，local 对它无意义（recompose 跳过）。
+      localOrigin: localSnapshot[i].origin,
+      localScale: localSnapshot[i].scale,
+      localAngles: localSnapshot[i].angles,
+      // 「渲染惰性纯容器」：父 scale 是否传给子层由父级这个标志决定，
+      // 判据与 parse 合并阶段逐字相同（见 isRenderInert）。
+      renderInert: isRenderInert(o),
+      // 父 scale 绑了脚本/用户属性（运行时可变）。与 renderInert 一起决定传播闸门。
+      scaleRuntimeBound: !!(o.scale !== null && typeof o.scale === "object" && (typeof o.scale.script === "string" || o.scale.user !== void 0)),
       size: layerSize,
       alignment: o.alignment || "center",
       color: parseColor(o.color),
@@ -1234,15 +1282,110 @@ function resolveMaterial(modelJson) {
     cropoffset: modelJson.cropoffset ? parseVec2(modelJson.cropoffset) : null
   };
 }
+function recomposeWorld(layers, dirty) {
+  if (!layers || layers.length === 0) return;
+  const byId = /* @__PURE__ */ new Map();
+  for (const l of layers) {
+    if (l && l.id !== void 0 && l.id !== null) byId.set(l.id, l);
+  }
+  const depthOf = (l) => {
+    let d = 0;
+    let p = l.parentId;
+    for (let guard = 0; p !== void 0 && p !== null && guard < 64; guard++) {
+      const parent = byId.get(p);
+      if (!parent) break;
+      d++;
+      p = parent.parentId;
+    }
+    return d;
+  };
+  const targets = [];
+  for (const l of layers) {
+    if (!l || !l.localOrigin) continue;
+    if (l.isPostProcess) continue;
+    if (dirty && !dirty.has(l.id)) continue;
+    targets.push(l);
+  }
+  targets.sort((a, b) => depthOf(a) - depthOf(b));
+  for (const l of targets) {
+    const parent = l.parentId !== void 0 && l.parentId !== null ? byId.get(l.parentId) : null;
+    let w;
+    if (!parent) {
+      w = { origin: l.localOrigin.slice(), scale: l.localScale.slice(), angles: l.localAngles.slice() };
+    } else {
+      const propagateScale = !(parent.scaleRuntimeBound && parent.renderInert);
+      w = composeChildTransform(
+        { origin: parent.origin, scale: parent.scale, angles: parent.angles },
+        { origin: l.localOrigin, scale: l.localScale, angles: l.localAngles },
+        propagateScale
+      );
+    }
+    const d = l.attachBindDelta;
+    if (d) {
+      w.origin[0] += d[0];
+      w.origin[1] += d[1];
+    }
+    l.origin[0] = w.origin[0];
+    l.origin[1] = w.origin[1];
+    l.origin[2] = w.origin[2];
+    l.scale[0] = w.scale[0];
+    l.scale[1] = w.scale[1];
+    l.scale[2] = w.scale[2];
+    l.angles[0] = w.angles[0];
+    l.angles[1] = w.angles[1];
+    l.angles[2] = w.angles[2];
+    if (l.attachBase) {
+      l.attachBase[0] = w.origin[0];
+      l.attachBase[1] = w.origin[1];
+    }
+  }
+}
+function collectTransformDirty(layers, extraSeeds) {
+  const dirty = /* @__PURE__ */ new Set();
+  if (!layers || layers.length === 0) return dirty;
+  const childrenOf = /* @__PURE__ */ new Map();
+  for (const l of layers) {
+    if (!l || l.parentId === void 0 || l.parentId === null) continue;
+    const list = childrenOf.get(l.parentId);
+    if (list) list.push(l);
+    else childrenOf.set(l.parentId, [l]);
+  }
+  const TRANSFORM_FIELDS = ["origin", "scale", "angles"];
+  const seeds = [];
+  for (const l of layers) {
+    if (!l || l.id === void 0 || l.id === null) continue;
+    const scripts = l.objectScripts || null;
+    const anims = l.objectAnimations || null;
+    const bound = TRANSFORM_FIELDS.some((f) => scripts && scripts[f] || anims && anims[f]);
+    if (bound) seeds.push(l);
+  }
+  if (extraSeeds) {
+    for (const l of extraSeeds) if (l && l.id !== void 0 && l.id !== null) seeds.push(l);
+  }
+  const stack = seeds.slice();
+  for (let guard = 0; stack.length > 0 && guard < 1e5; guard++) {
+    const l = stack.pop();
+    if (!l || l.id === void 0 || l.id === null) continue;
+    if (dirty.has(l.id)) continue;
+    dirty.add(l.id);
+    const kids = childrenOf.get(l.id);
+    if (kids) for (const c of kids) stack.push(c);
+  }
+  return dirty;
+}
 const sceneMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   applySolidFromModel,
+  collectTransformDirty,
+  composeChildTransform,
+  isRenderInert,
   parseBool,
   parseColor,
   parseNum,
   parseScene,
   parseVec2,
   parseVec3,
+  recomposeWorld,
   recomputeLayerVisibility,
   resolveMaterial
 }, Symbol.toStringTag, { value: "Module" }));
@@ -1646,12 +1789,36 @@ function expandMacrosIn(text, depth) {
     const { defs, fns } = collectMacros(text);
     if (defs.size === 0 && fns.size === 0) break;
     const lines = text.split("\n");
+    const defLine = /* @__PURE__ */ new Map();
+    for (let i = 0; i < lines.length; i++) {
+      const dm = /^[ \t]*#define[ \t]+([A-Za-z_][A-Za-z0-9_]*)/.exec(lines[i]);
+      if (dm && !defLine.has(dm[1])) defLine.set(dm[1], i);
+    }
+    const declLine = /* @__PURE__ */ new Map();
+    {
+      const TYPES = "(?:float|int|bool|vec[234]|ivec[234]|bvec[234]|mat[234])";
+      for (const name of defs.keys()) {
+        const esc = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const re = new RegExp(
+          "^\\s*(?:const\\s+|uniform\\s+|varying\\s+|in\\s+|out\\s+|attribute\\s+)*" + TYPES + "\\s+" + esc + "\\s*[=;]"
+        );
+        for (let i = 0; i < lines.length; i++) {
+          if (re.test(lines[i])) {
+            declLine.set(name, i);
+            break;
+          }
+        }
+      }
+    }
     let changed = false;
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i];
       if (/^[ \t]*#/.test(line)) continue;
       let l = line;
       for (const [name, val] of defs) {
+        const dl = defLine.get(name);
+        if (dl !== void 0 && i < dl) continue;
+        if (declLine.get(name) === i) continue;
         const re = new RegExp("\\b" + name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\b");
         if (re.test(l)) {
           l = replaceWord(l, name, val);
@@ -1659,6 +1826,8 @@ function expandMacrosIn(text, depth) {
         }
       }
       for (const [name, info] of fns) {
+        const dl = defLine.get(name);
+        if (dl !== void 0 && i < dl) continue;
         if (l.includes(name)) {
           l = expandFunctionMacro(l, name, info, depth);
           changed = true;
@@ -1933,6 +2102,13 @@ function isDeclaration(text, idx) {
   const word = text.slice(p + 1, e);
   return GLSL_TYPES.has(word);
 }
+function collectIntNames(code) {
+  const names = /* @__PURE__ */ new Set();
+  let m;
+  const declRe = /\b(?:const\s+)?int\s+([A-Za-z_]\w*)\s*[=;)\u0003]/g;
+  while ((m = declRe.exec(code)) !== null) names.add(m[1]);
+  return names;
+}
 function rewriteCall(text, callName, fn) {
   let out = "";
   let i = 0;
@@ -2017,23 +2193,73 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
     const dim = sw.length;
     return fn + "(vec" + dim + "(" + num2 + "), " + expr + ")";
   });
-  code = code.replace(/(^|[^\w.])(\d+)\s*([*/])\s*([A-Za-z_][A-Za-z0-9_]*)/g, "$1$2.0 $3 $4");
-  code = code.replace(/\b([A-Za-z_][A-Za-z0-9_]*)\s*([*/])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
-  code = code.replace(/(\d+\.\d+)\s*([*/])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
-  code = code.replace(/(^|[^\w.])(\d+)\s*([*/])\s*(\d+\.\d+)/g, "$1$2.0 $3 $4");
-  code = code.replace(/(\.\d+)\s*([+-])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
-  code = code.replace(/([A-Za-z_]\w*\.(?:xyzw|xyz|xy|zw|rgba|rgb|rg|x|y|z|w|r|g|b|a))\s*([+-])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
-  code = code.replace(/(^|[^\w.])(\d+)\s*([+-])\s*(\d+\.\d+)/g, "$1$2.0 $3 $4");
-  code = code.replace(/(^|[^\w.])(\d+)\s*([+-])\s*([A-Za-z_]\w*\.(?:xyzw|xyz|xy|zw|rgba|rgb|rg|x|y|z|w|r|g|b|a))/g, "$1$2.0 $3 $4");
-  {
-    const floatNames = /* @__PURE__ */ new Set();
-    const declRe = /\b(?:uniform\s+)?(?:highp|mediump|lowp\s+)?(?:float|vec2|vec3|vec4|mat2|mat3|mat4)\s+([A-Za-z_][A-Za-z0-9_]*)/g;
-    let dm;
-    while ((dm = declRe.exec(code)) !== null) floatNames.add(dm[1]);
-    if (floatNames.size > 0) {
-      const alt = Array.from(floatNames).sort((a, b) => b.length - a.length).join("|");
-      code = code.replace(new RegExp("(^|[^\\w.])(\\d+)\\s*([+-])\\s*(" + alt + ")(?![A-Za-z0-9_])", "g"), "$1$2.0 $3 $4");
+  code = code.replace(
+    /(\.([xyzwrgba]{2,4})\s*=\s*)(max|min)\(\s*(-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?)\s*,\s*([^;]+?)\s*\)\s*;/g,
+    (all, lead, sw, fn, scalar, vecExpr) => {
+      if (!/\.[xyzwrgba]{2,4}\b|\bvec[234]\s*\(/.test(vecExpr)) return all;
+      return `${lead}${fn}(vec${sw.length}(${scalar}), ${vecExpr});`;
+    }
+  );
+  code = code.replace(
+    /(^|[^\w)\]])([+-])([+-])(?=[\d.])/g,
+    (all, pre, s1, s2) => pre + (s1 === s2 ? "+" : "-")
+  );
+  const sciHoles = [];
+  code = code.replace(/\b\d+(?:\.\d+)?[eE][+-]?\d+\b/g, (m) => {
+    sciHoles.push(m);
+    return "
" + "".repeat(sciHoles.length) + "
";
+  });
+  const forHoles = [];
+  code = code.replace(/\bfor\s*\(\s*int\s+([A-Za-z_]\w*)([^)]*)\)/g, (m, name, rest) => {
+    forHoles.push(rest + ")");
+    return `for (int ${name}${"".repeat(forHoles.length)}`;
+  });
+  for (let pass = 0; pass < 8; pass++) {
+    const before = code;
+    code = code.replace(/(^|[^\w.])(\d+)\s*([*/])\s*([A-Za-z_][A-Za-z0-9_]*)/g, "$1$2.0 $3 $4");
+    code = code.replace(/\b([A-Za-z_][A-Za-z0-9_]*)\s*([*/])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
+    code = code.replace(/(\d+\.\d+)\s*([*/])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
+    code = code.replace(/(^|[^\w.])(\d+)\s*([*/])\s*(\d+\.\d+)/g, "$1$2.0 $3 $4");
+    code = code.replace(/(\.\d+)\s*([+-])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
+    code = code.replace(/([A-Za-z_]\w*\.(?:xyzw|xyz|xy|zw|rgba|rgb|rg|x|y|z|w|r|g|b|a))\s*([+-])\s*(\d+)(?![\d.])/g, "$1 $2 $3.0");
+    code = code.replace(/(^|[^\w.])(\d+)\s*([+-])\s*(\d+\.\d+)/g, "$1$2.0 $3 $4");
+    code = code.replace(/(^|[^\w.])(\d+)\s*([+-])\s*([A-Za-z_]\w*\.(?:xyzw|xyz|xy|zw|rgba|rgb|rg|x|y|z|w|r|g|b|a))/g, "$1$2.0 $3 $4");
+    code = code.replace(
+      /(^|[^\w.])(\d+)\s*([*/+-])\s*(\()/g,
+      (all, pre, num2, op, open, offset, whole) => {
+        let depth = 0;
+        let end = offset + all.length - 1;
+        for (; end < whole.length; end++) {
+          const ch = whole[end];
+          if (ch === "(") depth++;
+          else if (ch === ")") {
+            depth--;
+            if (depth === 0) {
+              end++;
+              break;
+            }
+          } else if (depth === 0 && (ch === ";" || ch === "," || ch === "\n")) break;
+        }
+        for (; end < whole.length; end++) {
+          const ch = whole[end];
+          if (ch === ";" || ch === "," || ch === "\n" || ch === ")") break;
+        }
+        const seg = whole.slice(offset, end);
+        return /\d\.\d/.test(seg) ? `${pre}${num2}.0 ${op} ${open}` : all;
+      }
+    );
+    {
+      const floatNames = /* @__PURE__ */ new Set();
+      const declRe = /\b(?:uniform\s+)?(?:highp|mediump|lowp\s+)?(?:float|vec2|vec3|vec4|mat2|mat3|mat4)\s+([A-Za-z_][A-Za-z0-9_]*)/g;
+      let dm;
+      while ((dm = declRe.exec(code)) !== null) floatNames.add(dm[1]);
+      if (floatNames.size > 0) {
+        const alt = Array.from(floatNames).sort((a, b) => b.length - a.length).join("|");
+        code = code.replace(new RegExp("(^|[^\\w.])(\\d+)\\s*([+-])\\s*(" + alt + ")(?![A-Za-z0-9_])", "g"), "$1$2.0 $3 $4");
+        code = code.replace(new RegExp("\\b(" + alt + ")\\s*([+-])\\s*(\\d+)(?![\\d.])", "g"), "$1 $2 $3.0");
+      }
     }
+    if (code === before) break;
   }
   {
     const FLOAT_BUILTINS = [
@@ -2169,6 +2395,67 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
         return pre + lhs + " = " + rhs + "." + SW[lw] + ";";
       });
     }
+    {
+      const floatDecl = /* @__PURE__ */ new Set();
+      {
+        const fdre = /\b(?:uniform|varying|attribute|in|out|const)?\s*\bfloat\s+([A-Za-z_]\w*)/g;
+        let fd;
+        while ((fd = fdre.exec(code)) !== null) floatDecl.add(fd[1]);
+      }
+      const vecW = (expr) => {
+        const e = expr.trim();
+        {
+          const c = /^vec([234])\s*\(/.exec(e);
+          if (c) {
+            let depth = 0;
+            for (let i = e.indexOf("("); i < e.length; i++) {
+              if (e[i] === "(") depth++;
+              else if (e[i] === ")") {
+                depth--;
+                if (depth === 0) return i === e.length - 1 ? Number(c[1]) : 0;
+              }
+            }
+            return 0;
+          }
+        }
+        if (/^texture(?:Lod)?\s*\(/.test(e)) {
+          let depth = 0;
+          for (let i = e.indexOf("("); i < e.length; i++) {
+            if (e[i] === "(") depth++;
+            else if (e[i] === ")") {
+              depth--;
+              if (depth === 0) return i === e.length - 1 ? 4 : 0;
+            }
+          }
+          return 0;
+        }
+        const m = /^([A-Za-z_]\w*)(?:\.([xyzwrgba]{2,4}))?\s*[*/]\s*([^*/]+)$/.exec(e);
+        if (!m) return 0;
+        const rhsPart = m[3];
+        if (/\bvec[234]\s*\(|\.[xyzwrgba]{2,4}\b/.test(rhsPart)) return 0;
+        if (m[2]) return m[2].length;
+        if (floatDecl.has(m[1])) return 0;
+        return width.get(m[1]) || 0;
+      };
+      code = code.replace(
+        /(^|[;{}\n]\s*)float\s+([A-Za-z_]\w*)\s*=\s*([^;]+);/g,
+        (all, pre, name, rhs) => {
+          const w = vecW(rhs);
+          if (w < 2) return all;
+          return `${pre}float ${name} = (${rhs.trim()}).x;`;
+        }
+      );
+      const SWN = { 2: "xy", 3: "xyz" };
+      code = code.replace(
+        /(^|[;{}\n]\s*)vec([23])\s+([A-Za-z_]\w*)\s*=\s*([^;]+);/g,
+        (all, pre, dim, name, rhs) => {
+          const lw = Number(dim);
+          const rw = vecW(rhs);
+          if (rw <= lw) return all;
+          return `${pre}vec${dim} ${name} = (${rhs.trim()}).${SWN[lw]};`;
+        }
+      );
+    }
     if (width.size > 0) {
       const floatNames = /* @__PURE__ */ new Set();
       const fre = /\b(?:uniform|varying|attribute|in|out)?\s*\bfloat\s+([A-Za-z_]\w*)/g;
@@ -2210,6 +2497,7 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
       code = code.replace(/(^|[;{}\n]\s*)([A-Za-z_]\w*)\s*=\s*([^;]+);/g, (all, pre, lhs, rhs) => {
         const lw = width.get(lhs);
         if (!lw) return all;
+        if (floatNames.has(lhs)) return all;
         const r = rhs.trim();
         if (new RegExp("^vec" + lw + "\\s*\\(").test(r)) return all;
         if (width.has(r)) return all;
@@ -2253,6 +2541,52 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
     new RegExp(`\\bint\\s+([A-Za-z_]\\w*)\\s*=\\s*((?:${FLOAT_FNS})\\s*\\()`, "g"),
     "float $1 = $2"
   );
+  code = code.replace(
+    /\bfloat\s+([A-Za-z_]\w*)\s*=\s*(int\s*\([^;]*\))\s*;/g,
+    "float $1 = float($2);"
+  );
+  {
+    const intNames = collectIntNames(code);
+    if (intNames.size > 0) {
+      code = code.replace(
+        /\b(const\s+)?float\s+([A-Za-z_]\w*)\s*=\s*([^;{}]+);/g,
+        (all, cst, name, rhs) => {
+          const body = rhs.trim();
+          if (/\./.test(body)) return all;
+          if (/[A-Za-z_]\w*\s*\(/.test(body)) return all;
+          const ids = body.match(/[A-Za-z_]\w*/g);
+          if (!ids || !ids.length) return all;
+          if (!ids.every((x) => intNames.has(x))) return all;
+          return `${cst || ""}float ${name} = float(${body});`;
+        }
+      );
+    }
+  }
+  {
+    const intNames = collectIntNames(code);
+    const floatNames = /* @__PURE__ */ new Set();
+    let fm;
+    const fDeclRe = /\b(?:const\s+|uniform\s+|varying\s+|in\s+|out\s+)*float\s+([A-Za-z_]\w*)/g;
+    while ((fm = fDeclRe.exec(code)) !== null) floatNames.add(fm[1]);
+    for (const n of [...intNames]) {
+      if (floatNames.has(n)) {
+        intNames.delete(n);
+        floatNames.delete(n);
+      }
+    }
+    if (intNames.size > 0 && floatNames.size > 0) {
+      const iAlt = [...intNames].sort((a, b) => b.length - a.length).join("|");
+      const fAlt = [...floatNames].sort((a, b) => b.length - a.length).join("|");
+      code = code.replace(
+        new RegExp(`\\b(${iAlt})\\s*([*/+-])\\s*(${fAlt})\\b`, "g"),
+        (all, a, op, b) => `float(${a}) ${op} ${b}`
+      );
+      code = code.replace(
+        new RegExp(`\\b(${fAlt})\\s*([*/+-])\\s*(${iAlt})\\b`, "g"),
+        (all, a, op, b) => `${a} ${op} float(${b})`
+      );
+    }
+  }
   {
     const boolNames = /* @__PURE__ */ new Set();
     const boolRe = /\bbool\s+([A-Za-z_]\w*)\s*=/g;
@@ -2266,6 +2600,17 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
       );
     }
   }
+  {
+    const CMP = /\(\s*([^()&|]+?)\s*(<=|>=|<|>|==|!=)\s*([^()&|]+?)\s*\)/g;
+    code = code.replace(
+      new RegExp(CMP.source + "\\s*([*/])", "g"),
+      (all, lhs, op, rhs, mulOp) => `float(${lhs.trim()} ${op} ${rhs.trim()}) ${mulOp}`
+    );
+    code = code.replace(
+      new RegExp("([-+*/]=\\s*)" + CMP.source, "g"),
+      (all, assign, lhs, op, rhs) => `${assign}float(${lhs.trim()} ${op} ${rhs.trim()})`
+    );
+  }
   {
     const names = /* @__PURE__ */ new Set();
     for (const fm of code.matchAll(/\b(?:uniform\s+)?(?:highp|mediump|lowp\s+)?float\s+([A-Za-z_]\w*)\s*\[/g)) {
@@ -2284,6 +2629,17 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
         let p = close1 + 1;
         while (p < code.length && /[ \t]/.test(code[p])) p++;
         if (code[p] !== "[") {
+          const e12 = code.slice(open1 + 1, close1);
+          const t = e12.trim();
+          const isFloatish = /\d\.\d/.test(t) || /^[A-Za-z_]\w*$/.test(t) && new RegExp("\\bfloat\\s+" + t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\b").test(code);
+          const alreadyInt = /^\s*int\s*\(/.test(t) || /^-?\d+$/.test(t);
+          if (isFloatish && !alreadyInt) {
+            out += code.slice(last, fm.index);
+            out += fm[1] + "[int(" + t + ")]";
+            last = close1 + 1;
+            re.lastIndex = last;
+            continue;
+          }
           re.lastIndex = close1 + 1;
           continue;
         }
@@ -2424,6 +2780,59 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
           }).join("\n");
         }
       }
+      code = code.replace(
+        /^(\s*in\s+(?:highp|mediump|lowp\s+)?)(vec[234]|float)(\s+)([A-Za-z_]\w*)(\s*;)/gm,
+        (all, pre, ty, sp, name, tail) => {
+          const vt = vertTypes.get(name);
+          if (!vt || RANK[vt] >= RANK[ty]) return all;
+          const CH = "xyzw";
+          const RG = "rgba";
+          const over = new RegExp(
+            "\\b" + name + "\\s*\\.\\s*[" + CH + RG + "]*[" + CH.slice(RANK[vt]) + RG.slice(RANK[vt]) + "]"
+          );
+          if (over.test(code)) return all;
+          return pre + vt + sp + name + tail;
+        }
+      );
+    }
+    {
+      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();
@@ -2444,18 +2853,27 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
         let body = code.slice(braceIdx + 1);
         const decls = [];
         for (const name of written) {
+          const shadowed = new RegExp(
+            "(?:^|[;{}\\n])\\s*(?:highp|mediump|lowp\\s+)?(?:vec[234]|float|int|bool)\\s+" + name + "\\s*[=;]"
+          ).test(body);
+          if (shadowed) continue;
           const tm = new RegExp("^\\s*in\\s+(?:highp|mediump|lowp\\s+)?(vec[234]|float)\\s+" + name + "\\s*;", "m").exec(code);
           const ty = tm ? tm[1] : "vec4";
           decls.push("    " + ty + " " + name + "_rw = " + name + ";");
           body = replaceWord(body, name, name + "_rw");
         }
-        body = "\n" + decls.map((d) => d.replace(/= (\w+)_rw;/, "= $1;")).join("\n") + "\n" + body;
+        if (decls.length > 0) {
+          body = "\n" + decls.map((d) => d.replace(/= (\w+)_rw;/, "= $1;")).join("\n") + "\n" + body;
+        }
         code = head + body;
       }
     }
   }
   code = code.replace(/\[(?:unroll|loop|branch|flatten)\]\s*/g, "");
   code = code.replace(/\bstatic\s+/g, "");
+  if (forHoles.length > 0) {
+    code = code.replace(/\u0003(\u0004+)\u0003/g, (m, marks) => forHoles[marks.length - 1]);
+  }
   {
     const floatNames = /* @__PURE__ */ new Set();
     for (const m of code.matchAll(/\b(?:uniform[ \t]+)?(?:highp|mediump|lowp)?[ \t]*float[ \t]+([A-Za-z_]\w*)[ \t]*[;=]/g)) {
@@ -2485,6 +2903,9 @@ function hlsl2glsl(src, stage, combos, includeResolver, siblingSrc) {
       return line;
     }).join("\n");
   }
+  if (sciHoles.length > 0) {
+    code = code.replace(/\u0001(\u0002+)\u0001/g, (m, marks) => sciHoles[marks.length - 1]);
+  }
   let prologue = "#version 300 es\n";
   if (stage === "vert") {
     prologue += "precision highp float;\n";
@@ -2720,7 +3141,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 +3691,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 +3710,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();
@@ -3294,8 +3721,9 @@ function createRenderer(canvas, opts = {}) {
           uni.set(base, { loc: gl.getUniformLocation(prog, info.name), type: GL_TYPES[info.type] || "unknown", size: info.size });
         }
         const matMeta = { ...parseMaterialMeta(src.vert), ...parseMaterialMeta(src.frag) };
+        const ndcDirect = /gl_Position\s*=\s*vec4\s*\(\s*a_Position/.test(src.vert) && !/[aA]_Position[\s\S]{0,40}mul\s*\(/.test(src.vert);
         const samplerDefaults = new Map([...parseSamplerDefaults(src.vert), ...parseSamplerDefaults(src.frag)]);
-        const entry = { prog, uni, matMeta, samplerDefaults, fragGlsl, vertGlsl };
+        const entry = { prog, uni, matMeta, samplerDefaults, fragGlsl, vertGlsl, ndcDirect };
         progCache.set(key, entry);
         return entry;
       }
@@ -4047,7 +4475,13 @@ function createRenderer(canvas, opts = {}) {
     }
     const drawLayers = cam.perspective ? scene.layers.slice().sort((a, b) => Number(!!b.isSkybox) - Number(!!a.isSkybox)) : scene.layers;
     for (const layer of drawLayers) {
-      if (!layer.visible || layer.destroyed) continue;
+      if (layer.destroyed) continue;
+      if (!layer.visible) {
+        if (pendingEmptyCompose.has(layer.id)) {
+          captureEmptyComposeAtZOrder(layer, cam, viewProj, width, height);
+        }
+        continue;
+      }
       if (layer.isPostProcess && !(layer.effects || []).some((e) => e.visible)) continue;
       if (groupChildIds.has(layer.id)) continue;
       if (layer.isContainer) {
@@ -4477,7 +4911,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;
       }
@@ -4503,7 +4940,13 @@ function createRenderer(canvas, opts = {}) {
       gl.bindFramebuffer(gl.FRAMEBUFFER, outFBO.fbo);
       gl.viewport(0, 0, outFBO.width, outFBO.height);
       gl.bindVertexArray(vao);
-      uploadQuad("pass", PASS_QUAD);
+      const usePixelQuad = !progEntry.ndcDirect;
+      if (usePixelQuad) {
+        uploadQuad("passPx" + outFBO.width + "x" + outFBO.height, layerQuad(outFBO.width, outFBO.height));
+      } else {
+        uploadQuad("pass", PASS_QUAD);
+      }
+      const passMVP = usePixelQuad ? mat4Transpose(mat4Ortho(0, outFBO.width, 0, outFBO.height, -1e4, 1e4)) : IDENT_M4;
       const texNames = mp.textures || [];
       const maxTex = Math.max(texNames.length, 8);
       const resolutions = /* @__PURE__ */ new Map();
@@ -4532,7 +4975,7 @@ function createRenderer(canvas, opts = {}) {
         usedUnits.add(ti);
         resolutions.set(ti, [t.width, t.height, t.width, t.height]);
       }
-      bindSystemUniforms(uni, layer, time, cam.projW, cam.projH, IDENT_M4, layerOrtho, IDENT_M4, resolutions, layerOrtho, cam);
+      bindSystemUniforms(uni, layer, time, cam.projW, cam.projH, passMVP, layerOrtho, IDENT_M4, resolutions, layerOrtho, cam);
       bindConstants(
         uni,
         animatedConstants(
@@ -4827,6 +5270,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 +5288,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 +5363,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 +5376,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 +5430,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 +5472,8 @@ class Particle {
     this.turbSpeed = 0;
     this.turbPhase = 0;
     this.trail = null;
+    this.trailClock = 0;
+    this.seq = 0;
   }
 }
 class ParticleSystem {
@@ -5018,20 +5482,7 @@ class ParticleSystem {
     this.model = model || {};
     this.override = override || {};
     this.layer = layer || null;
-    const lo = layer && layer.origin ? layer.origin : [0, 0, 0];
-    const ls = layer && layer.scale ? layer.scale : [1, 1, 1];
-    const la = layer && layer.angles ? layer.angles : [0, 0, 0];
-    this.originX = lo[0] || 0;
-    this.originY = lo[1] || 0;
-    this.originZ = lo[2] || 0;
-    this.scaleX = ls[0] === 0 ? 1 : ls[0];
-    this.scaleY = ls[1] === 0 ? 1 : ls[1];
-    this.angleZ = (la[2] || 0) * Math.PI / 180;
-    const asx = Math.abs(this.scaleX);
-    const asy = Math.abs(this.scaleY);
-    this.sysScale = Math.min(asx, asy) || 1;
-    this.spriteStretchX = asx / this.sysScale;
-    this.spriteStretchY = asy / this.sysScale;
+    this.syncLayerTransform();
     this.maxCount = Math.max(1, Math.min(2e4, num(this.model.maxcount, 100)));
     this.simTime = 0;
     this.paused = false;
@@ -5070,6 +5521,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 +5800,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;
@@ -5423,6 +5887,31 @@ class ParticleSystem {
   setVisible(v) {
     this.visible = v;
   }
+  /**
+   * [we-scene patch] 从图层重新读取变换（构造时也走这里）。
+   *
+   * 发射器变换原先只在构造时缓存一次、之后**从不刷新**。父组一旦带脚本/动画
+   * 变换（全库 17 个粒子层有脚本化祖先），图层被 recomposeWorld 挪走了，
+   * 粒子却仍从旧位置喷出来 —— 画面上是「人物滑走了、他的火焰留在原地」。
+   * 宿主在 recompose 之后对脏子树里的粒子层调用本方法。
+   */
+  syncLayerTransform() {
+    const layer = this.layer;
+    const lo = layer && layer.origin ? layer.origin : [0, 0, 0];
+    const ls = layer && layer.scale ? layer.scale : [1, 1, 1];
+    const la = layer && layer.angles ? layer.angles : [0, 0, 0];
+    this.originX = lo[0] || 0;
+    this.originY = lo[1] || 0;
+    this.originZ = lo[2] || 0;
+    this.scaleX = ls[0] === 0 ? 1 : ls[0];
+    this.scaleY = ls[1] === 0 ? 1 : ls[1];
+    this.angleZ = (la[2] || 0) * Math.PI / 180;
+    const asx = Math.abs(this.scaleX);
+    const asy = Math.abs(this.scaleY);
+    this.sysScale = Math.min(asx, asy) || 1;
+    this.spriteStretchX = asx / this.sysScale;
+    this.spriteStretchY = asy / this.sysScale;
+  }
   // 宿主每帧提供鼠标位置（世界像素）；转到局部空间供控制点使用
   setPointer(worldX, worldY) {
     const dx = worldX - this.originX;
@@ -5494,6 +5983,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 +6130,7 @@ class ParticleSystem {
         p.trail[i + 1] = p.y;
         p.trail[i + 2] = p.z;
       }
+      p.trailClock = 0;
     }
   }
   // ---------- 每粒子更新 ----------
@@ -5790,10 +6281,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 +6389,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 +6424,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 +6459,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 +6516,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 +6528,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 +6663,9 @@ const particlesMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.define
   particleInstanceSegs,
   particlePassRefract,
   rgbaIsBlankWhite,
+  ropeParticleV,
+  ropeTrailDuration,
+  ropeTrailHistoryCount,
   spriteTrailLengthFactor,
   spriteTrailRotation
 }, Symbol.toStringTag, { value: "Module" }));
@@ -6194,7 +6771,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 +6784,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 +7499,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 +7618,7 @@ function isBuiltinParticleTextureName(name) {
 const particleTexMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   buildBuiltinParticleTexture,
+  builtinParticleFrames,
   isBuiltinParticleTextureName,
   listBuiltinParticleTextureNames,
   particleNormalNameForAlbedo,
@@ -7623,6 +8236,11 @@ 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;
+    }
+    layer.attachBindDelta = [d[0], d[1]];
     follows.push({
       layer,
       parent,
@@ -7637,6 +8255,9 @@ function applyAttachmentBindOrigins(layers) {
     f.baseY = f.layer.origin[1];
     f.subtree = [{ layer: f.layer, x: f.layer.origin[0], y: f.layer.origin[1] }];
     for (const c of f.desc) f.subtree.push({ layer: c, x: c.origin[0], y: c.origin[1] });
+    for (const s of f.subtree) {
+      if (!s.layer.attachBase) s.layer.attachBase = [s.x, s.y];
+    }
   }
   return follows;
 }
@@ -7662,14 +8283,20 @@ function followAttachments(follows, time, getBoneOverrides) {
     }
     deltas.push(parentMeshToWorldDelta(f.parent, cur[12] - f.bindX, cur[13] - f.bindY));
   }
+  const baseOf = (s) => {
+    const ab = s.layer.attachBase;
+    if (ab) return ab;
+    return [s.x, s.y];
+  };
   const seen = /* @__PURE__ */ new Set();
   for (const f of follows) {
     const tree = f.subtree || [{ layer: f.layer, x: f.baseX, y: f.baseY }];
     for (const s of tree) {
       if (seen.has(s.layer)) continue;
       seen.add(s.layer);
-      s.layer.origin[0] = s.x;
-      s.layer.origin[1] = s.y;
+      const b = baseOf(s);
+      s.layer.origin[0] = b[0];
+      s.layer.origin[1] = b[1];
     }
   }
   for (let i = 0; i < follows.length; i++) {
@@ -7930,10 +8557,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 +8937,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 +8983,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]）。
@@ -8549,6 +9183,19 @@ function evalTextScript(script, scriptprops, opts = {}) {
         if (opts.onError) opts.onError(e, "applyUserProperties");
       }
     },
+    /** 直调 update 不做文本加工：层可见性脚本（visible.script）要拿原始返回值
+     *  ——布尔控可见，callUpdate 会把它吞成 null（防画到画面上的文字版语义）。 */
+    callUpdateRaw(value) {
+      if (!fns.update || sandbox.disabled) return void 0;
+      try {
+        return fns.update(value);
+      } catch (e) {
+        sandbox.errCount++;
+        if (opts.onError) opts.onError(e, "update");
+        if (sandbox.errCount >= 3) sandbox.disabled = true;
+        return void 0;
+      }
+    },
     /** 求值当前文本：返回新文本；undefined/null 保留原值；连续出错 3 次熔断回退静态文本 */
     callUpdate(value) {
       if (!fns.update || sandbox.disabled) return null;
@@ -9240,13 +9887,8 @@ function makeObjectLayerProxy(layer, opts) {
     Object.defineProperty(proxy, key, {
       enumerable: true,
       get() {
-        if (layer && Array.isArray(layer[key])) {
-          const a = layer[key];
-          store[key].x = a[0] || 0;
-          store[key].y = a[1] || 0;
-          store[key].z = a[2] || 0;
-        }
-        return store[key];
+        const a = layer && Array.isArray(layer[key]) ? layer[key] : null;
+        return makeVec3(a || [0, 0, 0]);
       },
       set(v) {
         const a = normVec(v);
@@ -9299,7 +9941,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 || {},
@@ -9442,7 +10084,8 @@ function evalObjectScript(script, scriptprops, opts = {}) {
   const hasCursorHook = !!(fns && (fns.cursorClick || fns.cursorEnter || fns.cursorLeave || fns.cursorDown || fns.cursorUp || fns.cursorMove));
   const hasMediaHook = !!(fns && MEDIA_CALLBACKS.some((n) => fns[n]));
   const hasApplyHook = !!(fns && typeof fns.applyUserProperties === "function");
-  if (!fns || !fns.update && !hasCursorHook && !hasMediaHook && !hasApplyHook) return null;
+  const usesEngineClock = /\bengine\s*\.\s*(runtime|frametime)\b/.test(body);
+  if (!fns || !fns.update && !hasCursorHook && !hasMediaHook && !hasApplyHook && !usesEngineClock) return null;
   const sandbox = {
     engine,
     scriptProperties: spValues,
@@ -9734,7 +10377,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);
@@ -9743,14 +10386,14 @@ function createEngineTimers(host = {}, opts = {}) {
     cancel.handle = state.handle;
     return cancel;
   }
-  function clearTimeout(h) {
+  function clearTimeout2(h) {
     if (typeof h === "function") {
       h();
       return;
     }
     if (clearT && h != null) clearT(h);
   }
-  function clearInterval(h) {
+  function clearInterval2(h) {
     if (typeof h === "function") {
       h();
       return;
@@ -9763,9 +10406,9 @@ function createEngineTimers(host = {}, opts = {}) {
   }
   return {
     setTimeout,
-    setInterval,
-    clearTimeout,
-    clearInterval,
+    setInterval: setInterval2,
+    clearTimeout: clearTimeout2,
+    clearInterval: clearInterval2,
     dispose,
     /** 测试与诊断用：尚未触发且未取消的定时器数 */
     pendingCount: () => pending.size
@@ -9815,11 +10458,13 @@ 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 preL64 = new Float32Array(BANDS2);
+  const preR64 = 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);
@@ -9831,12 +10476,21 @@ function createSimulatedAudio(seed = 20260830) {
     right32,
     left16,
     right16,
+    /**
+     * 未钳位（pre-GAIN、pre-clamp）的 64 band，含左右声道 pan。
+     * left64/right64 是 `min(1, v*GAIN)` 之后的值：底鼓段基底就已到 ~0.6、峰值贴 1，
+     * 波峰因数被压平——网页作者按「峰值过阈值」判定敲击时（1520828134 猫爪
+     * `audioArray[i] > 0.5`），事后再乘任何标量都无法把基底与峰值分开。
+     * 网页驱动改对本数组做 gamma 对比扩展，音条墙仍走已标定的 left64/right64。
+     */
+    preL64,
+    preR64,
     /** vumeter：整体响度 0..1（粒子 audioprocessing / 文字脚本 average 用） */
     level: 0,
     /** 渲染器诊断：当前是否处于「静音段」 */
     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 +10517,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;
@@ -9876,6 +10530,7 @@ function createSimulatedAudio(seed = 20260830) {
       if (fq >= 0.45) v += hatV * 0.5 * ((fq - 0.45) / 0.55);
       v += riser * 0.5;
       v *= tilt;
+      const vPre = v;
       v = Math.min(1, v * GAIN);
       const width = 0.06 + fq * 0.2;
       const pan = vnoise(beat * 0.13 + i * 0.35, 11) * width;
@@ -9884,14 +10539,16 @@ function createSimulatedAudio(seed = 20260830) {
       const floorV = silent ? 0.012 : 0;
       rawL[i] = Math.max(floorV, l);
       rawR[i] = Math.max(floorV, r);
+      preL64[i] = Math.max(floorV, Math.max(0, vPre * (1 - pan)));
+      preR64[i] = Math.max(floorV, Math.max(0, vPre * (1 + pan)));
       if (i < 48) levelSum += (rawL[i] + rawR[i]) * 0.5;
     }
     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 +10557,7 @@ function createSimulatedAudio(seed = 20260830) {
     update,
     snapshot,
     /** 频段基数 */
-    bands: BANDS
+    bands: BANDS2
   };
 }
 function fillAudioBuffers(views, snapshot) {
@@ -9922,7 +10579,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 +10704,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 +10771,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 +10813,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 +10830,7 @@ function createSimulatedMedia(seed = 20260901) {
     snapshot,
     tracks,
     cycle,
-    MEDIA_PLAYBACK,
+    MEDIA_PLAYBACK: MEDIA_PLAYBACK$1,
     skipNext,
     skipPrevious,
     play,
@@ -10281,7 +10938,7 @@ function cloneMediaSnapshot(s) {
 }
 const mediaMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  MEDIA_PLAYBACK,
+  MEDIA_PLAYBACK: MEDIA_PLAYBACK$1,
   cloneMediaSnapshot,
   createSimulatedMedia,
   diffMediaEvents,
@@ -10381,15 +11038,7 @@ function createPointerSource(opts = {}) {
     state.screenH = v.h || 1;
   }
   readViewport();
-  function onMove(ev) {
-    readViewport();
-    let x = ev.clientX;
-    let y = ev.clientY;
-    if (target && typeof target.getBoundingClientRect === "function") {
-      const r = target.getBoundingClientRect();
-      x -= r.left;
-      y -= r.top;
-    }
+  function applyMove(x, y) {
     const u = x / state.screenW;
     const v = y / state.screenH;
     if (!state.has) {
@@ -10406,18 +11055,35 @@ function createPointerSource(opts = {}) {
     state.moveCount++;
     state.lastEventTime = Date.now();
   }
+  function applyButtons(mask) {
+    const left = (mask & 1) !== 0;
+    if (left === state.leftDown) return;
+    state.leftDown = left;
+    if (left) state.downCount++;
+    else state.upCount++;
+    state.lastEventTime = Date.now();
+  }
+  function onMove(ev) {
+    readViewport();
+    let x = ev.clientX;
+    let y = ev.clientY;
+    if (target && typeof target.getBoundingClientRect === "function") {
+      const r = target.getBoundingClientRect();
+      x -= r.left;
+      y -= r.top;
+    }
+    applyMove(x, y);
+  }
   function onDown(ev) {
     if (ev.button !== void 0 && ev.button !== 0) return;
-    state.leftDown = true;
-    state.downCount++;
+    applyButtons(1);
   }
   function onUp(ev) {
     if (ev.button !== void 0 && ev.button !== 0) return;
-    state.leftDown = false;
-    state.upCount++;
+    applyButtons(0);
   }
   function onLeaveWindow() {
-    state.leftDown = false;
+    applyButtons(0);
   }
   let attached = false;
   if (target && target.addEventListener) {
@@ -10433,9 +11099,45 @@ function createPointerSource(opts = {}) {
   return {
     state,
     /**
-     * 每帧所有消费方读完 current/last **之后**调用一次：把 last 推到 current。
-     * 事件驱动下 current 在 rAF 之间已被 mousemove 更新；消费前调用会把
-     * 帧间位移抹成 0（见文件头注释）。
+     * 外部注入指针状态（宿主轮询系统鼠标后推入）。协议见 docs/INTEGRATION.md。
+     *
+     * 接**归一化**坐标而不是像素：宿主知道自己那块屏的 points 尺寸，除法在它那边
+     * 做更准（混合 DPI 多显示器下无需任何 DPR 折算）；这里再乘回 screenW/H 得到
+     * input.cursorScreenPosition 要的像素。
+     *
+     * u/v 是 [0,1]、原点左上、**Y 朝下** —— 与 DOM 路径的 state.u/v 同一空间
+     * （见文件头坐标约定）。宿主不要替 shader 翻 Y。
+     *
+     * 不在这里推进 last：外部推送频率（~90Hz）高于帧率，若在推送里推进 last，
+     * `length(g_PointerPosition - g_PointerPositionLast)` 会恒接近 0，
+     * cursorripple 完全不起波且无报错（与 DOM 路径同一个坑，见文件头）。
+     *
+     * @param {{u:number, v:number, buttons?:number}} p 归一化位置 + 按键位掩码（bit0 左）
+     */
+    pushExternal(p) {
+      if (!p) return;
+      readViewport();
+      const u = Number(p.u);
+      const v = Number(p.v);
+      if (Number.isFinite(u) && Number.isFinite(v)) {
+        applyMove(u * state.screenW, v * state.screenH);
+      }
+      applyButtons(Number(p.buttons) || 0);
+    },
+    /**
+     * 外部指针离开本窗口（鼠标移到了别的显示器）。
+     *
+     * **只清按键，保留位置与 has** —— 清 has 会让 xray 开窗突然跳到相机外
+     * （renderer.js 的 XRAY_IDLE_SCREEN_UV）、视差弹回中心，画面会明显抽一下。
+     * 语义与 DOM 的 onLeaveWindow 一致：位置停在最后已知点，只是不再按着键。
+     */
+    pushExternalLeave() {
+      applyButtons(0);
+    },
+    /**
+     * 每帧所有消费方读完 current/last **之后**调用一次：把 last 推到 current。
+     * 事件驱动下 current 在 rAF 之间已被 mousemove 更新；消费前调用会把
+     * 帧间位移抹成 0（见文件头注释）。
      */
     beginFrame() {
       readViewport();
@@ -10958,6 +11660,21 @@ function httpSource(baseUrl, init) {
       } catch {
         return null;
       }
+    },
+    async webEntry(signal) {
+      let file = "index.html";
+      try {
+        const r = await fetch(`${base}/project.json`, { ...init, signal });
+        if (r.ok) {
+          const project = await r.json();
+          if (project && typeof project.file === "string" && project.file.trim()) {
+            file = project.file.trim().replace(/^\/+/, "");
+          }
+        }
+      } catch {
+        if (signal?.aborted) throw new Error("aborted");
+      }
+      return { url: `${base}/${file}` };
     }
   };
 }
@@ -11145,6 +11862,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 +12510,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 +12651,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",
@@ -11570,7 +12731,48 @@ const SYSTEM_FONT_FAMILIES = {
   systemfont_simhei: "SimHei, 'Heiti SC', sans-serif"
 };
 const fontFaceCache = /* @__PURE__ */ new Map();
+function fontKeyHash(key) {
+  let h = 5381;
+  for (let i = 0; i < key.length; i++) h = (h << 5) + h + key.charCodeAt(i) | 0;
+  return (h >>> 0).toString(36);
+}
+function releaseFontFaces(keys) {
+  for (const key of keys) {
+    const entry = fontFaceCache.get(key);
+    if (!entry) continue;
+    entry.refs--;
+    if (entry.refs > 0) continue;
+    fontFaceCache.delete(key);
+    try {
+      const dead = [];
+      document.fonts.forEach((f) => {
+        if (f.family === entry.family) dead.push(f);
+      });
+      for (const f of dead) document.fonts.delete(f);
+    } catch {
+    }
+  }
+}
 const pkgCache = /* @__PURE__ */ new Map();
+const PKG_CACHE_MAX_BYTES = 512 * 1024 * 1024;
+let pkgCacheBytes = 0;
+function pkgCacheEvict(currentKey) {
+  while (pkgCache.size > 0 && (pkgCache.size > 2 || pkgCacheBytes > PKG_CACHE_MAX_BYTES)) {
+    let oldestKey = null;
+    let oldestAt = Infinity;
+    for (const [k, v] of pkgCache) {
+      if (k === currentKey) continue;
+      if (v.at < oldestAt) {
+        oldestAt = v.at;
+        oldestKey = k;
+      }
+    }
+    if (!oldestKey) break;
+    const victim = pkgCache.get(oldestKey);
+    pkgCacheBytes -= victim.parsed.fileSize || 0;
+    pkgCache.delete(oldestKey);
+  }
+}
 async function loadParsedPkg(rt, cfg, source, signal) {
   const cacheKey = source.key;
   if (cacheKey) {
@@ -11593,38 +12795,40 @@ async function loadParsedPkg(rt, cfg, source, signal) {
   const parsed = pkg.parsePkg(bytes);
   if (!cacheKey) return parsed;
   pkgCache.set(cacheKey, { parsed, at: Date.now() });
-  if (pkgCache.size > 2) {
-    let oldestKey = null;
-    let oldestAt = Infinity;
-    for (const [k, v] of pkgCache) {
-      if (k === cacheKey) continue;
-      if (v.at < oldestAt) {
-        oldestAt = v.at;
-        oldestKey = k;
-      }
-    }
-    if (oldestKey) pkgCache.delete(oldestKey);
-  }
+  pkgCacheBytes += parsed.fileSize || 0;
+  pkgCacheEvict(cacheKey);
   return parsed;
 }
 function mountScene(rt, cfg) {
   clear(rt);
-  const c = cfg.canvas ?? document.createElement("canvas");
+  const c = (cfg.canvas instanceof HTMLCanvasElement ? cfg.canvas : null) ?? document.createElement("canvas");
   const dpr = effectiveDpr(rt, cfg);
   const vw = c.clientWidth || window.innerWidth || 1;
   const vh = c.clientHeight || window.innerHeight || 1;
   c.width = Math.max(1, Math.round(vw * dpr));
   c.height = Math.max(1, Math.round(vh * dpr));
-  if (!cfg.canvas) {
+  if (!(cfg.canvas instanceof HTMLCanvasElement)) {
     c.style.cssText = "position:absolute;inset:0;width:100%;height:100%;";
     rt.wrap?.appendChild(c);
   }
   rt.canvas = c;
   let disposed = false;
+  const origWarn = console.warn.bind(console);
+  console.warn = (...args) => {
+    const s = args.map((a) => typeof a === "string" ? a : String(a?.message ?? a)).join(" ");
+    if (s.includes("[we-scene]")) {
+      try {
+        reportDiag(rt, cfg, s.slice(0, 300));
+      } catch {
+      }
+    }
+    origWarn(...args);
+  };
   const pkgAbort = new AbortController();
   let particleCleanup;
   rt.sceneCleanup = () => {
     disposed = true;
+    console.warn = origWarn;
     pkgAbort.abort();
     rt.sceneTextUpdate = void 0;
     if (particleCleanup) {
@@ -11681,6 +12885,11 @@ function mountScene(rt, cfg) {
       const sceneEntry = pkg.getEntry(parsedPkg, "scene.json");
       if (!sceneEntry) throw new Error("pkg 中没有 scene.json（不是场景壁纸？）");
       const scene = scn.parseScene(JSON.parse(readText(sceneEntry)), project);
+      if (cfg.clearColor) {
+        const g = scene.general ??= {};
+        g.clearcolor = cfg.clearColor;
+        g.clearenabled = true;
+      }
       {
         const zRaw = scene.general?.zoom;
         const zVal = zRaw && typeof zRaw === "object" ? Number(zRaw.value) : Number(zRaw);
@@ -11751,6 +12960,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 +12988,108 @@ function mountScene(rt, cfg) {
         level: 0,
         silent: true
       };
-      renderer.setAudioProvider(() => audioSim.enabled ? simAudio.snapshot : SILENT_AUDIO);
+      const hostAudio = (() => {
+        const snapshot = {
+          left64: zero(64),
+          right64: zero(64),
+          left32: zero(32),
+          right32: zero(32),
+          left16: zero(16),
+          right16: zero(16),
+          // 未钳位频谱：网页驱动会对它做 gamma 对比扩展。宿主给的已是 0..1
+          // 归一化值，没有 pre-GAIN 概念，直接与 left64/right64 共用同一份数据
+          preL64: zero(64),
+          preR64: zero(64),
+          level: 0,
+          silent: true
+        };
+        const down = (dst, src) => {
+          const g = src.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 += src[j];
+            dst[i] = s / (i1 - i0);
+          }
+        };
+        return {
+          active: false,
+          snapshot,
+          /** 每帧从宿主拉一次。宿主返回 null（未采集/无权限）时置 active=false 回落模拟源 */
+          pump() {
+            const src = rt.audioBridge?.();
+            if (!src || !src.left || !src.right) {
+              this.active = false;
+              return;
+            }
+            const n = Math.min(64, src.left.length, src.right.length);
+            let sum = 0;
+            for (let i = 0; i < n; i++) {
+              const l = src.left[i] || 0;
+              const r = src.right[i] || 0;
+              snapshot.left64[i] = l;
+              snapshot.right64[i] = r;
+              snapshot.preL64[i] = l;
+              snapshot.preR64[i] = r;
+              if (i < 48) sum += l;
+            }
+            for (let i = n; i < 64; i++) {
+              snapshot.left64[i] = 0;
+              snapshot.right64[i] = 0;
+              snapshot.preL64[i] = 0;
+              snapshot.preR64[i] = 0;
+            }
+            down(snapshot.left32, snapshot.left64);
+            down(snapshot.right32, snapshot.right64);
+            down(snapshot.left16, snapshot.left64);
+            down(snapshot.right16, snapshot.right64);
+            snapshot.level = Math.min(1, sum / 48);
+            snapshot.silent = snapshot.level < 0.02;
+            this.active = true;
+          }
+        };
+      })();
+      const activeAudioSnapshot = () => hostAudio.active ? hostAudio.snapshot : audioDriverRef.current ? audioDriverRef.current.snapshot : simAudio.snapshot;
+      renderer.setAudioProvider(() => {
+        if (!audioSim.enabled) return SILENT_AUDIO;
+        return activeAudioSnapshot();
+      });
       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 +13098,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 +13127,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,
@@ -11871,6 +13181,10 @@ function mountScene(rt, cfg) {
         } : {}
       );
       renderer.setPointerProvider(() => pointerSrc);
+      rt.pointerCtl = {
+        push: (p) => pointerSrc.pushExternal(p),
+        leave: () => pointerSrc.pushExternalLeave()
+      };
       {
         const prevCleanup = particleCleanup;
         particleCleanup = () => {
@@ -11964,6 +13278,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 +13581,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 +13628,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;
@@ -12253,6 +13686,7 @@ function mountScene(rt, cfg) {
         if (usedVisible && !rt.paused) texEntry.videoCtl.play();
       }
       const particleSystems = [];
+      const particleDirty = [];
       const particleSystemsByLayer = /* @__PURE__ */ new Map();
       let builtinTexCount = 0;
       const loadParticleTex = async (name) => {
@@ -12266,7 +13700,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++;
@@ -12468,12 +13905,15 @@ function mountScene(rt, cfg) {
             const py = originY != null ? originY : wy;
             for (const ps of particleSystems) ps.setPointer(wx, py);
           }
-          for (const ps of particleSystems) ps.advance(pdt, audioSim.enabled ? simAudio.snapshot : null);
+          if (particleDirty.length) {
+            for (const ps of particleDirty) ps.syncLayerTransform();
+          }
+          for (const ps of particleSystems) ps.advance(pdt, audioSim.enabled ? activeAudioSnapshot() : null);
           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 +13932,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 +13941,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 +13953,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) => {
@@ -12653,6 +14093,17 @@ function mountScene(rt, cfg) {
       if (attachFollows.length) {
         reportDiag(rt, cfg, `attachments: ${attachFollows.length} hanging layers`);
       }
+      const transformDirty = scn.collectTransformDirty(
+        scene.layers,
+        attachFollows.map((f) => f.layer)
+      );
+      if (transformDirty.size) {
+        reportDiag(rt, cfg, `transform graph: ${transformDirty.size} live layers`);
+        for (const [lid, list] of particleSystemsByLayer) {
+          if (!transformDirty.has(lid)) continue;
+          for (const ps of list) particleDirty.push(ps);
+        }
+      }
       const textWidgets = [];
       const textLayerText = /* @__PURE__ */ new Map();
       const textShared = {};
@@ -12666,15 +14117,19 @@ function mountScene(rt, cfg) {
         const win0 = fitWindow(normalizeFit(rt.cfg.fit), projW, projH, c.width, c.height);
         const quality = Math.min(3, Math.max(0.5, c.width / Math.max(1, win0.viewW)));
         const fontFamilies = /* @__PURE__ */ new Map();
+        const usedFontKeys = [];
         const fontPaths = /* @__PURE__ */ new Set();
         for (const l of scene.layers) if (l.isText && l.textFont) fontPaths.add(l.textFont);
         for (const e of parsedPkg.entries || []) {
           if (typeof e.name === "string" && /^fonts\/.+\.(ttf|otf|woff2?)$/i.test(e.name)) fontPaths.add(e.name);
         }
         for (const fp of fontPaths) {
-          const cached = fontFaceCache.get(`${cfg.src}|${fp}`);
+          const key = `${cfg.src}|${fp}`;
+          const cached = fontFaceCache.get(key);
           if (cached) {
-            fontFamilies.set(fp, cached);
+            cached.refs++;
+            usedFontKeys.push(key);
+            fontFamilies.set(fp, cached.family);
             continue;
           }
           const sys = SYSTEM_FONT_FAMILIES[fp.toLowerCase()];
@@ -12685,18 +14140,33 @@ function mountScene(rt, cfg) {
           try {
             const fe = pkg.getEntry(parsedPkg, fp);
             if (!fe) continue;
-            const fam = "wefont_" + fp.split("/").pop().replace(/[^a-zA-Z0-9]/g, "_");
-            const url = URL.createObjectURL(new Blob([fe]));
+            const bytes = sanitizeFontForBrowser(
+              fe instanceof Uint8Array ? fe : new Uint8Array(fe)
+            );
+            const fam = "wefont_" + fontKeyHash(key) + "_" + fp.split("/").pop().replace(/[^a-zA-Z0-9]/g, "_");
+            const url = URL.createObjectURL(new Blob([bytes]));
             const ff = new FontFace(fam, `url(${url})`);
             await ff.load();
+            if (disposed) {
+              URL.revokeObjectURL(url);
+              break;
+            }
             document.fonts.add(ff);
             (rt.objectUrls ??= []).push(url);
             fontFamilies.set(fp, fam);
-            fontFaceCache.set(`${cfg.src}|${fp}`, fam);
+            fontFaceCache.set(key, { family: fam, refs: 1 });
+            usedFontKeys.push(key);
           } catch (e) {
             console.warn(`字体加载失败 ${fp}: ${e.message}`);
           }
         }
+        if (usedFontKeys.length) {
+          const prevCleanup = rt.sceneCleanup;
+          rt.sceneCleanup = () => {
+            releaseFontFaces(usedFontKeys);
+            prevCleanup?.();
+          };
+        }
         textCanvas = document.createElement("canvas");
         textCtx = textCanvas.getContext("2d");
         const MAX_TEX = 2048;
@@ -12730,7 +14200,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) => {
@@ -12749,10 +14219,18 @@ function mountScene(rt, cfg) {
               const hw = layer.size[0] * (layer.scale[0] || 1) / 2;
               const hh = layer.size[1] * (layer.scale[1] || 1) / 2;
               const a = layer.textAnchor;
-              if (a.includes("left")) layer.origin[0] += hw;
-              if (a.includes("right")) layer.origin[0] -= hw;
-              if (a.includes("top")) layer.origin[1] -= hh;
-              if (a.includes("bottom")) layer.origin[1] += hh;
+              let adx = 0;
+              let ady = 0;
+              if (a.includes("left")) adx += hw;
+              if (a.includes("right")) adx -= hw;
+              if (a.includes("top")) ady -= hh;
+              if (a.includes("bottom")) ady += hh;
+              layer.origin[0] += adx;
+              layer.origin[1] += ady;
+              if (layer.localOrigin) {
+                layer.localOrigin[0] += adx;
+                layer.localOrigin[1] += ady;
+              }
             }
             const em0 = TEXT_EM_SCALE * Math.max(1, layer.textPointsize);
             const marginCap = wtext.textLayerHasTintMask(layer) ? 8 : 256;
@@ -12978,7 +14456,7 @@ function mountScene(rt, cfg) {
             return clone;
           },
           mediaControl,
-          windowTitle: simWindow.snapshot,
+          windowTitle: windowDriver.snapshot,
           openUserShortcut: shortcuts.openUserShortcut,
           isScreensaver: false
         };
@@ -12995,6 +14473,15 @@ function mountScene(rt, cfg) {
             if (sb && sb.hasMediaHook) registerMediaHook(sb);
           }
         });
+        const LOCAL_SLOT = {
+          origin: "localOrigin",
+          scale: "localScale",
+          angles: "localAngles"
+        };
+        const fieldSlot = (layer, field) => {
+          const slot = LOCAL_SLOT[field];
+          return slot && layer && Array.isArray(layer[slot]) ? slot : field;
+        };
         for (const layer of scene.layers) {
           const defs = layer.objectAnimations;
           if (!defs) continue;
@@ -13005,11 +14492,13 @@ 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 slot = fieldSlot(layer, field);
+              const live2 = layer[slot];
+              ctrl.baseNumeric = Array.isArray(live2) ? live2.slice() : live2;
+              ctrl.slot = slot;
               layer.animationList.push(ctrl);
               if (ctrl.name) layer.animations[ctrl.name] = ctrl;
-              animRuns.push({ layer, field, ctrl });
+              animRuns.push({ layer, field, slot, ctrl });
             } catch (e) {
               reportDiag(rt, cfg, `animation '${layer.name}.${field}' 建控制器失败: ${String(e.message).slice(0, 80)}`);
             }
@@ -13074,7 +14563,8 @@ function mountScene(rt, cfg) {
               });
               if (sandbox) {
                 propSandboxes.push(sandbox);
-                const fieldVal = layer[field];
+                const initSlot = fieldSlot(layer, field);
+                const fieldVal = layer[initSlot];
                 const initArg = field === "angles" && Array.isArray(fieldVal) ? wtext.radToScriptAngles(fieldVal) : Array.isArray(fieldVal) ? { x: fieldVal[0] ?? 0, y: fieldVal[1] ?? 0, z: fieldVal[2] ?? 0 } : fieldVal;
                 sandbox.init(initArg);
                 sandbox.applyUserProperties(objUserProps);
@@ -13084,6 +14574,8 @@ function mountScene(rt, cfg) {
                   objectScriptRuns.push({
                     layer,
                     field,
+                    // 变换字段逐帧也在 local 槽上收发（与 init 同一空间）。
+                    slot: initSlot,
                     kind: field === "visible" ? "bool" : field === "alpha" || field === "brightness" ? "scalar" : "vec3",
                     sandbox
                   });
@@ -13147,6 +14639,7 @@ function mountScene(rt, cfg) {
         window.__objScripts = objectScriptRuns;
       }
       window.__mediaHooks = mediaHooks;
+      window.__sceneLayers = scene.layers;
       window.__compositeStats = () => renderer.compositeStats?.() ?? null;
       window.__compositeEnable = (on) => renderer.setCompositeEnabled?.(on);
       window.__scene = scene;
@@ -13207,6 +14700,7 @@ function mountScene(rt, cfg) {
       const playingVideos = [];
       const playingAudios = [];
       let lastRender = -Infinity;
+      let lastAnimT = 0;
       const renderLoop = (now) => {
         if (disposed || rt.paused) return;
         const fps = rt.cfg.sceneFps || 60;
@@ -13223,8 +14717,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,38 +14728,42 @@ 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);
+          const animDt = Math.max(0, t - lastAnimT);
+          lastAnimT = t;
           for (const run of animRuns) {
-            run.ctrl.advance(interval / 1e3);
+            run.ctrl.advance(animDt);
             const field = run.field;
+            const slot = run.slot || field;
             const out = run.ctrl.applyTo(run.ctrl.baseNumeric);
             if (Array.isArray(out)) {
-              const cur = run.layer[field];
+              const cur = run.layer[slot];
               if (Array.isArray(cur)) for (let i = 0; i < out.length && i < cur.length; i++) cur[i] = out[i];
             } else if (Number.isFinite(out)) {
               if (field === "visible") run.layer[field] = !!out;
-              else run.layer[field] = out;
+              else run.layer[slot] = out;
             }
           }
           for (const run of generalAnimRuns) {
-            run.ctrl.advance(interval / 1e3);
+            run.ctrl.advance(animDt);
             const out = run.ctrl.applyTo(run.ctrl.baseNumeric);
             if (typeof out === "number" && Number.isFinite(out)) run.write(out);
             else if (Array.isArray(out) && Number.isFinite(out[0])) run.write(out[0]);
           }
           for (const run of effectVisibleRuns) {
             if (run.sandbox.disabled) continue;
-            run.sandbox.engine.frametime = interval / 1e3;
+            run.sandbox.engine.frametime = animDt;
             run.sandbox.engine.runtime = t;
             const ret = run.sandbox.callUpdate(!!run.effect.visible);
             if (typeof ret === "boolean") run.effect.visible = ret;
           }
           for (const run of generalScriptRuns) {
             if (run.sandbox.disabled) continue;
-            run.sandbox.engine.frametime = interval / 1e3;
+            run.sandbox.engine.frametime = animDt;
             run.sandbox.engine.runtime = t;
             const g = scene.general || {};
             const cur = g[run.field] && typeof g[run.field] === "object" && "value" in g[run.field] ? g[run.field].value : g[run.field];
@@ -13271,10 +14771,16 @@ function mountScene(rt, cfg) {
             if (ret !== void 0) run.write(ret);
           }
           const screenRes = { x: c.clientWidth || window.innerWidth || 1, y: c.clientHeight || window.innerHeight || 1 };
+          for (const sb of propSandboxes) {
+            if (!sb || sb.disabled) continue;
+            sb.engine.frametime = animDt;
+            sb.engine.runtime = t;
+            sb.engine.screenResolution = screenRes;
+          }
           let visibilityDirty = false;
           for (const run of objectScriptRuns) {
             if (run.sandbox.disabled) continue;
-            run.sandbox.engine.frametime = interval / 1e3;
+            run.sandbox.engine.frametime = animDt;
             run.sandbox.engine.runtime = t;
             run.sandbox.engine.screenResolution = screenRes;
             const cur = run.layer[run.field];
@@ -13295,16 +14801,23 @@ function mountScene(rt, cfg) {
               const n = Number(ret);
               if (Number.isFinite(n)) run.layer[run.field] = n;
             } else {
-              const v = run.field === "angles" ? wtext.radToScriptAngles(cur) : { x: cur[0] || 0, y: cur[1] || 0, z: cur[2] || 0 };
+              const slot = run.slot || run.field;
+              const lcur = run.layer[slot];
+              const v = run.field === "angles" ? wtext.radToScriptAngles(lcur) : { x: lcur[0] || 0, y: lcur[1] || 0, z: lcur[2] || 0 };
               const ret = run.sandbox.callUpdate(v);
               const o = ret && typeof ret === "object" && "x" in ret ? ret : v;
-              run.layer[run.field] = run.field === "angles" ? wtext.scriptAnglesToRad(o) : [o.x || 0, o.y || 0, o.z || 0];
+              run.layer[slot] = run.field === "angles" ? wtext.scriptAnglesToRad(o) : [o.x || 0, o.y || 0, o.z || 0];
             }
           }
           if (visibilityDirty) recomputeVisibility();
+          if (transformDirty.size) scn.recomposeWorld(scene.layers, transformDirty);
           if (audioSim.enabled) {
-            simAudio.update(t);
-            fillAudioBuffers(audioViews, simAudio.snapshot);
+            hostAudio.pump();
+            if (!hostAudio.active) {
+              if (audioDriverRef.current) audioDriverRef.current.pump();
+              else simAudio.update(t);
+            }
+            fillAudioBuffers(audioViews, activeAudioSnapshot());
           }
           if (attachFollows.length) {
             mdl.followAttachments(attachFollows, t, getBoneOverrides);
@@ -13491,11 +15004,672 @@ function mountScene(rt, cfg) {
     }
   })();
 }
+const SHIM_MARK = 'data-we-shim="1"';
+const SHIM_ATTR = "data-we-shim-src";
+function entryDirUrl(entryUrl) {
+  try {
+    const u = new URL(entryUrl);
+    const path = u.pathname;
+    const i = path.lastIndexOf("/");
+    u.pathname = i < 0 ? "/" : path.slice(0, i + 1);
+    u.hash = "";
+    u.search = "";
+    return u.href;
+  } catch {
+    const s = entryUrl.replace(/[#?].*$/, "");
+    const i = s.lastIndexOf("/");
+    return i < 0 ? s : s.slice(0, i + 1);
+  }
+}
+function hasBlockingCsp(html) {
+  const re = /<meta[^>]+http-equiv\s*=\s*["']?Content-Security-Policy["']?[^>]*>/gi;
+  let m;
+  while (m = re.exec(html)) {
+    const tag = m[0];
+    const content = /content\s*=\s*"([^"]*)"/i.exec(tag)?.[1] ?? /content\s*=\s*'([^']*)'/i.exec(tag)?.[1] ?? "";
+    if (!/script-src/i.test(content)) continue;
+    if (/script-src[^;]*'unsafe-inline'/i.test(content)) continue;
+    if (/script-src[^;]*\*/i.test(content)) continue;
+    return true;
+  }
+  return false;
+}
+function escapeScriptClose(js) {
+  return js.replace(/<\/script/gi, "<\\/script");
+}
+function rewriteHtml(html, shimSource2, opts) {
+  if (!html) html = "";
+  if (html.includes(SHIM_MARK) || html.includes(SHIM_ATTR)) return html;
+  const base = opts.baseHref && !/<base\b/i.test(html) ? `<base href="${opts.baseHref.replace(/"/g, "&quot;")}">` : "";
+  const script = `<script ${SHIM_ATTR}="1">
+${escapeScriptClose(shimSource2)}
+<\/script>`;
+  const seed = opts.seedScript && opts.seedScript.trim() ? `<script>
+${escapeScriptClose(opts.seedScript)}
+<\/script>` : "";
+  const inject = `${base}${script}${seed}`;
+  const headOpen = /<head(\s[^>]*)?>/i.exec(html);
+  if (headOpen) {
+    const at = headOpen.index + headOpen[0].length;
+    return html.slice(0, at) + inject + html.slice(at);
+  }
+  const htmlOpen = /<html(\s[^>]*)?>/i.exec(html);
+  if (htmlOpen) {
+    const at = htmlOpen.index + htmlOpen[0].length;
+    return html.slice(0, at) + `<head>${inject}</head>` + html.slice(at);
+  }
+  return `<!DOCTYPE html><html><head>${inject}</head><body>${html}</body></html>`;
+}
+const shimSource = '/**\n * WE 网页壁纸兼容 shim（注入到 iframe，必须在作者脚本之前执行）。\n *\n * 语料：本机库 42 张 web 壁纸扫描（2026-09）——\n *   wallpaperPropertyListener 29 / RegisterAudioListener 22 /\n *   RequestRandomFileForProperty 8 / userDirectoryFiles* 9 /\n *   Media*Listener 2 / PluginListener 2\n *\n * 官方 CEF 在任何壁纸脚本前就把这些做成原生函数；工坊顶层直接注册。\n * 本文件作为 <head> 首个 classic script 插入。\n *\n * 父页控制面 __we*（main.ts weShimCall / web.ts 泵）：\n *   __weSetPaused / __weSetFps / __weSetVolume / __weApplyProps / __weSeedProps\n *   __wePushAudio(arr128)\n *   __wePushMedia(event)  — {op, payload} 见下\n *   __wePushDirectoryFiles(prop, files) / __weRemoveDirectoryFiles(prop, files)\n *   __weRewriteFileUrl(s) — file:/// → 同源相对（HTTP 页）；空 file:/// → ""\n *   __wePushPointer(x, y, buttons) / __wePointerLeave() — 外部指针注入（见文末）\n */\n(function (w) {\n  "use strict";\n  try {\n    if (w.document && w.document.documentElement) {\n      w.document.documentElement.setAttribute("data-we-shim", "1");\n    }\n  } catch (_) {\n    /* 忽略 */\n  }\n\n  var audioListener = null;\n  var propertyListener = null;\n  var paused = false;\n  var fps = 60;\n  var volume = 0;\n  var pendingProps = null;\n  var pendingGeneral = null;\n  var rafMap = Object.create(null);\n  var rafCounter = 0;\n  var origRaf = w.requestAnimationFrame.bind(w);\n  var origCaf = w.cancelAnimationFrame.bind(w);\n\n  // 官方 CEF 以文件系统为源，作者普遍 `\'file:///\' + value`。HTTP 同源页里\n  // file:///files/x.webm 加载失败；空 value 变成 file:///（1748506393）。\n  // file: 协议页保持原样（真本地嵌入）。\n  function rewriteBareFileUrl(url) {\n    if (typeof url !== "string") return url;\n    var s = url.trim();\n    if (!/^file:/i.test(s)) return s;\n    try {\n      var loc = w.location;\n      if (loc && loc.protocol === "file:") return s;\n    } catch (_) {\n      /* 忽略 */\n    }\n    var rest = s.replace(/^file:\\/\\//i, "").replace(/^\\/+/, "");\n    if (!rest) return "";\n    if (/^[a-zA-Z][:|]/.test(rest)) return "";\n    if (/^(Users|home|tmp|var|etc|private|Volumes)\\//.test(rest)) return "";\n    try {\n      var href = w.location && w.location.href;\n      if (href) return new URL(rest, href).href;\n    } catch (_) {\n      /* 忽略 */\n    }\n    return rest;\n  }\n\n  function rewriteWeFileUrl(input) {\n    if (typeof input !== "string") return input;\n    if (/url\\(/i.test(input)) {\n      return input.replace(/url\\(\\s*([\'"]?)([^)\'"]*?)\\1\\s*\\)/gi, function (_m, q, inner) {\n        var next = rewriteBareFileUrl(inner);\n        if (!next) return "none";\n        var quote = q || \'"\';\n        return "url(" + quote + next + quote + ")";\n      });\n    }\n    return rewriteBareFileUrl(input);\n  }\n\n  w.__weRewriteFileUrl = rewriteWeFileUrl;\n\n  function installFileUrlHooks() {\n    try {\n      if (w.Element && w.Element.prototype && typeof w.Element.prototype.setAttribute === "function") {\n        var origSetAttr = w.Element.prototype.setAttribute;\n        w.Element.prototype.setAttribute = function (name, value) {\n          var n = String(name || "").toLowerCase();\n          if (n === "src" || n === "href" || n === "poster") value = rewriteWeFileUrl(value);\n          return origSetAttr.call(this, name, value);\n        };\n      }\n    } catch (_) {\n      /* 无 DOM 的 verifier 跳过 */\n    }\n    var ctorNames = ["HTMLImageElement", "HTMLMediaElement", "HTMLSourceElement", "HTMLScriptElement"];\n    for (var i = 0; i < ctorNames.length; i++) {\n      try {\n        var Ctor = w[ctorNames[i]];\n        if (!Ctor || !Ctor.prototype) continue;\n        var desc = Object.getOwnPropertyDescriptor(Ctor.prototype, "src");\n        if (!desc || typeof desc.set !== "function") continue;\n        (function (d) {\n          Object.defineProperty(Ctor.prototype, "src", {\n            configurable: true,\n            enumerable: d.enumerable,\n            get: d.get,\n            set: function (v) {\n              d.set.call(this, rewriteWeFileUrl(v));\n            },\n          });\n        })(desc);\n      } catch (_) {\n        /* 忽略单个原型 */\n      }\n    }\n    try {\n      var styleDesc =\n        w.HTMLElement && Object.getOwnPropertyDescriptor(w.HTMLElement.prototype, "style");\n      // Chromium 的 backgroundImage 不是原型自有描述符，只能包 HTMLElement.style 的 Proxy。\n      if (styleDesc && typeof styleDesc.get === "function" && w.Proxy && w.WeakMap) {\n        var styleCache = new w.WeakMap();\n        Object.defineProperty(w.HTMLElement.prototype, "style", {\n          configurable: true,\n          enumerable: styleDesc.enumerable,\n          get: function () {\n            var raw = styleDesc.get.call(this);\n            if (!raw) return raw;\n            var cached = styleCache.get(raw);\n            if (cached) return cached;\n            var proxy = new w.Proxy(raw, {\n              set: function (target, prop, value) {\n                if (typeof value === "string" && typeof prop === "string" && /background/i.test(prop)) {\n                  value = rewriteWeFileUrl(value);\n                }\n                target[prop] = value;\n                return true;\n              },\n              get: function (target, prop) {\n                var v = target[prop];\n                if (typeof v === "function") return v.bind(target);\n                return v;\n              },\n            });\n            styleCache.set(raw, proxy);\n            return proxy;\n          },\n          set: styleDesc.set,\n        });\n      }\n      var styleProto = w.CSSStyleDeclaration && w.CSSStyleDeclaration.prototype;\n      if (styleProto && typeof styleProto.setProperty === "function") {\n        var origSetProp = styleProto.setProperty;\n        styleProto.setProperty = function (name, value, priority) {\n          if (typeof value === "string" && /background/i.test(String(name || ""))) {\n            value = rewriteWeFileUrl(value);\n          }\n          return origSetProp.call(this, name, value, priority);\n        };\n      }\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n  installFileUrlHooks();\n\n  // propertyName → string[]（绝对/相对路径；随机文件从此抽）\n  var directoryFiles = Object.create(null);\n\n  var mediaListeners = {\n    properties: null,\n    thumbnail: null,\n    playback: null,\n    timeline: null,\n    status: null,\n  };\n  // 晚注册时回放最近一帧（作者脚本常在 DOMContentLoaded 后才 Register）\n  var lastMedia = {\n    properties: null,\n    thumbnail: null,\n    playback: null,\n    timeline: null,\n    status: null,\n  };\n\n  function callApplyUserProperties(props) {\n    if (!propertyListener || typeof propertyListener.applyUserProperties !== "function") return;\n    try {\n      propertyListener.applyUserProperties(props || {});\n    } catch (_) {\n      /* 壁纸脚本抛错不打断宿主 */\n    }\n  }\n\n  function callApplyGeneralProperties(props) {\n    if (!propertyListener || typeof propertyListener.applyGeneralProperties !== "function") return;\n    try {\n      propertyListener.applyGeneralProperties(props || {});\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n\n  function callSetPaused(v) {\n    if (!propertyListener || typeof propertyListener.setPaused !== "function") return;\n    try {\n      propertyListener.setPaused(!!v);\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n\n  function callDirectoryAdded(prop, files) {\n    if (!propertyListener || typeof propertyListener.userDirectoryFilesAddedOrChanged !== "function")\n      return;\n    try {\n      propertyListener.userDirectoryFilesAddedOrChanged(prop, files);\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n\n  function callDirectoryRemoved(prop, files) {\n    if (!propertyListener || typeof propertyListener.userDirectoryFilesRemoved !== "function") return;\n    try {\n      propertyListener.userDirectoryFilesRemoved(prop, files);\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n\n  function flushPending() {\n    if (pendingProps) {\n      var p = pendingProps;\n      pendingProps = null;\n      callApplyUserProperties(p);\n    }\n    if (pendingGeneral) {\n      var g = pendingGeneral;\n      pendingGeneral = null;\n      callApplyGeneralProperties(g);\n    }\n  }\n\n  /**\n   * 工坊常在 React render 里写 `window.wallpaperPropertyListener = {…}`（2905017768）。\n   * 官方 CEF 不会在赋值当下同步回调 setPaused/apply*；若我们同步 flush，\n   * 等于 render 中 setState → React 熔断 → #root 空（一片黑）。\n   */\n  function afterAssign(fn) {\n    try {\n      if (typeof w.queueMicrotask === "function") w.queueMicrotask(fn);\n      else w.setTimeout(fn, 0);\n    } catch (_) {\n      try {\n        fn();\n      } catch (_) {\n        /* 忽略 */\n      }\n    }\n  }\n\n  function safeCall(fn, arg) {\n    if (typeof fn !== "function") return;\n    try {\n      fn(arg);\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n\n  // —— 媒体集成枚举（3747222633：缺省时 PLAYBACK_PLAYING||0 会把「播放」当成 0）——\n  w.wallpaperMediaIntegration = {\n    PLAYBACK_STOPPED: 0,\n    PLAYBACK_PLAYING: 1,\n    PLAYBACK_PAUSED: 2,\n  };\n\n  // —— 官方 API：音频 ——\n  w.wallpaperRegisterAudioListener = function (cb) {\n    audioListener = typeof cb === "function" ? cb : null;\n  };\n\n  // —— 官方 API：媒体 ——\n  w.wallpaperRegisterMediaPropertiesListener = function (cb) {\n    mediaListeners.properties = typeof cb === "function" ? cb : null;\n    if (mediaListeners.properties && lastMedia.properties) {\n      safeCall(mediaListeners.properties, lastMedia.properties);\n    }\n  };\n  w.wallpaperRegisterMediaThumbnailListener = function (cb) {\n    mediaListeners.thumbnail = typeof cb === "function" ? cb : null;\n    if (mediaListeners.thumbnail && lastMedia.thumbnail) {\n      safeCall(mediaListeners.thumbnail, lastMedia.thumbnail);\n    }\n  };\n  w.wallpaperRegisterMediaPlaybackListener = function (cb) {\n    mediaListeners.playback = typeof cb === "function" ? cb : null;\n    if (mediaListeners.playback && lastMedia.playback) {\n      safeCall(mediaListeners.playback, lastMedia.playback);\n    }\n  };\n  w.wallpaperRegisterMediaTimelineListener = function (cb) {\n    mediaListeners.timeline = typeof cb === "function" ? cb : null;\n    if (mediaListeners.timeline && lastMedia.timeline) {\n      safeCall(mediaListeners.timeline, lastMedia.timeline);\n    }\n  };\n  w.wallpaperRegisterMediaStatusListener = function (cb) {\n    mediaListeners.status = typeof cb === "function" ? cb : null;\n    if (mediaListeners.status && lastMedia.status) {\n      safeCall(mediaListeners.status, lastMedia.status);\n    }\n  };\n\n  // —— 官方 API：随机文件（slideshow）——\n  // 回调签名：function(propertyName, filePath)。无库存文件时 filePath 为空串（语料 if(i) 守卫）。\n  w.wallpaperRequestRandomFileForProperty = function (propertyName, callback) {\n    if (typeof callback !== "function") return;\n    var prop = String(propertyName || "");\n    var list = directoryFiles[prop];\n    var path = "";\n    if (list && list.length) {\n      path = String(list[(Math.random() * list.length) | 0] || "");\n    }\n    try {\n      callback(prop, path);\n    } catch (_) {\n      /* 忽略 */\n    }\n  };\n\n  // —— PropertyListener（getter/setter；回调延后到微任务，见 afterAssign）——\n  // 官方在页面加载完成后才发全量属性/暂停状态；首屏脚本（body onLoad=init 等）常\n  // 假设属性到达时 DOM/场景已初始化（827982449：applyUserProperties→cl() 在 load 前\n  // 跑会撞上未创建的 scene/material）。未加载完成时等 window load + 一个宏任务\n  // （保证排在 onLoad 属性处理器之后），已加载完成则微任务即发。\n  function whenPageReady(fn) {\n    var ready = "complete";\n    try {\n      ready = w.document.readyState;\n    } catch (_) {\n      /* 忽略 */\n    }\n    if (ready === "complete") {\n      afterAssign(fn);\n      return;\n    }\n    try {\n      w.addEventListener("load", function () {\n        // setTimeout 保证排在 load 同步链（onLoad 处理器）之后\n        w.setTimeout(fn, 0);\n      }, { once: true });\n    } catch (_) {\n      afterAssign(fn);\n    }\n  }\n  Object.defineProperty(w, "wallpaperPropertyListener", {\n    configurable: true,\n    enumerable: true,\n    get: function () {\n      return propertyListener;\n    },\n    set: function (v) {\n      var next = v && typeof v === "object" ? v : null;\n      var prev = propertyListener;\n      propertyListener = next;\n      if (!next) return;\n      // 仅首次注册补发挂载状态。官方 CEF 从不在赋值当下回调；2905017768 等 React 壁纸在\n      // 渲染体里重新赋值（新对象字面量），若每次都补 setPaused 会形成\n      // 渲染 → 赋值 → 补发 setState → 再渲染 的微任务死循环（点下一曲整页卡死）。\n      if (prev) return;\n      whenPageReady(function () {\n        flushPending();\n        callApplyGeneralProperties({ fps: fps });\n        callSetPaused(paused);\n        // 已缓存的目录文件补推一次（作者可能后挂 userDirectoryFilesAddedOrChanged）\n        for (var prop in directoryFiles) {\n          if (Object.prototype.hasOwnProperty.call(directoryFiles, prop) && directoryFiles[prop].length) {\n            callDirectoryAdded(prop, directoryFiles[prop].slice());\n          }\n        }\n      });\n    },\n  });\n\n  // —— Plugin（iCUE 等；无硬件时空实现，避免 if 判断失败）——\n  if (!w.wallpaperPluginListener) {\n    w.wallpaperPluginListener = {\n      onPluginLoaded: function () {},\n    };\n  }\n\n  // —— 定时器冻结：官方暂停 = "fully freeze the process that renders the wallpaper"，\n  // rAF 已在节流层挂起，这里冻结定时器：暂停期间新建的挂起登记、恢复时按原延迟/间隔\n  // 重新启动；**已启动**的真定时器到期由包装回调拦下——timeout 转挂起（恢复后立即补跑，\n  // 近似官方的剩余等待），interval 直接跳过该周期（恢复后从下个周期继续）。\n  var pendTimers = [];\n  var tmSeq = 0;\n  var TM_BASE = 0x40000000; // 假 id 段，避免与真实 timer id 混淆\n  var origST = w.setTimeout;\n  var origSI = w.setInterval;\n  var origCTO = w.clearTimeout;\n  var origCIT = w.clearInterval;\n  function guardTimeout(fn) {\n    if (typeof fn !== "function") return fn;\n    return function () {\n      if (paused) {\n        pendTimers.push({ id: 0, kind: "t", fn: fn, ms: 1, extra: [] });\n        return;\n      }\n      return fn.apply(this, arguments);\n    };\n  }\n  function guardInterval(fn) {\n    if (typeof fn !== "function") return fn;\n    return function () {\n      if (paused) return;\n      return fn.apply(this, arguments);\n    };\n  }\n  function startTimer(kind, fn, ms, extra) {\n    if (paused) {\n      var id = TM_BASE + ++tmSeq;\n      pendTimers.push({ id: id, kind: kind, fn: fn, ms: ms, extra: extra });\n      return id;\n    }\n    var args = [kind === "t" ? guardTimeout(fn) : guardInterval(fn), ms].concat(extra);\n    return (kind === "t" ? origST : origSI).apply(w, args);\n  }\n  w.setTimeout = function (fn, ms) {\n    return startTimer("t", fn, ms, Array.prototype.slice.call(arguments, 2));\n  };\n  w.setInterval = function (fn, ms) {\n    return startTimer("i", fn, ms, Array.prototype.slice.call(arguments, 2));\n  };\n  function unpend(id) {\n    for (var i = 0; i < pendTimers.length; i++) {\n      if (pendTimers[i].id === id) {\n        pendTimers.splice(i, 1);\n        return true;\n      }\n    }\n    return false;\n  }\n  w.clearTimeout = function (id) {\n    if (unpend(id)) return;\n    origCTO.call(w, id);\n  };\n  w.clearInterval = function (id) {\n    if (unpend(id)) return;\n    origCIT.call(w, id);\n  };\n  function resumeTimers() {\n    var list = pendTimers;\n    pendTimers = [];\n    for (var i = 0; i < list.length; i++) {\n      var t = list[i];\n      (t.kind === "t" ? origST : origSI).call(w, t.fn, t.ms, t.extra);\n    }\n  }\n\n  /**\n   * 恢复暂停期间被挂起的 rAF 请求。\n   *\n   * **不补跑这些回调，主循环就永久断掉**（1278092907 Monstercat：`draw()` 在函数体\n   * 开头就 `requestAnimationFrame(draw)` 再画，暂停期间那次请求被登记成 hold，\n   * 恢复后没人跑它 → 整条链没有下一帧，画面永久定格，且没有任何报错）。\n   * 这是 rAF 自递归的通用形态，不是这一张的特例。\n   *\n   * 走 `w.requestAnimationFrame` 而不是 `origRaf`：此时已 unpaused，要让它重新经过\n   * 节流层（低 fps 时该走 setTimeout 路径），并照常发 we-frame 打点。\n   */\n  function resumeRafHolds() {\n    var holds = [];\n    for (var id in rafMap) {\n      if (!Object.prototype.hasOwnProperty.call(rafMap, id)) continue;\n      if (rafMap[id] && rafMap[id].kind === "hold") {\n        holds.push(rafMap[id].cb);\n        delete rafMap[id];\n      }\n    }\n    for (var i = 0; i < holds.length; i++) {\n      try {\n        w.requestAnimationFrame(holds[i]);\n      } catch (_) {\n        /* 单个回调重挂失败不影响其它 */\n      }\n    }\n  }\n\n  // —— 媒体音量：对齐官方 CEF 语义（浏览器级主音量与作者页面内音量独立相乘）——\n  // 作者常在播放前重设 a.volume = uiVolume（Bocchi），且音频多为 `new Audio()` 不进\n  // DOM——querySelectorAll 找不到、直接覆盖 volume 又会被作者回写。因此 hook 原型：\n  // setter 记作者值，元素实际音量 = 作者值 × 主音量；`__weSetVolume` 改系数并刷新\n  // 全部活实例（DOM 内 + Audio 构造器登记的 WeakRef）。\n  var hostVolume = 1;\n  var liveMedia = []; // WeakRef<HTMLMediaElement>\n  function trackMedia(el) {\n    if (!w.WeakRef) return;\n    liveMedia.push(new w.WeakRef(el));\n  }\n  function applyMediaVolume(el) {\n    if (el.__weBaseVol != null) {\n      mediaVolDesc.set.call(el, el.__weBaseVol * hostVolume);\n    } else {\n      mediaVolDesc.set.call(el, hostVolume);\n    }\n    var baseMuted = !!el.__weBaseMuted;\n    mediaMutedDesc.set.call(el, baseMuted || hostVolume <= 0);\n  }\n  function refreshAllMediaVolume() {\n    try {\n      var nodes = w.document.querySelectorAll("audio,video");\n      for (var i = 0; i < nodes.length; i++) applyMediaVolume(nodes[i]);\n    } catch (_) {\n      /* 忽略 */\n    }\n    for (var j = liveMedia.length - 1; j >= 0; j--) {\n      var el = liveMedia[j].deref();\n      if (!el) {\n        liveMedia.splice(j, 1);\n        continue;\n      }\n      applyMediaVolume(el);\n    }\n  }\n  var mediaVolDesc = null;\n  var mediaMutedDesc = null;\n  function installMediaVolumeHooks() {\n    try {\n      if (!w.HTMLMediaElement || !w.HTMLMediaElement.prototype) return;\n      var proto = w.HTMLMediaElement.prototype;\n      mediaVolDesc = Object.getOwnPropertyDescriptor(proto, "volume");\n      mediaMutedDesc = Object.getOwnPropertyDescriptor(proto, "muted");\n      if (mediaVolDesc && typeof mediaVolDesc.set === "function") {\n        Object.defineProperty(proto, "volume", {\n          configurable: true,\n          enumerable: mediaVolDesc.enumerable,\n          get: function () {\n            return this.__weBaseVol != null ? this.__weBaseVol : mediaVolDesc.get.call(this);\n          },\n          set: function (v) {\n            this.__weBaseVol = Math.max(0, Math.min(1, Number(v) || 0));\n            mediaVolDesc.set.call(this, this.__weBaseVol * hostVolume);\n          },\n        });\n      }\n      if (mediaMutedDesc && typeof mediaMutedDesc.set === "function") {\n        Object.defineProperty(proto, "muted", {\n          configurable: true,\n          enumerable: mediaMutedDesc.enumerable,\n          get: function () {\n            return this.__weBaseMuted != null\n              ? this.__weBaseMuted || hostVolume <= 0\n              : mediaMutedDesc.get.call(this);\n          },\n          set: function (v) {\n            this.__weBaseMuted = !!v;\n            mediaMutedDesc.set.call(this, !!v || hostVolume <= 0);\n          },\n        });\n      }\n      // `new Audio()` 不进 DOM：构造器登记 WeakRef 以便主音量变化时刷新\n      if (typeof w.Audio === "function" && w.WeakRef) {\n        var OrigAudio = w.Audio;\n        function WrappedAudio(src) {\n          var a = new OrigAudio(src);\n          trackMedia(a);\n          applyMediaVolume(a);\n          return a;\n        }\n        WrappedAudio.prototype = OrigAudio.prototype;\n        w.Audio = WrappedAudio;\n      }\n    } catch (_) {\n      /* 无媒体环境的 verifier 跳过 */\n    }\n  }\n  installMediaVolumeHooks();\n\n  // —— 父页控制面 ——\n  // 官方 setPaused 只在暂停状态实际变化时调用一次；重复调用去重。\n  // 暂停还要冻结页内媒体：官方是进程级冻结（无声、解码器可回收），作者的\n  // setPaused 常只管自己的逻辑。只记录「我们代为暂停」的元素，恢复时仅还原这部分，\n  // 不碰作者自己暂停的。\n  var weFrozenMedia = [];\n  function freezePageMedia() {\n    weFrozenMedia.length = 0;\n    try {\n      var nodes = w.document.querySelectorAll("audio,video");\n      for (var i = 0; i < nodes.length; i++) {\n        if (!nodes[i].paused) {\n          weFrozenMedia.push(nodes[i]);\n          try {\n            nodes[i].pause();\n          } catch (_) {\n            /* 忽略 */\n          }\n        }\n      }\n    } catch (_) {\n      /* 忽略 */\n    }\n  }\n  function thawPageMedia() {\n    for (var i = 0; i < weFrozenMedia.length; i++) {\n      try {\n        var p = weFrozenMedia[i].play();\n        if (p && p.catch) p.catch(function () {});\n      } catch (_) {\n        /* 忽略 */\n      }\n    }\n    weFrozenMedia.length = 0;\n  }\n\n  /**\n   * 暂停还要冻结 **CSS 动画 / 过渡**（Web Animations 时间轴）。\n   *\n   * rAF 与定时器冻结管不到它们：CSS `animation` 由浏览器**合成器**独立驱动，\n   * 与 JS 主线程无关。1444432396 Glitch Clock 的整个视觉（背景移动、抖动、故障\n   * 闪烁）是 10 处 `animation: … infinite`，只有时钟文字走 `setInterval` ——\n   * 暂停后画面照旧动个不停，用户看到的就是「无法暂停」（实测暂停期间 6 个动画\n   * 全为 `playState:"running"`，`currentTime` 700ms 推进整 700ms）。\n   *\n   * 官方暂停语义是「fully freeze the process that renders the wallpaper」，\n   * 合成器动画自然也在冻结范围内。\n   *\n   * 与媒体冻结同一条纪律：**只记录我们代为暂停的**，恢复时仅还原这部分——\n   * 作者自己用 `animation-play-state: paused` 停下的（常见于 hover 才播的装饰）\n   * 不能被我们唤醒。`getAnimations()` 拿的是活动动画对象，`pause()`/`play()`\n   * 直接作用在时间轴上，比改 `style.animationPlayState` 干净（后者会污染作者的\n   * 内联样式，且被作者下一次样式写入覆盖）。\n   */\n  var weFrozenAnims = [];\n  function freezePageAnimations() {\n    weFrozenAnims.length = 0;\n    try {\n      if (typeof w.document.getAnimations !== "function") return;\n      var anims = w.document.getAnimations();\n      for (var i = 0; i < anims.length; i++) {\n        var a = anims[i];\n        if (a && a.playState === "running") {\n          weFrozenAnims.push(a);\n          try {\n            a.pause();\n          } catch (_) {\n            /* 个别动画不可暂停时跳过 */\n          }\n        }\n      }\n    } catch (_) {\n      /* 旧引擎无 getAnimations：退化为不冻结，不报错 */\n    }\n  }\n  function thawPageAnimations() {\n    for (var i = 0; i < weFrozenAnims.length; i++) {\n      try {\n        weFrozenAnims[i].play();\n      } catch (_) {\n        /* 已被作者移除的动画忽略 */\n      }\n    }\n    weFrozenAnims.length = 0;\n  }\n  w.__weSetPaused = function (v) {\n    var next = !!v;\n    if (next === paused) return;\n    paused = next;\n    if (paused) {\n      callSetPaused(true);\n      freezePageMedia();\n      freezePageAnimations();\n    } else {\n      callSetPaused(false);\n      thawPageMedia();\n      thawPageAnimations();\n      resumeTimers();\n      // rAF 挂起项必须补跑，否则自递归的主循环永久断链（1278092907）\n      resumeRafHolds();\n    }\n  };\n\n  w.__weSetFps = function (n) {\n    var next = Number(n);\n    if (!Number.isFinite(next) || next <= 0) return;\n    fps = next;\n    callApplyGeneralProperties({ fps: fps });\n  };\n\n  w.__weSetVolume = function (v) {\n    var next = Math.max(0, Math.min(1, Number(v) || 0));\n    volume = next;\n    hostVolume = next;\n    refreshAllMediaVolume();\n  };\n\n  w.__weApplyProps = function (props) {\n    if (!props || typeof props !== "object") return;\n    // file 属性：值是路径时登记进随机池（单文件 slideshow）\n    try {\n      for (var key in props) {\n        if (!Object.prototype.hasOwnProperty.call(props, key)) continue;\n        var ent = props[key];\n        var val = ent && typeof ent === "object" && "value" in ent ? ent.value : ent;\n        if (typeof val === "string" && val !== "" && /\\.(png|jpe?g|gif|webp|webm|mp4|bmp)$/i.test(val)) {\n          directoryFiles[key] = [val];\n        }\n      }\n    } catch (_) {\n      /* 忽略 */\n    }\n    if (!propertyListener || typeof propertyListener.applyUserProperties !== "function") {\n      pendingProps = props;\n      return;\n    }\n    callApplyUserProperties(props);\n  };\n\n  w.__weSeedProps = function (props) {\n    if (!props || typeof props !== "object") return;\n    if (propertyListener && typeof propertyListener.applyUserProperties === "function") {\n      w.__weApplyProps(props);\n    } else {\n      pendingProps = props;\n    }\n  };\n\n  w.__wePushAudio = function (arr) {\n    if (paused || !audioListener) return;\n    try {\n      audioListener(arr);\n    } catch (_) {\n      /* 忽略 */\n    }\n  };\n\n  /**\n   * 媒体事件泵。payload 形态对齐官方：\n   *   { op:"properties", title, artist, album, albumArtist }\n   *   { op:"thumbnail", thumbnail, primaryColor, textColor, ... }\n   *   { op:"playback", state }  // 0/1/2\n   *   { op:"timeline", position, duration }\n   *   { op:"status", enabled }\n   */\n  w.__wePushMedia = function (payload) {\n    if (!payload || typeof payload !== "object") return;\n    var op = payload.op;\n    if (op === "properties") {\n      lastMedia.properties = payload;\n      safeCall(mediaListeners.properties, payload);\n    } else if (op === "thumbnail") {\n      lastMedia.thumbnail = payload;\n      safeCall(mediaListeners.thumbnail, payload);\n    } else if (op === "playback") {\n      lastMedia.playback = payload;\n      safeCall(mediaListeners.playback, payload);\n    } else if (op === "timeline") {\n      lastMedia.timeline = payload;\n      safeCall(mediaListeners.timeline, payload);\n    } else if (op === "status") {\n      lastMedia.status = payload;\n      safeCall(mediaListeners.status, payload);\n    }\n  };\n\n  /** 目录文件列表（首次或追加）。files: string[] */\n  w.__wePushDirectoryFiles = function (propertyName, files) {\n    var prop = String(propertyName || "");\n    if (!prop || !Array.isArray(files)) return;\n    var cleaned = [];\n    for (var i = 0; i < files.length; i++) {\n      if (files[i] != null && String(files[i]) !== "") cleaned.push(String(files[i]));\n    }\n    if (!directoryFiles[prop]) directoryFiles[prop] = [];\n    // 首次全量替换语义由调用方决定；这里 concat 去重\n    var seen = Object.create(null);\n    for (var j = 0; j < directoryFiles[prop].length; j++) seen[directoryFiles[prop][j]] = 1;\n    var added = [];\n    for (var k = 0; k < cleaned.length; k++) {\n      if (!seen[cleaned[k]]) {\n        seen[cleaned[k]] = 1;\n        directoryFiles[prop].push(cleaned[k]);\n        added.push(cleaned[k]);\n      }\n    }\n    if (added.length) callDirectoryAdded(prop, added);\n  };\n\n  w.__weRemoveDirectoryFiles = function (propertyName, files) {\n    var prop = String(propertyName || "");\n    if (!prop || !Array.isArray(files) || !directoryFiles[prop]) return;\n    var removeSet = Object.create(null);\n    for (var i = 0; i < files.length; i++) removeSet[String(files[i])] = 1;\n    var kept = [];\n    var removed = [];\n    for (var j = 0; j < directoryFiles[prop].length; j++) {\n      var f = directoryFiles[prop][j];\n      if (removeSet[f]) removed.push(f);\n      else kept.push(f);\n    }\n    directoryFiles[prop] = kept;\n    if (removed.length) callDirectoryRemoved(prop, removed);\n  };\n\n  // —— 外部指针注入（桌面 underlay 层收不到鼠标事件，父页经 __wp.pushPointer 推入）——\n  //\n  // 场景壁纸那条通道是「写一个状态对象、渲染器每帧读」（render/pointer.js）；网页壁纸\n  // 没有这样的单一消费点 —— 作者代码就是**监听 DOM 事件**的，所以这里必须把推送\n  // 还原成一串合成事件。语料（本机 49 张 web）：mousemove 24 张、click 29 张、\n  // mouseover/out 17 张、mouseenter/leave 8 张、pointer* 16 张（createjs 系一律走\n  // pointerdown/move/up）、.button 18 张、.which 17 张、pointerId/relatedTarget 15 张。\n  //\n  // 三条要点（都有语料依据，改错了会静默失效）：\n  //\n  //   1. **必须 elementFromPoint 按命中元素派发**，不能一律打 document。作者既有挂\n  //      document/window 的（15 张，靠冒泡收到），也有挂 canvas 上读 `event.offsetX`\n  //      的（1748506393 流体 `pointers[0].dx = (e.offsetX - …)`）。offsetX/offsetY 由\n  //      浏览器按 target 的 padding box 现算 —— target 打错就是错的偏移，且无任何报错。\n  //      pageX/pageY 同理由 clientX + 滚动量现算，不用我们填。\n  //\n  //   2. **over/out/enter/leave 链要按 W3C 语义补全**。1748506393 靠 canvas 的\n  //      `mouseenter` 把 `pointers[0].down` 置 true（不进这个分支则鼠标怎么动都不出染料）、\n  //      靠 window 的 `mouseleave` 复位；1081733658 animatedGrid 靠 `document.body` 的\n  //      mouseover/mouseleave 起停整个网格动画。leave/enter 不冒泡，必须自己沿祖先链走到\n  //      最近公共祖先，只发生变化的那一段。\n  //\n  //   3. **click 要靠 down/up 边缘合成**，且 down 与 up 的 target 不同（拖拽）时不发。\n  //      29 张听 click 是最大的消费方；轮询推送里没有「点击」这个事件，只有按键掩码的\n  //      跳变，边缘丢了就等于整类交互消失。\n  //\n  // 硬限制（写在这里避免反复试）：CSS `:hover` 由浏览器自己的 hit-test 驱动，合成事件\n  // 永远点不亮它（18 张含 `:hover`）—— 纯 CSS hover 动画的壁纸无法用注入通道响应，\n  // 这不是实现缺陷，是合成事件的固有边界。\n  var ptrHas = false; // 是否收到过推送（首帧 movement 归零用）\n  var ptrX = 0;\n  var ptrY = 0;\n  var ptrButtons = 0;\n  var ptrTarget = null; // 上次命中元素（over/out 链的旧端）\n  var ptrDownTarget = null; // 按下时的命中元素（click 判定）\n  var ptrLastClickTime = 0;\n  var ptrLastClickTarget = null;\n  /** 双击判定窗口（ms）。与主流浏览器一致，语料里 5 张听 dblclick。 */\n  var PTR_DBLCLICK_MS = 500;\n\n  function ptrRoot() {\n    try {\n      return w.document.body || w.document.documentElement || null;\n    } catch (_) {\n      return null;\n    }\n  }\n\n  function ptrHitTest(x, y) {\n    try {\n      if (typeof w.document.elementFromPoint === "function") {\n        var el = w.document.elementFromPoint(x, y);\n        if (el) return el;\n      }\n    } catch (_) {\n      /* 忽略 */\n    }\n    return ptrRoot();\n  }\n\n  /** node → [node, parent, …, root]；用 parentNode 而非 parentElement，\n   *  这样 document / documentElement 也在链里（作者挂 document 的 leave 要收到）。 */\n  function ptrChain(node) {\n    var out = [];\n    var n = node;\n    while (n) {\n      out.push(n);\n      try {\n        n = n.parentNode || null;\n      } catch (_) {\n        n = null;\n      }\n    }\n    return out;\n  }\n\n  function ptrCommonAncestor(a, b) {\n    if (!a || !b) return null;\n    var ca = ptrChain(a);\n    var seen = [];\n    for (var i = 0; i < ca.length; i++) seen.push(ca[i]);\n    var cb = ptrChain(b);\n    for (var j = 0; j < cb.length; j++) {\n      for (var k = 0; k < seen.length; k++) {\n        if (seen[k] === cb[j]) return cb[j];\n      }\n    }\n    return null;\n  }\n\n  /**\n   * 造一个合成鼠标/指针事件。\n   *\n   * `PointerEvent` 优先：createjs 一族（语料 7 张）只挂 pointerdown/move/up，\n   * 且会读 `pointerId` / `pointerType` / `isPrimary`。环境没有 PointerEvent 时\n   * 退回 MouseEvent（事件名照旧，作者的 addEventListener(\'pointermove\') 仍能收到）。\n   */\n  function ptrMakeEvent(type, x, y, opts) {\n    var o = opts || {};\n    var isPointer = type.indexOf("pointer") === 0;\n    var init = {\n      bubbles: o.bubbles !== false,\n      cancelable: o.cancelable !== false,\n      // composed：作者把 canvas 放进 shadow DOM 时事件要能穿出来\n      composed: true,\n      view: w,\n      detail: o.detail || 0,\n      clientX: x,\n      clientY: y,\n      // screenX/screenY 是 init 字段（不像 pageX/offsetX 那样现算）。iframe 里\n      // 只能按外层窗口原点近似；16 张读 screenX，多用于算相对位移而非绝对定位。\n      screenX: x + (Number(w.screenX) || 0),\n      screenY: y + (Number(w.screenY) || 0),\n      // button：**移动/悬停类事件必须是 -1**，只有 down/up/click 才是 0（左）/1（中）/2（右）。\n      // 这条是 W3C 规定的「没有按键状态变化」哨兵值，不是可省的细节：GameMaker HTML5\n      // 导出的运行时（2517518192 FNAF）在 pointermove 分支里照抄 `_tq = e.button` 再\n      // `_mq |= (1 << _tq)`，而 _mq 只在 pointerup/out 才清零 —— 填 0 等于告诉游戏\n      // 「左键一直按着」，鼠标只是移过去就永久卡在按下态（且没有任何报错）。\n      button: o.button != null ? o.button : -1,\n      buttons: o.buttons != null ? o.buttons : ptrButtons,\n      movementX: o.movementX || 0,\n      movementY: o.movementY || 0,\n      ctrlKey: false,\n      shiftKey: false,\n      altKey: false,\n      metaKey: false,\n    };\n    if ("relatedTarget" in o) init.relatedTarget = o.relatedTarget || null;\n    // `button: -1` 无法经 MouseEvent 构造器表达：Chromium 把 -1 规范化成 0\n    // （实测 `new MouseEvent("x", {button:-1}).button === 0`，而 -2 能原样通过 ——\n    // 不是钳位，是对 -1 的特殊处理）。PointerEvent 构造器则保留 -1。\n    // 所以 mouse 类事件必须在构造后把 -1 盖回去，否则「移动=左键按下」的坑\n    // 只在 pointer 路径修好、mouse 路径依旧（2517518192 恰好走 pointer，\n    // 光看它会误以为已经修完）。\n    var needsButtonPatch = init.button < 0;\n    var ev = null;\n    if (isPointer) {\n      init.pointerId = 1;\n      init.pointerType = "mouse";\n      init.isPrimary = true;\n      init.width = 1;\n      init.height = 1;\n      init.pressure = init.buttons ? 0.5 : 0;\n      try {\n        if (typeof w.PointerEvent === "function") ev = new w.PointerEvent(type, init);\n      } catch (_) {\n        /* 退回 MouseEvent */\n      }\n    }\n    if (!ev) {\n      try {\n        if (typeof w.MouseEvent === "function") ev = new w.MouseEvent(type, init);\n      } catch (_) {\n        /* 忽略 */\n      }\n    }\n    if (ev && needsButtonPatch && ev.button !== init.button) {\n      try {\n        Object.defineProperty(ev, "button", { configurable: true, get: function () {\n          return init.button;\n        } });\n      } catch (_) {\n        /* 只读且不可重定义时保持构造值 */\n      }\n    }\n    return ev;\n  }\n\n  function ptrDispatch(node, type, x, y, opts) {\n    if (!node || typeof node.dispatchEvent !== "function") return;\n    var ev = ptrMakeEvent(type, x, y, opts);\n    if (!ev) return;\n    try {\n      node.dispatchEvent(ev);\n    } catch (_) {\n      /* 作者处理器抛错不打断后续事件（与官方 CEF 一致：一个坏 listener 不该\n         让整条链断掉，否则 leave 发不出去会留下永久 hover/按下态） */\n    }\n  }\n\n  /** 命中元素变化时补 out/leave + over/enter 四段，顺序与浏览器一致。 */\n  function ptrCrossBoundary(prev, next, x, y) {\n    if (prev === next) return;\n    var ancestor = ptrCommonAncestor(prev, next);\n    if (prev) {\n      ptrDispatch(prev, "pointerout", x, y, { relatedTarget: next });\n      ptrDispatch(prev, "mouseout", x, y, { relatedTarget: next });\n      var leaving = ptrChain(prev);\n      for (var i = 0; i < leaving.length; i++) {\n        if (leaving[i] === ancestor) break;\n        // leave 不冒泡：必须逐个发，且 target 就是它自己\n        ptrDispatch(leaving[i], "pointerleave", x, y, {\n          bubbles: false,\n          cancelable: false,\n          relatedTarget: next,\n        });\n        ptrDispatch(leaving[i], "mouseleave", x, y, {\n          bubbles: false,\n          cancelable: false,\n          relatedTarget: next,\n        });\n      }\n    }\n    if (next) {\n      ptrDispatch(next, "pointerover", x, y, { relatedTarget: prev });\n      ptrDispatch(next, "mouseover", x, y, { relatedTarget: prev });\n      var entering = [];\n      var chain = ptrChain(next);\n      for (var j = 0; j < chain.length; j++) {\n        if (chain[j] === ancestor) break;\n        entering.push(chain[j]);\n      }\n      // enter 由外向内（祖先先收到），与浏览器一致\n      for (var k = entering.length - 1; k >= 0; k--) {\n        ptrDispatch(entering[k], "pointerenter", x, y, {\n          bubbles: false,\n          cancelable: false,\n          relatedTarget: prev,\n        });\n        ptrDispatch(entering[k], "mouseenter", x, y, {\n          bubbles: false,\n          cancelable: false,\n          relatedTarget: prev,\n        });\n      }\n    }\n  }\n\n  /**\n   * 外部指针注入入口。\n   *\n   * @param {number} x 相对 iframe 视口左边的 **CSS 像素**（= clientX 空间）\n   * @param {number} y 同上，相对上边，Y 朝下\n   * @param {number} [buttons] 按键位掩码，bit0 左键。与场景通道同一约定，\n   *   当前只消费 bit0（右/中键位保留；桌面右键属于 Finder，不该被壁纸劫持）\n   *\n   * 接**像素**而不是归一化坐标：网页壁纸的 iframe 在 cover 露底自适配下可能比舞台大\n   * 并带居中偏移（见 web.ts installLetterboxFix），换算需要 iframe 的几何 —— 那是父页\n   * 才知道的信息，父页换算完再推进来，shim 不做二次除法。\n   *\n   * 暂停期间丢弃：官方暂停语义是「冻结渲染进程」，此时派发事件会让作者的动画状态\n   * 在冻结中继续推进，恢复时画面跳一下。\n   */\n  w.__wePushPointer = function (x, y, buttons) {\n    if (paused) return;\n    var nx = Number(x);\n    var ny = Number(y);\n    // 非有限值直接丢弃（与场景通道同一约定）：NaN 传进 clientX 会让 elementFromPoint\n    // 返回 null、后续 offsetX 全成 NaN，作者的位移积分会一次性污染成 NaN 且不报错。\n    if (!isFinite(nx) || !isFinite(ny)) return;\n    var mask = Number(buttons) || 0;\n    var moved = !ptrHas || nx !== ptrX || ny !== ptrY;\n    var maskChanged = mask !== ptrButtons;\n    // 位置与按键都没变就什么都不发：宿主按 ~90Hz 推送，静止时重复派发\n    // mousemove 会让作者的「有没有在动」判定（1081733658 网格）永远认为在动。\n    if (!moved && !maskChanged) return;\n\n    var dx = ptrHas ? nx - ptrX : 0;\n    var dy = ptrHas ? ny - ptrY : 0;\n    ptrX = nx;\n    ptrY = ny;\n    ptrHas = true;\n\n    var target = ptrHitTest(nx, ny);\n    if (moved) {\n      ptrCrossBoundary(ptrTarget, target, nx, ny);\n      ptrTarget = target;\n      ptrDispatch(target, "pointermove", nx, ny, { movementX: dx, movementY: dy });\n      ptrDispatch(target, "mousemove", nx, ny, { movementX: dx, movementY: dy });\n    } else {\n      ptrTarget = target;\n    }\n\n    if (!maskChanged) return;\n    var wasDown = (ptrButtons & 1) !== 0;\n    var isDown = (mask & 1) !== 0;\n    ptrButtons = mask;\n    if (isDown === wasDown) return; // 只有高位变化：当前不消费\n    if (isDown) {\n      ptrDownTarget = target;\n      ptrDispatch(target, "pointerdown", nx, ny, { button: 0, detail: 1 });\n      ptrDispatch(target, "mousedown", nx, ny, { button: 0, detail: 1 });\n      return;\n    }\n    ptrDispatch(target, "pointerup", nx, ny, { button: 0, detail: 1 });\n    ptrDispatch(target, "mouseup", nx, ny, { button: 0, detail: 1 });\n    // click 只在 down/up 落在同一元素上时发（否则是拖拽，浏览器也不发）\n    if (ptrDownTarget && ptrDownTarget === target) {\n      var now = Date.now();\n      var isDouble =\n        ptrLastClickTarget === target && now - ptrLastClickTime <= PTR_DBLCLICK_MS;\n      ptrDispatch(target, "click", nx, ny, { button: 0, detail: isDouble ? 2 : 1 });\n      if (isDouble) {\n        ptrDispatch(target, "dblclick", nx, ny, { button: 0, detail: 2 });\n        ptrLastClickTarget = null;\n        ptrLastClickTime = 0;\n      } else {\n        ptrLastClickTarget = target;\n        ptrLastClickTime = now;\n      }\n    }\n    ptrDownTarget = null;\n  };\n\n  /**\n   * 指针离开本窗口（鼠标去了别的显示器）。\n   *\n   * 与场景通道不同，这里**必须把 out/leave 链发出去**：场景侧只是清一个状态位，\n   * 而网页作者的 hover 态是自己记的，不发 leave 就永久卡在「鼠标还在上面」\n   * （1081733658 网格会一直跑、1748506393 的 `pointers[0].down` 一直为 true）。\n   * 按下态也要补一次 up，否则拖拽逻辑永远不结束。\n   */\n  w.__wePointerLeave = function () {\n    if ((ptrButtons & 1) !== 0 && ptrTarget) {\n      ptrDispatch(ptrTarget, "pointerup", ptrX, ptrY, { button: 0, buttons: 0, detail: 1 });\n      ptrDispatch(ptrTarget, "mouseup", ptrX, ptrY, { button: 0, buttons: 0, detail: 1 });\n    }\n    ptrButtons = 0;\n    ptrDownTarget = null;\n    if (ptrTarget) {\n      ptrCrossBoundary(ptrTarget, null, ptrX, ptrY);\n      ptrTarget = null;\n    }\n    // 位置（ptrX/ptrY）与 ptrHas 保留：下次进来时 movement 才是真实位移，\n    // 而不是从 (0,0) 跳过来的一个巨大假 delta。\n  };\n\n  // —— rAF 节流（带 __weThrottled，避免父页 injectGpuThrottle 双层减半）——\n\n  function installRafThrottle() {\n    var throttled = function (cb) {\n      if (typeof cb !== "function") return 0;\n      if (paused) {\n        var idHold = ++rafCounter;\n        rafMap[idHold] = { kind: "hold", cb: cb };\n        return idHold;\n      }\n      var limit = fps >= 60 ? 0 : 1000 / fps;\n      if (limit <= 0) {\n        var idNative = origRaf(function (now) {\n          delete rafMap[idNative];\n          try {\n            cb(now);\n          } catch (_) {\n            /* 忽略 */\n          }\n          try {\n            w.parent.postMessage({ op: "we-frame", t: now }, "*");\n          } catch (_) {\n            /* 忽略 */\n          }\n        });\n        rafMap[idNative] = { kind: "native", id: idNative };\n        return idNative;\n      }\n      var id = ++rafCounter;\n      var to = w.setTimeout(function () {\n        delete rafMap[id];\n        origRaf(function (now) {\n          try {\n            cb(now);\n          } catch (_) {\n            /* 忽略 */\n          }\n          try {\n            w.parent.postMessage({ op: "we-frame", t: now }, "*");\n          } catch (_) {\n            /* 忽略 */\n          }\n        });\n      }, limit);\n      rafMap[id] = { kind: "timeout", to: to };\n      return id;\n    };\n    throttled.__weThrottled = true;\n    w.requestAnimationFrame = throttled;\n    w.cancelAnimationFrame = function (id) {\n      var ent = rafMap[id];\n      if (!ent) {\n        try {\n          origCaf(id);\n        } catch (_) {\n          /* 忽略 */\n        }\n        return;\n      }\n      delete rafMap[id];\n      if (ent.kind === "timeout") w.clearTimeout(ent.to);\n      else if (ent.kind === "native") origCaf(ent.id);\n    };\n  }\n\n  installRafThrottle();\n})(window);\n\n';
+function weShimCall(rt, call) {
+  try {
+    const win = rt.iframe?.contentWindow;
+    if (win) call(win);
+  } catch {
+  }
+}
+function injectGpuThrottle(rt, f, _doc) {
+  const win = f.contentWindow;
+  if (!win) return;
+  if (win.requestAnimationFrame?.__weThrottled) return;
+  const fps = rt.cfg.sceneFps || 30;
+  if (fps >= 60) return;
+  const interval = 1e3 / fps;
+  try {
+    const origRaf = win.requestAnimationFrame.bind(win);
+    const rafMap = /* @__PURE__ */ new Map();
+    let counter = 0;
+    win.requestAnimationFrame = (cb) => {
+      const id = ++counter;
+      const to = win.setTimeout(() => {
+        rafMap.delete(id);
+        origRaf((now) => {
+          try {
+            cb(now);
+          } catch {
+          }
+        });
+      }, interval);
+      rafMap.set(id, to);
+      return id;
+    };
+    win.cancelAnimationFrame = (id) => {
+      const to = rafMap.get(id);
+      if (to !== void 0) {
+        win.clearTimeout(to);
+        rafMap.delete(id);
+      }
+    };
+  } catch {
+  }
+}
+const pumpBuffer = new Float32Array(128);
+function packWebAudioArrayInto(out, left, right) {
+  const nL = Math.min(64, left.length);
+  const nR = Math.min(64, right.length);
+  for (let i = 0; i < nL; i++) out[i] = Number(left[i]) || 0;
+  for (let i = 0; i < nR; i++) out[64 + i] = Number(right[i]) || 0;
+  return out;
+}
+const WEB_SIM_AUDIO_GAIN = 1.8;
+const WEB_SIM_AUDIO_GAMMA = 1.8;
+const WEB_AUDIO_PUMP_HZ = 30;
+function shapeWebAudioBand(pre) {
+  const v = Number(pre) || 0;
+  if (v <= 0) return 0;
+  return Math.min(1, Math.pow(v, WEB_SIM_AUDIO_GAMMA) * WEB_SIM_AUDIO_GAIN);
+}
+function defaultAudioDriver() {
+  const sim = createSimulatedAudio();
+  const left = new Float32Array(64);
+  const right = new Float32Array(64);
+  return {
+    tick(nowMs) {
+      sim.update(nowMs / 1e3);
+    },
+    snapshot() {
+      const s = sim.snapshot;
+      const preL = s.preL64;
+      const preR = s.preR64;
+      for (let i = 0; i < 64; i++) {
+        if (preL && preR) {
+          left[i] = shapeWebAudioBand(preL[i]);
+          right[i] = shapeWebAudioBand(preR[i]);
+        } else {
+          left[i] = (Number(s.left64[i]) || 0) * 0.2;
+          right[i] = (Number(s.right64[i]) || 0) * 0.2;
+        }
+      }
+      return { left, right };
+    }
+  };
+}
+function resolveContainer(rt, cfg) {
+  if (rt.wrap) return rt.wrap;
+  const el = cfg.canvas;
+  if (!el) return null;
+  if (el instanceof HTMLCanvasElement) {
+    const parent = el.parentElement;
+    if (parent) {
+      reportDiag(rt, cfg, "网页壁纸挂在 canvas 父容器上（canvas 不能有子节点；更适合空 div）");
+      return parent;
+    }
+    return null;
+  }
+  return el;
+}
+function buildSeedScript(props, fps, volume) {
+  const parts = [];
+  if (fps != null && Number.isFinite(fps)) parts.push(`window.__weSetFps(${Number(fps)});`);
+  if (volume != null && Number.isFinite(volume)) {
+    parts.push(`window.__weSetVolume(${Math.max(0, Math.min(1, Number(volume)))});`);
+  }
+  if (props && Object.keys(props).length) {
+    parts.push(`window.__weSeedProps(${JSON.stringify(props)});`);
+  }
+  return parts.join("\n");
+}
+function installLetterboxFix(rt, f, container) {
+  const BASE = "position:absolute;border:none;background:transparent;";
+  const applyFull = () => {
+    f.style.cssText = BASE + "inset:0;width:100%;height:100%;";
+  };
+  applyFull();
+  let lastKey = "";
+  const relayout = () => {
+    if (!f.isConnected) return;
+    let doc = null;
+    try {
+      doc = f.contentDocument;
+    } catch {
+      return;
+    }
+    if (!doc) return;
+    const stageW = container.clientWidth || window.innerWidth || 0;
+    const stageH = container.clientHeight || window.innerHeight || 0;
+    const cover = normalizeFit(rt.cfg.fit) === "cover";
+    applyFull();
+    const box = cover && stageW > 0 && stageH > 0 ? measureWebLetterbox(doc) : null;
+    const vp = box ? webCoverViewport(stageW, stageH, box.contentAspect) : null;
+    const key = vp ? `${Math.round(vp.width)}x${Math.round(vp.height)}` : "full";
+    if (!vp) {
+      lastKey = "full";
+      return;
+    }
+    f.style.cssText = BASE + `left:${vp.left}px;top:${vp.top}px;width:${vp.width}px;height:${vp.height}px;`;
+    if (key !== lastKey) {
+      lastKey = key;
+      reportDiag(
+        rt,
+        rt.cfg,
+        `网页壁纸露底自适配：视口按内容比例改为 ${Math.round(vp.width)}×${Math.round(vp.height)}（cover 居中裁切）`
+      );
+    }
+  };
+  const onResize = () => relayout();
+  window.addEventListener("resize", onResize);
+  let ro;
+  if (typeof ResizeObserver !== "undefined") {
+    ro = new ResizeObserver(() => relayout());
+    ro.observe(container);
+  }
+  const timers = [];
+  const onLoad = () => {
+    relayout();
+    for (const d of [120, 400, 1200]) timers.push(window.setTimeout(relayout, d));
+    try {
+      const doc = f.contentDocument;
+      if (doc) {
+        for (const el of doc.querySelectorAll("video,img")) {
+          el.addEventListener("loadedmetadata", relayout, { once: true });
+          el.addEventListener("load", relayout, { once: true });
+        }
+      }
+    } catch {
+    }
+  };
+  f.addEventListener("load", onLoad);
+  rt.webRelayout = relayout;
+  const prev = rt.sceneCleanup;
+  rt.sceneCleanup = () => {
+    window.removeEventListener("resize", onResize);
+    ro?.disconnect();
+    for (const t of timers) clearTimeout(t);
+    f.removeEventListener("load", onLoad);
+    if (rt.webRelayout === relayout) rt.webRelayout = void 0;
+    try {
+      prev?.();
+    } catch {
+    }
+  };
+}
+function webPointerToClient(u, v, stage, frame, client) {
+  if (!Number.isFinite(u) || !Number.isFinite(v)) return null;
+  if (!(stage.width > 0) || !(stage.height > 0)) return null;
+  const sx = frame.width > 0 && client.width > 0 ? frame.width / client.width : 1;
+  const sy = frame.height > 0 && client.height > 0 ? frame.height / client.height : 1;
+  return {
+    x: (u * stage.width - (frame.left - stage.left)) / (sx || 1),
+    y: (v * stage.height - (frame.top - stage.top)) / (sy || 1)
+  };
+}
+function installWebPointerBridge(rt, f, container) {
+  rt.pointerCtl = {
+    push(p) {
+      if (!f.isConnected) return;
+      const cRect = container.getBoundingClientRect();
+      const fRect = f.getBoundingClientRect();
+      const pt = webPointerToClient(
+        Number(p?.u),
+        Number(p?.v),
+        {
+          left: cRect.left,
+          top: cRect.top,
+          width: cRect.width || container.clientWidth || window.innerWidth || 0,
+          height: cRect.height || container.clientHeight || window.innerHeight || 0
+        },
+        { left: fRect.left, top: fRect.top, width: fRect.width, height: fRect.height },
+        { width: f.clientWidth, height: f.clientHeight }
+      );
+      if (!pt) return;
+      weShimCall(rt, (w) => w.__wePushPointer?.(pt.x, pt.y, Number(p.buttons) || 0));
+    },
+    leave() {
+      weShimCall(rt, (w) => w.__wePointerLeave?.());
+    }
+  };
+}
+function attachIframe(rt, cfg, container, src, opts) {
+  const f = document.createElement("iframe");
+  f.setAttribute("sandbox", "allow-scripts allow-same-origin");
+  f.style.cssText = "position:absolute;inset:0;width:100%;height:100%;border:none;background:transparent;";
+  if (!rt.wrap && getComputedStyle(container).position === "static") {
+    container.style.position = "relative";
+  }
+  f.src = src;
+  container.appendChild(f);
+  rt.iframe = f;
+  if (opts.blobUrl) {
+    (rt.objectUrls ??= []).push(opts.blobUrl);
+  }
+  installLetterboxFix(rt, f, container);
+  if (opts.injected) installWebPointerBridge(rt, f, container);
+  const onFrameMsg = (ev) => {
+    if (ev.source !== f.contentWindow) return;
+    const data = ev.data;
+    if (!data || data.op !== "we-frame") return;
+    if (rt.paused) return;
+    const t = typeof data.t === "number" ? data.t : performance.now();
+    if (opts.frameClock) opts.frameClock.last = t;
+    markFrame(rt, t);
+  };
+  window.addEventListener("message", onFrameMsg);
+  const prevCleanup = rt.sceneCleanup;
+  rt.sceneCleanup = () => {
+    window.removeEventListener("message", onFrameMsg);
+    try {
+      prevCleanup?.();
+    } catch {
+    }
+  };
+  f.addEventListener("load", () => {
+    try {
+      const doc = f.contentDocument;
+      if (doc) window.__blockContextMenu?.(doc);
+      if (!opts.injected) injectGpuThrottle(rt, f, doc);
+    } catch {
+    }
+    weShimCall(rt, (w2) => {
+      const wire = {};
+      for (const [k, v] of Object.entries(rt.liveUserProps ?? {})) wire[k] = { value: v };
+      w2.__weApplyProps?.(wire);
+      w2.__weSetFps?.(rt.cfg.sceneFps ?? 60);
+      w2.__weSetVolume?.(rt.cfg.muted === false ? 1 : 0);
+      if (rt.paused) w2.__weSetPaused?.(true);
+    });
+    try {
+      rt.onFirstFrame?.();
+      rt.onFirstFrame = void 0;
+    } catch {
+    }
+    const w = container.clientWidth || window.innerWidth || 1;
+    const h = container.clientHeight || window.innerHeight || 1;
+    try {
+      rt.onSceneInfo?.({
+        width: w,
+        height: h,
+        layerCount: 0,
+        hasModels: false,
+        hasParticles: false,
+        hasText: false
+      });
+    } catch {
+    }
+  });
+}
+const WEB_ASPECT_EPS = 5e-3;
+const WEB_LETTERBOX_MIN_RATIO = 0.01;
+const WEB_ASPECT_MIN = 0.2;
+const WEB_ASPECT_MAX = 6;
+function webCoverViewport(stageW, stageH, contentAspect) {
+  if (!(stageW > 0) || !(stageH > 0) || !(contentAspect > 0)) return null;
+  const stageAspect = stageW / stageH;
+  if (Math.abs(stageAspect - contentAspect) <= WEB_ASPECT_EPS) return null;
+  if (stageAspect < contentAspect) {
+    const width = stageH * contentAspect;
+    return { width, height: stageH, left: (stageW - width) / 2, top: 0 };
+  }
+  const height = stageW / contentAspect;
+  return { width: stageW, height, left: 0, top: (stageH - height) / 2 };
+}
+function measureWebLetterbox(doc) {
+  const win = doc.defaultView;
+  if (!win) return null;
+  const vw = win.innerWidth;
+  const vh = win.innerHeight;
+  if (!(vw > 0) || !(vh > 0)) return null;
+  const cands = [...doc.querySelectorAll("video,img")];
+  for (const el of cands) {
+    const r = el.getBoundingClientRect();
+    if (r.width <= 0 || r.height <= 0) continue;
+    if (r.width < vw * 0.98) continue;
+    if (Math.abs(r.left) > vw * 0.02 || r.top > vh * 0.02) continue;
+    if (vh - r.height < vh * WEB_LETTERBOX_MIN_RATIO) continue;
+    const natW = el.videoWidth || el.naturalWidth || 0;
+    const natH = el.videoHeight || el.naturalHeight || 0;
+    if (!(natW > 0) || !(natH > 0)) continue;
+    const aspect = natW / natH;
+    if (!Number.isFinite(aspect) || aspect < WEB_ASPECT_MIN || aspect > WEB_ASPECT_MAX) continue;
+    return { contentAspect: aspect };
+  }
+  return null;
+}
+function vecToCss(v) {
+  if (!v) return "rgb(128,128,128)";
+  const r = Math.round(Math.max(0, Math.min(1, Number(v.x) || 0)) * 255);
+  const g = Math.round(Math.max(0, Math.min(1, Number(v.y) || 0)) * 255);
+  const b = Math.round(Math.max(0, Math.min(1, Number(v.z) || 0)) * 255);
+  return `rgb(${r},${g},${b})`;
+}
+function thumbDataUrlFromSnap(snap) {
+  try {
+    const c = document.createElement("canvas");
+    c.width = c.height = 64;
+    const ctx = c.getContext("2d");
+    if (!ctx) return "";
+    const p = snap.primaryColor;
+    const s = snap.secondaryColor;
+    const grd = ctx.createLinearGradient(0, 0, 64, 64);
+    grd.addColorStop(0, vecToCss(p));
+    grd.addColorStop(1, vecToCss(s));
+    ctx.fillStyle = grd;
+    ctx.fillRect(0, 0, 64, 64);
+    return c.toDataURL("image/jpeg", 0.85);
+  } catch {
+    return "";
+  }
+}
+function defaultMediaDriver() {
+  return media.createSimulatedMedia();
+}
+function pushMediaDiff(rt, prev, snap) {
+  const events = media.diffMediaEvents(prev, snap);
+  for (const { name, event } of events) {
+    if (name === "mediaStatusChanged") {
+      weShimCall(rt, (w) => w.__wePushMedia?.({ op: "status", enabled: !!event.enabled }));
+    } else if (name === "mediaPropertiesChanged") {
+      weShimCall(
+        rt,
+        (w) => w.__wePushMedia?.({
+          op: "properties",
+          title: event.title ?? "",
+          artist: event.artist ?? "",
+          album: event.album ?? "",
+          albumArtist: event.albumArtist ?? ""
+        })
+      );
+    } else if (name === "mediaThumbnailChanged") {
+      const thumb = thumbDataUrlFromSnap(snap);
+      weShimCall(
+        rt,
+        (w) => w.__wePushMedia?.({
+          op: "thumbnail",
+          thumbnail: thumb,
+          hasThumbnail: !!event.hasThumbnail || !!thumb,
+          primaryColor: vecToCss(event.primaryColor),
+          secondaryColor: vecToCss(event.secondaryColor),
+          tertiaryColor: vecToCss(event.tertiaryColor),
+          textColor: vecToCss(event.textColor),
+          highContrastColor: vecToCss(event.highContrastColor)
+        })
+      );
+    } else if (name === "mediaPlaybackChanged") {
+      weShimCall(rt, (w) => w.__wePushMedia?.({ op: "playback", state: Number(event.state) || 0 }));
+    } else if (name === "mediaTimelineChanged") {
+      weShimCall(
+        rt,
+        (w) => w.__wePushMedia?.({
+          op: "timeline",
+          position: Number(event.position) || 0,
+          duration: Number(event.duration) || 0
+        })
+      );
+    }
+  }
+  return media.cloneMediaSnapshot(snap);
+}
+function startAudioPump(rt, driver, frameClock) {
+  if (!driver) return;
+  let raf = 0;
+  let lastPush = 0;
+  const tick = (now) => {
+    raf = requestAnimationFrame(tick);
+    if (rt.paused || !rt.iframe) return;
+    const fps = rt.cfg.sceneFps || 60;
+    const pumpFps = Math.min(Math.max(1, fps), WEB_AUDIO_PUMP_HZ);
+    const interval = 1e3 / pumpFps;
+    if (now - lastPush < interval * 0.85) return;
+    lastPush = now;
+    try {
+      driver.tick?.(now);
+      const snap = driver.snapshot();
+      const arr = packWebAudioArrayInto(pumpBuffer, snap.left, snap.right);
+      weShimCall(rt, (w) => w.__wePushAudio?.(arr));
+      if (frameClock && now - frameClock.last > 200) markFrame(rt, now);
+    } catch {
+    }
+  };
+  raf = requestAnimationFrame(tick);
+  const prev = rt.sceneCleanup;
+  rt.sceneCleanup = () => {
+    cancelAnimationFrame(raf);
+    try {
+      prev?.();
+    } catch {
+    }
+  };
+}
+function startMediaPump(rt, driver) {
+  if (!driver) return;
+  let raf = 0;
+  let lastMedia = null;
+  let lastTick = 0;
+  const tick = (now) => {
+    raf = requestAnimationFrame(tick);
+    if (rt.paused || !rt.iframe) return;
+    if (now - lastTick < 200) return;
+    lastTick = now;
+    try {
+      driver.update(now / 1e3);
+      lastMedia = pushMediaDiff(rt, lastMedia, driver.snapshot);
+    } catch {
+    }
+  };
+  raf = requestAnimationFrame(tick);
+  const prev = rt.sceneCleanup;
+  rt.sceneCleanup = () => {
+    cancelAnimationFrame(raf);
+    try {
+      prev?.();
+    } catch {
+    }
+  };
+}
+function installWebCtl(rt) {
+  rt.sceneCtl = {
+    pause() {
+      rt.paused = true;
+      weShimCall(rt, (w) => w.__weSetPaused?.(true));
+    },
+    resume() {
+      rt.paused = false;
+      weShimCall(rt, (w) => w.__weSetPaused?.(false));
+    },
+    applyUserProperties(props) {
+      const flat = { ...rt.liveUserProps ?? {} };
+      for (const [k, v] of Object.entries(props ?? {})) {
+        const val = v && typeof v === "object" && "value" in v ? v.value : v;
+        flat[k] = val;
+      }
+      rt.liveUserProps = flat;
+      weShimCall(rt, (w) => w.__weApplyProps?.(props));
+    }
+  };
+}
+function isSameOriginUrl(url) {
+  try {
+    return new URL(url, location.href).origin === location.origin;
+  } catch {
+    return false;
+  }
+}
+function projectPropertiesToWire(project) {
+  const props = project?.general?.properties;
+  if (!props || typeof props !== "object") return {};
+  const out = {};
+  for (const [name, def] of Object.entries(props)) {
+    if (!def || typeof def !== "object" || typeof def.type !== "string") continue;
+    const raw = def.value;
+    const type = def.type.toLowerCase();
+    if (raw === null || raw === void 0) {
+      if (type === "file" || type === "directory") {
+        out[name] = { value: "" };
+        continue;
+      }
+      if (!("value" in def)) continue;
+    }
+    out[name] = { value: raw };
+  }
+  return out;
+}
+async function fetchProjectWire(entryUrl) {
+  try {
+    const projUrl = new URL("project.json", new URL(entryUrl, location.href));
+    const r = await fetch(projUrl.href, { credentials: "same-origin" });
+    if (!r.ok) return {};
+    return projectPropertiesToWire(await r.json());
+  } catch {
+    return {};
+  }
+}
+function mergeLiveIntoWire(defaults, live) {
+  const out = { ...defaults };
+  if (live) {
+    for (const [k, v] of Object.entries(live)) out[k] = { value: v };
+  }
+  return out;
+}
+function mountWeb(rt, cfg) {
+  clear(rt);
+  rt.cfg = cfg;
+  const container = resolveContainer(rt, cfg);
+  if (!container) {
+    reportDiag(rt, cfg, "网页壁纸：无可用容器");
+    rt.onError?.(new Error("网页壁纸：无可用容器"));
+    return;
+  }
+  const entry = cfg.src ?? "";
+  if (!entry) {
+    reportDiag(rt, cfg, "网页壁纸：缺少 src");
+    rt.onError?.(new Error("网页壁纸：缺少 src"));
+    return;
+  }
+  installWebCtl(rt);
+  const cfgExt = cfg;
+  const audioDriver = cfgExt._webAudio === null ? null : cfgExt._webAudio ?? defaultAudioDriver();
+  const mediaDriver = cfgExt._webMedia === null ? null : cfgExt._webMedia ?? defaultMediaDriver();
+  const finishBare = (why) => {
+    reportDiag(rt, cfg, `网页壁纸 shim 注入失败（${why}），退回裸 iframe`);
+    attachIframe(rt, cfg, container, entry, { injected: false });
+    startAudioPump(rt, null);
+    startMediaPump(rt, null);
+  };
+  const frameClock = { last: 0 };
+  const startPumps = () => {
+    startAudioPump(rt, audioDriver, frameClock);
+    startMediaPump(rt, mediaDriver);
+  };
+  void (async () => {
+    const defaults = await fetchProjectWire(entry);
+    const wire = mergeLiveIntoWire(defaults, rt.liveUserProps);
+    rt.liveUserProps = Object.fromEntries(Object.entries(wire).map(([k, w]) => [k, w.value]));
+    if (isSameOriginUrl(entry)) {
+      attachIframe(rt, cfg, container, entry, { injected: true, frameClock });
+      startPumps();
+      const f = rt.iframe;
+      f?.addEventListener(
+        "load",
+        () => {
+          let hasShim = false;
+          weShimCall(rt, (w) => {
+            hasShim = typeof w.__weSetPaused === "function";
+          });
+          if (!hasShim) {
+            reportDiag(
+              rt,
+              cfg,
+              "网页壁纸：同源入口未检测到 WE shim（host 未注入？）；Spine 类壁纸请确认 /web/ HTML 改写"
+            );
+          }
+        },
+        { once: true }
+      );
+      return;
+    }
+    try {
+      const res = await fetch(entry, { credentials: "same-origin" });
+      if (!res.ok) {
+        finishBare(`HTTP ${res.status}`);
+        return;
+      }
+      const html = await res.text();
+      if (hasBlockingCsp(html)) {
+        finishBare("CSP 阻止 inline script");
+        return;
+      }
+      const rewritten = rewriteHtml(html, shimSource, {
+        baseHref: entryDirUrl(entry),
+        seedScript: buildSeedScript(wire, cfg.sceneFps, cfg.muted === false ? 1 : 0)
+      });
+      const blob = new Blob([rewritten], { type: "text/html;charset=utf-8" });
+      const blobUrl = URL.createObjectURL(blob);
+      attachIframe(rt, cfg, container, blobUrl, { blobUrl, injected: true, frameClock });
+      startPumps();
+    } catch (e) {
+      finishBare(e instanceof Error ? e.message : String(e));
+    }
+  })();
+}
 function mountWallpaper(rt, cfg) {
-  if ((cfg.type === "video" || cfg.type === "gif" || cfg.type === "image") && cfg.src) {
+  const type = String(cfg.type ?? "").toLowerCase();
+  cfg = { ...cfg, type };
+  rt.cfg = cfg;
+  if ((type === "video" || type === "gif" || type === "image") && cfg.src) {
     mountMedia(rt, cfg);
-  } else if (cfg.type === "scene" && (cfg.source || cfg.src)) {
+  } else if (type === "scene" && (cfg.source || cfg.src)) {
     mountScene(rt, cfg);
+  } else if (type === "web" && cfg.src) {
+    mountWeb(rt, cfg);
   } else {
     rt.onUnhandledType?.(cfg);
   }
@@ -13505,22 +15679,60 @@ function normalizeFitOption(fit) {
   if (fit === "fill") return "cover";
   return fit === "contain" || fit === "stretch" ? fit : "cover";
 }
-function toConfig(canvas, o) {
-  return {
-    type: "scene",
-    canvas,
-    source: o.source,
+function isWebProject(project) {
+  const t = project?.type;
+  return typeof t === "string" && t.toLowerCase() === "web";
+}
+function ensureSceneCanvas(el) {
+  if (el instanceof HTMLCanvasElement) return el;
+  const existing = el.querySelector(":scope > canvas[data-webwallgl]");
+  if (existing instanceof HTMLCanvasElement) return existing;
+  const c = document.createElement("canvas");
+  c.setAttribute("data-webwallgl", "1");
+  c.style.cssText = "position:absolute;inset:0;width:100%;height:100%;display:block;";
+  if (getComputedStyle(el).position === "static") el.style.position = "relative";
+  el.appendChild(c);
+  return c;
+}
+async function resolveMountConfig(el, o) {
+  const base = {
     fit: normalizeFitOption(o.fit),
     renderDpr: o.renderDpr ?? 1,
     sceneFps: o.fps ?? 60,
     muted: (o.volume ?? 0) <= 0,
-    loop: true
+    loop: true,
+    canvas: el,
+    source: o.source
   };
+  let project = null;
+  try {
+    project = await o.source.project?.() ?? null;
+  } catch {
+    project = null;
+  }
+  if (isWebProject(project)) {
+    let url;
+    try {
+      const entry = await o.source.webEntry?.();
+      url = entry?.url;
+    } catch {
+      url = void 0;
+    }
+    if (!url && o.source.key) {
+      const file = project && typeof project.file === "string" ? String(project.file).trim().replace(/^\/+/, "") || "index.html" : "index.html";
+      url = `${o.source.key.replace(/\/+$/, "")}/${file}`;
+    }
+    if (!url) throw new Error("网页壁纸：无法解析入口 URL（需要 Source.webEntry 或 httpSource）");
+    return { ...base, type: "web", src: url, source: o.source };
+  }
+  const canvas = ensureSceneCanvas(el);
+  return { ...base, type: "scene", canvas, source: o.source };
 }
-function createScene(canvas, options) {
+function createScene(el, options) {
   const rt = createRuntime();
   const events = { ready: [], error: [], diagnostic: [] };
   let currentOptions = { ...options ?? {}, source: null };
+  let boundEl = el;
   const emitError = (err) => {
     for (const fn of events.error) {
       try {
@@ -13559,6 +15771,24 @@ function createScene(canvas, options) {
       rt.onFirstFrame = () => {
         rt.onFirstFrame = void 0;
         prev?.();
+        const info = rt.info ?? {
+          width: 0,
+          height: 0,
+          layerCount: 0,
+          hasModels: false,
+          hasParticles: false,
+          hasText: false
+        };
+        try {
+          currentOptions.onReady?.(info);
+        } catch {
+        }
+        for (const fn of events.ready) {
+          try {
+            fn(info);
+          } catch {
+          }
+        }
         resolve();
       };
     });
@@ -13572,7 +15802,9 @@ function createScene(canvas, options) {
     return { promise, off };
   };
   const instance = {
-    canvas,
+    get canvas() {
+      return boundEl;
+    },
     pause() {
       rt.paused = true;
       rt.sceneCtl?.pause();
@@ -13591,11 +15823,13 @@ function createScene(canvas, options) {
     },
     setFps(fps) {
       rt.cfg.sceneFps = fps;
+      weShimCall(rt, (w) => w.__weSetFps?.(fps));
     },
     setVolume(volume) {
       const v = Math.max(0, Math.min(1, volume));
       rt.cfg.muted = v <= 0;
       rt.sceneAudio?.setVolume(v);
+      weShimCall(rt, (w) => w.__weSetVolume?.(v));
     },
     setRenderDpr(dpr) {
       rt.cfg.renderDpr = dpr;
@@ -13612,17 +15846,17 @@ function createScene(canvas, options) {
     async load(source) {
       currentOptions = { ...currentOptions, source };
       wireOptions(currentOptions);
-      const cfg = {
-        ...rt.cfg,
-        type: "scene",
-        source,
-        src: void 0,
-        mediaBase: void 0
-      };
+      const cfg = await resolveMountConfig(boundEl, currentOptions);
+      if (cfg.type === "scene" && cfg.canvas instanceof HTMLCanvasElement) {
+        boundEl = cfg.canvas;
+      }
       rt.cfg = cfg;
       rt.paused = false;
       rt.info = void 0;
       resetCoverAlign(rt);
+      if (currentOptions.properties) {
+        rt.liveUserProps = { ...currentOptions.properties };
+      }
       const firstFrame = armFirstFrame();
       const failure = armFailure();
       mountWallpaper(rt, cfg);
@@ -13666,10 +15900,17 @@ function createScene(canvas, options) {
   const applyOptions = async (o) => {
     currentOptions = o;
     wireOptions(o);
-    rt.cfg = toConfig(canvas, o);
+    const cfg = await resolveMountConfig(el, o);
+    if (cfg.type === "scene" && cfg.canvas instanceof HTMLCanvasElement) {
+      boundEl = cfg.canvas;
+    }
+    rt.cfg = cfg;
     rt.paused = o.autoplay === false;
     rt.info = void 0;
     resetCoverAlign(rt);
+    if (o.properties && Object.keys(o.properties).length) {
+      rt.liveUserProps = { ...o.properties };
+    }
     const firstFrame = armFirstFrame();
     const failure = armFailure();
     mountWallpaper(rt, rt.cfg);
@@ -13684,8 +15925,8 @@ function createScene(canvas, options) {
   instance.__applyOptions = applyOptions;
   return instance;
 }
-async function mount(canvas, options) {
-  const instance = createScene(canvas, options);
+async function mount(el, options) {
+  const instance = createScene(el, options);
   const withApply = instance;
   await withApply.__applyOptions(options);
   return instance;