版本 1.3.3 ｜ Windows 桌面版实测（内核 0.2.1-rc.2）｜ 可直接照做，也可用于给别人讲课
把 Wallpaper Engine 的动态壁纸搬进 DSH 的对话界面：Scene / Web 壁纸实时渲染，视频壁纸直接播放，再配上 iOS 风格的液态玻璃、自定义字体与光标。
讲师提示 · 全场只有一个关键点：profile 必须是 desktop。 装到 web 里，桌面版应用永远不会认这个插件。
一、装完能得到什么
视觉：对话区背后是 Wallpaper Engine 里收藏的壁纸，Scene 壁纸是真在动（粒子、鼠标交互、音频反应）。
质感：整个界面可以调成液态玻璃，设置窗口、对话框、侧边栏都能单独调模糊、透明度、边框。
入口：设置里多出「Wallpaper Engine」一栏，内含壁纸库、外观、字体、吉祥物、轮播等页签。
持久：配置保存在宿主端，换浏览器、清缓存都不会丢。
二、开讲前先核对环境
本次实测环境：Windows 11 + DeepSeek Harness 0.2.1-rc.2 桌面版，Node 24.21.0 / pnpm 11.28.5（均为 DSH 自带）。
三、三行速通
bash
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@1.3.3
# 然后彻底退出应用再重新打开（不是刷新页面）
# 左下角头像 → 设置 → Wallpaper Engine → 壁纸库报错就看第五节；一切顺利就跳到第六节确认重启。
四、方法 A：应用内插件面板（新手首选）
点左下角头像，在菜单里点「插件」（页面标题「插件」，副标题「安装、启用和配置插件」）。
点右上角「＋ 添加插件」。
输入包名
dsh-plugin-wallpaper-engine，确认。等进度条走完，然后彻底退出应用再打开。
常见报错：面板日志只有一行
Command failed with exit code 1: pnpm add dsh-plugin-wallpaper-engine—— 大概率是系统 PATH 里没有 pnpm（桌面版自带运行时，但插件面板沿用系统 PATH）。改用方法 B。
五、方法 B：命令行（进阶 / 排错都用它）
5.1 先确认配置装在哪
bash
dsh plugin --profile desktop list
dsh plugin --profile web list两条命令分别对应桌面版和 dsh web 起的网页版。桌面版应用只认 desktop。
5.2 执行安装
bash
# 锁定版本（推荐，教程与别人一致）
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@1.3.3
# 或跟随最新版
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@latest成功后输出类似 Packages +6、dependencies: + dsh-plugin-wallpaper-engine 1.3.3（本次实测约 26 秒）。
5.3 坑：pnpm 不在 PATH 怎么办
dsh plugin 本质是把参数转发给 pnpm，所以 pnpm 必须能被 shell 找到。桌面版其实自带了一套运行时，把它的目录临时加进 PATH 即可：
powershell
# PowerShell 示例：<DSH安装目录> 换成实际路径
$rt = "<DSH安装目录>\resources\runtime\primary-runtime\dependencies"
$env:PATH = "$rt\node\bin;$env:PATH"
& "$rt\node\bin\node.exe" "$rt\pnpm\bin\pnpm.cjs" --version # 有版本号输出即可
dsh plugin --profile desktop add dsh-plugin-wallpaper-engine@1.3.3也可以先 npm install -g pnpm 装全局 pnpm，再重开终端执行安装命令。
六、必须彻底重启（最容易漏的一步）
退出方式：关掉窗口不算退出。托盘图标右键退出，或在任务管理器里结束全部
DeepSeek Harness.exe（通常 3 个进程）。为什么：插件的主进程部分只在应用启动时加载，刷新网页没有任何作用。
顺序建议：重启后再看设置，能省掉后面一半的排错时间。
七、三层验证，确认装好了
7.1 文件层：package.json 里两处都要有
json
// ~/.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。
7.2 命令行层
bash
dsh plugin --profile desktop list
# 输出中应出现：dsh-plugin-wallpaper-engine 1.3.37.3 界面层
重启后：头像 → 设置（Ctrl + ,），左侧列表在「Agent 预设」下面应多出 Wallpaper Engine。
八、打开壁纸库并上手
左下角头像 → 设置（
Ctrl + ,）。左侧选 Wallpaper Engine。
切到「壁纸库」页签，点「选择壁纸」。
挑一张点应用；右键或悬浮可看壁纸属性（颜色、开关、滑块）。
修改即时生效并保存在宿主端，不会因为换浏览器丢配置。
九、常见问题速查
十、更新、回滚与卸载
bash
# 更新到最新版
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以上操作完成后都要重启应用；卸载只移除插件，不影响壁纸文件。
十一、附录：本次实测记录
讲解收尾建议：让学员亲手走一遍「三层验证」——看 package.json、跑 list、进设置找入口。三步都能对上，这节课就没白讲。