dsh-wallpaper-engine

解决什么问题

DSH 的网页界面（dsh web）背景一成不变，而本机 Wallpaper Engine 里积累的壁纸只能停留在桌面上。本插件自动发现本机（含 WSL 下的 /mnt/<盘符> Steam 库）的 Wallpaper Engine 安装，列出壁纸库，把可移植的类型渲染到对话界面后方：

• Video（.mp4） 动态循环播放，支持 0.5x–2x 倍速、水平翻转、亮度/对比度/饱和度/透明度调节；
• Web（网页） 由内置 WebWallGL 挂载并注入 WE API（音频监听、属性、媒体），严格 sandbox="allow-scripts" 隔离，失败自动回退兼容 iframe；
• Scene（场景） 由内置 WebWallGL 实时 WebGL 渲染（对象树、shader、puppet 骨骼、粒子、SceneScript、鼠标视差、包内音频），失败按壁纸记忆并降级到「内嵌 MP4 → 静态帧」旧链，静态帧链解析 scene.pkg（PKGV + LZ4）自行软件光栅化兜底。

配套的体验与工程能力：

• iOS 液态玻璃：一级设置页、整机原生设置窗口（含全部分区）液态玻璃化，配色 / 玻璃颜色 / 玻璃模糊与透明度独立可调；
• 壁纸管理：缩略图选择弹窗、内容分级与类型过滤、隐藏/恢复（软删除）、自定义 JPG/PNG/MP4 上传并可指定存储位置与画面适配、紧凑 CD 架布局、黑胶唱片展示、自动轮播；
• 省电与性能：遮挡/失焦/电池供电自动暂停（解码归零）、帧率上限抽帧转码（4K120→24fps 可把 Video Decode 占用从约 60% 降到约 15%，ffmpeg 支持指定/自动下载/系统 PATH 三档供给）、媒体流句柄即时释放；
• 设置持久化：全部配置写入 ~/.dsh-wallpaper-engine/config.json，重启、随机端口、清浏览器数据均不丢失，旧 localStorage 自动迁移。

适合谁

• 已经在用 DSH 网页端 / DSH Desktop，想让对话界面不止是纯色背景的用户；
• 已有 Wallpaper Engine 素材库（Steam 创意工坊或自建项目目录），希望复用到 DSH 上的人；
• 喜欢 iOS 液态玻璃风格、需要细粒度调节 UI 外观（配色、玻璃、字体、光标颜色、壁纸效果）的折腾型用户；
• 关注性能与功耗、希望在高分辨率高帧率壁纸下控制 GPU 占用的用户。

需要注意

v0.7.2 起有更新前置条件：先把 DeepSeek Harness / DSH Desktop 更新到最新版，再把 dsh-better-sidebar 更新到 ≥0.19.0，最后更新本插件。macOS 版由 Jerry 维护。许可证 MIT。