前言¶

DeepSeek Harness（DSH）通过插件机制扩展功能。默认的静态界面往往难以提供沉浸感。b-tq/dsh-wallpaper 插件旨在解决这一问题，它允许用户将本地视频或图片作为全屏动态背景，通过调节参数获得更好的视觉效果。

功能概览¶

该插件具备以下能力：
* 全屏动态壁纸：视频静音循环播放，图片平铺全屏。
* 效果调节：支持调节遮罩暗度、面板透明度、缩放模式（填充/适应/拉伸）。
* 一键切换：在壁纸库列表中点选即用，或随时删除。
* 上传导入：支持本地上传（mp4/webm/gif/jpg/png/webp，上限 1GB）及 Wallpaper Engine 工坊扫描导入。
* 永久保存：设置写入 ~/.dsh/wallpaper-config.json，重启后不丢失。
* 轻量无依赖：不依赖仅限 macOS/Linux 的包，Windows 原生可跑。

安装与启用¶

前置要求：已安装 DeepSeek Harness（dsh web 能正常打开），Node.js >= 22.19。

使用一条命令即可自动注册：

dsh plugin --profile web add "github:B-TQ/dsh-wallpaper"

安装完成后，强制刷新浏览器（Ctrl + Shift + R），在设置菜单中找到「动态壁纸」即可看到插件界面。

使用方法¶

进入 设置 → 动态壁纸，即可控制壁纸。

1. 开关与库：开启总开关。在壁纸库中查看 ~/.dsh/wallpapers 下的文件，点击使用立即切换，或删除不需要的文件。
2. 上传本地文件：点击上传，选择本地视频或图片，文件会自动入库并设为当前壁纸。
3. 扫描工坊：点击扫描，插件会查找 Wallpaper Engine 工坊中的壁纸并导入。
4. 效果调节：调节遮罩暗度、面板透明度、缩放模式，改动实时生效。

配置与注意事项¶

工坊目录扫描：默认扫描 D:\steam\steamapps\workshop\content\431960。若 Steam 库路径不同，可设置环境变量 DSH_WALLPAPER_WORKSHOP_ROOT 指定路径。

常见问题：
* Windows 报错 EBADPLATFORM：因不依赖仅限 macOS/Linux 的包，此错误可忽略。
* 设置页空白：浏览器缓存问题，请强制刷新。

卸载¶

1. 删除 ~/.dsh/profiles/web/cordis.patch.yml 中的 wallpaper 条目。
2. 删除 ~/.dsh/profiles/web/package.json 中的 dsh-wallpaper 依赖行。
3. 删除链接及源码目录 ~/.dsh/plugins/dsh-wallpaper。

结语¶

该插件为 DSH 提供了轻量级的动态背景方案。更多细节可查看插件目录或源码。