wallpaper-engine-dsh 2.1.1 → 2.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | [中文](README.zh.md)
 
-A DSH bundle that turns your local **Wallpaper Engine** library into the live background of the DSH web GUI (`dsh web`). Video wallpapers play behind the chat, web wallpapers render in place, and everything in between — crossfade transitions, liquid-glass panels, a legibility veil that adapts to any wallpaper, manual framing, rotation lists, search, and a bilingual UI — is controlled from a single settings row.
+A DSH bundle that turns your local **Wallpaper Engine** library into the live background of the DSH web GUI (`dsh web`). Video wallpapers play behind the chat, web wallpapers render in place, and everything in between — crossfade transitions, liquid-glass panels, a legibility veil that adapts to any wallpaper, manual framing, rotation lists, search, and a bilingual UI — is controlled from its own dedicated settings section.
 
 ## Features
 
@@ -35,7 +35,7 @@ git clone https://github.com/Weilv-D/wallpaper-engine-dsh.git
 dsh plugin --profile web add link:<absolute path to the cloned folder>
 ```
 
-Restart `dsh web`, then open **Settings → General → Wallpaper Engine**.
+Restart `dsh web`, then open **Settings → Wallpaper Engine**.
 
 ## Usage
 
@@ -73,6 +73,7 @@ Media serving is defensive by design: tokens are unguessable 72-bit values, stab
 - Scene and application wallpapers are not listed: they are Wallpaper Engine's private `.pkg` scene packages, and their live animation can only be rendered by Wallpaper Engine itself on the desktop.
 - Web wallpapers run isolated from the page's storage, so ones that persist state across loads won't keep it.
 - Web wallpapers with sound may stay silent until you interact with the page — browsers gate audio in sandboxed documents on a user gesture, and wallpapers that rely on Wallpaper Engine's system-audio feed (visualizers) have no signal to draw from.
+- Video codecs are bounded by what the browser can decode. H.264/AVC, VP8/VP9, and AV1 play natively; workshop videos compressed with H.265/HEVC cannot be software-decoded on most machines — previously a solid black screen, now detected as "playing but zero decoded frames" and automatically demoted to the preview still with a status note. Transcoding to H.264 mp4 or VP9 webm restores full playback.
 - The glass effect reads DSH design tokens; if a future shell redesign renames them, frosting degrades to plain transparency.
 
 ## Development

package/README.zh.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | [中文](README.zh.md)
 
-一个 DSH bundle:把本机 **Wallpaper Engine** 壁纸库变成 DSH web GUI(`dsh web`)的动态背景。视频壁纸在聊天界面背后播放,网页壁纸直接渲染。交叉淡入、液态玻璃面板、随壁纸自适应的可读性遮罩、手动取景、轮播列表、搜索与中英双语界面,全部集中在一个设置行里。
+一个 DSH bundle:把本机 **Wallpaper Engine** 壁纸库变成 DSH web GUI(`dsh web`)的动态背景。视频壁纸在聊天界面背后播放,网页壁纸直接渲染。交叉淡入、液态玻璃面板、随壁纸自适应的可读性遮罩、手动取景、轮播列表、搜索与中英双语界面,集中在一个专门的设置分区里。
 
 ## 功能
 
@@ -35,7 +35,7 @@ git clone https://github.com/Weilv-D/wallpaper-engine-dsh.git
 dsh plugin --profile web add link:<克隆文件夹的绝对路径>
 ```
 
-重启 `dsh web`,打开 **设置 → 通用 → 壁纸背景 (Wallpaper Engine)**。
+重启 `dsh web`,打开 **设置 → 壁纸背景 (Wallpaper Engine)**。
 
 ## 使用
 
