dsh-mpkg-wallpaper 3.5.2 → 3.6.0

package/lib/client.js

@@ -98,6 +98,11 @@ window.__ModuleLoader__.load({
 		let persistTimer = null;
 		let hostSettingsOk = false; // ⑤(新) host /settings 是否可用（持久化到宿主端文件）
 		let sectionDirty = false;   // ⑤(修正) 本次启动后用户是否已改过设置（防 host GET 竞态覆盖）
+		// ①(修正) 用户手动暂停/播放壁纸（停住画面）。wallUserPaused 是**唯一**权威事实来源，
+		// 只由 toggleWallPause（source='user'）修改并执行暂停/恢复。
+		// ①(修正) 声明**上移**到模块级顶部（原在下方函数区）：确保任何 video play/pause 事件
+		// 回调（ensureBgDom 阶段挂载）引用它时已初始化，避免 TDZ 报错。
+		let wallUserPaused = false;
 		// ⑤(修正) 宿主端只存"设置"（外观类），不含大体积 image dataURL/临时 info——
 		// 既避免每次滑块拖动 PUT 1MB+，也让恢复时壁纸选择（image 等）回落到 localStorage。
 		// ①(修正) webUrl 只是短 URL（几十字节），不该在 SKIP 里——它不持久化到 host 会导致
@@ -666,7 +671,10 @@ window.__ModuleLoader__.load({
 				const video = document.createElement("video");
 				video.id = BG_VIDEO_ID;
 				video.className = "mpw-bgVideo";
-				video.autoplay = true;
+				// ①(修正) 不用 autoplay 属性——只要 autoplay 在，src 一重载浏览器就自动播放，
+				// 会**绕过** showVideoEl 里基于 (wallUserPaused||powPaused) 的 play() 暂停门控。
+				// 改为靠那个门控的 play() 统一播放：暂停时任何 src 重载都不重播。
+				// video.autoplay = true;
 				video.loop = true;
 				video.muted = true;
 				video.playsInline = true;
@@ -681,6 +689,12 @@ window.__ModuleLoader__.load({
 					console.warn("[dsh-mpkg-wallpaper] 视频背景加载失败（编码可能不被浏览器支持）:", video.src);
 					try { window.__mpwVideoFailed = true; } catch {}
 				});
+				// ①(修正) 暂停按钮**实时**同步：监听 video 实际 play/pause 事件，刷新模块级
+				// wallPausedByUser 标志并派发自定义事件给设置页按钮（否则用户暂停后，任何
+				// 非本按钮路径（如切换壁纸、省电恢复、重载重播）导致的实际播放变化，按钮文案
+				// 不会跟着变 — 用户实测「暂停键不是实时检测」）。
+				video.addEventListener("play", () => { try { setWallPausedByUserState(false); } catch {} });
+				video.addEventListener("pause", () => { try { setWallPausedByUserState(true); } catch {} });
 				wrap.appendChild(img);
 				wrap.appendChild(video);
 				// ①(新) 网页壁纸 iframe（web wallpaper）：独立沙箱层，覆盖整屏。
@@ -875,10 +889,13 @@ window.__ModuleLoader__.load({
 			edgeDraw = { ctx: g, video, wrap };
 			if (edgeResizeObs) { try { edgeResizeObs.disconnect(); } catch {} }
 			try { edgeResizeObs = new ResizeObserver(() => edgeDrawFrame()); edgeResizeObs.observe(canvas); } catch {}
-			try { if (video.src !== url) video.src = url; } catch {}
+			// ①(修正) 同 showVideoEl：用 getAttribute('src') 判等，避免 video.src(绝对)与 url(相对)恒不等
+			// 导致每次 applyFromStorage 都重设 src → Edge 端也重载重播。
+			try { if (video.getAttribute('src') !== url) video.src = url; } catch {}
 			video.playbackRate = (typeof readSection().playbackRate === "number" && readSection().playbackRate >= 0.5 && readSection().playbackRate <= 2) ? readSection().playbackRate : 1;
 			edgeDrawFrame();
-			try { const p = video.play(); if (p && p.catch) p.catch(() => {}); } catch {}
+			// ①(修正) 暂停门控：Edge canvas 渲染路径也尊重暂停，避免其余路径重播
+			try { if (!(wallUserPaused || powPaused)) { const p = video.play(); if (p && p.catch) p.catch(() => {}); } } catch {}
 			// ①(修正) 首帧前先画一帧（避免白屏）——用命名函数 + removeEventListener 防泄漏
 			//（原来 {once:true} 在视频永不加载时会残留监听，评审指出）
 			const drawOnce = () => { try { video.removeEventListener("loadeddata", drawOnce); } catch {} edgeDrawFrame(); };
@@ -945,14 +962,25 @@ window.__ModuleLoader__.load({
 			if (canvas) canvas.style.display = "none";
 			if (lastObjectUrl && lastObjectUrl !== url) { try { URL.revokeObjectURL(lastObjectUrl); } catch {} }
 			lastObjectUrl = url;
-			try { if (video.src !== url) video.src = url; } catch {}
+			// ①(修正) 用 getAttribute('src')（原始相对串）比较，**别用 video.src**——
+			// video.src 读取返回**绝对** URL（http://host/api/...），而 url 是相对路径，
+			// 两者恒不相等 → 每次 applyFromStorage（调静音/亮度等**无关**设置）都重赋值
+			// video.src → 浏览器重载媒体源 → autoplay 自动播放，绕过下方 play() 暂停门控
+			// （用户实测：暂停后调静音壁纸又重播、暂停按钮与实际状态脱节）。
+			// getAttribute('src') 返回原始的相对字符串，同 url 相等 → 不重载，彻底避免。
+			try { if (video.getAttribute('src') !== url) video.src = url; } catch {}
 			// ⑳(新) 视频倍速：原生 playbackRate（0.5-2x，即时生效，不重载）
 			try {
 				const rate = readSection().playbackRate;
 				if (typeof rate === "number" && rate >= 0.5 && rate <= 2 && video.playbackRate !== rate) video.playbackRate = rate;
 			} catch {}
 			video.style.display = "";
-			try { const p = video.play(); if (p && p.catch) p.catch(() => {}); } catch {}
+			// ①(修正) 暂停状态门控：用户手动暂停（wallUserPaused）或省电暂停（powPaused）
+			// 时不 play——否则任何设置开关 apply（commit→applyFromStorage→showVideoEl）都
+			// 无条件 play()，把用户手动暂停解开（用户实测"暂停后开启效果又解开暂停"）。
+			if (!(wallUserPaused || powPaused)) {
+				try { const p = video.play(); if (p && p.catch) p.catch(() => {}); } catch {}
+			}
 		}
 		/** ①(新) 网页壁纸：iframe 全屏显示（隐藏 img/video）。 */
 		function showWebEl(url) {
@@ -984,10 +1012,12 @@ window.__ModuleLoader__.load({
 			wrap.classList.add("mpw-web");
 			img.style.display = "none";
 			video.style.display = "none";
-			try { if (frame.src !== url) frame.src = url; } catch {}
-			// ①(修正) 同 URL 重入（如调 opacity 滑块 → applyFromStorage → showWebEl 同 URL）：
+			try { if (frame.getAttribute('src') !== url) frame.src = url; } catch {}
+			// ①(修正) 同 URL 重入（如调 opacity/静音滑块 → applyFromStorage → showWebEl 同 URL）：
 			// src 未变 → onload 不触发 → observer 不会重挂（评审发现的回归：旧 observer 已
 			// 被上面 disposeWebFrame 断开）。此时手动补挂，面板/媒体保障不丢。
+			// ①(修正) 用 getAttribute('src') 判等（与上行一致）——frame.src 读回绝对 URL，
+			// 与相对 url 恒不等会让每次 applyFromStorage 都重设 src → web 壁纸无关设置也重载。
 			try {
 				if (frame.getAttribute("src") === url) {
 					webMediaObserve(frame);
@@ -1365,7 +1395,11 @@ window.__ModuleLoader__.load({
 					if (useTranscode) console.log("[dsh-mpkg-wallpaper] 转码播放:", playUrl);
 					// ①(修正) 重启竞态兜底：video 也要 404 重试（否则 host 晚就绪 → 视频壁纸永久空白）
 					const vid = bgElements().video;
-					if (vid && !vid.__mpwHostRetryVideo) {
+					// ①(修正) 监听守卫：原 `!vid.__mpwHostRetryVideo` 在 error 发生前恒为 falsy
+					// → 每次 applyFromStorage 都 addEventListener("error") 累积监听器（拖滑块
+					// 100 次 = 100 个闭包空转）。改用独立布尔 __mpwErrWired，只加一次。
+					if (vid && !vid.__mpwErrWired) {
+						vid.__mpwErrWired = true;
 						vid.__mpwHostTries = 0;
 						vid.__mpwAutoTranscoded = false; // ①(新) 编码不支持 → 自动转码降级（只做一次）
 						vid.addEventListener("error", () => {
@@ -1388,7 +1422,9 @@ window.__ModuleLoader__.load({
 									vid.removeAttribute("src");
 									vid.src = tcUrl;
 									vid.load();
-									try { const pp = vid.play(); if (pp && pp.catch) pp.catch(() => {}); } catch {}
+									// ①(修正) 暂停门控：自动转码重试也尊重暂停，否则用户暂停后
+									// 编码报错自动切转码会重播（绕过 showVideoEl 的门控）。
+									try { if (!(wallUserPaused || powPaused)) { const pp = vid.play(); if (pp && pp.catch) pp.catch(() => {}); } } catch {}
 								} catch {}
 								return;
 							}
@@ -1407,7 +1443,8 @@ window.__ModuleLoader__.load({
 								vid.removeAttribute("src");
 								vid.src = cur;
 								vid.load();
-								try { const pp = vid.play(); if (pp && pp.catch) pp.catch(() => {}); } catch {}
+								// ①(修正) 暂停门控：404 重试不重播（同上，尊重暂停状态）
+								try { if (!(wallUserPaused || powPaused)) { const pp = vid.play(); if (pp && pp.catch) pp.catch(() => {}); } } catch {}
 							}, 800 * vid.__mpwHostTries);
 						});
 					}
@@ -1473,6 +1510,9 @@ window.__ModuleLoader__.load({
 			} else if (typeof image === "string" && image.indexOf("idb:") === 0) {
 				idbGet("bg").then((v) => { if (gen !== bgGen) return; if (v && img.src !== v) { img.src = v; showImageEl(); } }).catch(() => {});
 			} else {
+				// ①(修正) 内存：置 null 前 revoke 旧 Blob URL——否则清壁纸/切换到图片时
+				// 上次的 blob（最大 600MB 视频）URL 仍存活在 registry，不可回收，只增不减。
+				if (lastBgSig && lastBgSig.url) { try { URL.revokeObjectURL(lastBgSig.url); } catch {} }
 				lastBgSig = null;
 				// ①(修正) 非 web 壁纸：无条件卸载残留的 web iframe（否则帧泄漏，
 				// 星野/瞬这类 web 壁纸清除后 iframe 仍存活，内存只增不减）。
@@ -1594,6 +1634,9 @@ window.__ModuleLoader__.load({
 			try { updateClock(); } catch {}
 			// ①(新) 液态玻璃叠加层（lgComposer/lgSidebar/lgHeader 任一开启时启动）
 			try { applyLiquidGlass(section); } catch {}
+			// ①(修正) 省电：每次 apply 后同步暂停状态——否则勾选"省电"开关后不立即生效
+			//（原只有事件触发才 updatePowerPause，开关开了要等下次事件才暂停）
+			try { updatePowerPause(); } catch {}
 		}
 
 		// ═══════════════════════════════════════════════════════════════════
@@ -1604,36 +1647,16 @@ window.__ModuleLoader__.load({
 		let lgModule = null;          // { LiquidGlassWebGLV2 }
 		let lgStatus = "";           // 调试状态（显示在 tab 里）
 		function setLgStatus(s) { lgStatus = s; try { notifySectionChanged(); } catch {} }
-		let lgGlass = null;          // 实例
-		let lgCanvas = null;         // 全屏玻璃 canvas
-		let lgResizeObs = null;
-		let lgBgVideoHooked = false;
-		const LG_EL_KEYS = [['lgComposer', '.wSkVaW_scrollBody, [data-slot*="composer"] [class*="card"], [data-composer-card]'], ['lgSidebar', '[class*="sidebarCol"], [data-dsh-better-sidebar] [class*="_panel"], [data-dsh-better-sidebar] [class*="_bottomPanel"]'], ['lgHeader', '.wSkVaW_header, [class*="wSkVaW_header"]']];
-		async function ensureLgModule() {
-			if (lgModule) return lgModule;
-			// ①(修正) 用 host 路由动态加载（不再内联 107KB 源码——内联的模板字符串
-			// 含反引号/${，会触发 DSH client-modules 打包器异常 → 插件 bundle 损坏
-			// → loadSection is not defined + 连带官方插件 bundle 失败，dsh 启动崩溃）。
-			// host 路由（/lg）在 index.js 注册，加载失败仅 console 警告，不影响主功能。
-			try {
-				const mod = await import(HOST_BASE + "/lg/v2.js");
-				lgModule = mod;
-				setLgStatus("✓ 模块加载成功");
-				return mod;
-			} catch (err) { console.warn("[dsh-mpkg-wallpaper] 液态玻璃模块加载失败:", err); setLgStatus("✗ 模块加载失败: " + (err && err.message || err)); return null; }
-		}
+		const LG_EL_KEYS = [['lgComposer', '[data-composer-card], [data-slot*="composer"] [class*="card"], .wSkVaW_scrollBody'], ['lgSidebar', '[class*="sidebarCol"], [data-dsh-better-sidebar] [class*="_panel"], [data-dsh-better-sidebar] [class*="_bottomPanel"]'], ['lgHeader', '.wSkVaW_header, [class*="wSkVaW_header"]']];
+		// ①(重做) 液态玻璃 bundle 用 **base64 内联**（LG_BUNDLE_B64 由 tools/inline-lg-b64.mjs
 		function lgEnabled(section) {
 			return !!(section && ((section.lgComposer !== void 0 ? !!section.lgComposer : false)
 				|| (section.lgSidebar !== void 0 ? !!section.lgSidebar : false)
 				|| (section.lgHeader !== void 0 ? !!section.lgHeader : false)));
 		}
 		function destroyLiquidGlass() {
-			try { if (lgResizeObs) { lgResizeObs.disconnect(); lgResizeObs = null; } } catch {}
-			try { if (lgGlass && typeof lgGlass.stop === "function") lgGlass.stop(); } catch {}
-			lgGlass = null;
-			try { if (lgCanvas) { lgCanvas.remove(); } } catch {}
-			lgCanvas = null;
-			lgBgVideoHooked = false;
+			// ①(修正) CSS 版：只用 lgClearClasses 清除标记即可（WebGL 残留已删）
+			lgClearClasses();
 		}
 		/** 收集当前启用的玻璃目标元素（按开关），返回 { el, shape } 列表。 */
 		function lgTargets(section) {
@@ -1647,84 +1670,143 @@ window.__ModuleLoader__.load({
 			}
 			return out;
 		}
+		// ①(重做) 液态玻璃改为 **CSS 版**（方案1：稳定可靠，不崩）。
+		//  之前用 WebGL 库（setBackdrop + 喂 DSH 元素坐标）bug：setBackdrop 用残留壁纸帧
+		//  透出"已清除的壁纸"、overlay 模式取代目标区域内容（用户 4 张截图确认）。
+		//  CSS 版：给目标元素加 backdrop-filter（磨砂）+ 半透明背景，模拟液态玻璃——
+		//  不覆盖、不透壁纸（backdrop-filter 只模糊元素背后，不画壁纸帧）、不取代内容。
+		const LG_CSS_ON = 'data-mpw-lg-css';
+		function lgClearClasses() {
+			try { document.querySelectorAll('[' + LG_CSS_ON + ']').forEach((el) => { try { el.removeAttribute(LG_CSS_ON); } catch {} }); } catch {}
+		}
 		async function applyLiquidGlass(section) {
 			try {
-				if (!lgEnabled(section)) { destroyLiquidGlass(); return; }
-				const mod = await ensureLgModule();
-				if (!mod || !mod.LiquidGlassWebGLV2) { setLgStatus("✗ 模块加载失败（检查 /lg 路由）"); return; }
-				setLgStatus("✓ 模块加载成功");
+				if (!lgEnabled(section)) { lgClearClasses(); destroyLiquidGlass(); return; }
+				lgClearClasses();
 				const targets = lgTargets(section);
-				if (!targets.length) { setLgStatus("✗ 未匹配到玻璃目标元素（检查开关与 DSH 元素）"); destroyLiquidGlass(); return; }
-				setLgStatus("✓ 匹配 " + targets.length + " 个元素");
-				if (!lgCanvas) {
-					lgCanvas = document.createElement("canvas");
-					lgCanvas.id = "mpw-lg-canvas";
-					lgCanvas.style.cssText = "position:fixed;inset:0;width:100%;height:100%;z-index:9999;pointer-events:none;";
-					(document.body || document.documentElement).appendChild(lgCanvas);
-					lgGlass = new mod.LiquidGlassWebGLV2(lgCanvas, { preserveDrawingBuffer: true, compositeMode: "overlay" });
-					// 背景：优先当前壁纸 video（live），否则静态渐变
-					try {
-						const vid = bgElements().video;
-						if (vid && vid.readyState >= 2 && vid.videoWidth > 0) {
-							lgGlass.setBackdrop(vid, { update: "live", autoStart: true });
-							lgBgVideoHooked = true;
-						} else {
-							lgGlass.setBackdrop(makeLgFallback(), { update: "static" });
-						}
-					} catch { try { lgGlass.setBackdrop(makeLgFallback(), { update: "static" }); } catch {} }
+				if (!targets.length) { setLgStatus("✗ 未匹配到玻璃目标元素"); destroyLiquidGlass(); return; }
+				setLgStatus("✓ CSS 玻璃作用于 " + targets.length + " 个元素");
+				// 给每个目标元素标记，buildCss 的 lg 规则会让它变玻璃（backdrop-filter 磨砂）
+				targets.forEach((t) => { try { t.el.setAttribute(LG_CSS_ON, ""); } catch {} });
+			} catch (err) { console.warn("[dsh-mpkg-wallpaper] 液态玻璃 CSS 应用失败:", err); setLgStatus("✗ " + (err && err.message || err)); }
+		}
+		/** 静态渐变兜底背景（视频不可用时）。 */
+
+		// ═══════════════════════════════════════════════════════════════════
+		//  🔋(新) 省电（遮挡暂停三档，借鉴 elysia395）：页面最小化/切页、窗口失焦、
+		//  电池供电时自动暂停壁纸视频（解码归零），回到界面/接通电源自动继续。
+		//  三档独立开关（powPauseHidden/powPauseBlur/powPauseBattery），持久保存。
+		// ═══════════════════════════════════════════════════════════════════
+		let powBattery = null;          // BatteryManager（getBattery 探测）
+		let powBatteryAsked = false;
+		let powPaused = false;          // 当前是否被省电暂停
+		let powHiddenNow = false;       // 页面当前隐藏
+		let powFocusedNow = true;       // 窗口当前聚焦
+		/** 当前壁纸视频暂停（停住画面）。 */
+		/** web 壁纸 iframe 内所有 video/audio 暂停（省电/暂停按钮对 web 生效）。 */
+		function pauseWebFrame() {
+			try {
+				const { frame } = bgElements();
+				if (!frame) return;
+				const doc = frame.contentDocument;
+				if (doc) {
+					const els = doc.querySelectorAll("video,audio");
+					for (let i = 0; i < els.length; i++) { try { els[i].pause(); } catch {} }
 				}
-				// 元素几何对齐
-				const els = targets.map((t, i) => {
-					const r = t.el.getBoundingClientRect();
-					return { id: "lg" + i, shape: "rect", x: r.left, y: r.top, width: r.width, height: r.height };
-				});
-				try { lgGlass.setElements(els); } catch {}
-				if (!lgResizeObs) {
-					try {
-						lgResizeObs = new ResizeObserver(() => {
-							try {
-								if (!lgGlass) return;
-								// 元素可能移动/缩放：重算几何后重渲染
-								const els2 = targets.map((t, i) => {
-									const r = t.el.getBoundingClientRect();
-									return { id: "lg" + i, shape: "rect", x: r.left, y: r.top, width: r.width, height: r.height };
-								});
-								lgGlass.setElements(els2);
-								lgGlass.render();
-							} catch {}
-						});
-						targets.forEach((t) => { try { lgResizeObs.observe(t.el); } catch {} });
-					} catch {}
-				} else {
-					// 已有 observer：确保覆盖新目标
-					try { targets.forEach((t) => { try { lgResizeObs.observe(t.el); } catch {} }); } catch {}
+			} catch {}
+		}
+		/** web 壁纸 iframe 内所有 video/audio 恢复播放。 */
+		function resumeWebFrame() {
+			try {
+				const { frame } = bgElements();
+				if (!frame) return;
+				const doc = frame.contentDocument;
+				if (doc) {
+					const els = doc.querySelectorAll("video,audio");
+					for (let i = 0; i < els.length; i++) { try { const p = els[i].play(); if (p && p.catch) p.catch(() => {}); } catch {} }
 				}
-				// 视频就绪后切换 live 背景
-				if (!lgBgVideoHooked) {
-					try {
-						const vid = bgElements().video;
-						if (vid) {
-							vid.addEventListener("loadeddata", () => {
-								try { if (lgGlass && vid.videoWidth > 0) { lgGlass.setBackdrop(vid, { update: "live", autoStart: true }); lgBgVideoHooked = true; } } catch {}
-							}, { once: true });
-						}
-					} catch {}
+			} catch {}
+		}
+		function pauseWallpaperVideo() {
+			try {
+				const { video, frame } = bgElements();
+				if (video && !video.paused) video.pause();
+				if (frame && frame.style.display !== "none") pauseWebFrame();
+			} catch {}
+		}
+		/** 当前壁纸视频恢复播放（用户手动暂停时恢复——由调用方判断, 见 toggleWallPause）。 */
+		function resumeWallpaperVideo() {
+			try {
+				const s = readSection();
+				if (!(s.enabled !== void 0 ? !!s.enabled : true)) return;
+				const { video, frame } = bgElements();
+				if (video && video.paused && video.src) {
+					try { const p = video.play(); if (p && p.catch) p.catch(() => {}); } catch {}
 				}
-			} catch (err) { console.warn("[dsh-mpkg-wallpaper] 液态玻璃叠加失败:", err); }
+				if (frame && frame.style.display !== "none") resumeWebFrame();
+			} catch {}
 		}
-		/** 静态渐变兜底背景（视频不可用时）。 */
-		function makeLgFallback() {
+		/** 按三档状态决定暂停/恢复（任一档触发即暂停，全恢复才继续）。 */
+		function updatePowerPause() {
 			try {
-				const c = document.createElement("canvas");
-				c.width = 800; c.height = 600;
-				const g = c.getContext("2d");
-				if (!g) return c;
-				const grad = g.createRadialGradient(300, 200, 50, 400, 300, 600);
-				grad.addColorStop(0, "#4a6cf7"); grad.addColorStop(0.5, "#8a4ad8"); grad.addColorStop(1, "#123456");
-				g.fillStyle = grad; g.fillRect(0, 0, 800, 600);
-				for (let i = 0; i < 8; i++) { g.beginPath(); g.arc(Math.random() * 800, Math.random() * 600, 20 + Math.random() * 50, 0, Math.PI * 2); g.fillStyle = "rgba(255,255,255," + (0.05 + Math.random() * 0.1) + ")"; g.fill(); }
-				return c;
-			} catch { return null; }
+				const s = readSection();
+				const hiddenOn = s.powPauseHidden !== void 0 ? !!s.powPauseHidden : false;
+				const blurOn = s.powPauseBlur !== void 0 ? !!s.powPauseBlur : false;
+				const battOn = s.powPauseBattery !== void 0 ? !!s.powPauseBattery : false;
+				const shouldPause = (hiddenOn && powHiddenNow) || (blurOn && !powFocusedNow) || (battOn && powBattery && powBattery.charging === false);
+				if (shouldPause && !powPaused) { powPaused = true; pauseWallpaperVideo(); }
+				else if (!shouldPause && powPaused) { powPaused = false; resumeWallpaperVideo(); }
+			} catch {}
+		}
+		/** 注册省电监听（一次性）。 */
+		function setupPowerSave() {
+			if (window.__mpwPowerWired) return;
+			window.__mpwPowerWired = true;
+			try {
+				document.addEventListener("visibilitychange", () => {
+					powHiddenNow = document.hidden === true;
+					updatePowerPause();
+				});
+			} catch {}
+			try {
+				window.addEventListener("blur", () => { powFocusedNow = false; updatePowerPause(); });
+				window.addEventListener("focus", () => { powFocusedNow = true; updatePowerPause(); });
+			} catch {}
+			// 电池状态（非标准 API，存在则用，不存在静默跳过）
+			try {
+				if (typeof navigator !== "undefined" && navigator.getBattery && !powBatteryAsked) {
+					powBatteryAsked = true;
+					navigator.getBattery().then((b) => {
+						powBattery = b;
+						b.addEventListener("chargingchange", () => updatePowerPause());
+						b.addEventListener("levelchange", () => updatePowerPause());
+						updatePowerPause();
+					}).catch(() => {});
+				}
+			} catch {}
+			// 初始化一次
+			try { powHiddenNow = !!(document && document.hidden); updatePowerPause(); } catch {}
+		}
+		/** ①(修正) 设置页暂停标志更新 + 派发 mpw:wallpaused 事件，供按钮实时刷新。
+		 *  - source='user'：用户点按钮 → 改权威 wallUserPaused + 执行暂停/恢复。
+		 *  - source='video'：视频实际 play/pause 事件 → **只派发展示事件**，不改权威值。
+		 *    （否则 video 加载新 src 时的瞬态 pause 会把「未暂停」误置「已暂停」，跳过门控。）
+		 *  - source='state'：设置页内部同步显示（不改权威）。 */
+		function setWallPausedByUserState(paused, source) {
+			try {
+				if (source === "user") {
+					wallUserPaused = paused;
+					if (paused) pauseWallpaperVideo();
+					else resumeWallpaperVideo();
+					// ①(修正) notifySectionChanged 只在用户操作时触发（改权威值后刷新设置页）；
+					// video 实际 play/pause 事件（source 非 user）不触发，避免每帧瞬态多余通知。
+					try { notifySectionChanged(); } catch {}
+				}
+				window.dispatchEvent(new CustomEvent("mpw:wallpaused", { detail: { paused: wallUserPaused } }));
+			} catch {}
+		}
+		function toggleWallPause() {
+			setWallPausedByUserState(!wallUserPaused, "user");
 		}
 
 		// ═══════════════════════════════════════════════════════════════════
@@ -2188,10 +2270,10 @@ window.__ModuleLoader__.load({
 					headerBlur: false, headerBlurAmount: 0, headerBg: false, aquaMask: false, aquaTint: false,
 					aquaInk: false, aquaTextEnhance: false, todoBlur: false, clock: false, clock24h: false,
 					clockSec: false, clockDate: false, themeColor: "", accent: "", glassWindow: false,
-					// ①(修正) 侧边栏保持透出壁纸（sidebar:true）：lgTest 是纯净环境测玻璃，
-					// 玻璃折射需要侧边栏透明透出壁纸才有意义；原 sidebar:false 让侧边栏
-					// 变不透明 → 用户实测"侧边栏不变透明、没玻璃效果"。
-					sidebar: true, sharp: false,
+					// ①(修正) lgTest 测试模式下侧边栏**不透明**（sidebar:false）：用户实测
+					// 测试模式侧边栏透壁纸，界面花、看不清内容。测试模式要的是干净对比界面
+					// （壁纸在右侧聊天区可测玻璃），侧边栏不透明便于看清。
+					sidebar: false, sharp: false,
 				});
 			}
 			// ①(新) 悬浮效果开关（buildCss 内声明，之前误加在 applyFromStorage 里导致 ReferenceError）
@@ -2956,6 +3038,40 @@ body[data-mpw-todo-blur] [data-tool="todo_write"] * {
 }
 `;
 			}
+			// ①(新) 液态玻璃（CSS 版）：给标记 [data-mpw-lg-css] 的目标元素加磨砂玻璃
+			// 材质（半透明 + backdrop-filter 模糊背后内容）。不清壁纸、不覆盖内容、不崩。
+			// 不同元素不同 blur 半径：输入框/侧边栏/标题栏各自可调（复用 lg 开关）。
+			css += `
+/* ── 液态玻璃（CSS 版）──
+   ①(修正) **侧边栏玻璃不能用 backdrop-filter**：sidebarCol 是 DSH 设置弹窗的祖先
+   （弹窗渲染在 sidebarCol > settingsArea 内），backdrop-filter 会创建 containing block
+   → 设置弹窗被"困"进侧边栏压缩成窄条（用户实测；与之前 Via 设置被压缩同根因）。
+   故 sidebarCol 的玻璃**只半透明 + 边缘高光**（无 blur），磨砂由壁纸层 blur 提供
+   （见 G/E 块）。输入框/标题栏不是设置弹窗祖先，可用 backdrop-filter。 */
+/* 通用玻璃材质（输入框/标题栏等）：半透明 + backdrop blur */
+body:not([data-ds-dark-theme]) [data-mpw-lg-css] {
+	background-color: color-mix(in srgb, #eef1f7 45%, transparent) !important;
+}
+body[data-ds-dark-theme] [data-mpw-lg-css] {
+	background-color: color-mix(in srgb, #10141f 45%, transparent) !important;
+}
+/* backdrop blur 仅用于**非侧边栏**目标（输入框/标题栏）；sidebarCol 排除 */
+body:not([data-ds-dark-theme]) [data-mpw-lg-css]:not([class*="sidebarCol"]):not([class*="wSkVaW_header"]) {
+	backdrop-filter: blur(${(() => { const v = Number(section.lgBlur); return Number.isFinite(v) ? Math.max(4, Math.min(40, v)) : 18; })()}px) saturate(1.4) !important;
+	-webkit-backdrop-filter: blur(${(() => { const v = Number(section.lgBlur); return Number.isFinite(v) ? Math.max(4, Math.min(40, v)) : 18; })()}px) saturate(1.4) !important;
+}
+body[data-ds-dark-theme] [data-mpw-lg-css]:not([class*="sidebarCol"]):not([class*="wSkVaW_header"]) {
+	backdrop-filter: blur(${(() => { const v = Number(section.lgBlur); return Number.isFinite(v) ? Math.max(4, Math.min(40, v)) : 18; })()}px) saturate(1.4) !important;
+	-webkit-backdrop-filter: blur(${(() => { const v = Number(section.lgBlur); return Number.isFinite(v) ? Math.max(4, Math.min(40, v)) : 18; })()}px) saturate(1.4) !important;
+}
+/* 玻璃边缘高光（液态玻璃感）：顶部一条细亮边 */
+[data-mpw-lg-css] { position: relative; }
+[data-mpw-lg-css]:before {
+	content: ""; position: absolute; top: 0; left: 0; right: 0; height: 1px;
+	background: linear-gradient(90deg, transparent, rgba(255,255,255,0.35) 25%, rgba(255,255,255,0.35) 75%, transparent);
+	pointer-events: none; z-index: 1;
+}
+`;
 			return css + buildUiCss(section, dlgFrosted);
 		}
 
@@ -3725,6 +3841,7 @@ body[data-mpw-modal] [role="dialog"] {
 				setSettingsTab(id);
 			};
 			const [mpkgMeta, setMpkgMeta] = react.useState(initMeta); // { name, key, info, entryName, slot }
+			const [wallPausedByUser, setWallPausedByUser] = react.useState(wallUserPaused); // ①(新) 用户手动暂停壁纸（初值取权威 wallUserPaused，避免重开设置页显示错）
 			const [busy, setBusy] = react.useState(false);
 			// ①(修正) hint 自动超时清空（5 秒）：用户反馈「恢复所有默认设置」下方一直挂着
 			// 「已应用壁纸：xxx」——hint 是操作结果提示，常驻会让用户误以为是与恢复默认相关
@@ -3733,6 +3850,13 @@ body[data-mpw-modal] [role="dialog"] {
 			const hintTimerRef = react.useRef(null);
 			// ①(修正) 卸载时清理 hint 计时器（防对已卸载组件 setState）
 			react.useEffect(() => () => { try { if (hintTimerRef.current) clearTimeout(hintTimerRef.current); } catch {} }, []);
+			// ①(修正) 暂停按钮**实时**同步：监听 mpw:wallpaused 事件（视频实际 play/pause 变化
+			// 或用户点按钮都会派发），把 wallPausedByUser 同步为权威 wallUserPaused 的值。
+			react.useEffect(() => {
+				const onWallPaused = (e) => { try { setWallPausedByUser(!!(e && e.detail && e.detail.paused)); } catch {} };
+				try { window.addEventListener("mpw:wallpaused", onWallPaused); } catch {}
+				return () => { try { window.removeEventListener("mpw:wallpaused", onWallPaused); } catch {} };
+			}, []);
 			const setHint = (msg) => {
 				_setHintRaw(msg);
 				if (hintTimerRef.current) { try { clearTimeout(hintTimerRef.current); } catch {} }
@@ -4712,7 +4836,7 @@ body[data-mpw-modal] [role="dialog"] {
 						// ①(修正) 类型校验（评审指出：原实现直接透传，`opacity:"abc"` 会污染设置）：
 						// 数值类必须为有限数、布尔类必须为 boolean、字符串类必须为 string。
 						const numFields = ["opacity", "blur", "zoom", "headerBlurAmount", "dialogAmount", "popoverAmount", "maskAmount", "unifyAmount", "sidebarAlpha", "aquaMaskAlpha", "aquaTintStrength", "glassAlpha", "rotateMin", "brightness", "playbackRate", "clockSize", "fpsCap", "resMax", "bsRevealAlpha"];
-						const boolFields = ["sidebar", "sharp", "headerBlur", "headerBg", "dialogBlur", "popoverBlur", "maskBlur", "unifyTint", "chatFollow", "sessionFollow", "aquaMask", "aquaTint", "aquaInk", "aquaTextEnhance", "todoBlur", "hybrid", "roundCompat", "rotate", "float", "newStyle", "mute", "thinkBg", "enabled", "forceEnabled", "clock", "clock24h", "clockSec", "clockDate", "glassWindow", "bsCompat", "bsFloat", "bsFont", "bsReveal", "bsAlpha", "bsAqua", "bsBottomAvoid", "lgTest", "lgComposer", "lgSidebar", "lgHeader"];
+						const boolFields = ["sidebar", "sharp", "headerBlur", "headerBg", "dialogBlur", "popoverBlur", "maskBlur", "unifyTint", "chatFollow", "sessionFollow", "aquaMask", "aquaTint", "aquaInk", "aquaTextEnhance", "todoBlur", "hybrid", "roundCompat", "rotate", "float", "newStyle", "mute", "thinkBg", "enabled", "forceEnabled", "clock", "clock24h", "clockSec", "clockDate", "glassWindow", "bsCompat", "bsFloat", "bsFont", "bsReveal", "bsAlpha", "bsAqua", "bsBottomAvoid", "lgTest", "lgComposer", "lgSidebar", "lgHeader", "powPauseHidden", "powPauseBlur", "powPauseBattery"];
 						const strFields = ["aquaColor", "aquaInkColor", "themeColor", "accent", "glassColor", "clockPos", "fontColorGrayColor"];
 						for (const k of BACKUP_FIELDS) {
 							const v = settings[k];
@@ -4786,6 +4910,8 @@ body[data-mpw-modal] [role="dialog"] {
 					}
 					if (s.image === "idb:blob") {
 						// idb 视频/动图：强制重建 ObjectURL 重缓冲
+						// ①(修正) 内存：先 revoke 旧 blob URL 再清引用，防泄漏
+						if (lastBgSig && lastBgSig.url) { try { URL.revokeObjectURL(lastBgSig.url); } catch {} }
 						lastBgSig = null;
 						applyFromStorage();
 						setHint(t("refresh.done"));
@@ -5003,6 +5129,8 @@ body[data-mpw-modal] [role="dialog"] {
 					}, true);
 					setMpkgMeta(meta);
 					// ①(修正) 视频→图片切换：强制清掉背景内容缓存，确保新壁纸立即显示
+					// ①(修正) 内存：先 revoke 旧 blob URL 再清引用，防切换泄漏
+					if (lastBgSig && lastBgSig.url) { try { URL.revokeObjectURL(lastBgSig.url); } catch {} }
 					try { lastBgSig = null; } catch {}
 					// ①(修正) 仅当最终显示的是图片/GIF（非 mp4）才提示预览模式；
 					// 独立 mp4 视频壁纸（洛茜_01 等）不弹窗、不显示 GIF 提示
@@ -5362,6 +5490,10 @@ body[data-mpw-modal] [role="dialog"] {
 						])
 						: null,
 					h("div", { className: "mpw_inline" }, [
+						// ①(新) 暂停/播放：视频/web 类壁纸可暂停（停住画面），再点恢复。
+						// ①(修正) 只调 toggleWallPause()——它内部更新权威 wallUserPaused + 派发
+						// mpw:wallpaused 事件，组件监听后实时刷新 wallPausedByUser，不必手动翻转。
+						(section.converted === "mp4" || section.converted === "web") ? h("button", { className: "mpw_reset", type: "button", onClick: () => { toggleWallPause(); } }, wallPausedByUser ? t("pause.play") : t("pause.pause")) : null,
 						h("button", { className: "mpw_reset", type: "button", onClick: refreshBg }, t("refresh.bg")),
 						h("button", { className: "mpw_reset", type: "button", onClick: clearBg }, t("clear.bg"))
 					])
@@ -6182,6 +6314,11 @@ body[data-mpw-modal] [role="dialog"] {
 				// ①(新) 第三方 UI 圆角兼容开关（其他组）
 				toggleRow(t("roundCompat"), t("roundCompat.desc"), "roundCompat", DEFAULT_ROUND_COMPAT),
 
+				// ①(新) 省电（遮挡暂停三档，借鉴 elysia395）：页面隐藏/失焦/电池供电时暂停壁纸
+				toggleRow(t("powPauseHidden"), t("powPauseHidden.desc"), "powPauseHidden", false),
+				toggleRow(t("powPauseBlur"), t("powPauseBlur.desc"), "powPauseBlur", false),
+				toggleRow(t("powPauseBattery"), t("powPauseBattery.desc"), "powPauseBattery", false),
+
 				// ①(新) 检测更新 / 一键热更新
 				h("div", { className: "mpw_field" }, [
 					h("label", { className: "mpw_label" }, t("update.title")),
@@ -6429,6 +6566,10 @@ body[data-mpw-modal] [role="dialog"] {
 			"nav": "壁纸引擎背景",
 			"master": "启用壁纸引擎背景功能",
 			"clear.bg": "清除背景",
+			"pause.pause": "暂停壁纸",
+			"pause.play": "播放壁纸",
+			"pause.pause": "暂停壁纸",
+			"pause.play": "播放壁纸",
 			"refresh.bg": "刷新壁纸",
 			"refresh.done": "壁纸已刷新",
 			"master.desc": "开启后应用所选背景",
@@ -6647,6 +6788,12 @@ body[data-mpw-modal] [role="dialog"] {
 			"update.chooseBody": "推荐先到插件市场更新（semver 检测与市场一致）。确认仍用本插件的直接更新（拉取 GitHub 代码写回本地）吗？版本 ",
 			"update.confirmSelf": "直接用本插件更新",
 			"roundCompat.desc": "给其他插件注入界面的矩形容器补圆角（不覆盖插件自己的样式）；如与某插件冲突可关闭",
+			"powPauseHidden": "省电·页面隐藏/切页暂停",
+			"powPauseHidden.desc": "最小化/切页时暂停壁纸视频（解码归零），回来自动继续",
+			"powPauseBlur": "省电·失焦暂停",
+			"powPauseBlur.desc": "窗口失去焦点（切到其他窗口）时暂停壁纸，回来继续",
+			"powPauseBattery": "省电·电池供电暂停",
+			"powPauseBattery.desc": "使用电池供电时不播放壁纸（省电），接通电源自动恢复",
 			"error.title": "导入失败",
 			"preview.title": "预览模式",
 			"preview.desc": "该壁纸当前以预览图（GIF/图片）显示，浏览器无法播放其动态内容（Live2D 场景/高清视频需壁纸引擎 App 渲染）。",
@@ -6767,6 +6914,8 @@ body[data-mpw-modal] [role="dialog"] {
 			"nav": "MPKG Wallpaper",
 			"master": "Enable mpkg background",
 			"clear.bg": "Clear background",
+			"pause.pause": "Pause wallpaper",
+			"pause.play": "Play wallpaper",
 			"refresh.bg": "Refresh wallpaper",
 			"refresh.done": "Wallpaper refreshed",
 			"master.desc": "On applies the chosen background",
@@ -7005,6 +7154,12 @@ body[data-mpw-modal] [role="dialog"] {
 			"update.chooseBody": "Prefer updating from the plugin market (semver check matches the market). Still update directly via this plugin (pull GitHub code and write it back locally)? v",
 			"update.confirmSelf": "Update via this plugin",
 			"roundCompat.desc": "Adds border-radius to rectangular containers injected by other plugins (does not override their own styles); turn off if it conflicts",
+			"powPauseHidden": "Power save · pause when hidden",
+			"powPauseHidden.desc": "Pause the wallpaper video when the page is hidden/in a background tab (decoder to zero), resume on return",
+			"powPauseBlur": "Power save · pause on blur",
+			"powPauseBlur.desc": "Pause the wallpaper when the window loses focus, resume when refocused",
+			"powPauseBattery": "Power save · pause on battery",
+			"powPauseBattery.desc": "Do not play the wallpaper when on battery power; resume when plugged in",
 			"error.title": "Import failed",
 			"preview.title": "Preview mode",
 			"preview.desc": "This wallpaper is currently shown as a preview image (GIF/picture); the browser cannot play its dynamic content (Live2D scene / HD video requires the Wallpaper Engine app).",
@@ -7298,15 +7453,19 @@ body[data-mpw-modal] [role="dialog"] {
 				// 按 timeSrc 按需提取，单槽峰值 ~50MB；④(新) timeOverride 手动锁定时暂停自动切换）
 				try {
 					setInterval(() => {
-						const s = readSection();
-						if (!s.timeVideos || !s.timeConfig || !s.timeConfig.enabled) return;
-						// ④(新) 手动锁定时段：不再随时间自动切换，直到点「自动」
-						if (s.timeOverride) return;
-						const slot = slotForTime(s.timeConfig, new Date());
-						if (slot === s.activeSlot) return;
-						swapTimeSlot(slot);
+						try {
+							const s = readSection();
+							if (!s.timeVideos || !s.timeConfig || !s.timeConfig.enabled) return;
+							// ④(新) 手动锁定时段：不再随时间自动切换，直到点「自动」
+							if (s.timeOverride) return;
+							const slot = slotForTime(s.timeConfig, new Date());
+							if (slot === s.activeSlot) return;
+							swapTimeSlot(slot);
+						} catch { /* 时段配置畸形等异常不得成为未捕获定时器错误 */ }
 					}, 60000);
 				} catch {}
+				// ①(新) 省电（遮挡暂停三档）：页面隐藏/失焦/电池供电时暂停壁纸，回来自动继续
+				try { setupPowerSave(); } catch {}
 			}
 			const sectionInjected = () => ({
 				commit: () => { applyFromStorage(); }

package/lib/index.js

@@ -7,6 +7,7 @@
 import { createWriteStream, createReadStream, mkdirSync, existsSync, statSync, readFileSync, readdirSync, writeFileSync, openSync, readSync, closeSync, renameSync, unlinkSync, chmodSync, writeSync } from 'node:fs';
 import { join, resolve, sep, isAbsolute } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import os from 'node:os';
 // tmpdir 不再使用（持久目录用 DATA_DIR）
 import crypto from 'node:crypto';
 import { execFileSync, spawn } from 'node:child_process';
@@ -41,7 +42,10 @@ const STEAM_PROBE_DIRS = [
 /** ①(修正) 持久数据目录：放 DSH_HOME/HOME 下而非 tmpdir —— Termux/proot 环境
  *  /tmp 每次重启清空 → 重启后 mpkg 与 customDir 全部丢失（用户实测）。
  *  用持久目录：上传的 mpkg、custom-dir.json、token 映射重启后都能恢复。 */
-const DATA_DIR = join(process.env.DSH_HOME || process.env.HOME || '.', '.dsh-mpkg-wallpaper');
+// ①(修正) 用 os.homedir() 兜底：Windows 默认**无 process.env.HOME**（原回退 '.' 相对路径
+//  → cwd 不可写时 /settings、/upload、customDir、上传 mpkg 全部静默丢失）。os.homedir()
+//  跨平台正确（Windows/ macOS/Linux/WSL）。DSH_HOME 优先，其次 os.homedir()。
+const DATA_DIR = join(process.env.DSH_HOME || os.homedir() || '.', '.dsh-mpkg-wallpaper');
 
 /** token → { path, size, dataStart, entries } */
 const files = new Map();
@@ -237,12 +241,20 @@ function steamPathFromRegistry() {
   } catch { return null; }
 }
 
-/** ③ 自动发现：定位壁纸引擎安装目录（Steam libraryfolders.vdf + 常见路径探测）。 */
+/** ③ 自动发现：定位壁纸引擎安装目录（Steam libraryfolders.vdf + 常见路径探测）。
+ *  ①(修正) 补非 Windows 平台探测：macOS/Linux/WSL 也各自有 Steam 安装路径。
+ *  路径是纯字符串，平台用不到时 existsSync 自然为 false，无副作用。 */
+const STEAM_PROBE_DIRS_NONWIN = [
+  ...(process.platform === 'darwin' ? [join(os.homedir(), 'Library', 'Application Support', 'Steam')] : []),
+  ...(process.platform === 'linux' || process.platform === 'android' ? [join(os.homedir(), '.local', 'share', 'Steam')] : []),
+  '/mnt/c/Program Files (x86)/Steam',   // WSL
+  '/mnt/c/Program Files/Steam',          // WSL
+];
 function locateWallpaperEngine() {
   const probes = [];
   const reg = steamPathFromRegistry();
   if (reg) probes.push(reg);
-  probes.push(...STEAM_PROBE_DIRS);
+  probes.push(...STEAM_PROBE_DIRS, ...STEAM_PROBE_DIRS_NONWIN);
   const libraries = [];
   for (const probe of probes) {
     const vdf = join(probe, 'steamapps', 'libraryfolders.vdf');
@@ -957,14 +969,27 @@ function apply(ctx) {
           mkdirSync(dir, { recursive: true });
           const filePath = join(dir, token + '.mpkg');
           const out = createWriteStream(filePath);
+          // ①(修正) 给写入流挂 error 监听：原无监听——写失败（磁盘满/权限 EACCES/
+          // Windows 文件被占用/杀软锁文件）时 EventEmitter 直接 throw → uncaught
+          // exception → 宿主进程崩溃（用户实测风险）。error 转成 reject → 被外层
+          // catch 接住返回 500 而非崩宿主进程。
+          let writeErr = null;
+          out.on('error', (e) => { writeErr = e; });
           let head = Buffer.alloc(0);
           let size = 0;
-          for await (const chunk of req) {
-            size += chunk.length;
-            if (head.length < HEAD_BYTES) head = Buffer.concat([head, chunk]);
-            if (!out.write(chunk)) await new Promise((r) => out.once('drain', r));
+          try {
+            for await (const chunk of req) {
+              size += chunk.length;
+              if (head.length < HEAD_BYTES) head = Buffer.concat([head, chunk]);
+              if (writeErr) throw writeErr;
+              if (!out.write(chunk)) await new Promise((r) => { out.once('drain', r); if (writeErr) r(); });
+            }
+            await new Promise((r) => { out.on('error', r); out.on('finish', r); if (writeErr) r(); out.end(); });
+            if (writeErr) throw writeErr;
+          } catch (e) {
+            try { out.destroy(); } catch {}
+            throw e;
           }
-          await new Promise((r) => { out.end(r); });
           const { dataStart, entries } = parseMpkgHead(head);
           files.set(token, { path: filePath, size, dataStart, entries });
           json(res, 200, { ok: true, token, size, entries });
@@ -1074,7 +1099,19 @@ function apply(ctx) {
           const client = await fetchRaw('lib/client.js');
           const index = await fetchRaw('lib/index.js');
           if (!client.includes('dsh-mpkg-wallpaper') || !index.includes('dsh-mpkg-wallpaper')) { json(res, 400, { ok: false, error: 'invalid payload' }); return; }
-          writeFileSync(new URL('./client.js', dir), client, 'utf8');
+          // ①(修正) id 适配：仓库 client.js 注册 id=dsh-mpkg-wallpaper；本地 @local 安装
+          // 时 cordis 以 @local/dsh-mpkg-wallpaper 引用，DSH 期望注册同名 id——直接覆盖
+          // 会导致 loaded without registering → dsh 启动崩溃（用户实测：点"从本插件更新"
+          // 后崩溃）。写回前按**当前 client.js 的 id** 调整（本地是 @local 就替换成 @local）。
+          let clientOut = client;
+          try {
+            const curSrc = readFileSync(new URL('./client.js', dir), 'utf8');
+            const curId = /id:\s*"([^"]+)"/.exec(curSrc);
+            if (curId && curId[1] && curId[1] !== 'dsh-mpkg-wallpaper') {
+              clientOut = clientOut.replace(/id:\s*"dsh-mpkg-wallpaper"/, 'id: "' + curId[1] + '"');
+            }
+          } catch { /* 读当前 id 失败则保持仓库 id */ }
+          writeFileSync(new URL('./client.js', dir), clientOut, 'utf8');
           writeFileSync(new URL('./index.js', dir), index, 'utf8');
           // 同步更新 package.json 版本号（让"更新到 vX"名副其实）
           try {
@@ -1099,13 +1136,15 @@ function apply(ctx) {
           const url = new URL(req.url || '', 'http://localhost');
           const p = (url.searchParams.get('path') || '').trim();
           // ③(修正) 默认起始路径：Windows → C:\；其他平台 → 当前用户 HOME（proot 的 /root 等），
-          // 而不是直接开根目录（用户反馈打开的是安卓根目录、看不到自己环境）
-          const base = p || (process.platform === 'win32' ? 'C:\\' : (process.env.HOME || '/'));
+          // 而不是直接开根目录（用户反馈打开的是安卓根目录、看不到自己环境）。
+          // ①(修正) 用 os.homedir() 兜底（Windows 无 process.env.HOME；os.homedir() 跨平台正确）。
+          const home = os.homedir() || '/';
+          const base = p || (process.platform === 'win32' ? 'C:\\' : home);
           if (!existsSync(base) || !statSync(base).isDirectory()) { json(res, 400, { ok: false, error: 'invalid dir' }); return; }
           const subdirs = readdirSync(base, { withFileTypes: true })
             .filter((d) => d.isDirectory() && !d.name.startsWith('.'))
             .map((d) => d.name);
-          json(res, 200, { ok: true, dir: base, subdirs, home: process.env.HOME || '/', platform: process.platform });
+          json(res, 200, { ok: true, dir: base, subdirs, home, platform: process.platform });
         } catch (err) { json(res, 500, { ok: false, error: String(err && err.message || err) }); }
       },
     });
@@ -1720,7 +1759,9 @@ function apply(ctx) {
           const wallpapers = [];
           const scan = (root) => {
             if (!existsSync(root)) return;
-            for (const dir of readdirSync(root)) {
+            let dirs = [];
+            try { dirs = readdirSync(root); } catch { return; }   // ①(修正) 目录不可读则整体跳过，不崩
+            for (const dir of dirs) {
               const p = join(root, dir);
               const proj = join(p, 'project.json');
               if (!existsSync(proj)) continue;

package/package.json

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