dsh-plugin-wallpaper-engine

English | 中文

🆕 没用过命令行？先看这里：小白向使用指南（新手快速上手）→ —— 给完全没接触过命令行的用户准备的简化说明。

一个 DSH bundle，把你电脑上的 Wallpaper Engine 壁纸变成 DSH 网页界面（dsh web）的背景。

它会自动发现你本机的 Wallpaper Engine 安装，列出你的壁纸，并把可移植的类型渲染到 DSH 对话界面的后方，配以 iOS 风格液态玻璃效果：Video（.mp4）动态播放、Web/HTML 以 iframe 加载，Scene（场景）提取主纹理作为静态帧。v0.2 起还支持：

• 壁纸选择弹窗：缩略图网格收纳进独立弹窗，设置页不再被长列表占满；
• 隐藏 / 恢复：不想看的壁纸一键隐藏（软删除），随时恢复，不碰源文件；
• 视频倍速：0.5x – 2x 六档原生调速，即时生效、不重载；
• 水平翻转：镜像画面（视频 / 网页 / 上传图片均适用）；
• 自定义壁纸：直接上传本地 JPG / PNG / MP4 当壁纸，可选存储位置与画面适配模式；
• 场景壁纸静态帧（v0.3）：Scene 壁纸提取主纹理作为静态背景，不再只是"不可播放"的占位。
• 液态玻璃设置页（v0.3.1）：设置页升级为一级设置页（参照 dsh-web-ui-all 皮肤中心的设计），整页是可自定义的液态玻璃卡片 —— 配色（6 种预设 + 自定义取色）与玻璃透明度（0–60%）即时生效、持久保存。
• 整个设置窗口液态玻璃化（v0.3.2）：一键把 DSH 原生设置窗口整体（对话框 + 左侧导航 + General / 模型 / 插件等全部原生分区）换成液态玻璃 + 自定义配色 —— 开启「设置窗口液态玻璃」开关后，窗口背景、导航选中/悬停、按钮、开关、链接等全部跟随 配色 与 玻璃透明度，关闭则恢复原生样式。
• 玻璃调节统一（v0.3.3–v0.3.5）：设置窗口的玻璃模糊与对话栏共用同一套调节参数（「玻璃」滑动条 0–60 px 同时控制设置窗口与输入栏/气泡的模糊半径，饱和度/亮度/对比度配方一致）；新增「玻璃颜色」—— 设置窗口玻璃的底色色调可自定义（6 预设 + 自定义取色，默认浅色白 / 深色深夜蓝，选定后两种主题统一使用该色），与「配色」（交互元素）分工：配色管控件、玻璃颜色管玻璃本身。
• 设置持久化到宿主端文件（v0.4.0）：全部设置（已选壁纸、配色、透明度、布局、轮播、隐藏、倍速/翻转等）改存 ~/.dsh-wallpaper-engine/config.json，不再依赖浏览器 localStorage —— 重启、换端口（含 DSH Desktop 的随机端口）、清浏览器数据、换浏览器都不再丢失；旧版 localStorage 配置首次启动自动迁移。
• Edge 兼容渲染：Edge（且仅 Edge）会在页面里任何"可见的 <video>"上绘制浏览器自带的「下载 / 投屏」悬浮工具栏，且没有官方开关可以关闭；插件因此在 Edge 中默认把视频壁纸改为 canvas 渲染来规避。「紧凑布局」同一行右侧新增「Edge 兼容」开关（默认开启），关闭后所有浏览器一律回退到原生 <video>。
• 媒体流句柄修复 + 扫描提速（v0.4.1）：媒体/预览/场景帧流在客户端断开时立即释放文件句柄（修复反复切壁纸/刷新累积句柄、Windows 上壁纸文件被锁无法删除/移动的问题）；壁纸库扫描改全异步（fs.promises 线程池），不再阻塞事件循环（WSL / 大壁纸库下启动明显更快）；WSL 支持：自动探测 /mnt/<盘符> 挂载的 Windows Steam 库，WSL 里也能发现壁纸。
• 遮挡暂停（省电三档）：类似 Wallpaper Engine 的「被遮挡时暂停」——最小化 / 切页、窗口失焦、使用电池供电时自动暂停视频壁纸，解码引擎直接归零；回到界面 / 接通电源自动继续（网页壁纸仅随页面隐藏被浏览器节流）。三档开关均持久保存。
• 解码帧率上限（抽帧转码）：高帧率源（如 4K120 H.264）的硬解是 GPU 占用大头（4060 实测 1.0x 达 ~60% Video Decode）。「壁纸效果」区设置 帧率上限（无限制 / 60 / 48 / 30 / 24 fps），宿主端用 ffmpeg 一次性重编码为上限帧率（时间线保持 1.0x 正常速度、与倍速完全解耦），输出 4K 保留 + AV1，带下载 / 转码实时进度条；实测 4K120→24fps 后占用从 ~60% 降至 ~15%。ffmpeg 三档供给：显式指定 → 自动下载（npmmirror + GitHub 双源竞速，跨平台资产表已验证）→ 系统 PATH。

壁纸 + 磨砂遮罩 + iOS 液态玻璃，渲染在 DSH 界面后方。

支持哪些壁纸类型？

Wallpaper Engine 的壁纸分四种类型：

类型	由谁渲染	能否搬到 DSH
Scene（场景）	Wallpaper Engine 自带的 3D 引擎	✅ 静态帧 — 提取主纹理（.pkg/.json 内的 .tex/JPEG），见下文
Video（视频）	就是一个 .mp4 文件	✅ 能 — 在 <video> 标签里播放
Web（网页）	WE 内置的 Chromium 壳（webwallpaper64.exe）承载 HTML	✅ 能 — 在 <iframe> 里加载
Application（应用）	注入的外部窗口	❌ 不能

Scene 壁纸的 3D 场景（shader/粒子/几何）本身无法在浏览器里重放，但它的主纹理（通常是背景艺术图）可以提取出来作为静态帧背景——对摄影类、插画类场景壁纸效果接近原图。选择器里场景卡片带有「静态帧」徽标，可与动态壁纸区分。

展现效果：大部分场景壁纸都能有较好的静态帧展现（本机实测约 80%+ 的 Scene 壁纸能提取出接近原图的彩色主图，尤其摄影、插画、动画截图类）；少部分无法正常展示，包括纯 shader 粒子/程序生成类场景（没有可提取的主纹理）、使用特殊纹理格式（如 BC7）的场景、以及以视频纹理驱动的动画场景——这类会自动回退显示工坊预览图（preview.jpg），属预期行为，不视为缺陷。

场景静态帧：怎么工作的

…