把 Wallpaper Engine 的动态壁纸搬进 DeepSeek Harness 的对话界面：Scene / Web 壁纸实时渲染、视频壁纸直接播放，再配上 iOS 风格的液态玻璃、自定义字体与光标。
本文基于 Windows + DeepSeek Harness 桌面版（0.2.1-rc.2） 整理，命令与文件路径都实际核对过。
不想看长文？三行速通：
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@1.3.3
# 然后彻底退出应用再重新打开
# 左下角头像 → 设置 → Wallpaper Engine → 壁纸库关键点只有一个：profile 必须是
desktop，装到web里桌面版是不认的。
一、先看效果
插件做的是一件事：给 DSH 网页界面加一层壁纸和玻璃质感。装上之后：
对话区背后是 Wallpaper Engine 里你收藏的壁纸，Scene 壁纸是真的在动（粒子、鼠标交互、音频反应）；
整个界面变成液态玻璃：设置窗口、对话框、侧边栏都可以单独调模糊、透明度、边框；
设置里多出「Wallpaper Engine」一栏，里面有壁纸库、外观、字体、吉祥物、轮播等页签。
📷 配图建议：装好之后截一张「设置 → Wallpaper Engine → 壁纸库」的图放在这一段，比文字更有说服力。
二、下载与获取
当前最新版：1.3.3
如果你想手动下载安装包（不走 npm 命令）：
https://registry.npmjs.org/dsh-plugin-wallpaper-engine/-/dsh-plugin-wallpaper-engine-1.3.3.tgz注意：0.6.1 是旧版本（发布于 1.x 之前）。0.6.1 的 Scene 壁纸只能截静态帧，而 1.3.3 用内置引擎实时渲染，功能差距很大。照着旧教程装 0.6.1 会很失望，建议直接用 1.3.3。
三、环境要求
DeepSeek Harness 内核 ≥ 0.1.5-rc.1（以 npm 包
engines声明为准；官方桌面端与 DSH Desktop 2.0.7+ 均满足）Node.js ≥ 18（DSH 自带运行时，一般不用自己装）
Wallpaper Engine（Steam 应用 431960）：可选。没有也能用，插件支持上传自定义图片 / 视频当壁纸
四、安装方法 A：应用内插件面板（推荐普通用户）
打开 DSH 桌面版，点击左下角头像。
在菜单里点 插件（页面标题是「插件」，副标题「安装、启用和配置插件」）。
点右上角 ＋ 添加插件。
在输入框里填包名：
dsh-plugin-wallpaper-engine确认安装，等待进度条走完。
完全退出应用再重新打开（不是刷新页面，是彻底关掉进程）。
一定要「彻底退出」：插件的主进程部分只在应用启动时加载，刷新网页没用。
五、安装方法 B：命令行（推荐进阶用户 / 排错）
DSH 自带了一个插件命令，本质是调用 pnpm：
# 装最新版
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@1.3.3
# 或者不锁版本
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine
# 指定旧版本（不推荐）
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@0.6.1⚠️ 坑 1：profile 名字必须是 desktop，不是 web
这是最容易踩的坑。DSH 有两套配置：
装进 web，桌面版应用里永远不会出现这个插件——设置里怎么找都没有 Wallpaper Engine。
验证一下当前装在哪：
dsh plugin --profile desktop list
dsh plugin --profile web list⚠️ 坑 2：pnpm 不在 PATH
如果你在应用内点安装，插件面板的日志里只有一行：
Command failed with exit code 1: pnpm add dsh-plugin-wallpaper-engine大概率是系统 PATH 里没有 pnpm（桌面版是自带运行时的，但插件面板沿用了系统 PATH）。解决办法就是改用上面的命令行方式，或者把 DSH 自带的 pnpm 目录加进 PATH。
⚠️ 坑 3：装完必须重启应用
装完不重启，等于没装。重启后再看设置。
六、验证是否装好
命令行验证
dsh plugin --profile desktop list应该能看到：
dependencies:
└── dsh-plugin-wallpaper-engine@1.3.3文件验证
~/.dsh/profiles/desktop/package.json里面应该同时有两处记录：
{
"dependencies": {
"dsh-plugin-wallpaper-engine": "1.3.3"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-plugin-wallpaper-engine"
]
}
}
}依赖和 bundles 缺一不可：前者管下载，后者管加载。用命令行安装会自动写入这两处；手动改文件的话别漏了 bundles。
界面验证
重启后：头像 → 设置，左侧列表里应该多出一项 Wallpaper Engine（在「Agent 预设」下面）。
📷 配图建议：这里放一张设置窗口左侧列表的截图，把 Wallpaper Engine 那一项标个红框。
七、打开壁纸库
左下角头像 → 设置（快捷键
Ctrl + ,）左侧选 Wallpaper Engine
切到 壁纸库 页签，点「选择壁纸」
挑一张，点应用；右键/悬浮可以看壁纸属性（颜色、开关、滑块）
修改即时生效，并保存在宿主端，不会因为换浏览器丢配置。
八、常见问题
Q：设置里没有 Wallpaper Engine 这一项？
按顺序排查：
是不是装进了
web配置（见坑 1）；装完有没有彻底重启应用；
~/.dsh/profiles/desktop/package.json里bundles数组有没有这个包名；还是不行就看应用日志，通常是版本不匹配（内核太旧）。
Q：Scene 壁纸是黑屏 / 只有一张静态图？
动态渲染依赖 WebGL，显卡驱动太旧会降级成静态帧；
部分工坊壁纸用了特殊脚本，降级属于正常现象；
可以在设置里换成视频壁纸对比一下，排除壁纸本身的问题。
Q：装完感觉变卡 / 费电？
插件默认有「遮挡暂停」，窗口被挡住时会暂停渲染。省电可以在设置里降低帧率上限、关闭视差和粒子效果。
Q：能装在 macOS / Linux 上吗？
同一个包、同一条命令，三平台通用。但 Wallpaper Engine 官方只有 Windows 版，macOS / Linux 上需要用「自定义壁纸」上传图片或视频，或者把目录指向含有 WE 项目的文件夹。
Q：要重装系统 / 换电脑怎么办？
把 ~/.dsh/profiles/desktop 整个目录带走即可，插件和配置都在里面（壁纸文件本身还在原来的 WE 目录，需要一起迁移）。
九、更新、回滚与卸载
更新到最新版
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@latest更新完同样要重启应用。
回滚到旧版本
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@0.6.1卸载
dsh plugin --profile desktop remove dsh-plugin-wallpaper-engine卸载后重启应用，界面会恢复成默认样子，壁纸文件不受影响。
十、许可与致谢
项目基于 MIT License 开源，作者 elysia395
实时场景渲染由内置的 MIT 开源引擎 WebWallGL 提供
如果这个插件帮到了你，去仓库点个 Star 就是最好的支持