前言¶

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于 Web GUI 用户而言，保持沉浸式的编码环境往往比静态背景更有价值。本插件旨在解决这一需求，它通过在浏览器中实时渲染 Wallpaper Engine 的场景文件，让动态壁纸（粒子、水波、云卷等）成为 DeepSeek Harness 的背景，而无需在后台运行完整的 Wallpaper Engine 应用程序。

这是什么¶

这是一个为 DSH Web GUI 设计的插件，由用户 yu502950715yang 维护，采用 MIT 许可证。

它将 Wallpaper Engine 的 scene（场景）壁纸迁移到浏览器环境中，利用 WebGL 进行实时计算。插件不依赖 Wallpaper Engine 的运行时，也不重新分发任何第三方素材，而是直接读取用户本机安装的壁纸文件和引擎资源。

核心能力¶

该插件提供以下能力：

1. 实时场景渲染：在浏览器中实时计算壁纸背景与粒子系统，还原原作者设定的缩放、透明度与亮度。
2. 完整粒子效果：支持雪、雨、花瓣、火星、雾、气泡等粒子效果，包含重力、风向、湍流、寿命及颜色渐变。
3. 纹理解压支持：支持主流压缩格式（DXT1/3/5、RGBA、R8、RG88）及多帧精灵动画（火把、雾、光晕）的解压，不出现糊图或黑边。
4. 多格式支持：支持视频循环播放、网页壁纸（沙箱加载）以及图片壁纸（预览图 + 缓慢缩放动效）。
5. 动态特效：常见特效会动，包括水波、涟漪、云飘、植物摆动、脉冲等。
6. 文本对象显示：壁纸中的时间/日期文本对象会实时显示（如 VHS 时间与日期）。
7. 性能优化：支持一键暂停壁纸与自动暂停后台渲染；画质档位可降至 0.5× 以节省显存。
8. 容错机制：任何壁纸渲染失败时，会自动退回预览图，确保界面可用。
9. 自动探测：自动探测 Steam 壁纸目录（通过注册表、Steam 库配置及常见路径）。

安装与启用¶

根据使用的环境，选择相应的安装方式。

CLI 安装（推荐）¶

在终端中执行以下命令添加插件：

dsh plugin --profile web add github:yu502950715yang/dsh-use-wallpaper

安装完成后，刷新 Web GUI 即可生效。

桌面版 App 安装¶

桌面版 App 不能使用上述 CLI 命令（desktop profile 由 App 独占管理）。

1. 打开桌面版，点击侧边栏的 插件 页面。
2. 点击 添加插件。
3. 在包名框中输入：
   • GitHub 方式：github:yu502950715yang/dsh-use-wallpaper
   • npm 方式：@dsh-use/wallpaper-engine
   • 本地开发方式：填写本地仓库的绝对路径（如 E:/code/dsh-use-wallpaper）。
4. 点击 安装 并刷新页面。

本地开发¶

如果在本地修改代码以即时生效，可以使用链接安装：

dsh plugin --profile web add link:E:/code/dsh-use-wallpaper

配置与使用¶

安装完成后，需要在设置中配置路径并选择壁纸。

1. 启动 dsh web 并打开 GUI。
2. 进入 设置，在侧边栏找到 Wallpaper 壁纸。
3. 填写 壁纸目录（Steam workshop 内容路径）与 引擎目录（Wallpaper Engine 安装目录），或点击 自动探测。
   • 典型路径示例：
     • 壁纸目录：D:/Steam/steamapps/workshop/content/431960
     • 引擎目录：D:/Steam/steamapps/common/wallpaper_engine
4. 在缩略图网格中选择壁纸即可生效。

常用功能：
* 画质档位：在设置中调整 qualityScale（0.5–1），数值越小越省显存。
* 暂停控制：通过面板开关暂停壁纸渲染，或启用切后台自动暂停。

注意事项¶

1. 桌面版限制：桌面版 App 禁止使用 dsh plugin CLI 命令，插件管理必须在 App 界面内完成。
2. 兼容性：旧版 DSH（≤0.1.6）有兼容层，新版（0.1.7-alpha.1 起）已适配新的设置系统。
3. 视觉异常：部分壁纸（尤其是带复杂遮罩或特殊混合方式的）可能出现黑块；模糊、光轴等特效可能在特定对象上不可见。
4. 沙箱执行：文本脚本在沙箱环境中执行，不会影响主进程。
5. 构建产物：发布包仅包含 lib、dist 和 cordis.patch.yml，安装后无需本地构建。

结尾¶

该插件通过浏览器原生能力实现了 Wallpaper Engine 场景的实时复现，为开发者提供了动态的编码背景。更多详情、目录索引及源码请访问其 GitHub 仓库 或 技能社区目录。