dsh-mpkg-wallpaper 3.13.6 → 3.13.8

package/README.en.md

@@ -325,7 +325,7 @@ These keys **exist and participate in the logic** but have no widget on the sett
 | `aquaTintStrength` | 45 | How much of the wallpaper colour is mixed into panel tints; read at runtime |
 | `glassColor` / `glassAlpha` | empty / 12 | Early WebGL liquid-glass leftovers: backup/restore only, **no widget and no reader** |
 | `webInteraction` | `pointer` | Web-wallpaper interaction mode (`off`/`pointer`/`full`); use `?mpwinteract=…` or write the stored settings |
-| `sceneRendererUrl` | `http://127.0.0.1:8899/` | Scene-renderer address, overridable |
+| `sceneRendererUrl` | `http://127.0.0.1:8902/webloader/` | Scene-renderer address, overridable (default = the one-stop :8902 bench serving `/webloader/` itself; the old default was `:8899`, changed 2026-09-25) |
 | `npVolume` | 100 | The **volume level** in the Now playing card (0..100, applied to the real element); the default profile **never writes element volume**, only your own change does |
 | `glassWindow` | — | **Retired and deleted** (2026-09-19): no widget, no reader; covered by `settingsBlur` + `dialogBlur`/`popoverBlur` |
 
@@ -406,7 +406,7 @@ Start here when something is wrong: one click sends state back to the local host
 Two different numbers — do not mix them up:
 
 - The **main table holds 158 flags**, in the **renderer repository**, [`we-scene-demo/docs/README-DIAGNOSTICS.md`](../we-scene-demo/docs/README-DIAGNOSTICS.md) (generated by `diag-flag-check.mjs`, cross-checked against `web/diag-flags.json`).
-- The plugin panel only ships the **common / escape-hatch table** (the 10 flags with `common:true`), appended to the renderer URL, e.g. `http://127.0.0.1:8899/?id=3719111841&audit=3`:
+- The plugin panel only ships the **common / escape-hatch table** (the 10 flags with `common:true`), appended to the renderer URL, e.g. `http://127.0.0.1:8902/webloader/?id=3719111841&audit=3`:
 
 | Flag | Purpose | Default |
 |---|---|---|
@@ -464,7 +464,7 @@ A "WE install" means the Steam edition of Wallpaper Engine (appid **431960**). T
 
 The plugin offers two paths:
 
