本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-wallpaper-engine

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-plugin-wallpaper-engine

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 壁纸选择弹窗：缩略图网格收纳进独立弹窗，设置页不再被长列表占满；
• 隐藏 / 恢复：不想看的壁纸一键隐藏（软删除），随时恢复，不碰源文件；
• 视频倍速：0.5x – 2x 六档原生调速，即时生效、不重载；
• 水平翻转：镜像画面（视频 / 网页 / 上传图片均适用）；
• 自定义壁纸：直接上传本地 JPG / PNG / MP4 当壁纸，可选存储位置与画面适配模式；

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

macOS 用户能用吗？

这个插件主要面向 Windows，因为 Wallpaper Engine 客户端本身就是 Steam 上的 Windows 应用。macOS 端有社区维护者 Jerry 单独维护的衍生包 dsh-plugin-wallpaper-engine-mac。

选中的壁纸为什么看起来不像在动？

如果你选的是「场景」类型，浏览器无法重放 Wallpaper Engine 自带的 3D 引擎，插件会从 .pkg 文件中提取主纹理作为静态背景展示，无法呈现 shader/粒子/动画效果；选「应用」类型则完全不显示。

设置保存后会不会丢失？

自 v0.4.0 起所有设置都改存在宿主端文件 ~/.dsh-wallpaper-engine/config.json，不再依赖浏览器 localStorage，重启、切换端口、清浏览器缓存、换浏览器都不会丢；旧版 localStorage 数据首次启动会自动迁移。

自定义壁纸会占满 C 盘吗？

默认会写到 ~/.dsh-wallpaper-engine/uploads（Windows 下通常在 C 盘用户目录下），你可以在设置里改成任意盘符的绝对路径，已有文件会自动迁移到新位置。

文字看不清怎么办？

在「壁纸效果」里把「暗化」「边框」两个滑动条调高，必要时再加点「壁纸模糊」；颜色鲜艳或花纹复杂的壁纸可能还需要在 DSH 的浅色/深色主题之间切换以获得最佳对比度。

怎么完全卸载或重置？

在设置里删除已上传的自定义壁纸，然后删除 ~/.dsh-wallpaper-engine 目录（包括 config.json、uploads 和 cache 子目录），再用 dsh plugin --profile web remove 卸载插件即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: 未声明
• Platforms: Windows

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则