dsh-mpkg-wallpaper 3.7.0 → 3.7.1

package/lib/client.js

@@ -1483,6 +1483,50 @@ window.__ModuleLoader__.load({
 					// ⑤(新) Edge 兼容：Edge 上画到 canvas（视频元素不可见，避开悬浮工具栏）
 					if (IS_EDGE) { try { showVideoEdge(playUrl, bgElements().video); } catch { showVideoEl(playUrl); } }
 					else showVideoEl(playUrl);
+					// ②(fix) 转码加载超时兜底（用户实测：60fps 源 + fpsCap=60 → host 白转码
+					// 几分钟 → video 一直 loading 白屏；切回无限制才加载）。现在 host 端
+					// 已做"无需转码直返原片"，但真需要转码(如 4K→1080p)时仍可能慢——
+					// 10s 内未进入可播放状态 → 切回原片播放（host 转码继续，完成缓存后
+					// 自动切回转码产物）。只对 useTranscode 生效且只回退一次。
+					if (useTranscode && vid && !vid.__mpwTransLoadingTimeout) {
+						const clearTransTimeout = () => { try { clearTimeout(vid.__mpwTransLoadingTimeout); vid.__mpwTransLoadingTimeout = null; } catch {} };
+						vid.addEventListener("canplay", clearTransTimeout, { once: true });
+						vid.addEventListener("playing", clearTransTimeout, { once: true });
+						vid.__mpwTransLoadingTimeout = setTimeout(() => {
+							if (gen !== bgGen) return;
+							if (vid.__mpwTransFallback) return;
+							if (vid.readyState >= 2) return; // 已能播放，不切
+							try {
+								console.warn("[dsh-mpkg-wallpaper] 转码 10s 未就绪 → 回退原片", String(hostUrl).slice(0, 100));
+								vid.__mpwTransFallback = true;
+								try { setHint(t("transcode.fallback")); } catch {}
+								vid.removeAttribute("src");
+								vid.src = hostUrl;
+								vid.load();
+								try { if (!(wallUserPaused || powPaused)) { const pp = vid.play(); if (pp && pp.catch) pp.catch(() => {}); } } catch {}
+								// ②(fix) 转码完成自动切换：回退后轮询 host 转码进度，
+								// done → 重新 apply（此时 /transcode 命中缓存，秒开转码产物）。
+								// 只轮询到转码完成或超时（上限 3 分钟，避免无限轮询）。
+								let pollTries = 0;
+								const poll = setInterval(() => {
+									if (gen !== bgGen) { clearInterval(poll); return; }
+									if (++pollTries > 18) { clearInterval(poll); return; } // 3min
+									try {
+										fetch(HOST_BASE + "/transcode-progress?src=" + encodeURIComponent(image) + "&fps=" + transcodeFps + (resMaxN > 0 ? "&maxW=" + resMaxN : ""))
+											.then((r) => r.ok ? r.json() : null)
+											.then((j) => {
+												if (gen !== bgGen) return;
+												if (j && j.phase === "done") {
+													clearInterval(poll);
+													console.log("[dsh-mpkg-wallpaper] 转码完成 → 重新应用(命中缓存)");
+													try { applyFromStorage(); } catch {}
+												}
+											}).catch(() => {});
+									} catch {}
+								}, 10000);
+							} catch {}
+						}, 10000);
+					}
 				} else {
 					// ①(修正) 重启竞态兜底：dsh 重启后浏览器可能先于 host 就绪请求 media → 404；
 					// 挂 onerror 自动重试（最多 5 次、间隔递增），host 恢复后壁纸自动回来。
@@ -1608,8 +1652,10 @@ window.__ModuleLoader__.load({
 			try { setupHeaderBlurWatch(); } catch {}
 			try { setupAquaThemeWatch(); } catch {}
 			// ①(新) 主题颜色：body 门控 + CSS 变量（控制侧边栏/标题栏/新会话/设置弹窗底色）
+			// ①(Qoder 审查 R3) 总开关关闭时还原默认外观：themeColor/accent 的
+			// body 属性与 CSS 变量也受 enabled 门控（关 = 移除 tint，DSH 原色）。
 			try {
-				const tc = section.themeColor || "";
+				const tc = enabled && section.themeColor || "";
 				if (tc && /^#[0-9a-fA-F]{6}$/.test(tc)) {
 					document.body.setAttribute("data-mpw-theme", "");
 					document.documentElement.style.setProperty("--mpw-theme-color", tc);
@@ -1618,7 +1664,7 @@ window.__ModuleLoader__.load({
 					document.documentElement.style.removeProperty("--mpw-theme-color");
 				}
 				// ①(新) 配色（accent）：品牌交互元素（按钮/滑条/选中/链接/发送键）
-				const ac = section.accent || "";
+				const ac = enabled && section.accent || "";
 				if (ac && /^#[0-9a-fA-F]{6}$/.test(ac)) {
 					document.body.setAttribute("data-mpw-accent", "");
 					document.documentElement.style.setProperty("--mpw-accent-color", ac);
@@ -1637,10 +1683,6 @@ window.__ModuleLoader__.load({
 					|| (section.aquaTint !== void 0 ? !!section.aquaTint : DEFAULT_AQUA_TINT);
 				if (headerTint) document.body.setAttribute("data-mpw-aqua-header", "");
 				else document.body.removeAttribute("data-mpw-aqua-header");
-				// ①(新) 配色（accent，品牌交互元素）：与主题颜色分工
-				if (section.accent && /^#[0-9a-fA-F]{6}$/.test(section.accent))
-					document.body.setAttribute("data-mpw-accent", "");
-				else document.body.removeAttribute("data-mpw-accent");
 				if (section.aquaTextEnhance !== void 0 ? !!section.aquaTextEnhance : DEFAULT_AQUA_TEXT_ENHANCE)
 					document.body.setAttribute("data-mpw-aqua-text", "");
 				else document.body.removeAttribute("data-mpw-aqua-text");
@@ -2284,6 +2326,27 @@ window.__ModuleLoader__.load({
 		//  侧边栏/聊天区的根元素上（否则设置弹窗会被"关"在侧边栏里，①），
 		//  只加在内部滚动容器上（regionArea / scrollBody / details body）。
 		// ═══════════════════════════════════════════════════════════════════
+		// ①(Qoder 审查 R1) themeColor 独立块提取为单函数，两分支共用：
+		// 不依赖「标题栏透出/侧边栏透出」开关，只要设置了主题颜色就 tint
+		// 侧边栏/标题栏/新会话按钮/设置弹窗。此前两处逐字重复，第4项再改
+		// 时漏改一处（fa2e0e6 就是补漏 commit）——集中到一处避免再犯。
+		function buildThemeColorCss() {
+			return `
+body[data-mpw-theme] .pI_x6G_sidebarCol {
+	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
+}
+body[data-mpw-theme] .wSkVaW_header {
+	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
+}
+body[data-mpw-theme] button[class*="newSession"] {
+	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
+}
+body[data-mpw-theme] [class*="settingsArea"] [role="dialog"],
+body[data-mpw-theme] [class*="settingsArea"] [role="alertdialog"] {
+	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
+}
+`;
+		}
 		function buildCss(section) {
 			// ③(修正) 总开关关闭时统一视为无背景：所有路径（applyFromStorage/previewCss）
 			// 都走同一逻辑，避免拖动滑块时 previewCss 绕过 enabled 检查把壁纸又显示出来
@@ -2436,21 +2499,7 @@ body:not([data-ds-dark-theme]) .mpw_dialog {
 `;
 				// ①(修正) 主题颜色(themeColor) 独立块（第4项）：无壁纸分支也输出——
 				// 不依赖透出开关，只要设置了主题颜色就 tint 侧边栏/标题栏/新会话/设置弹窗。
-				css += `
-body[data-mpw-theme] .pI_x6G_sidebarCol {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-body[data-mpw-theme] .wSkVaW_header {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-body[data-mpw-theme] button[class*="newSession"] {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-body[data-mpw-theme] [class*="settingsArea"] [role="dialog"],
-body[data-mpw-theme] [class*="settingsArea"] [role="alertdialog"] {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-`;
+				css += buildThemeColorCss();
 				return css + buildUiCss(section, false);
 			}
 			css += `
@@ -3155,23 +3204,8 @@ body[data-ds-dark-theme] [data-mpw-lg-css]:not([class*="sidebarCol"]):not([class
 			// 「侧边栏透出」开关，只要设置了主题颜色就 tint 侧边栏/标题栏/新会话按钮/
 			// 设置弹窗。放在 buildCss 最末尾（最后追加 → 覆盖前面所有同特异性规则，
 			// 包括透出开关的纯色/透明分支），由 body[data-mpw-theme] 门控。
-			css += `
-/* 主题颜色(themeColor)：整体底色 tint（独立于透出开关，第4项） */
-body[data-mpw-theme] .pI_x6G_sidebarCol {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-body[data-mpw-theme] .wSkVaW_header {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-body[data-mpw-theme] button[class*="newSession"] {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-/* 设置弹窗：覆盖不透明兜底（同特异性后定义者胜 → 生效） */
-body[data-mpw-theme] [class*="settingsArea"] [role="dialog"],
-body[data-mpw-theme] [class*="settingsArea"] [role="alertdialog"] {
-	background-color: color-mix(in srgb, var(--mpw-theme-color) 30%, transparent) !important;
-}
-`;
+			// ①(Qoder 审查 R1) CSS 内容统一走 buildThemeColorCss()（两分支共用）。
+			css += buildThemeColorCss();
 			return css + buildUiCss(section, dlgFrosted);
 		}
 
@@ -4117,7 +4151,10 @@ body[data-mpw-modal] [role="dialog"] {
 							const skelKey = (d.SettingModel && d.SettingModel.skel) || "setting";
 							const raw = ls.getItem(skelKey);
 							if (raw) {
-								const stored = JSON.parse(raw);
+								// ①(Qoder 审查) JSON.parse 单独保护：损坏的 localStorage
+								// 只丢弃读回（回退 loadJson 默认值），不影响后续 setWebCfg。
+								let stored = null;
+								try { stored = JSON.parse(raw); } catch { stored = null; }
 								if (stored && stored.SettingModel) {
 									d.SettingModel = Object.assign({}, d.SettingModel, stored.SettingModel);
 								}

package/lib/index.js

@@ -402,6 +402,62 @@ let ffmpegDownloadPromise = null;     // 下载单飞（防并发重复下载）
 let ffmpegDownloadProgress = null;    // 下载进度（bytes/total）
 let lastFfmpegDownloadError = null;
 
+/** ②(fix) 源视频探测缓存：srcId|mtime → { fps, width, height } | null。
+ *  避免每次 /transcode 都跑一次 ffprobe（4K 源探测也要几秒）。 */
+const TRANSCODE_PROBE_CACHE = new Map();
+const TRANSCODE_PROBE_CACHE_MAX = 64;
+
+/** ②(fix) 用 ffprobe 探测视频流的帧率/分辨率（失败返回 null，不抛错）。
+ *  用于"源帧率≤上限 且 源宽≤上限 → 无需转码直接原片"的判断——
+ *  用户实测：60fps 源 + fpsCap=60 仍走重编码 → 白屏几分钟（Android 单线程
+ *  转 4K 100s 极慢），切回无限制时后台 ffmpeg 还在跑 → 卡。 */
+function probeVideoInfo(filePath) {
+  try {
+    const out = execFileSync('ffprobe', [
+      '-v', 'error', '-select_streams', 'v:0',
+      '-show_entries', 'stream=r_frame_rate,avg_frame_rate,width,height',
+      '-of', 'csv=p=0', filePath,
+    ], { encoding: 'utf8', timeout: 15000, windowsHide: true, stdio: ['ignore', 'pipe', 'ignore'] });
+    const line = String(out).trim().split(/\r?\n/)[0] || '';
+    const parts = line.split(',').map((s) => s.trim());
+    // 实测 ffprobe 4.4.2 csv 输出顺序: <width>,<height>,<r_frame_rate>[,<avg_frame_rate>]
+    // （如 "3840,2160,60/1" 或 "1920,1080,30000/1001"）——不是文档常见的
+    // r_frame_rate,width,height 顺序，按 show_entries 声明顺序也实测为 width 在前。
+    const width = Number(parts[0]);
+    const height = Number(parts[1]);
+    const parseRate = (s) => { const r = String(s || '').split('/'); const n = Number(r[0]), d = Number(r[1]); return d > 0 && Number.isFinite(n) ? n / d : 0; };
+    // ①(fix) VFR 视频 r_frame_rate 可能是 0/0 → 用 avg_frame_rate 兜底
+    let fps = parseRate(parts[2]);
+    if (!(fps > 0)) fps = parseRate(parts[3]);
+    if (!(fps > 0) || !(width > 0)) return null;
+    return { fps, width, height };
+  } catch { return null; }
+}
+
+/** ②(fix) 带缓存的探测（src 统一输入：mpkg 或 file）。 */
+function probeVideoSource(src) {
+  try {
+    const srcPath = src.type === 'file' ? src.path : src.rec.path;
+    const st = statSync(srcPath);
+    const srcId = src.type === 'mpkg' ? 'mpkg:' + src.rec.path + ':' + src.entry.index : srcPath;
+    const ck = srcId + '|' + Math.round(st.mtimeMs);
+    if (TRANSCODE_PROBE_CACHE.has(ck)) return TRANSCODE_PROBE_CACHE.get(ck);
+    let info = null;
+    if (src.type === 'file') {
+      info = probeVideoInfo(srcPath);
+    } else {
+      // mpkg 容器内条目：materialize 提取临时文件后探测，探完即删
+      try {
+        const mat = materializeSource(src, transcodeCacheDir());
+        try { info = probeVideoInfo(mat.file); } finally { if (mat.cleanup) mat.cleanup(); }
+      } catch { info = null; }
+    }
+    if (TRANSCODE_PROBE_CACHE.size >= TRANSCODE_PROBE_CACHE_MAX) TRANSCODE_PROBE_CACHE.clear();
+    TRANSCODE_PROBE_CACHE.set(ck, info);
+    return info;
+  } catch { return null; }
+}
+
 function ffmpegDataDir() {
   const dir = join(DATA_DIR, 'ffmpeg');
   try { mkdirSync(dir, { recursive: true }); } catch { /* 忽略 */ }
@@ -430,6 +486,9 @@ let TRANSCODE_FUTEX_FALLBACK = false;
 const TRANSCODE_MAX_ACTIVE = Math.max(1, Number(process.env.DSH_WE_TRANSCODE_MAX_ACTIVE) || 1);
 let TRANSCODE_ACTIVE = 0;
 const TRANSCODE_WAITERS = [];
+/** ②(Qoder 审查 M7) 转码排队等待上限：超过即抛错让客户端回退原片（防浏览器已
+ *  放弃、服务端仍白跑长队列）。默认 30s。 */
+const TRANSCODE_QUEUE_TIMEOUT_MS = Math.max(5000, Number(process.env.DSH_WE_TRANSCODE_QUEUE_TIMEOUT_MS) || 30000);
 function pruneTranscodeCache() {
   try {
     const dir = transcodeCacheDir();
@@ -460,14 +519,26 @@ function pruneTranscodeCache() {
   // ①(修正) src_*.bin 残留清理：materializeSource 提取的临时源文件，正常路径在
   // transcodeToFps 的 finally 里 cleanup；进程被杀/崩溃时残留（实测 20 个 × 130MB
   // ≈ 3GB 堆积）。转码单任务硬超时 15 分钟，mtime 超过 1 小时必是残留，直接删。
+  // ②(Qoder 审查) 一并清理 tc_*.mp4.tmp* 残留（同源泄漏：renameSync 未执行时残留）。
   try {
     const dir = transcodeCacheDir();
     const cutoff = Date.now() - 60 * 60 * 1000;
     for (const n of readdirSync(dir)) {
-      if (!n.startsWith('src_') || !n.endsWith('.bin')) continue;
-      try {
-        if (statSync(join(dir, n)).mtimeMs < cutoff) unlinkSync(join(dir, n));
-      } catch { /* 忽略 */ }
+      if (n.startsWith('src_') && n.endsWith('.bin')) {
+        try {
+          if (statSync(join(dir, n)).mtimeMs < cutoff) unlinkSync(join(dir, n));
+        } catch { /* 忽略 */ }
+      }
+    }
+    // ②(Qoder 审查) tc_*.mp4.tmp<PID>：转码中间文件，进程被杀时 renameSync
+    // 未执行 → 永久残留。mtime>1h 必是残留（单任务硬超时 15min），直接删。
+    // 正在写的 tmp 由当前任务持有（<15min），不会被误删。
+    for (const n of readdirSync(dir)) {
+      if (n.startsWith('tc_') && /\.tmp(\d+)?$/.test(n)) {
+        try {
+          if (statSync(join(dir, n)).mtimeMs < cutoff) unlinkSync(join(dir, n));
+        } catch { /* 忽略 */ }
+      }
     }
   } catch { /* 忽略 */ }
 }
@@ -661,8 +732,16 @@ function resolveTranscodeSource(fileOrToken) {
     return entry ? { type: 'mpkg', rec, entry } : null;
   }
   if (isAbsolute(fileOrToken)) {
+    // ①(Qoder 审查 S1) 路径穿越：绝对路径只允许 DATA_DIR / customDir 白名单内，
+    // 否则 /transcode?file=/etc/passwd 可探测/流出任意系统文件。
+    // 用 resolve 归一后前缀匹配（防 .. 绕过）。
     const p = resolve(fileOrToken);
-    if (existsSync(p) && statSync(p).isFile()) return { type: 'file', path: p };
+    const allowed = [DATA_DIR, customDir].filter((d) => d && typeof d === 'string');
+    const ok = allowed.some((d) => {
+      const base = resolve(d);
+      return p === base || p.startsWith(base + sep);
+    });
+    if (ok && existsSync(p) && statSync(p).isFile()) return { type: 'file', path: p };
     return null;
   }
   if (customDir && !fileOrToken.includes('..') && !fileOrToken.includes('/') && !fileOrToken.includes('\\')) {
@@ -766,12 +845,17 @@ function spawnFfmpeg(ff, args) {
       }
       const a = attempts[idx++];
       let errFd = null;
-      try { errFd = openSync(errLog, 'w'); } catch { /* 忽略 */ }
+      // ①(Qoder 审查 M3) 用 'a' 追加而非 'w' 截断：多 attempt 时保留第一个
+      // attempt 的 stderr（'w' 会让第二个 attempt 清空第一个的失败原因）。
+      try { errFd = openSync(errLog, 'a'); } catch { /* 忽略 */ }
       let proc = null;
       try {
         proc = spawn(ff, args, { ...a.opts, cwd, stdio: errFd ? ['ignore', 'ignore', errFd] : 'ignore' });
       } catch (err) {
         if (errFd) { try { closeSync(errFd); } catch { /* 忽略 */ } }
+        // ①(Qoder 审查 M4) spawn 阶段 throw（EPERM/ENOENT）：刚创建的空 errLog
+        // 无内容无价值，直接删（失败保留语义只对**真实运行过**的 ffmpeg 有意义）。
+        try { unlinkSync(errLog); } catch { /* 忽略 */ }
         errors.push(a.name + ' spawn throw ' + (err && err.code ? err.code : err));
         runNext();
         return;
@@ -857,8 +941,9 @@ async function runTranscode(srcFile, out, fps, maxW, job) {
     { name: 'libx264', tail: ['-c:v', 'libx264', '-crf', '23', '-preset', 'veryfast'] },
     { name: 'libsvtav1', tail: ['-c:v', 'libsvtav1', '-crf', '32', '-preset', '6'] },
   ];
-  // ①(修正) 线程模式：多线程 → (futex 失败时) 单线程。单线程时 -threads 1 同时放
-  // 输入侧(解码)与输出侧(编码)，并加 -filter_threads 1 限制滤镜线程。
+  // ①(修正) 线程模式：多线程 → (futex 失败时) 单线程。单线程时限制解码
+  // 线程(-threads 1 输入侧)+滤镜线程(-filter_threads 1)，编码线程由输出侧
+  // -threads 1 控制（见下方 full 拼接）。
   const threadModes = [
     { label: 'mt', extra: [] },
     { label: 'st', extra: ['-threads', '1', '-filter_threads', '1'] },
@@ -872,6 +957,8 @@ async function runTranscode(srcFile, out, fps, maxW, job) {
     for (const enc of encoders) {
       job.encoder = enc.name + (mode.label === 'st' ? ' (单线程)' : '');
       // -f mp4 显式指定：临时输出路径不是 .mp4 后缀，ffmpeg 无法按扩展名选 muxer
+      // ①(Qoder 审查 M5) 单线程时输出侧再加 -threads 1 控制编码线程
+      // （输入侧 -threads 只管解码；mode.extra 已含输入侧与 filter_threads）。
       try {
         const full = [...mode.extra, ...base, ...enc.tail, ...(mode.label === 'st' ? ['-threads', '1'] : []), '-movflags', '+faststart', '-an', '-f', 'mp4', out];
         await spawnFfmpeg(ff.path, full);
@@ -879,7 +966,10 @@ async function runTranscode(srcFile, out, fps, maxW, job) {
       } catch (err) {
         lastErr = err;
         try { unlinkSync(out); } catch { /* 忽略 */ }
-        if (/futex/i.test(String(err && err.message || ''))) {
+        // ①(Qoder 审查) futex 判定用精确报错原文匹配，避免误伤：文件名/路径
+        // 含 "futex"（如用户 mpkg 名 futex_test.mpkg）的打开错误也会被宽松
+        // /futex/i 命中 → 误置 TRANSCODE_FUTEX_FALLBACK 永久单线程（性能损失）。
+        if (/futex facility returned an unexpected error/i.test(String(err && err.message || ''))) {
           futexSeen = true;
           TRANSCODE_FUTEX_FALLBACK = true; // 记忆：本进程后续直接单线程
           break; // 多线程 futex 崩 → 不再试本模式其他编码器，直接单线程
@@ -922,8 +1012,27 @@ async function transcodeToFps(src, fps, maxW) {
   const p = (async () => {
     // ①(修正) 并发闸门：Android 内存小，多个 4K 转码并发会 OOM/futex 崩溃
     // （实测用户环境 3 个并发同时崩）。超过 TRANSCODE_MAX_ACTIVE 则排队等待。
+    // ②(Qoder 审查 M7) 排队加超时：MAX=1 时排在长任务(4K 15min)后面的请求
+    // 会挂到浏览器放弃，服务端仍白跑。30s 等不到就抛错 → 客户端回退原片。
     if (TRANSCODE_ACTIVE >= TRANSCODE_MAX_ACTIVE) {
-      await new Promise((resolve) => TRANSCODE_WAITERS.push(resolve));
+      const got = await new Promise((resolve) => {
+        let settled = false;
+        const timer = setTimeout(() => {
+          if (settled) return;
+          settled = true;
+          const i = TRANSCODE_WAITERS.indexOf(wake);
+          if (i >= 0) TRANSCODE_WAITERS.splice(i, 1);
+          resolve(false);
+        }, TRANSCODE_QUEUE_TIMEOUT_MS);
+        const wake = () => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timer);
+          resolve(true);
+        };
+        TRANSCODE_WAITERS.push(wake);
+      });
+      if (!got) throw new Error('转码队列繁忙（等待超过 ' + Math.round(TRANSCODE_QUEUE_TIMEOUT_MS / 1000) + 's），请稍后重试');
     }
     TRANSCODE_ACTIVE++;
     try {
@@ -950,9 +1059,14 @@ async function transcodeToFps(src, fps, maxW) {
         throw err;
       } finally {
         if (mat.cleanup) mat.cleanup();
-        TRANSCODE_INFLIGHT.delete(cachePath);
       }
     } finally {
+      // ①(修正) Qoder 审查发现：TRANSCODE_INFLIGHT.delete 原先在内层 finally ——
+      // ensureFfmpeg 失败 / materializeSource 抛错时（内层 try 未进入）不执行 →
+      // cachePath 永久残留在 inflight Map → 该源后续所有转码请求 return 已 reject
+      // 的 promise → 永久转码失败（用户实测"装了 ffmpeg 也没用/黑屏"）。
+      // 移到外层 finally：任何路径都必定清理。
+      TRANSCODE_INFLIGHT.delete(cachePath);
       TRANSCODE_ACTIVE--;
       const next = TRANSCODE_WAITERS.shift();
       if (next) next();
@@ -967,15 +1081,20 @@ function handleTranscodeProgress(req, res) {
   try {
     const url = new URL(req.url || '', 'http://localhost');
     const file = (url.searchParams.get('file') || '').trim();
+    const srcParam = (url.searchParams.get('src') || '').trim();
     const fps = Number(url.searchParams.get('fps')) || 0;
+    const maxWRaw = Number(url.searchParams.get('maxW'));
+    const maxW = Number.isFinite(maxWRaw) && maxWRaw > 0 ? Math.min(3840, Math.round(maxWRaw)) : 0;
     let job = null;
-    if (file) {
-      const src = resolveTranscodeSource(file);
-      if (src) {
-        const srcPath = src.type === 'file' ? src.path : src.rec.path;
-        const srcId = src.type === 'mpkg' ? 'mpkg:' + src.rec.path + ':' + src.entry.index : srcPath;
-        job = transcodeJobs.get(srcId + '|' + fps) || null;
-      }
+    // ②(fix) src 优先（与 /transcode 同款）：客户端回退原片后轮询转码完成，
+    // 用原始 image 串查询（旧式 file 兼容保留）。
+    const src = srcParam ? resolveTranscodeByImage(srcParam) : resolveTranscodeSource(file);
+    if (src) {
+      const srcPath = src.type === 'file' ? src.path : src.rec.path;
+      const srcId = src.type === 'mpkg' ? 'mpkg:' + src.rec.path + ':' + src.entry.index : srcPath;
+      // ①(Qoder 审查 R7) 查询 key 与写入一致（含 maxW）——此前写入
+      // srcId|fps|maxW、查询 srcId|fps，设了 maxW 的任务进度永远查不到(idle)。
+      job = transcodeJobs.get(srcId + '|' + fps + '|' + maxW) || transcodeJobs.get(srcId + '|' + fps) || null;
     } else if (ffmpegDownloadProgress) {
       job = { phase: 'downloading', percent: ffmpegDownloadProgress.total > 0 ? Math.min(99, Math.round(ffmpegDownloadProgress.downloaded / ffmpegDownloadProgress.total * 100)) : 0, updatedAt: ffmpegDownloadProgress.updatedAt };
     } else {
@@ -2051,9 +2170,41 @@ function apply(ctx) {
           // ①(新) src 优先（client 播放路径直接传原 image 串）；旧式 file/token 兼容保留。
           const src = srcParam ? resolveTranscodeByImage(srcParam) : resolveTranscodeSource(file || token);
           if (!src) { json(res, 404, { ok: false, error: 'unknown source' }); return; }
+          // ②(fix) 用户实测：60fps 源 + fpsCap=60 仍走重编码 → 白屏（Android 单线程
+          // 转 4K 100s 极慢），切回无限制时后台 ffmpeg 还在跑 → 卡。
+          // 先探测源 fps/分辨率：`fps >= 源fps 且 maxW(或 0=不限制) >= 源宽` →
+          // 上限没低于源规格 → **无需转码，直接 serveRange 原片**（零延迟）。
+          const probe = probeVideoSource(src);
+          if (probe && fps >= probe.fps && (maxW === 0 || maxW >= probe.width)) {
+            if (src.type === 'file') {
+              serveRange(req, res, src.path, 'video/mp4');
+              return;
+            }
+            // mpkg 容器内条目：materialize 提取临时文件 serveRange，流结束后清理
+            try {
+              const mat = materializeSource(src, transcodeCacheDir());
+              const orig = mat.file;
+              const origCleanup = mat.cleanup;
+              const origRes = res;
+              origRes.on('close', () => { try { if (origCleanup) origCleanup(); } catch {} });
+              serveRange(req, res, orig, 'video/mp4');
+              return;
+            } catch (err) {
+              // materialize 失败 → 落回转码路径（或 404）
+            }
+          }
           let out = null;
           let transcodeErr = null;
+          // ②(fix) 客户端断开（切回无限制/换壁纸/关页）→ 取消进行中的转码：
+          // 否则后台 ffmpeg 继续跑满 CPU（用户实测"60 帧停留后切无限制特别卡"）。
+          // 默认 MAX_ACTIVE=1 时同时只有一个 ffmpeg，kill 全部活动进程安全；
+          // MAX_ACTIVE>1 时仅 kill 本请求启动的（通过任务级 proc 标记，见下）。
+          let reqAborted = false;
+          const onAbort = () => { reqAborted = true; try { for (const proc of ACTIVE_FFMPEG) { try { proc.kill(); } catch {} } } catch {} };
+          res.on('close', () => { if (!out) onAbort(); });
+          req.on('aborted', onAbort);
           try { out = await transcodeToFps(src, fps, maxW); } catch (err) { transcodeErr = err; } /* 转码失败 → 回退原片 */
+          if (reqAborted) return; // 客户端已断开，不再写响应
           if (!out) {
             json(res, 502, { ok: false, error: String(transcodeErr && transcodeErr.message || transcodeErr || 'transcode failed') });
             return;

package/package.json

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