dsh-wallpaper-engine（壁纸引擎背景，elysia395/dsh-wallpaper-engine）把本机 Wallpaper Engine 的壁纸搬到 dsh web 的对话界面后方固定图层上，再配一层 iOS 风格液态玻璃。它已在 dsh 0.2.0-rc.2 下完成真实安装验证；但装得上不等于出得了画，从安装到出帧之间隔着包管理器、宿主形态判定、ffmpeg 供给链和窗口底板四道关。下面按症状排四个坑，每个都给出现象、成因和能落地的处置。想先对照同类插件的中文清单与安装形态，见 完整插件清单与汉化避坑指南。
装不上
坑一：安装命令报错退出，插件根本没进到设置页。症状。执行dsh plugin --profile web add dsh-plugin-wallpaper-engine时直接失败，抛出ERR_PNPM_UNEXPECTED_VIRTUAL_STORE一类的包管理器错误。成因。这类安装失败有一套专门的逐步处置流程，但它写在docs/TROUBLESHOOTING.md里，不在 README 正文；而 npm 包只带三份 README，docs/目录不随包发布，所以照着 npm 包里的提示翻是翻不到这份文档的。处置。到源码仓库https://github.com/elysia395/dsh-wallpaper-engine的同名路径，直接读docs/TROUBLESHOOTING.md，按里面的步骤逐条走。动手前先备份~/.dsh配置——dsh 与插件都处于 developer-preview 阶段，出问题好回滚。
网页壁纸 403
坑二：视频壁纸正常，网页壁纸却加载失败。症状。在「壁纸库」里点选网页（Web）类壁纸，画面出不来，请求被 403 挡掉；换成视频或场景壁纸却照常显示。成因。问题出在「高级」页签的适配目标上。适配段会按请求头与 UA 自动识别你跑在原生浏览器 / 非官方桌面端 / 官方桌面端哪一种形态里（观测到能力头x-dsh-desktop-renderer⇒ 非官方桌面端；UA 含Electron/⇒ 桌面壳；两者皆无 ⇒ 原生浏览器）。手选与自动检测冲突时就会坏：手选了「浏览器」，但宿主实际观测到了能力头栅栏，网页壁纸就会 403。处置。只在自动检测不准时才手选——手选优先于检测；一旦面板给出冲突警示，就按警示把手动覆盖去掉、回退到检测结果。冲突时面板会把后果直接说明，那一行别忽略。
帧率上限整个消失
坑三：翻遍「效果」页签也找不到帧率上限。症状。高帧率视频壁纸卡顿，想用帧率上限降载，却发现这一档根本不存在，功能像被整体关掉了。成因。帧率上限靠 ffmpeg 一次性转码实现，整条能力都挂在 ffmpeg 的供给上。ffmpeg 有三档供给：显式指定（环境变量DSH_WE_FFMPEG，或插件目录下的ffmpeg/）→ 自动下载（npmmirror 与 GitHub 双源竞速，校验后缓存）→ 系统 PATH。只有连这三档都拿不到（含自动下载不可用，例如 musl / Alpine 这类未覆盖平台）时，该功能才会自动关闭。处置。想用就自己把 ffmpeg 补上：设好DSH_WE_FFMPEG指向可执行文件，或把二进制放进插件目录的ffmpeg/，这档优先级最高。拿不到就别硬开——此时壁纸保持原片播放，不影响其它任何功能。另外，无 NVIDIA 显卡时编码器会回落到libx264软件编码，慢但能出片，对无独显机器要有预期。
最小化还原时闪白
坑四：桌面端最小化再还原，会闪一下白。症状。在桌面壳里把窗口最小化再还原，能看到极短的一帧白。成因。壁纸激活期间，插件会给根元素垫一层不透明的壁纸代表色，这样「壁纸层的像素没送到屏上」会退化成同色底而不是白闪；但窗口连一帧都没有可提交的那一瞬，露出来的是桌面壳的窗口底板——Windows 上 BrowserWindow 用的是默认底板色即白色，壳侧只给 macOS 设了透明底板。处置。这一条要壳侧配合，插件侧改不动，不要指望在设置的哪一项里调掉它。原生浏览器形态不吃壳层材质，用浏览器直接访问时不存在这个问题，可以据此绕开。
总结
四个坑的共同点是：都不是插件坏了，而是前提与供给链没对齐——安装失败去仓库读docs/TROUBLESHOOTING.md，403 先看适配目标的手选与检测是否冲突，帧率上限消失先补 ffmpeg，闪白则要等壳侧修。想横向对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。
适合与不适合
适合：本机已有 Wallpaper Engine、想把 Steam 壁纸库搬进 dsh web 的人；遇到安装或出图故障、需要按症状定位的排障者；愿意手动补一个 ffmpeg 换取帧率上限降载的高帧率视频壁纸用户；习惯用浏览器直接访问 dsh web、不受桌面壳白帧影响的用户。
不适合：没有 Wallpaper Engine 客户端、又不想自备工程目录或上传图片 / 视频的场景，此时根本没有壁纸库可用；依赖 Application（应用）类壁纸的场景，该类完全不支持；拿不到 ffmpeg 的平台，帧率上限会整体关闭；以及只用桌面壳、对最小化闪白零容忍的场景——这一条插件侧修不了。
标签：壁纸引擎背景、DeepSeek Harness、故障排查、dsh 插件、排错速查
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