-1. **External renderer iframe (preferred)**: when the local we-scene renderer on `:8899` is online, the scene is mounted as an iframe (`lib/client.js:3133-3190`). If the renderer is offline or the first frame times out, a **watchdog** falls back to the static frame and says so in a hint bar; a manual "remount renderer" button is provided. The renderer address can be overridden with `sceneRendererUrl`.
+1. **External renderer iframe (preferred)**: when the local renderer (default `http://127.0.0.1:8902/webloader/`, previously `:8899`) is online, the scene is mounted as an iframe (`lib/client.js:3133-3190`). If the renderer is offline or the first frame times out, a **watchdog** falls back to the static frame and says so in a hint bar; a manual "remount renderer" button is provided. The renderer address can be overridden with `sceneRendererUrl`.
 2. **In-container asset extraction (fallback, `lib/pkg-extract.js`, MIT, adopted from [elysia395/dsh-wallpaper-engine](https://github.com/elysia395/dsh-wallpaper-engine))**:
    - **Static frame**: parses the PKG (LZ4) and decodes TEX textures, picking the main texture by "area × format weight × path penalty" (`lib/pkg-extract.js:1422-1491`)
    - **Layer composite**: parses every image layer of `scene.json` and composites them on a canvas using source coordinates/sizes (at most 24 layers, `lib/pkg-extract.js:1734-1829`)

package/README.md

@@ -326,7 +326,7 @@ node tools/build-bundle.mjs
 | `aquaTintStrength` | 45 | 面板取色的壁纸主色混合比例；运行时读取（`lib/client.js:5575`），无控件 |
 | `glassColor` / `glassAlpha` | 空 / 12 | 早期 WebGL 液态玻璃的遗留键：只随备份导出/导入与「恢复默认」走动，**无控件、无读取点**（`lib/client.js:11968`、`:11986`） |
 | `webInteraction` | `pointer` | 网页壁纸交互档位（`off`/`pointer`/`full`）：**无面板控件**，用 URL `?mpwinteract=…` 或写存档 |
-| `sceneRendererUrl` | `http://127.0.0.1:8899/` | 场景渲染器地址，可覆盖（`lib/client.js:3129-3132`） |
+| `sceneRendererUrl` | `http://127.0.0.1:8902/webloader/` | 场景渲染器地址，可覆盖（默认 = 一站式测试台 :8902 自己直供的 `/webloader/`；旧默认是 `:8899`，2026-09-25 改） |
 | `npVolume` | 100 | Now playing 卡片里的**音量电平**（0..100，落到真实元素）；默认档**从不写元素音量**，只有你动过才写 |
 | `glassWindow` | — | **已退役删除**（2026-09-19）：无控件、无读取点，功能已被 `settingsBlur` + `dialogBlur`/`popoverBlur` 覆盖；源码与 zh/en 字典 0 残留 |
 
@@ -407,7 +407,7 @@ node tools/build-bundle.mjs
 这两个数字口径不同，别混：
 
 - **主表共 158 个开关**，在**渲染器仓**的 [`we-scene-demo/docs/README-DIAGNOSTICS.md`](../we-scene-demo/docs/README-DIAGNOSTICS.md)（由 `diag-flag-check.mjs` 生成、与 `web/diag-flags.json` 对拍）。
-- 插件面板里只放**常用/逃生口那一张小表**（10 个，`common:true` 集合），拼在渲染器地址后面用，例如 `http://127.0.0.1:8899/?id=3719111841&audit=3`：
+- 插件面板里只放**常用/逃生口那一张小表**（10 个，`common:true` 集合），拼在渲染器地址后面用，例如 `http://127.0.0.1:8902/webloader/?id=3719111841&audit=3`：
 
 | 开关 | 用途 | 默认 |
 |---|---|---|
@@ -465,7 +465,7 @@ node tools/build-bundle.mjs
 
 插件提供两条路径：
 
-1. **外部渲染器 iframe（首选）**：本机 `:8899` 的 we-scene 渲染器在线时，场景以 iframe 挂载（`lib/client.js:3133-3190`）。渲染器离线/首帧超时则由**看门狗**回退静态帧并在提示条说明，可手动「重新挂载渲染器」。渲染器地址可用 `sceneRendererUrl` 覆盖。
+1. **外部渲染器 iframe（首选）**：本机渲染器（默认 `http://127.0.0.1:8902/webloader/`，旧默认 `:8899`）在线时，场景以 iframe 挂载（`lib/client.js:3133-3190`）。渲染器离线/首帧超时则由**看门狗**回退静态帧并在提示条说明，可手动「重新挂载渲染器」。渲染器地址可用 `sceneRendererUrl` 覆盖。
 2. **容器内素材提取（兜底，`lib/pkg-extract.js`，MIT，采用自 [elysia395/dsh-wallpaper-engine](https://github.com/elysia395/dsh-wallpaper-engine)）**：
    - **静态帧**：解析 PKG（LZ4 解压）+ TEX 纹理解码，按"面积 × 格式权重 × 路径惩罚"选主纹理（`lib/pkg-extract.js:1422-1491`）
    - **图层合成**：解析 `scene.json` 的全部 image 图层，按源坐标/尺寸在 canvas 上合成（最多 24 层，`lib/pkg-extract.js:1734-1829`）

package/lib/client.js

@@ -2677,7 +2677,12 @@ function mpwThumbFail(el, why) {
 				.trim();
 		}
 
-		/** 解析 project.json 文本，提取标题 + 可调参数信息。 */
+		/** 解析 project.json 文本，提取标题 + **官方 user properties 全字段**。
+		 *  ①(2026-09-24 用户 bug「WE 自带选项只显示一项且展不开」修复) 旧实现只留
+		 *    `{key,label,value,type,options,displayOnly,important}` —— `group`（分组头）、
+		 *    `condition`（条件显示）、`min/max/step/precision`（控件量程）、`order/index`（官方排序）
+		 *    **全部被丢掉** ⇒ 面板只能渲染成一堆只读文本行、且无法按官方口径分组/联动。
+		 *    现在**逐字段保留**（分组/条件/量程/排序都能用），并由 mpwPropsModel 决定渲染形态。 */
 		function extractProjectInfo(jsonText) {
 			try {
 				// ①(P-177 同口径) 包内 project.json 走宽容解析（官方允许尾逗号）；健康文件与 JSON.parse 逐位等价
@@ -2685,23 +2690,38 @@ function mpwThumbFail(el, why) {
 				const props = json.general && json.general.properties;
 				const list = [];
 				if (props) {
+					let seq = 0;
 					for (const key of Object.keys(props)) {
 						if (!safePropKey(key)) continue;
 						const p = props[key];
 						if (!p || typeof p !== "object") continue;
+						// ①(修正) 原来 `if (!label) continue` 把**没有 text 的条目整条丢掉**
+						//   （语料 70 包实测：无 type 的 HTML 营销块 102 条、group 也有空文案的）——
+						//   丢掉的后果不只是"少一行"，还会把分组头吞掉 ⇒ 后面所有子项失去归属。
+						//   现在一律保留（渲染与否交给 mpwPropsModel 按官方口径裁定并记账）。
 						const label = cleanLabel(p.text);
-						if (!label) continue;
 						let value = p.value;
 						if (Array.isArray(p.options) && p.options.length) {
 							const opt = p.options.find((o) => String(o.value) === String(value));
 							if (opt) value = opt.label;
 						}
 						// type "text" 是纯展示性条目（作者信息/说明），不给输入框（⑥）
-						const displayOnly = p.type === "text";
+						const displayOnly = p.type === "text" || p.type === "txt" || !p.type;
 						// ① 关键开关识别（entry animation 开场动画 / prompt box 提示框）
 						const keyText = (label + " " + (p.text || "")).toLowerCase();
 						const important = /entry\s*animation|开场动画|入场动画|prompt\s*box|提示框|水印|盗版|防盗|开始时间|随现实时间|timevarying|morningtime|daytime|dusktime|nighttime|时间变化|时间段/.test(keyText);
-						list.push({ key, label, value: value === void 0 ? "" : value, type: p.type, options: p.options || null, displayOnly, important });
+						const num = (v) => (typeof v === "number" && isFinite(v) ? v : (typeof v === "string" && v.trim() !== "" && isFinite(Number(v)) ? Number(v) : null));
+						list.push({
+							key, label, value: value === void 0 ? "" : value, type: p.type,
+							options: Array.isArray(p.options) ? p.options : null,
+							displayOnly, important,
+							// ①(新) 官方字段：分组归属、条件显示、控件量程、排序
+							group: typeof p.group === "string" && p.group ? p.group : null,
+							conditions: typeof p.condition === "string" ? p.condition : (typeof p.conditions === "string" ? p.conditions : null),
+							min: num(p.min), max: num(p.max), step: num(p.step),
+							precision: num(p.precision),
+							order: num(p.order), index: num(p.index), seq: seq++,
+						});
 					}
 				}
 				return { title: json.title || "", properties: list };
@@ -2722,6 +2742,253 @@ function mpwThumbFail(el, why) {
 			}
 		}
 
+		/* ═══ MPW-PROPS-MODEL-BEGIN ═══
+		   官方 user properties（`project.json → general.properties`）的**面板行模型**。
+		   纯函数、无 DOM：同一份代码在 Node 里跑断言（tools/props-panel-wiring-test.mjs）。
+		   口径（行为结论来自渲染器侧同名面板的真包/真机验证；代码为本仓自研，未复制）：
+		     · 一个 group 类型条目 = **分组头**；子项 = 其后（按官方 order 排序）直到下一个 group 的条目，
+		       `group` 字段显式指认时以字段为准。
+		     · `condition` 是**表达式**（真包语料：`clock.value`、`tishi.value==0`、`!timevarying.value`、
+		       `a.value == true && b.value == true`）⇒ 走白名单递归下降求值，**绝不 eval**；
+		       condition 引用的属性自身被门控隐藏时，本项一并隐藏（传递闭包）。
+		     · 白名单外/引用缺失 ⇒ 返回 null（**未知**）：未知一律**照显示**（宁多显示不误藏）并记账。
+		     · 类型 → 控件：bool 开关 / slider 量程滑杆 / combo 下拉 / color 取色 / textinput 文本框；
+		       file·directory·scenetexture 需要渲染器侧资源通道，插件侧**只读如实展示**（不猜）；
+		       `schemecolor`（编辑器配色）与 `usershortcut`（官方语义未实现）**不渲染但逐条记账**。
+		     · 排序：`order` → `index` → 文件内顺序。
+		   ═══ */
+		const MPW_PROP_CONTROL_TYPES = { bool: "bool", slider: "slider", combo: "combo", color: "color", textinput: "textinput" };
+		const MPW_PROP_READONLY_TYPES = { file: "选择文件（需要渲染器资源通道，插件侧未接线）", directory: "选择文件夹（需要渲染器资源通道，插件侧未接线）", scenetexture: "贴图替换（需要渲染器资源通道，插件侧未接线）" };
+		const MPW_PROP_SKIP_TYPES = { schemecolor: "编辑器配色（官方不在用户属性面板渲染）", usershortcut: "官方语义未实现（不猜）" };
+		/** 官方排序键：order 优先，其次 index，再退文件内出现顺序。 */
+		function mpwPropSorted(allProps) {
+			const list = Array.isArray(allProps) ? allProps.slice() : [];
+			const ord = (p) => (typeof p.order === "number" && isFinite(p.order) ? p.order : (typeof p.index === "number" && isFinite(p.index) ? p.index : 1e9));
+			list.sort((a, b) => (ord(a) - ord(b)) || ((a.seq || 0) - (b.seq || 0)));
+			return list;
+		}
+		/** 条目分类：group / control / readonly / note / skip（不渲染的必须带 why，不静默丢）。 */
+		function mpwPropKind(p) {
+			const type = p && p.type ? String(p.type).toLowerCase() : "";
+			// ① `schemecolor` 是**属性名**（不是类型）：它是编辑器配色，官方用户面板不渲染
+			if (p && p.key === "schemecolor") return { kind: "skip", why: MPW_PROP_SKIP_TYPES.schemecolor };
+			if (type === "group") return { kind: "group", why: "" };
+			if (MPW_PROP_CONTROL_TYPES[type]) return { kind: "control", why: "" };
+			if (MPW_PROP_READONLY_TYPES[type]) return { kind: "readonly", why: MPW_PROP_READONLY_TYPES[type] };
+			if (MPW_PROP_SKIP_TYPES[type]) return { kind: "skip", why: MPW_PROP_SKIP_TYPES[type] };
+			if (type === "text" || type === "txt") return { kind: "note", why: "" };
+			// 无 type：官方口径=HTML 营销块，不渲染；有文案的按作者说明行展示（可读性），空文案的记账跳过
+			if (!type) return p.label ? { kind: "note", why: "无 type（官方不在面板渲染；此处按作者说明行展示）" } : { kind: "skip", why: "无 type 且无文案" };
+			return { kind: "skip", why: "未知类型 " + type + "（不猜）" };
+		}
+		/** 条件表达式 → token 流；白名单外返回 null（调用方按"未知"处理）。 */
+		function mpwPropCondTokens(src) {
+			const s = String(src == null ? "" : src);
+			const out = [];
+			let i = 0;
+			while (i < s.length) {
+				const c = s[i];
+				if (/\s/.test(c)) { i++; continue }
+				if (c === "(" || c === ")") { out.push({ t: "punc", v: c }); i++; continue }
+				if (c === "!" && s[i + 1] === "=") { out.push({ t: "op", v: "!=" }); i += 2; continue }
+				if (c === "!") { out.push({ t: "op", v: "!" }); i++; continue }
+				if (c === "&" && s[i + 1] === "&") { out.push({ t: "op", v: "&&" }); i += 2; continue }
+				if (c === "|" && s[i + 1] === "|") { out.push({ t: "op", v: "||" }); i += 2; continue }
+				if (c === "=" && s[i + 1] === "=") { out.push({ t: "op", v: "==" }); i += 2; continue }
+				if (c === '"' || c === "'") {
+					let j = i + 1, buf = "";
+					while (j < s.length && s[j] !== c) { if (s[j] === "\\") j++; buf += s[j] === void 0 ? "" : s[j]; j++ }
+					if (j >= s.length) return null; // 未闭合字符串 = 白名单外
+					out.push({ t: "str", v: buf }); i = j + 1; continue;
+				}
+				if (/[0-9]/.test(c) || (c === "-" && /[0-9.]/.test(s[i + 1] || ""))) {
+					let j = i + 1;
+					while (j < s.length && /[0-9.eE+-]/.test(s[j])) j++;
+					const num = Number(s.slice(i, j));
+					if (!isFinite(num)) return null;
+					out.push({ t: "num", v: num }); i = j; continue;
+				}
+				if (/[A-Za-z_$]/.test(c)) {
+					let j = i;
+					while (j < s.length && /[A-Za-z0-9_$.]/.test(s[j])) j++;
+					const id = s.slice(i, j);
+					if (id === "true" || id === "false") out.push({ t: "bool", v: id === "true" });
+					else if (/^[A-Za-z_$][\w$]*\.value$/.test(id)) out.push({ t: "ref", v: id.slice(0, -6) });
+					else return null; // 只认 `<属性名>.value`
+					i = j; continue;
+				}
+				return null;
+			}
+			return out;
+		}
+		/** 值的真值口径（官方两态 bool / 数值 / 字符串）。 */
+		function mpwPropTruthy(v) {
+			if (typeof v === "boolean") return v;
+			if (typeof v === "number") return v !== 0;
+			if (typeof v === "string") { const s = v.trim().toLowerCase(); return !(s === "" || s === "0" || s === "false" || s === "off" || s === "no"); }
+			return false;
+		}
+		/** `==` 口径：bool 字面量/数值/字符串三态归一到可比对的值。 */
+		function mpwPropEq(a, b) {
+			const numish = (x) => (typeof x === "number" && isFinite(x)) || (typeof x === "string" && x.trim() !== "" && isFinite(Number(x)));
+			if (typeof a === "boolean" || typeof b === "boolean") return mpwPropTruthy(a) === mpwPropTruthy(b);
+			if (numish(a) && numish(b)) return Number(a) === Number(b);
+			return String(a) === String(b);
+		}
+		/** 条件求值（白名单子集）：true / false / null（未知 ⇒ 调用方照显示）。 */
+		function mpwPropCondEval(expr, values) {
+			if (expr === null || expr === void 0) return true;
+			const text = String(expr).trim();
+			if (!text) return true;
+			const toks = mpwPropCondTokens(text);
+			if (!toks || !toks.length) return null;
+			let pos = 0;
+			const peek = () => toks[pos];
+			const eat = (t, v) => { const x = toks[pos]; return !!x && x.t === t && (v === void 0 || x.v === v) ? (pos++, x) : null };
+			const val = (n) => {
+				if (!n) return null;
+				if (n.t === "ref") return Object.prototype.hasOwnProperty.call(values, n.v) ? { v: values[n.v] } : null; // 引用缺失 ⇒ 未知
+				return { v: n.t === "bool" ? n.v : (n.t === "num" ? n.v : n.v) };
+			};
+			let bad = false;
+			const prim = () => {
+				if (eat("punc", "(")) { const r = or(); if (!eat("punc", ")")) { bad = true; return null } return r }
+				const n = eat("ref") || eat("bool") || eat("num") || eat("str");
+				if (!n) { bad = true; return null }
+				return val(n);
+			};
+			const cmp = () => {
+				let a = prim();
+				if (bad) return null;
+				const op = eat("op", "==") || eat("op", "!=");
+				if (!op) return a;
+				const b = prim();
+				if (bad) return null;
+				if (a === null || b === null) return null; // 任一侧未知 ⇒ 未知
+				return { v: op.v === "==" ? mpwPropEq(a.v, b.v) : !mpwPropEq(a.v, b.v) };
+			};
+			const unary = () => {
+				if (eat("op", "!")) { const r = unary(); if (bad || r === null) return r; return { v: !mpwPropTruthy(r.v) } }
+				return cmp();
+			};
+			const and = () => {
+				let l = unary();
+				while (eat("op", "&&")) {
+					const r = unary();
+					if (bad) return null;
+					if (l === null || r === null) l = null; else l = { v: mpwPropTruthy(l.v) && mpwPropTruthy(r.v) };
+				}
+				return l;
+			};
+			function or() {
+				let l = and();
+				while (eat("op", "||")) {
+					const r = and();
+					if (bad) return null;
+					if (l === null || r === null) l = null; else l = { v: mpwPropTruthy(l.v) || mpwPropTruthy(r.v) };
+				}
+				return l;
+			}
+			const res = or();
+			if (bad || pos !== toks.length) return null; // 有残余 token ⇒ 白名单外
+			if (res === null) return null;
+			return mpwPropTruthy(res.v);
+		}
+		/** 行模型：把官方属性表变成"（分组头 + 子行）序列 + 记账"。 */
+		function mpwPropsModel(allProps, edits, opts) {
+			const list = mpwPropSorted(allProps);
+			const e = (edits && typeof edits === "object") ? edits : {};
+			const values = {};
+			for (const p of list) values[p.key] = e[p.key] !== void 0 ? e[p.key] : p.value;
+			// ① 分类 + 显式 group 字段指认的集合
+			const kinds = list.map((p) => mpwPropKind(p));
+			const explicitGroups = new Set();
+			for (const p of list) if (p.group) explicitGroups.add(p.group);
+			// ② 归属：显式字段优先；否则"其后（排序后）直到下一个 group 的条目"
+			const rows = [];
+			let curGroup = null;
+			const depthOf = (p, i) => {
+				const k = kinds[i];
+				if (k.kind === "group") { curGroup = p.key; return 0 }
+				if (p.group && explicitGroups.has(p.group)) return 1;
+				return curGroup ? 1 : 0;
+			};
+			list.forEach((p, i) => {
+				const k = kinds[i];
+				const depth = depthOf(p, i);
+				rows.push({
+					key: p.key, label: p.label, type: p.type ? String(p.type).toLowerCase() : "",
+					kind: k.kind, kindWhy: k.why, depth,
+					group: k.kind === "group" ? null : (p.group && explicitGroups.has(p.group) ? p.group : curGroup),
+					value: values[p.key], def: p.value, edited: e[p.key] !== void 0,
+					options: p.options || null, min: p.min, max: p.max, step: p.step, precision: p.precision,
+					// ① 官方的字段名是 `condition`（单数）；提取结果里存成 `conditions`（避免与行的
+					//   condition 同名字段混淆）⇒ 两个都认，手工构造的属性表也能直接用。
+					condition: (typeof p.conditions === "string" ? p.conditions : (typeof p.condition === "string" ? p.condition : null)), important: !!p.important, displayOnly: !!p.displayOnly,
+				});
+			});
+			// ③ 条件门控（含传递闭包）：自身 condition 为假，或其 condition 引用的属性已被隐藏
+			const hidden = {};
+			const refsOf = (r) => {
+				if (!r.condition) return [];
+				const toks = mpwPropCondTokens(r.condition) || [];
+				return toks.filter((t) => t.t === "ref").map((t) => t.v);
+			};
+			for (let round = 0; round < 4; round++) {
+				let changed = false;
+				for (const r of rows) {
+					if (hidden[r.key]) continue;
+					let res;
+					if (r.condition) {
+						const refs = refsOf(r);
+						if (refs.some((k2) => hidden[k2])) res = false;      // 父属性被门控 ⇒ 子属性一并隐藏
+						else res = mpwPropCondEval(r.condition, values);
+					} else res = true;
+					r.condResult = res;
+					if (res === false) { hidden[r.key] = true; changed = true; }
+				}
+				if (!changed) break;
+			}
+			// ①(修正) **先算完所有行的 visible，再做"空分组"收口**：
+			//   同一趟里算会让"子项还没轮到 ⇒ visible 仍是 undefined"被当成不可见，分组头全被判空。
+			for (const r of rows) r.visible = !hidden[r.key];
+			for (const r of rows) {
+				// 分组头：没有任何可见子项时也隐藏（不留空壳分组）
+				if (r.kind === "group" && r.visible) {
+					const mine = rows.filter((x) => x.group === r.key && x.visible && x.kind !== "group");
+					r.childCount = mine.length;
+					r.controlCount = mine.filter((x) => x.kind === "control").length;
+					if (!mine.length) r.visible = false;
+				}
+			}
+			const counts = { total: rows.length, groups: 0, controls: 0, readonly: 0, notes: 0, skipped: 0, hidden: 0, condUnknown: 0, visible: 0 };
+			for (const r of rows) {
+				if (r.kind === "group") counts.groups++;
+				else if (r.kind === "control") counts.controls++;
+				else if (r.kind === "readonly") counts.readonly++;
+				else if (r.kind === "note") counts.notes++;
+				else counts.skipped++;
+				if (r.visible) counts.visible++; else if (r.kind !== "skip") counts.hidden++;
+				if (r.condition && r.condResult === null) counts.condUnknown++;
+			}
+			return { rows, counts };
+		}
+		/* ═══ MPW-PROPS-MODEL-END ═══ */
+		/** 官方 color 属性是**线性 0..1 浮点三通道**（`"r g b"`），不是 0..255。取色控件用 #rrggbb 中转。 */
+		function mpwPropColorToHex(v) {
+			const arr = Array.isArray(v) ? v : String(v === void 0 || v === null ? "" : v).trim().split(/[\s,]+/);
+			if (arr.length < 3) return null;
+			const n = arr.slice(0, 3).map(Number);
+			if (!n.every((x) => isFinite(x))) return null;
+			return "#" + n.map((x) => Math.max(0, Math.min(255, Math.round(x * 255))).toString(16).padStart(2, "0")).join("");
+		}
+		function mpwPropHexToColor(hex) {
+			const m = /^#?([0-9a-fA-F]{6})$/.exec(String(hex || "").trim());
+			if (!m) return null;
+			const s = m[1];
+			return [0, 2, 4].map((i) => String(Math.round((parseInt(s.slice(i, i + 2), 16) / 255) * 1e6) / 1e6)).join(" ");
+		}
+
 
 		// ═══════════════════════════════════════════════════════════════════
 		//  背景 DOM（一个固定 img 层；用 <img> 保证 GIF 动画可靠播放，⑪）
@@ -2772,7 +3039,7 @@ function mpwThumbFail(el, why) {
 				// ①(新) 网页壁纸 iframe（web wallpaper）：独立沙箱层，覆盖整屏。
 				// ①(2026-09-13 注释更正 —— 之前写着"去掉 allow-same-origin"但属性里**并没有去掉**，
 				//   属于注释与代码不符，会误导安全判断。现状与事实如下：
-				//   · iframe 带 `allow-same-origin`，因此它与宿主**同源**（渲染器在 127.0.0.1:8899，
+				//   · iframe 带 `allow-same-origin`，因此它与宿主**同源**（渲染器在 127.0.0.1:8902/webloader，
 				//     cookie 按主机不按端口隔离 → 同 site）→ 它对插件宿主 `/api/mpkg-wallpaper/...`
 				//     的 fetch **会自动带上 DSH 的会话 cookie**（这是"自定义场景/缩略图上报"能工作的前提）。
 				//   · DSH 的会话 cookie 是 `HttpOnly; SameSite=Strict; Path=/`（见 dsh-client-connection
@@ -3160,6 +3427,9 @@ function mpwThumbFail(el, why) {
 				try { mpwWebIxDisarm("teardown"); } catch {} // ①(第 11 条) 卸载网页壁纸必须退出交互模式（否则残留输入面）
 			try { if (window.__mpwLnReset) window.__mpwLnReset(); } catch {} // ①(批次15 B3) 方向键守卫复位
 				if (!frame) return;
+				/* ①(2026-09-25 任务 ㉑ 追加) 撤 src 之前**先明确停源**：撤 src 让文档销毁这条依赖浏览器行为，
+				   而"隐藏但保留"的窗口期（看门狗兜底/总开关关掉）里声音是真会漏出去的 ⇒ 两条都做。 */
+				try { sendRendererAudioPolicy(frame, true, true, "teardown") } catch (e) {}
 				disposeWebFrame(frame);
 				try { frame.removeAttribute("src"); } catch {}
 				frame.style.display = "none";
@@ -3979,6 +4249,7 @@ function mpwThumbFail(el, why) {
 			if (wd.fallback) {
 				// 兜底后渲染器终于出画（迟到首帧）→ 自动恢复实时渲染
 				wd.fallback = false;
+				try { const f0 = bgElements().frame; if (f0) { sendRendererAudioPolicy(f0, true, false, "scene-recovered"); applyWebMute(f0) } } catch (e) {}
 				mpwSceneClearFallback();
 				mpwSceneSetHint(mpwSceneT("scnRender.wd.recovered", "场景渲染器已出画，自动恢复实时渲染"));
 				try { fetch(HOST_BASE + "/diag", { method: "POST", body: JSON.stringify({ kind: "scene-render-health", why: "late-first-frame-recovered", ident: wd.ident, armedAt: wd.armedAt, at: new Date().toISOString() }) }).catch(() => {}) } catch {}
@@ -3990,6 +4261,12 @@ function mpwThumbFail(el, why) {
 			if (!wd || wd.fallback) return;
 			wd.fallback = true;
 			wd.fallbackAt = Date.now();
+			/* ①(2026-09-25 任务 ㉑ 追加) **兜底隐藏 iframe 时，必须把帧内声音停掉**：
+			   这条路径是"**隐藏但保留元素与 src**"（等迟到首帧恢复），而隐藏的 iframe 里音频照样在放 ——
+			   真机现场就是"壁纸没有自动播放（显示静态帧）、声音却在响，而且**不是当前壁纸的**音频"。
+			   跨源帧没有别的通道 ⇒ 走 postMessage `park`（渲染器侧 pause 元素 + ctx.suspend）。 */
+			try { const f0 = bgElements().frame; if (f0) sendRendererAudioPolicy(f0, true, true, "scene-fallback:" + String(why || "")) } catch (e) {}
+			try { window.__mpwSceneFallbackPark = { at: Date.now(), why: String(why || "") } } catch (e) {}
 			try {
 				const { img, wrap } = bgElements();
 				if (wrap) wrap.classList.add("mpw-scene-fallback");
@@ -4289,6 +4566,45 @@ function mpwThumbFail(el, why) {
 				} catch {}
 			} catch {}
 		}
+		/** ①(2026-09-25 任务 ㉑) **场景渲染器帧的图级音频策略**通道（`{type:"mpw-audio-policy"}`）。
+		 *  为什么必须单独有它（真机读数，见 docs/reports-issue0924a3-audio-leak.md）：
+		 *   场景渲染器 iframe 在 `127.0.0.1:8902`、插件页在 `127.0.0.1:3080` ⇒ **不同源**，
+		 *   于是 `applyWebMute` 的三条既有通道**一条都到不了帧里**：
+		 *     · `frame.contentDocument` = null（逐元素写 `muted` 那趟扫不到）；
+		 *     · `window.frameElement` = null（帧内读不到宿主写的 `frame.muted` expando）；
+		 *     · shim policy 只对 `?mpwshim=1` 的网页壁纸帧发。
+		 *   实测（静音=开 + 场景档 + 刷新）：帧内 4 条 `<audio>` 全是 `muted:false/volume:0.25`、
+		 *   AudioContext `running`、接 destination 那条边的抽头 rms≈0.013 → **静音开着照样出声**。
+		 *  `postMessage` 是**跨源唯一可达**的通道；渲染器侧收口是一个 master GainNode（图级归零），
+		 *  见 demo.html 的 `mpwAudioSetPolicy` / `mpwAudioConnectMaster`。
+		 *  幂等 + **刷新后必发**：`contentWindow` 换了（帧重载/换 src/刷新）⇒ 即使值相同也重发一次 ——
+		 *  这正是"刷新之后壁纸又开始出声"的那条缝（旧写法只在挂载/切歌时下发）。 */
+		function sendRendererAudioPolicy(frame, mute, park, why) {
+			try {
+				const cw = frame && frame.contentWindow;
+				if (!cw || typeof cw.postMessage !== "function") return false;
+				const want = { muted: !!mute, volume: npWantVolume() };
+				/* ①(2026-09-25 任务 ㉑ 追加) `park` = “把这一页收起来”（宿主隐藏/看门狗兜底/省电暂停）：
+				   渲染器侧收到就**停源**（pause 元素 + ctx.suspend），不是只压增益。 */
+				if (park !== undefined) want.park = !!park;
+				const prev = frame.__mpwRendererAudioPolicy;
+				const stale = !prev || prev.win !== cw;
+				if (!stale && prev.muted === want.muted && prev.volume === want.volume && prev.park === want.park) return false;
+				frame.__mpwRendererAudioPolicy = { win: cw, muted: want.muted, volume: want.volume, park: want.park, at: Date.now() };
+				let posted = false;
+				try { cw.postMessage({ type: "mpw-audio-policy", muted: want.muted, volume: want.volume, park: want.park, why: String(why || "") }, "*"); posted = true } catch (e) { /* 跨源不可达时如实留 false */ }
+				/* 同源时再走一遍**真能力** API（跨源读不到 `__wp` ⇒ 静默跳过；幂等由渲染器侧保证）。 */
+				try { if (cw.__wp && typeof cw.__wp.setAudioPolicy === "function") cw.__wp.setAudioPolicy({ muted: want.muted, volume: want.volume, park: want.park }) } catch (e) {}
+				/* 可查台账（探针/tools/audio-leak-frame-probe.mjs 读它证明"刷新后重新下发过"）。 */
+				try {
+					const rec = window.__mpwRendererAudioPush || (window.__mpwRendererAudioPush = { n: 0, last: null, log: [] });
+					rec.n++;
+					rec.last = { at: Date.now(), muted: want.muted, volume: want.volume, park: want.park, why: String(why || ""), stale: stale, posted: posted, sameOrigin: (() => { try { return !!cw.document } catch (e) { return false } })() };
+					rec.log.push(rec.last); if (rec.log.length > 12) rec.log.shift();
+				} catch (e) {}
+				return posted;
+			} catch (e) { return false }
+		}
 		/** ①(新) web 壁纸静音：iframe.muted + 内部所有 audio/video 元素 muted。
 		 *  （仅 iframe.muted 对部分用 WebAudio/动态创建的壁纸无效，双保险。）
 		 *  ①(NP-3) 我们自己的曲目播放器在放音时**强制静音帧内**（见 npAudioOwns）：壁纸目录里
@@ -4307,6 +4623,14 @@ function mpwThumbFail(el, why) {
 				   的 `__mpwAudioBusRepatch` 台账），这里是同一类问题的插件侧落点。
 				   语义不变：`mute` 的算法、释放路径（只撤自己按过的）与失败留痕都不动。 */
 				if (frame && frame.muted !== mute) frame.muted = mute;
+				/* ①(2026-09-25 任务 ㉑) **图级静音通道**（跨源唯一可达的那条）：场景渲染器帧必须走它 ——
+				   它的音轨挂在 WebAudio 图上，元素 `muted` 只覆盖元素路径，而 8902 与 3080 不同源，
+				   上面那三条老通道一条都到不了。这里**每次 applyWebMute 都尝试下发**（含帧 load、
+				   800ms/2s 周期、以及刷新后的第一次），幂等由 `sendRendererAudioPolicy` 自己保证。 */
+				try { sendRendererAudioPolicy(frame, mute); } catch {}
+				/* ①(2026-09-25 任务 ㉑ 追加) 帧内音频归属/暂停状态也要跟着走：`npFrameSoundBlocked()` 为真
+				   （卡片暂停/我们真的在放音）时，把这一页**收起来**（停源），否则只是压增益。 */
+				try { if (npFrameSoundBlocked()) sendRendererAudioPolicy(frame, true, true, "np-owns"); } catch {}
 				// ①(2026-09-16 I 项) shim 通道：帧内静音由 shim 执行（不透明源读不到帧内元素）
 				if (frame && mpwWebShimUrl(frame.getAttribute("src"))) {
 					const want = { muted: mute, speed: npPolicySpeed(), volume: npWantVolume() };
@@ -5528,7 +5852,7 @@ function mpwThumbFail(el, why) {
 		//   链路：插件宿主 /raw 暴露容器字节（PKGM0018 场景束 / PKGV scene.pkg）
 		//        → 渲染器页面 ?pkgurl=<该 url>（浏览器直连带 cookie，过 DSH 鉴权）
 		//        → 渲染器 parsePkg 直接吃同族容器（RE-25 证实布局相同）→ 实时渲染。
-		//   sceneRendererUrl 可在设置里覆盖（默认本机 8899）。
+		//   sceneRendererUrl 可在设置里覆盖（默认本机 8902 的 `/webloader/`；旧默认是 8899，见 ISSUE0924A 第 20 点）。
 		// ① 渲染器可达性探测（结果缓存；未知时按可用处理，避免首次使用被误拦）
 		const probeSceneRenderer = () => {
 			try {
@@ -5558,7 +5882,12 @@ function mpwThumbFail(el, why) {
 
 		const mpwSceneRendererBase = () => {
 			try { const s = readSection(); if (s && s.sceneRendererUrl) return String(s.sceneRendererUrl) } catch {}
-			return "http://127.0.0.1:8899/";
+			/*  ①(2026-09-25 ISSUE0924A 第 20 点) 默认渲染器地址从 `http://127.0.0.1:8899/` 换成
+			   `http://127.0.0.1:8902/webloader/`：8902 是**一站式**测试台，它自己就直供渲染器面
+			   （`/webloader/`、`/bundle.js`、`/core/**`、`/pkg`、`/project`、`/diag-flags.json`，带 `X-Bench-Served: local`），
+			   实测把 8899 进程**停掉**这些路由仍全部 200 ⇒ 不必再为了壁纸渲染单独启一个 8899。
+			   尾斜杠**必须留**：下面的 `fetch(base + "diag-flags.json")` 是按字符串拼的。 */
+			return "http://127.0.0.1:8902/webloader/";
 		};
 		const applySceneViaRenderer = (meta) => {
 			// meta: { rawFile, folder, title, key }
@@ -6429,7 +6758,15 @@ function mpwThumbFail(el, why) {
 						});
 					} catch (e) {}
 				} else {
-					try { const f = bgElements().frame; if (f) f.style.display = "none"; } catch {}
+					try {
+						const f = bgElements().frame
+						if (f) {
+							/* ①(2026-09-25 任务 ㉑ 追加) **总开关关掉 = 只隐藏不卸载** ⇒ 帧内音频必须停掉
+							   （旧写法只 `display:none`，隐藏 iframe 里的媒体照放）。 */
+							try { sendRendererAudioPolicy(f, true, true, "wallpaper-disabled") } catch (e) {}
+							f.style.display = "none"
+						}
+					} catch {}
 				}
 				// ①(修正) 刷新 buildCss（hasImage 已含 webUrl）→ .mpw-bgWrap.mpw-web iframe 可见
 				try { const se = getStyleEl(); if (se) se.textContent = buildCss(section); } catch (err) { mpwErr("buildCss(web 路径)", err); }
@@ -7110,7 +7447,7 @@ function mpwThumbFail(el, why) {
 					try {
 						const d = ev && ev.data;
 						if (!d || d.type !== "mpw-ln-mode") return;
-						// 只接受渲染器来源（:8899 或 strict 下的不透明源 "null"）——contentWindow 精确匹配优先，
+						// 只接受渲染器来源（**配置的那个 renderer base** 或 strict 下的不透明源 "null"）——contentWindow 精确匹配优先，
 						// 避免任意页面控制按键；①(B6) 改走统一校验（旧规则会拒掉 Origin:"null"）。
 						if (!mpwIsSceneFrameMsg(ev)) return;
 						lnMode = !!d.on;
@@ -8267,6 +8604,19 @@ function mpwThumbFail(el, why) {
 			/* ①(NP-3) 我们的播放器在放音时，web 壁纸帧内的那份声音要让位（同一首会被放两遍）。 */
 			try { return !!(npAudio && !npAudio.paused && (npAudio.currentSrc || npAudio.getAttribute("src") || npAudio.src)) } catch (e) { return false }
 		}
+		/** ①(2026-09-25 任务 ㉑) **"我们真的在出声"**（比 `npAudioOwns()` 严一档）：元素在放 **且**
+		 *  没被静音 **且** 音量 > 0。为什么单独有它：`npFrameSoundBlocked()` 只该在"帧内那份声音会与
+		 *  **可听见的**我们叠在一起"时压帧内 —— 旧口径用 `npAudioOwns()`（只看 `paused`），
+		 *  于是"元素在放但被 muted/volume=0"也算占用 ⇒ 帧内被白白压住（用户报的"壁纸自己没声音"）。
+		 *  反过来，用户报"静音开着仍有声音"那一条**不靠它**：设置项 `mute` 是独立的一项，
+		 *  下面 `npFrameSoundBlocked()` 里仍旧算数。 */
+		function npOwnAudible() {
+			try {
+				if (!npAudioOwns()) return false
+				if (npAudio.muted) return false
+				return Number(npAudio.volume) > 0
+			} catch (e) { return false }
+		}
 		/* ══════════════════════════════════════════════════════════════════════════════════
 		   ④(2026-09-20 真机修复)「卡片的静音/暂停必须**真的管住壁纸自带的音频**」
 		   ──────────────────────────────────────────────────────────────────────────────────
@@ -8313,8 +8663,11 @@ function mpwThumbFail(el, why) {
 				const s = readSection();
 				const on = s.npNowPlaying !== void 0 ? !!s.npNowPlaying : DEFAULT_NP_NOW_PLAYING;
 				if (!on) return false;
+				/* ①(2026-09-25 任务 ㉑) 口径对齐"**真的在放音**"：元素在放但被 muted/音量 0 ⇒ 不占用，
+				   帧内那份声音放行（旧口径只看 `paused` ⇒ 白白压住壁纸自带的 BGM）。
+				   ⚠ 这两行必须**紧邻**（`wallpaper-lifecycle-test` 的变异锚点钉的就是它们连在一起的字面量）。 */
 				if (npCardPaused) return true;
-				return npAudioOwns();
+				return npOwnAudible();
 			} catch (e) { return false }
 		}
 		/** ④ 把"帧内音频现在归谁管"如实发布到 DOM/全局（探针与设置面板都读它，不猜）。 */
@@ -9194,7 +9547,20 @@ function mpwThumbFail(el, why) {
 				//   （旧写法恢复时会 play() **作者自己**停着的媒体 —— 省电档默认打开后这会变成常态问题）。
 				//   ①(2026-09-23) 再加一条前置：**这一下真的送达了**（shim 投出成功，或我们确实 pause 到了
 				//   至少一个元素）才记账；失败路径不许把"没停成"记成"我们停的"。
+				/* ①(2026-09-25 任务 ㉑ 追加) 跨源帧（场景渲染器 / 不透明源 web 帧）：shim 到不了、
+				   `contentDocument` 为 null ⇒ 上面两条都等于没停。这时走 postMessage `park`（渲染器侧
+				   真的 pause + suspend），并把"我们停过"如实记账（否则恢复时会去 play 作者自己停着的媒体）。 */
+				/* `shimOk` 只等于"postMessage 投出没抛错" —— 对**不是** shim 的帧（场景渲染器）它同样返回 true，
+				   那条 `{mpw:"mpw:web", op:"pause"}` 发过去根本没人收 ⇒ 必须按"**这个帧是不是 shim 帧**"分流：
+				     · shim 帧（`?mpwshim=1`）：帧内 shim 自己按下暂停（既有语义，不动）；
+				     · 非 shim 帧 / 跨源帧：走 `park`（渲染器侧真停源）。 */
+				const isShimFrame = !!(frame && mpwWebShimUrl(frame.getAttribute("src")));
+				let parked = false;
+				if ((!isShimFrame || !shimOk) && n === 0) { try { parked = sendRendererAudioPolicy(frame, true, true, "pause-frame") } catch (e) { parked = false } }
 				webFramePausedByUs = !!(shimOk || n > 0);
+				/* ①(2026-09-25 任务 ㉑ 追加) `park` 也是"我们按下的暂停"（跨源帧那条）⇒ 记账，
+				   恢复时才允许撤销（这一行**单独**写：`silent-failure-guards-test` 的变异锚点钉的是上面那行的字面量）。 */
+				if (parked) webFramePausedByUs = true;
 				return n;
 			} catch { return 0 }
 		}
@@ -9205,6 +9571,8 @@ function mpwThumbFail(el, why) {
 				if (!frame) return;
 				if (!webFramePausedByUs) return;          // ⑤ 我们没停过 ⇒ 一个字节都不碰
 				webFramePausedByUs = false;
+				/* ①(2026-09-25 任务 ㉑ 追加) 撤销我们自己按下的"收起来"（跨源帧那条）。 */
+				try { sendRendererAudioPolicy(frame, !!readSection().mute || npFrameSoundBlocked(), false, "resume-frame") } catch (e) {}
 				webShimCallChecked(frame, { op: "pause", value: false }, "resumeWebFrame");
 				const doc = frame.contentDocument;
 				if (doc) {
@@ -11453,6 +11821,17 @@ function installAudioBus(win, opts = {}) {
 				pauseWebFrame: () => { try { return pauseWebFrame() } catch (e) { return String(e && e.message || e) } },
 				resumeWebFrame: () => { try { resumeWebFrame(); return true } catch (e) { return String(e && e.message || e) } },
 				pauseWallpaperVideo: () => { try { pauseWallpaperVideo(); return true } catch (e) { return String(e && e.message || e) } },
+				/* ①(2026-09-25 任务 ㉑ 追加) 场景看门狗兜底：真机"壁纸显示静态帧、声音却在响（且不是当前
+				   壁纸的音频)"那条路径。跑的是**真实** `sceneFallbackActivate`；钩子只负责播种最小
+				   watchdog 状态（`__mpwSceneWd`），否则它自己会因 `!wd` 提前返回（判据就变成空转）。 */
+				sceneFallback: (why) => {
+					try {
+						if (!__mpwSceneWd) __mpwSceneWd = { ident: "test-hook", info: null, url: "", armedAt: Date.now(), secs: 0, confirmed: false, fallback: false, lastPostAt: 0, checkTimer: 0, fallbackAt: 0 };
+						sceneFallbackActivate(String(why || "test"));
+						return { fallback: !!(__mpwSceneWd && __mpwSceneWd.fallback), park: window.__mpwSceneFallbackPark || null };
+					} catch (e) { return String(e && e.message || e) }
+				},
+				sceneWd: () => { try { return __mpwSceneWd ? { ident: __mpwSceneWd.ident, fallback: !!__mpwSceneWd.fallback, confirmed: !!__mpwSceneWd.confirmed } : null } catch (e) { return null } },
 				applyFrostInline: (sec) => { try { applyFrostInline(sec || readSection()); return true } catch (e) { return String(e && e.message || e) } },
 				startFrostObserver: () => { try { startFrostObserver(); return true } catch (e) { return String(e && e.message || e) } },
 				startCompatObserver: () => { try { startCompatObserver(); return true } catch (e) { return String(e && e.message || e) } },
@@ -17166,7 +17545,13 @@ body[data-mpw-modal] [role="dialog"] {
 				}
 			};
 			const [url, setUrl] = react.useState("");
-			const [propsExpanded, setPropsExpanded] = react.useState(false);
+			// ①(2026-09-24 用户 bug 修复) **默认展开**：旧默认 false ⇒ 面板只剩一个「展开全部（N）」
+			//   按钮，用户视角就是"只显示了一项、展不开"。现在默认把官方属性**逐项摊开**。
+			const [propsExpanded, setPropsExpanded] = react.useState(true);
+			// ①(新) 分组折叠（按 group key 记；默认全展开）+ 文本框草稿（失焦/回车才落盘，避免逐字符重挂壁纸）
+			const [propGroupsClosed, setPropGroupsClosed] = react.useState({});
+			const [propDraft, setPropDraft] = react.useState({});
+			const propTimer = react.useRef(null);
 			const [conflictModal, setConflictModal] = react.useState(false);
 			const [previewModal, setPreviewModal] = react.useState(false);
 			const [errorModal, setErrorModal] = react.useState(false);
@@ -18850,12 +19235,14 @@ body[data-mpw-modal] [role="dialog"] {
 
 
 			const propEdits = (section.propEdits && section.propEdits[section.mpkgKey]) || {};
-			const setProp = (key, value) => {
+			/** ①(2026-09-24 用户 bug 修复) 可调参数**写入通道**（原 `setProp` 是死代码，全仓 0 处调用）。
+			 *  `instant=false` 走 writeSection 的防抖路径（滑杆拖动/文本输入不每步重挂壁纸）。 */
+			const setProp = (key, value, instant) => {
 				const key2 = section.mpkgKey;
 				if (!key2 || !safePropKey(key)) return;
 				const edits = Object.assign({}, propEdits, { [key]: value });
 				const propEditsAll = Object.assign({}, section.propEdits || {}, { [key2]: edits });
-				commit({ propEdits: propEditsAll }, true);
+				commit({ propEdits: propEditsAll }, instant !== false);
 				// ①(2026-09-16 I 项) 网页壁纸 shim 通道：编辑立刻下发到已挂载的帧（沙箱下父页读不到帧内 DOM，
 				//   只能靠 postMessage；作者侧 applyUserProperties 会收到增量）。
 				try {
@@ -18868,10 +19255,12 @@ body[data-mpw-modal] [role="dialog"] {
 			const tvProp = allProps.find((p) => /随现实时间|timevarying|real time/.test(p.label + " " + p.key));
 			const tvEnabled = tvProp ? (propEdits[tvProp.key] !== void 0 ? !!propEdits[tvProp.key] : !!tvProp.value) : true;
 			const TIME_KEYS = new Set(["morningtime", "daytime", "dusktime", "nighttime", "display"]);
-			// ④(重做) 参数渲染暂不可用（浏览器显示的是预渲染素材，改了不生效）：
-			// 默认全部折叠，只显示「展开全部」按钮；点击展开后只读展示全部参数。
-			const propsShown = tvEnabled ? allProps : allProps.filter((p) => !TIME_KEYS.has(p.key));
-			const propsToShow = propsExpanded ? propsShown : [];
+			/* ①(2026-09-24 用户 bug「WE 自带选项只显示一项且展不开」修复) —— 面板行模型：
+			   由 `mpwPropsModel` 按官方口径产出（分组头 + 子项 + condition 显隐 + 控件类型 + 记账），
+			   面板**默认展开**（原来默认折叠 ⇒ 用户只看到一个「展开全部」按钮）。 */
+			const propModel = mpwPropsModel(allProps, propEdits);
+			const propRows = propModel.rows.filter((r) => r.visible && (tvEnabled || !TIME_KEYS.has(r.key)));
+			const propsShownCount = propRows.filter((r) => r.kind !== "group").length;
 			// ②(修正) web 壁纸选项项数（折叠按钮显示用）：分辨率+语言+音量+开关
 			const webCfgCount = (() => {
 				if (!webCfg || !webCfg.model) return 0;
@@ -19794,37 +20183,160 @@ body[data-mpw-modal] [role="dialog"] {
 					]),
 
 
-				// 可调参数展示（④(重做)：默认折叠成「展开全部」按钮。
-				// ②(修正) mpkg → 只读 + "暂不可用"（浏览器显示的是预渲染素材，改不了）；
-				// web 壁纸（L2D 类 loadJson SettingModel）→ 同一折叠区，**可改**（分辨率/
-				// 语言/音量写入 iframe 同源 localStorage）。两者共用 propsExpanded 折叠。
+				// 可调参数展示（①(2026-09-24 用户 bug「WE 自带选项只显示一项且展不开」修复）：
+				//   · **默认展开**（旧默认折叠 ⇒ 面板只剩「展开全部」一个按钮 = 用户说的"只显示一项"）；
+				//   · 每个官方属性渲染**真控件**（bool 开关 / slider 量程滑杆 / combo 下拉 / color 取色 /
+				//     textinput 文本框），onChange 走 `setProp` **真的写进 propEdits 并下发**（此前是死代码）；
+				//   · `type:"group"` = 分组头（可折叠，默认展开），子项按官方 order 跟随；
+				//   · `condition` 为假的项**不显示**（含传递闭包），白名单外的表达式按"未知"照显示并记账；
+				//   · file/directory/scenetexture 需要渲染器资源通道 ⇒ **只读如实展示 + 写明原因**（不猜）；
+				//   · schemecolor/usershortcut 等不渲染的条目**逐条记账**（下方一行提示，不静默）。
+				// ②(修正) mpkg → 控件可调但画面是否即时变化取决于壁纸类型（预渲染素材=下次生效）；
+				// web 壁纸（L2D 类 loadJson SettingModel）→ 同一折叠区，分辨率/语言/音量写入 iframe 同源 localStorage。
 				((mpkgMeta && mpkgMeta.info && section.fromMpkg && allProps.length) || webCfg) ? h("div", { className: "mpw_field" }, [
 					h("label", { className: "mpw_label" },
-						`${t("props.title")}${webCfg ? "" : `（${t("props.unavailable")}）`}`),
+						`${t("props.title")}${webCfg ? "" : `（${propsShownCount}）`}`),
 					h("p", { className: "mpw_hint" }, webCfg ? t("webcfg.desc") : t("props.desc")),
 					propsExpanded ? h("div", { className: "mpw_props" }, [
-						// ── mpkg 只读参数列表 ──
-						mpkgMeta && mpkgMeta.info && section.fromMpkg && allProps.length ? propsToShow.map((p) => {
-							// 纯展示性条目（作者信息/说明）：不渲染输入框
-							if (p.displayOnly) {
-								return h("div", { className: "mpw_prop mpw_static", key: p.key },
-									h("span", { className: "mpw_propLabel" }, p.label));
+						// ── 官方 user properties（分组 + 控件；写入 propEdits）──
+						mpkgMeta && mpkgMeta.info && section.fromMpkg && allProps.length ? propRows.map((row) => {
+							// 分组头：可折叠（默认展开），带子项数
+							if (row.kind === "group") {
+								const closed = !!propGroupsClosed[row.key];
+								return h("div", { className: "mpw_prop mpw_propGroup", key: "g:" + row.key }, [
+									h("button", {
+										className: "mpw_reset mpw_moreBtn", type: "button", "data-mpw-propgroup": row.key,
+										"aria-expanded": closed ? "false" : "true",
+										onClick: () => setPropGroupsClosed(Object.assign({}, propGroupsClosed, { [row.key]: !closed }))
+									}, (closed ? "▸ " : "▾ ") + (row.label || row.key) + `（${row.childCount}）`)
+								]);
 							}
-							const edited = propEdits[p.key] !== void 0 ? propEdits[p.key] : p.value;
-							const isBool = typeof p.value === "boolean";
+							// 被折叠的分组 ⇒ 其子项不渲染
+							if (row.group && propGroupsClosed[row.group]) return null;
+							// 官方口径不渲染的条目（schemecolor / usershortcut / 未知类型）：
+							// **不渲染控件**（只在上面的"未渲染条目"一行里如实登记）
+							if (row.kind === "skip") return null;
+							const indent = row.group ? { marginLeft: 12 } : null;
+							const shown = row.value;
 							const fmt = (v) => {
 								if (typeof v === "boolean") return v ? t("props.on") : t("props.off");
-								if (Array.isArray(p.options) && p.options.length) {
-									const o = p.options.find((x) => String(x.value) === String(v));
+								if (Array.isArray(row.options) && row.options.length) {
+									const o = row.options.find((x) => String(x.value) === String(v));
 									return o ? cleanLabel(o.label) : String(v);
 								}
-								return String(v);
+								return String(v === void 0 || v === null ? "" : v);
 							};
-							return h("div", { className: "mpw_prop", key: p.key }, [
-								h("div", { className: "mpw_propLabel" }, h("b", null, p.label)),
-								h("span", { className: "mpw_propValue" }, fmt(edited))
+							// 说明行（type text/txt 或无 type 的作者文案）：不渲染输入控件
+							if (row.kind === "note") {
+								return h("div", { className: "mpw_prop mpw_static", key: row.key, style: indent },
+									h("span", { className: "mpw_propLabel" }, row.label || row.key));
+							}
+							const labelEl = h("div", { className: "mpw_propLabel" }, [
+								h("b", null, row.label || row.key),
+								row.edited ? h("span", { className: "mpw_hint" }, " · " + t("props.edited")) : null
+							]);
+							// file/directory/scenetexture：官方语义需要渲染器资源通道 ⇒ 只读 + 写明原因
+							if (row.kind === "readonly") {
+								return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+									labelEl,
+									h("span", { className: "mpw_propValue" }, fmt(shown)),
+									h("span", { className: "mpw_hint" }, row.kindWhy)
+								]);
+							}
+							// ── 真控件 ──
+							if (row.kind === "control" && row.type === "bool") {
+								return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+									h("div", { className: "mpw_inline" }, [
+										h(Toggle, { checked: !!shown, onChange: (v) => setProp(row.key, !!v) }),
+										h("span", { className: "mpw_propLabel" }, row.label || row.key),
+										row.edited ? h("span", { className: "mpw_hint" }, " · " + t("props.edited")) : null
+									])
+								]);
+							}
+							if (row.kind === "control" && row.type === "slider") {
+								const min = typeof row.min === "number" ? row.min : 0;
+								const max = typeof row.max === "number" ? row.max : 1;
+								const step = typeof row.step === "number" && row.step > 0 ? row.step : ((max - min) / 100 || 0.01);
+								const base = Number(shown);
+								// ① 与插件既有滑杆同一口径：拖动时**即时显示**，落盘/重挂防抖 350ms
+								//   （逐个 input 事件都 commit → applyFromStorage 会把壁纸层反复重挂）
+								const live = propDraft[row.key] !== void 0 ? Number(propDraft[row.key]) : (isFinite(base) ? base : min);
+								const flush = (v) => {
+									if (propTimer.current) { clearTimeout(propTimer.current); propTimer.current = null }
+									setProp(row.key, v, false);
+								};
+								return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+									labelEl,
+									h("div", { className: "mpw_inline" }, [
+										h("input", {
+											className: "mpw_slider", type: "range", min, max, step,
+											"data-mpw-prop": row.key,
+											value: live,
+											onChange: (ev) => {
+												const v = Number(ev.target.value);
+												setPropDraft(Object.assign({}, propDraft, { [row.key]: v }));
+												if (propTimer.current) clearTimeout(propTimer.current);
+												propTimer.current = setTimeout(() => { propTimer.current = null; flush(v) }, 350);
+											},
+											onMouseUp: (ev) => flush(Number(ev.target.value)),
+											onTouchEnd: (ev) => flush(live),
+											onBlur: (ev) => flush(Number(ev.target.value))
+										}),
+										h("span", { className: "mpw_value" }, fmt(live))
+									])
+								]);
+							}
+							if (row.kind === "control" && row.type === "combo") {
+								const opts = (row.options || []).map((o) => ({ value: String(o.value), label: cleanLabel(o.label) }));
+								return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+									labelEl,
+									h(SelectBox, {
+										name: "prop:" + row.key, value: String(shown === void 0 ? "" : shown),
+										placeholder: fmt(shown), options: opts,
+										onChange: (v) => setProp(row.key, v)
+									})
+								]);
+							}
+							if (row.kind === "control" && row.type === "color") {
+								const hex = mpwPropColorToHex(shown);
+								return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+									labelEl,
+									h("div", { className: "mpw_inline" }, [
+										h("input", {
+											className: "mpw_colorSwatch", type: "color", "data-mpw-prop": row.key,
+											value: hex || "#000000",
+											onChange: (ev) => setProp(row.key, mpwPropHexToColor(ev.target.value))
+										}),
+										h("span", { className: "mpw_hint" }, (hex || "") + "  (" + fmt(shown) + ")")
+									])
+								]);
+							}
+							// textinput / 其余可编辑文本
+							const draftKey = row.key;
+							return h("div", { className: "mpw_prop", key: row.key, style: indent }, [
+								labelEl,
+								h("input", {
+									className: "mpw_input", type: "text", "data-mpw-prop": row.key,
+									value: propDraft[draftKey] !== void 0 ? propDraft[draftKey] : fmt(shown),
+									onChange: (ev) => setPropDraft(Object.assign({}, propDraft, { [draftKey]: ev.target.value })),
+									onBlur: () => {
+										const v = propDraft[draftKey];
+										if (v === void 0) return;
+										setProp(draftKey, v);
+										const next = Object.assign({}, propDraft); delete next[draftKey]; setPropDraft(next);
+									},
+									onKeyDown: (ev) => { if (ev.key === "Enter") { try { ev.currentTarget.blur() } catch (e) {} } }
+								})
 							]);
 						}) : null,
+						// 记账：未渲染的官方条目（schemecolor / usershortcut / 未知类型）如实列出，不静默
+						mpkgMeta && mpkgMeta.info && section.fromMpkg && propModel.counts.skipped
+							? h("p", { className: "mpw_hint" },
+								t("props.skipped") + propModel.rows.filter((r) => r.kind === "skip").map((r) => r.key + "：" + r.kindWhy).join("；"))
+							: null,
+						mpkgMeta && mpkgMeta.info && section.fromMpkg && propModel.counts.hidden
+							? h("p", { className: "mpw_hint" }, t("props.hiddenByCond") + propModel.counts.hidden)
+							: null,
 						!tvEnabled ? h("p", { className: "mpw_hint" }, t("props.tvOff")) : null,
 						// ── web 壁纸可改选项（分辨率/语言/音量，写入 iframe localStorage）──
 						webCfg ? h("div", { className: "mpw_props" }, [
@@ -19871,13 +20383,15 @@ body[data-mpw-modal] [role="dialog"] {
 								const next = Object.assign({}, s, { propEdits: pe });
 								writeSection(next, true);
 								setSection(next);
+								// ① 恢复默认时把滑杆/文本框的本地草稿一并清掉（否则控件仍显示已改的值）
+								setPropDraft({});
 								setHint(t("props.resetDone"));
 							} }, t("props.resetWallpaper"))
 						])
 					]) : null,
 					h("div", { className: "mpw_inline" }, [
 						h("button", { className: "mpw_reset mpw_moreBtn", type: "button", onClick: () => setPropsExpanded(!propsExpanded) },
-							propsExpanded ? t("props.collapse") : t("props.expand") + `（${webCfg ? webCfgCount : propsShown.length}）`)
+							propsExpanded ? t("props.collapse") : t("props.expand") + `（${webCfg ? webCfgCount : propsShownCount}）`)
 					])
 				]) : null,
 				// ①(新) 省电（从「其他」tab 挪到壁纸设置最下面）：遮挡暂停三档（tab 内结尾）
@@ -20722,7 +21236,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"scnRender.extUrl": "渲染器扩展钩子地址（sceneExtUrl，可选）",
 			"scnRender.report": "场景渲染上报（排障）",
 			"scnRender.report.desc": "开启后壁纸每 10 秒把渲染器现场（截图 + 逐层绘制台账 + 纹理统计）写到渲染器的 reports/ 目录，用于定位“坐标/可见性”问题。仅排障时开，默认关（有磁盘写入）",
-			"scnRender.extUrl.ph": "http://127.0.0.1:8899/ext",
+			"scnRender.extUrl.ph": "http://127.0.0.1:8902/webloader/",
 			"scnRender.extUrl.hint": "留空=不启用。填写后按 extbase 拼进场景渲染 iframe（见渲染器仓文档 EXTENSION-HOOKS.md）；点「测试」验证索引可达并显示钩子数量。",
 			"scnRender.extUrl.save": "保存",
 			"scnRender.extUrl.saved": "扩展钩子地址已保存，下次应用场景壁纸生效",
@@ -20754,7 +21268,7 @@ body[data-mpw-modal] [role="dialog"] {
 				"scnRender.bigPkg": "该场景包体积较大，首帧可能较慢",
 			// ①(MERGED-3 1.3/2.3) 诊断开关速查区（集合 == diag-flags.json common，panel-smoke 断言）
 			"diag.sec": "诊断开关速查（渲染器）",
-			"diag.sec.desc": "拼到渲染器地址后面用，如 http://127.0.0.1:8899/?id=3719111841&audit=3；常用开关如下，点「复制」拿 URL 片段。",
+			"diag.sec.desc": "拼到渲染器地址后面用，如 http://127.0.0.1:8902/webloader/?id=3719111841&audit=3；常用开关如下，点「复制」拿 URL 片段。",
 			"diag.expand": "展开开关",
 			"diag.fold": "收起开关",
 			"diag.copy": "复制",
@@ -20919,11 +21433,14 @@ body[data-mpw-modal] [role="dialog"] {
 			"webcfg.saveFail": "保存失败：",
 			"webcfg.readFail": "读取壁纸自身设置失败（为避免覆盖你已改过的选项，本次**不写回**）：",
 			"webcfg.fail": "应用失败：",
-			"props.desc": "浏览器显示的是壁纸引擎预渲染的素材，修改参数不会改变画面。以下为壁纸自带的参数及当前值，供对照：如需修改，请在壁纸引擎 App 中调整",
+			"props.desc": "以下为壁纸**自带**的官方参数（project.json → general.properties），逐项可调：改动会保存到本插件设置，并即时下发给已加载的网页壁纸；静态帧/视频类素材的画面要等下次应用（或由场景渲染器应用）才反映改动",
 			"props.unavailable": "暂不可用",
 			"props.on": "开",
 			"props.off": "关",
 			"props.expand": "展开全部",
+			"props.edited": "已改",
+			"props.skipped": "未渲染的条目（如实登记，不做猜测）：",
+			"props.hiddenByCond": "按壁纸自带 condition 隐藏的条目数：",
 			"props.important": "★ 关键开关",
 			"props.resetWallpaper": "重置壁纸参数",
 			"props.resetDone": "壁纸参数已恢复默认",
@@ -21392,11 +21909,14 @@ body[data-mpw-modal] [role="dialog"] {
 			"webcfg.saveFail": "Save failed: ",
 			"webcfg.readFail": "Could not read the wallpaper's own settings (nothing was written back, so your existing options are not overwritten): ",
 			"webcfg.fail": "Apply failed: ",
-			"props.desc": "The browser shows pre-rendered wallpaper assets, so editing these options cannot change the picture. Listed below are the wallpaper's own parameters and their current values for reference; change them in the Wallpaper Engine app instead",
+			"props.desc": "These are the wallpaper's own official options (project.json → general.properties), adjustable per item: changes are saved to this plugin's settings and pushed live to a loaded web wallpaper; for still-frame/video assets the picture reflects them after the next apply (or when a scene renderer applies them)",
 			"props.unavailable": "unavailable",
 			"props.on": "On",
 			"props.off": "Off",
 			"props.expand": "Show all",
+			"props.edited": "edited",
+			"props.skipped": "Not rendered (recorded as-is, never guessed): ",
+			"props.hiddenByCond": "Items hidden by the wallpaper's own condition: ",
 			"props.important": "★ Key switch",
 			"props.resetWallpaper": "Reset wallpaper options",
 			"props.resetDone": "Wallpaper options restored to defaults",
@@ -21531,7 +22051,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"scnRender.extUrl": "Renderer extension hooks URL (sceneExtUrl, optional)",
 			"scnRender.report": "Scene render reporting (debug)",
 			"scnRender.report.desc": "When on, the wallpaper sends the renderer's live state (screenshot + per-layer draw ledger + texture stats) to the renderer's reports/ folder every 10s, to diagnose position/visibility bugs. Debug only; off by default (writes to disk)",
-			"scnRender.extUrl.ph": "http://127.0.0.1:8899/ext",
+			"scnRender.extUrl.ph": "http://127.0.0.1:8902/webloader/",
 			"scnRender.extUrl.hint": "Empty = disabled. When set, it is passed to the scene iframe as extbase (see the renderer repo docs EXTENSION-HOOKS.md); press Test to verify the index and show the hook count.",
 			"scnRender.extUrl.save": "Save",
 			"scnRender.extUrl.saved": "Extension hooks URL saved; takes effect the next time a scene wallpaper is applied",
@@ -21563,7 +22083,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"scnRender.bigPkg": "This scene package is large; the first frame may be slow",
 			// ①(MERGED-3 1.3/2.3) Diagnostic flags quick reference (set == diag-flags.json common)
 			"diag.sec": "Diagnostic flags (renderer)",
-			"diag.sec.desc": "Append to the renderer URL, e.g. http://127.0.0.1:8899/?id=3719111841&audit=3. Common flags below; press Copy to grab the URL fragment.",
+			"diag.sec.desc": "Append to the renderer URL, e.g. http://127.0.0.1:8902/webloader/?id=3719111841&audit=3. Common flags below; press Copy to grab the URL fragment.",
 			"diag.expand": "Show flags",
 			"diag.fold": "Hide flags",
 			"diag.copy": "Copy",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mpkg-wallpaper",
-  "version": "3.13.6",
+  "version": "3.13.8",
   "description": "DSH Web 壁纸引擎 Wallpaper Engine mpkg 背景插件：浏览器内直接解析 .mpkg（preview.gif 动态背景/内嵌 mp4 视频/多时段切换），整屏统一虚化/对话框/弹层/遮罩独立虚化、镜头缩放平移、时钟、冲突检测。",
   "private": false,
   "type": "module",