@@ -73,6 +73,7 @@ bundle 分为两半:
 - 场景与应用壁纸不出现在列表中:它们是 Wallpaper Engine 私有的 `.pkg` 场景包,动态渲染只能由桌面端的 Wallpaper Engine 完成。
 - 网页壁纸与页面存储隔离,需要跨加载保存状态的壁纸无法保留状态。
 - 带声音的网页壁纸可能在你与页面交互前保持静默——浏览器对沙箱文档的音频有自动播放限制;依赖 Wallpaper Engine 系统音频输入的壁纸(如音频可视化)在浏览器中没有信号可画。
+- 视频编码受浏览器解码能力约束。浏览器可以直接播放 H.264/AVC、VP8/VP9 与 AV1;创意工坊中用 H.265/HEVC 压缩的视频在多数机器上无法软解——之前表现为只有一片黑色,现在检测到「声称在播放但解不出任何帧」时会自动降级为预览图并在状态行说明。手工转码为 H.264 的 mp4 或 VP9 的 webm 即可完整播放。
 - 玻璃效果读 DSH 设计令牌;若未来外壳重构重命名令牌,磨砂会退化为普通半透明。
 
 ## 开发

package/lib/client.js

@@ -729,32 +729,64 @@ window.__ModuleLoader__.load({
 		  });
 		}
 
