前言¶
DSH 的插件机制允许在 Web 界面中扩展能力。对 dsh web 来说，背景通常由宿主样式决定；如果希望把 Wallpaper Engine 的 .mpkg、Steam 创意工坊原始目录、本地视频/网页/图片作为背景，就需要一个专门处理背景加载和外观适配的插件。
下面介绍 dsh-mpkg-wallpaper。
这是什么¶
dsh-mpkg-wallpaper 是 XHR666 维护的 DSH Web 壁纸引擎插件，用于给 DeepSeek Harness Web 界面（dsh web）添加背景壁纸。它把 Wallpaper Engine .mpkg 解析、Steam 创意工坊原始目录发现、视频/网页/图片壁纸、时间变化壁纸、虚化、主题外观、本地壁纸库、轮换、播放控制、设置持久化和更新检查放在一个插件里。
- 仓库：GitHub: XHR666/dsh-mpkg-wallpaper
- 许可证：
MIT - 运行环境：
node >=20
核心能力¶
壁纸来源¶
.mpkg：在浏览器内直接解析，不上传第三方。- Steam 创意工坊原始目录：自动发现，支持
video、web、scene类型。 - 普通壁纸：支持视频、网页、图片/GIF/URL 壁纸加载。
时间变化壁纸¶
支持时间变化壁纸的多时段自动切换，也支持手动锁定某个时段。
虚化与外观¶
- 统一虚化控制整屏背景模糊。
- 对话框、设置面板、弹层、遮罩、侧边栏等可独立控制虚化。
- 提供主题颜色、统一雾、面板匹配壁纸色等玻璃外观能力。
- 液态玻璃仍为实验性功能，默认全关，不建议日常启用。
壁纸库与轮换¶
支持本地壁纸库、自定义目录、壁纸切换与定时轮换。可以使用上一个/下一个切换壁纸，也可以设置定时自动轮换。
播放控制与省电¶
- 视频/网页壁纸支持暂停/播放控制。
- 调整无关设置不触发重播。
- 可开启页面隐藏时暂停、窗口失焦时暂停、电池供电时暂停三档省电策略。
大文件播放¶
支持大文件 hybrid 模式流式播放，支持大于 600MB 的文件。
设置与更新¶
- 设置会持久化到浏览器
localStorage与~/.dsh-mpkg-wallpaper/settings.json。 - 支持导出/导入外观类设置 JSON 文件，用于备份与恢复。
- 支持「检查更新」按版本号对比，以及「一键更新」从 GitHub 拉最新代码并重启生效。
- 可检测并适配
dsh-better-sidebar。
安装与启用¶
已核实资料未给出官方安装命令，本文不拼接安装命令。启用前请先查看仓库说明或插件目录说明，并确认运行环境满足：
node >=20
由于插件会在 DSH 的 Web 界面中执行本地逻辑，安装前应检查源码、依赖和许可证。
典型用法¶
1、进入设置页后，可在「可调参数」折叠区查看 .mpkg 的只读参数；部分网页壁纸的分辨率、语言、音量等参数可在同一折叠区修改。
2、当前壁纸为视频或网页壁纸时，点击设置页的暂停/播放按钮控制画面；调整无关设置不会重播。
3、在「其他」tab 中开启页面隐藏时暂停、窗口失焦时暂停、电池供电时暂停。
4、在「其他」tab 中导出或导入外观类设置 JSON 文件。
5、使用上一个/下一个切换壁纸，或设置定时自动轮换。
6、使用「检查更新」按版本号对比，或使用「一键更新」从 GitHub 拉最新代码并重启生效。
适用场景与注意¶
适合想在 dsh web 中使用 Wallpaper Engine 壁纸、本地视频/网页/图片背景，并需要控制虚化、主题外观、轮换和省电策略的用户。
注意：
- 网页壁纸（HTML）为实验性，部分依赖外网 SDK/特殊交互逻辑的壁纸未完全适配。
Application（.exe）壁纸被完全排除，用于防病毒注入。- 场景壁纸无法在 Web 端完整还原，仅提供静态帧提取或图层合成折中方案。
- 浏览器兼容性参考：Chrome/Edge 推荐；Firefox/移动端可能受自动播放策略、性能或 API 支持限制。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
获取¶
GitHub 仓库：https://github.com/XHR666/dsh-mpkg-wallpaper
目录页 URL 未在已核实资料中出现；社区目录属于独立站点，与 DeepSeek / 幻方无官方从属关系，不应视为官方应用商店。
