前言¶

DeepSeek Harness（DSH）的 Web UI 默认是实色面板。如果你桌面已经在用 Steam 上的 Wallpaper Engine，或者只是想把一张图、一段视频铺在对话界面后面，又不想改 Harness 主题源码，就需要一个只读接入、能在界面上调半透明和模糊的插件。dsh-wallpaper-engine 走的就是这条路：在 Harness 画布之下挂一层壁纸，并把侧栏、阅读区等块面做成可调的磨砂玻璃效果。

这是什么¶

dsh-wallpaper-engine 由社区维护者 SharpWord 发布，归类为「趣味换装」。它读取 Wallpaper Engine 当前激活的壁纸以及创意工坊壁纸库（也可不装 Wallpaper Engine，改用本机投放文件夹），在 Harness Web UI 背后绘制壁纸层，并通过主题 token 覆写实现半透明界面、分块模糊，以及随壁纸亮度调整的文字对比度。

插件对 Wallpaper Engine 是只读的：不修改其配置，只读取 config.json 与创意工坊目录；除首次创建投放文件夹和 README.txt 外，不写用户其它个人文件，README 中亦说明不发遥测、壁纸经本机回环地址流式返回。

核心功能¶

壁纸来源与类型¶

1. 跟随模式：使用 Wallpaper Engine 里当前每台显示器激活的壁纸，支持多显示器。
2. 固定模式：从壁纸库中点选一张固定显示。
3. 无 Wallpaper Engine：插件启动时会创建投放文件夹（默认在系统「图片」目录下的 dsh-wallpapers），把图片或视频放入后点「重新扫描」即可进库，标记为「本地文件夹」。Steam 版与投放文件夹可共存，库中会同时列出创意工坊与本地项。

支持的壁纸类型包括 scene、video、web、application；视频壁纸会实际播放，可静音或暂停。

界面与操作入口¶

壁纸层通过 shell.overlay 挂在 document.body 下，z-index 为 -1，位于应用框架之下、画布之上。设置里没有单独的「壁纸」页：侧栏有一行图标作为唯一入口。点击后左侧列表区换成壁纸面板，中间对话区保持不动；点「返回」恢复会话列表。

侧栏面板自上而下包括：按比例显示的预览（可拖动取景、滚轮或双指缩放、双击复位）、五种显示方式（自适应 / 填充 / 适合 / 拉伸 / 居中）、可搜索筛选的壁纸库，以及折叠区的浓度、压暗、分块模糊等参数。壁纸库按最近使用与使用次数排序，记录保存在本机 localStorage，不上传。

画面与半透明¶

显示方式与 Wallpaper Engine 的 Fill / Fit / Stretch / Centre 对齐，并增加「自适应」：默认等同填充，仅在窗口与壁纸比例差极大时退到「适合」。浓度滑块（20–100）按曲线分配到列背景、卡片、代码块、浮层等 token；窗口底层与侧栏列填充在开启壁纸时可变为透明，配合分块模糊形成磨砂效果。预览使用与真实窗口相同的 placement() 与 framing() 处理链，便于「不闭眼」调参。

安装与启用¶

面向桌面版 profile，从 GitHub 安装：

dsh plugin --profile desktop add github:SharpWord/dsh-wallpaper-engine

也可从本地打包文件安装：

dsh plugin --profile desktop add "C:\path\to\dsh-wallpaper-engine-1.1.0.tgz"

开发时从本地目录：

plugin_manager install_bundle target=<插件目录的绝对路径>

安装后重启或刷新 Harness Web UI，从侧栏壁纸入口进入配置（README 早期版本写「设置 → 壁纸」，当前实现以侧栏行为为准）。

典型用法¶

仅用投放文件夹（不装 Wallpaper Engine）¶

1. 安装插件并打开 Web UI，在壁纸设置区查看顶部显示的投放文件夹路径（旁有「打开文件夹 / 复制路径 / 重新扫描」）。
2. 将图片（如 .jpg、.png、.webp）或视频（如 .mp4、.webm）放入该文件夹（仅扫描这一层，不递归子目录）。
3. 在设置页点「重新扫描」，在壁纸库中选择壁纸；可选跟随或固定，并调节显示方式与浓度。

默认路径示例：

%USERPROFILE%\Pictures\dsh-wallpapers

路径跟随注册表中的「图片」文件夹；若需更换目录，可设置环境变量：

DSH_WALLPAPER_FOLDER=<目录绝对路径>

已安装 Wallpaper Engine¶

1. 保持 Wallpaper Engine 照常使用；插件通过注册表与 libraryfolders.vdf 定位安装目录，读取 config.json 与 projects、创意工坊 content/431960。
2. 在 Harness 侧栏打开壁纸面板，选择「跟随」以同步当前激活壁纸，或从库中固定一张创意工坊或本地壁纸。
3. 在预览上拖动、缩放取景，在「更多」中微调浓度与分块模糊；需要恢复画面参数时使用「恢复默认画面」（不重置开关与壁纸选择）。

适用场景与注意¶

适合希望在 DSH 桌面版 Web UI 背后显示动态或静态壁纸、并愿意用侧栏面板细调玻璃感与裁剪的 Windows 用户。未安装 Wallpaper Engine 时，投放文件夹即可满足静态图与本地视频场景。

使用前请注意：

• 插件以当前 dsh 进程权限 运行，会读取 Steam 路径、Wallpaper Engine 配置、创意工坊目录与投放文件夹；安装前建议在 GitHub 查看源码与 MIT 许可证，自行判断是否信任。
• 仅支持文档中写明的 web 客户端注入（platform: "web"，immediately: true）；与其它占用 sidebar.workspaces 单实例槽位、同优先级的插件可能冲突，README 说明了通过优先级注册侧栏面板的约定。
• 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库为准（当前 package 版本为 1.1.6）。

结尾¶

dsh-wallpaper-engine 把 Wallpaper Engine（或本地文件夹）里的壁纸接到 Harness 背后，用只读方式读库、用侧栏集中完成选图与磨砂调参，适合作为 DSH「一切皆插件」生态里的趣味换装扩展。

• 社区目录：https://www.skillhub.cn/plugins/SharpWord/dsh-wallpaper-engine
• 源码与说明：https://github.com/SharpWord/dsh-wallpaper-engine