前言¶
DSH Web 界面默认的背景通常较为简单。对于希望利用本地 Wallpaper Engine 资源的开发者或用户，需要一个方案将动态壁纸无缝集成到 dsh web 的后台。该插件通过宿主与客户端的协作，实现了壁纸的发现、渲染与界面融合。
插件介绍¶
这是一个 DSH 插件，核心功能是将本机 Wallpaper Engine 的壁纸变成 DSH 网页界面的背景。
- 核心能力：支持 Video（直接播放）、Web（iframe 加载）、Scene（提取主纹理作为静态帧或实时渲染）三种类型。
- 维护者：elysia395。
- 开源协议：MIT。
核心功能¶
插件提供了从渲染到界面的完整控制能力：
- 实时渲染与降载：支持 Scene 和 Web 壁纸的实时渲染。具备高帧率源降载功能（转码为 4K/AV1），可降低 GPU 占用；支持遮挡暂停（最小化/失焦/电池供电时暂停）。
- iOS 风格液态玻璃界面：对设置窗口、字体、光标、吉祥物与侧边栏进行液态玻璃改造，支持配色、玻璃颜色与透明度调节。
- 壁纸管理：自动发现本机 Wallpaper Engine 安装。支持内容分级与类型过滤（全部/Everyone/PG13/Mature/未分级，全部/视频/网页/图片/场景）。支持自定义壁纸上传，具备黑胶唱片展示、视频倍速与翻转、自动轮播功能。
安装与启用¶
安装插件需要使用官方命令行工具。
- 执行安装命令：
dsh plugin --profile web add dsh-plugin-wallpaper-engine
- 安装完成后，重启
dsh web，进入 设置 即可看到 Wallpaper Engine 相关选项。
典型用法¶
- 启用壁纸：重启
dsh web并打开设置，壁纸即可被识别并使用。 - 选择壁纸：使用选择弹窗浏览壁纸缩略图并选择，支持批量隐藏与恢复。
- 控制播放：使用暂停/播放控制视频壁纸，或使用关闭清除壁纸。
- 查看进度：在设置页可以查看转码实时进度条。
注意事项¶
- 系统差异：macOS 原生没有 Wallpaper Engine 客户端，需使用社区维护的 macOS 版（如
dsh-plugin-wallpaper-engine-mac）。 - 类型限制：不支持 Application（应用）类壁纸。
- 兼容性：网页壁纸在非官方桌面壳可能导致 403 错误。
- 依赖项：依赖 ffmpeg 进行高帧率转码。
- 前置更新：安装前需更新 DSH 内核与
dsh-better-sidebar到最新版本。
结尾¶
该插件通过本地渲染与液态玻璃风格的结合，丰富了 DSH Web 界面的表现力。更多技术细节与源码请参考插件目录与 GitHub 仓库。