+		function handleMediaFailure(sel) {
+		  const id = sel.id;
+		  const count = (mediaFailures.get(id) || 0) + 1;
+		  mediaFailures.set(id, count);
+		  const w = selection.inventory.wallpapers.find((x) => x.id === id);
+		  if (count === 1) {
+		    // Maybe just a dead token: refetch fresh URLs and remount. Throttled
+		    // PER WALLPAPER - a global window would strand a video whose first
+		    // error lands soon after an unrelated recovery (no remount, no second
+		    // error, blank layer until a manual refresh).
+		    const now = Date.now();
+		    if (now - (lastRecoveryAt.get(id) || 0) < 10000) return;
+		    lastRecoveryAt.set(id, now);
+		    forceRemount = true;
+		    loadInventory(true);
+		  } else if (w && w.preview && !demotedToPreview.has(id)) {
+		    // The media itself is unusable here - fall back to the still preview.
+		    demotedToPreview.add(id);
+		    applySelection(id);
+		  } else {
+		    // Unrenderable here with no preview to fall back on (or the entry has
+		    // vanished from the inventory entirely): clear the selection rather
+		    // than leave a dead element on the layer.
+		    applySelection("");
+		  }
+		}
+
 		function attachMediaError(media, sel) {
-		  media.addEventListener("error", () => {
-		    const id = sel.id;
-		    const count = (mediaFailures.get(id) || 0) + 1;
-		    mediaFailures.set(id, count);
-		    const w = selection.inventory.wallpapers.find((x) => x.id === id);
-		    if (count === 1) {
-		      // Maybe just a dead token: refetch fresh URLs and remount. Throttled
-		      // PER WALLPAPER — a global window would strand a video whose first
-		      // error lands soon after an unrelated recovery (no remount, no second
-		      // error, blank layer until a manual refresh).
-		      const now = Date.now();
-		      if (now - (lastRecoveryAt.get(id) || 0) < 10000) return;
-		      lastRecoveryAt.set(id, now);
-		      forceRemount = true;
-		      loadInventory(true);
-		    } else if (w && w.preview && !demotedToPreview.has(id)) {
-		      // The media itself is unusable here — fall back to the still preview.
-		      demotedToPreview.add(id);
-		      applySelection(id);
-		    } else {
-		      // Unrenderable here with no preview to fall back on (or the entry has
-		      // vanished from the inventory entirely): clear the selection rather
-		      // than leave a dead element on the layer.
-		      applySelection("");
-		    }
+		  media.addEventListener("error", () => handleMediaFailure(sel));
+		  if (sel.type === "video") attachZeroFrameDetector(media, sel);
+		}
+
+		// Zero-decoded-frames detector: Chromium can report a video as PLAYING
+		// without ever decoding a frame - no error event, currentTime advancing,
+		// picture permanently black. Typical with HEVC/H.265 content when the
+		// machine has no usable hardware decode. getVideoPlaybackQuality exposes
+		// the truth (totalVideoFrames stays 0); a genuinely dark wallpaper is
+		// unaffected because its frames DO decode. Wired into the same recovery
+		// ladder as a media error: first hit retries with fresh tokens, second
+		// hit demotes to the preview still (or clears without one).
+		function attachZeroFrameDetector(media, sel) {
+		  media.addEventListener("playing", () => {
+		    // One probe ~2s into claimed playback: enough for even a slow
+		    // hardware pipeline to produce its first frames.
+		    schedule(() => {
+		      // Stale guard: crossfade may have swapped the element out already,
+		      // and the probe must never run while the user paused playback.
+		      const layer = document.getElementById(LAYER_ID);
+		      if (!layer || layer.querySelector("video") !== media) return;
+		      if (media.paused || !(media.currentTime > 0)) return;
+		      const q = typeof media.getVideoPlaybackQuality === "function"
+		        ? media.getVideoPlaybackQuality() : null;
+		      const frames = q ? q.totalVideoFrames
+		        : (typeof media.webkitDecodedFrameCount === "number"
+		          ? media.webkitDecodedFrameCount : null);
+		      if (frames === null) return; // no probe available -> cannot detect
+		      if (frames === 0) handleMediaFailure(sel);
+		    }, 2000);
 		  });
 		}
 
@@ -2076,7 +2108,7 @@ window.__ModuleLoader__.load({
 		  /* padding-top lifts the first row off the settings-section divider so the
 		     search/language row breathes; gap keeps every row evenly spaced.
 		     Type scale follows the shell: 14px body → 13px controls → 12px hints. */
-		  .webg-picker { display: flex; flex-direction: column; gap: 12px; padding-top: 10px; }
+		  .webg-picker { display: flex; flex-direction: column; gap: 12px; padding-top: 10px; max-width: 900px; }
 		  .webg-row { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
 		  .webg-hint { font-size: 12px; opacity: 0.7; color: var(--dsw-alias-label-tertiary, inherit); }
 		  .webg-error {
@@ -2298,7 +2330,7 @@ window.__ModuleLoader__.load({
 
 		// ── Plugin exports ──────────────────────────────────────────────────────────
 		// The client runner (dsh-cordis-client-runner) rejects ctx.get() of any
-		// service this plugin does not declare. slots registers the settings row,
+		// service this plugin does not declare. slots registers the settings section,
 		// locale drives the bilingual UI, theme drives the veil/scheme reactions.
 		const inject = ["slots", "locale", "theme"];
 
@@ -2503,11 +2535,15 @@ window.__ModuleLoader__.load({
 		    });
 		  }
 
-		  // 4. Settings row (this slot is NOT the overlay; safe to register into).
+		  // 4. Own settings section — NOT a row inside General. The settings dialog
+		  //    enumerates every registered settings.section slot for its nav
+		  //    (settings-general and settings-plugins register theirs the same way),
+		  //    so the picker renders as a full page with its own sidebar entry,
+		  //    ordered after the built-in sections (general 0, plugins 15).
 		  if (ctx.slots) {
-		    ctx.slots.inject("settings.general.item", () =>
+		    ctx.slots.inject("settings.section", () =>
 		      ctx.slots.register(
-		        { name: "settings.general.item", id: "we-background", order: 500, label: () => S().settingsLabel },
+		        { name: "settings.section", id: "we-background", order: 20, label: () => S().settingsLabel },
 		        () => React.createElement(WallpaperPicker),
 		      ),
 		    );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wallpaper-engine-dsh",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Wallpaper Engine library as the DSH web GUI background — video/web/still wallpapers, rotation lists, search, resource monitor, bilingual UI.",
   "type": "module",
   "main": "lib/index.js",