前言¶
在 DSH 的“一切皆插件”场景下，Web 界面的背景通常依赖默认主题或手动替换静态文件。如果你本机已经通过 Wallpaper Engine 下载了一批壁纸，并且希望在 DeepSeek Harness Web 中直接选择图片或视频背景，dsh-wallpaper-engine 提供了这条路径。
DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍该插件的能力、安装与配置方式。
这是什么¶
dsh-wallpaper-engine 由 sakuraaa667 维护，许可证为 MIT。它的定位是：把本机 Wallpaper Engine 中已经下载的壁纸接入 DeepSeek Harness Web 界面，作为页面背景。
核心功能¶
下面按使用路径介绍它支持的内容。
自动发现已下载壁纸¶
- Steam 创意工坊壁纸：对应 app
431960，自动读取libraryfolders.vdf，支持多 Steam 库。 - Wallpaper Engine 本地项目：覆盖
projects/myprojects与projects/defaultprojects。
浏览与同步¶
- 在“设置 → 壁纸 Wallpaper Engine”中浏览缩略图、搜索、一键使用。
- 打开壁纸页时每 30 秒静默重扫磁盘，新下载的壁纸会自动出现。
- 也可以点击「刷新」立即更新。
显示与可读性¶
- 视频壁纸以
<video>方式播放，使用muted + loop。 - 图片壁纸优先使用目录内最高分辨率原图，并支持「铺满 / 完整显示」两种适配模式。
- 提供「面板暗化（0–100%）」与「背景压暗（0–50%）」滑杆，用于控制可读性。
持久化¶
- 壁纸选择会持久化到
$DSH_HOME/dsh-wallpaper.json。 - 重启或刷新后自动恢复。
安装与启用¶
运行环境方面，package.json 声明：
engines.node需要>=22peerDependencies包含@deepseek-ai/cordis ^4.0.1
在 DSH 安装目录或任意目录执行安装命令，把 file: 后的路径替换为本机插件目录：
dsh plugin --profile web add file:C:\path\to\dsh-wallpaper-engine
安装前应检查源码与 MIT 许可证。插件会以当前 dsh 进程权限运行。
典型用法¶
1、打开 DeepSeek Harness Web 界面。
2、进入“设置 → 壁纸 Wallpaper Engine”。
3、点击任意壁纸卡片即可设为背景。
4、再次点击「清除背景」恢复默认。
如果在 Wallpaper Engine 中新增了壁纸，打开壁纸页后会自动重扫；也可以点击「刷新」立即更新。
配置¶
插件支持在 profile 的 cordis.patch.yml 中按 id 覆盖目录配置：
- id: dsh-wallpaper-engine
config:
workshopDir: "<workshop 目录>"
projectsDir: "<projects 目录>"
其中 workshopDir 用于指定创意工坊壁纸目录，projectsDir 用于指定本地项目目录。
也支持环境变量：
DSH_WALLPAPER_WORKSHOP_DIRDSH_WALLPAPER_STEAM_DIR
HTTP 路由¶
插件提供以下路由，用于壁纸列表、当前选择、缩略图和媒体文件访问：
/dsh-wallpaper/list
/dsh-wallpaper/config
/dsh-wallpaper/preview/<id>
/dsh-wallpaper/file/<id>
所有 id 均通过扫描生成的映射查找，不参与路径拼接，以避免路径穿越。
适用场景与注意¶
适合在本机使用 Wallpaper Engine，并且希望把已下载壁纸直接用于 DeepSeek Harness Web 背景的场景。
需要注意：
- 场景型（scene）与网页型（web）壁纸无法在浏览器背景中实时渲染，会回退为预览图。
- 视频通过本机 HTTP 流式传输，仅本机访问，默认 loopback。
- 安装命令中的路径是占位示例，需要替换为实际插件路径。
- 安装前建议阅读源码，并确认
MIT许可证满足你的使用要求。
链接¶
- GitHub：https://github.com/sakuraaa667/dsh-wallpaper-engine
- 目录页：本次材料未提供可核实 URL，可按插件名
dsh-wallpaper-engine在 DSH 社区目录中检索。
