前言¶
如果在维护本地 DeepSeek Harness 工作区，并希望让 DSH web 界面使用自己已经下载的 Wallpaper Engine 素材，同时不引入额外的远程壁纸服务，下面这个插件比较直接。
@haibala-aii/dsh-extensions-wallpaperskin 是一个面向 DeepSeek Harness web 的插件。它把 Wallpaper Engine 的本地媒体接到 DSH 背景上，并把选择器放在已有的 Extensions 区域，而不是再单独增加一个设置页。
这是什么¶
@haibala-aii/dsh-extensions-wallpaperskin 用于 DeepSeek Harness web，作用是使用本地 Wallpaper Engine 媒体作为 DSH 背景。
它由 haibala-aii 维护，许可证为 MIT。
这个插件主要解决三件事：
- 从本机已有的 Wallpaper Engine 项目中选择背景。
- 在 DSH web 界面中预览、暂存和应用壁纸。
- 通过表面透明度控制，让 DSH 基础表面仍然可读。
它不依赖远程壁纸 API，也不上传壁纸文件。
核心功能¶
本地 Wallpaper Engine 媒体发现¶
插件在 Windows 上发现 Steam 库。已核实的路径判断包括：
STEAM_PATH- Steam 注册表项
- 常见安装路径
发现 Steam 库后，插件会扫描两类 Wallpaper Engine 内容：
- 已订阅的 Wallpaper Engine Workshop 项目
- 本地 Wallpaper Engine 项目
这里要注意：Wallpaper Engine 用于 Workshop 和本地项目发现。没有 Wallpaper Engine 时，插件仍可加载，但选择器为空。
可播放与可读取的媒体范围¶
插件支持以下媒体能力：
- 使用浏览器原生方式播放
MP4、WebM、M4V和MOV的静音循环视频。 - 读取
PKGVscene 包。 - 解码
PNG、JPEG、BMP、raw BGRA和RLE压缩TEX基础纹理。
经过上面的能力组合，本地图像、视频或兼容的场景媒体都可以被应用为全窗口 cover 背景。
Extensions 内打开，不新增设置页¶
插件不单独新增一个设置页，而是在 Extensions > External 中打开。
入口名称是 extensions-wallpaperskin，对应包名为：
@haibala-aii/dsh-extensions-wallpaperskin
选择器内部分为两个标签页：
- 本地库
- Wallpaper Engine Workshop 缓存
这样可以把本地项目和 Workshop 缓存分开查看。
暂存、应用与恢复¶
插件在正式保存前会先暂存更改。
下面是已核实的行为：
- 点击卡片后会暂存所选壁纸。
- 可以调整
Surface transparency预览效果。 - 按下
Apply wallpaper后保存壁纸和透明度设置。 - 关闭对话框会恢复已保存的壁纸和透明度。
- 按下
Restore current selection也会恢复已保存状态。 - 按下
Disable wallpaper可移除背景，但不会删除任何 Wallpaper Engine 文件。
透明度控制¶
插件提供 0-70% 的表面透明度控制。
默认值为 36%。
配置中的 surfaceTransparency 是 0 到 70 的整数，默认值为 36。
安装与启用¶
安装前需要满足以下条件：
DeepSeek Harness web profile
Node.js ^22.19.0 或 >=24.0.0
自动 Steam 发现当前面向 Windows 注册表和磁盘布局。如果主要目标是 Wallpaper Engine 素材，还需要本机已经具备 Wallpaper Engine 的发现来源；没有 Wallpaper Engine 时插件能加载，但选择器为空。
从 GitHub 安装到 DSH web profile 的命令是：
dsh plugin --profile web add github:haibala-aii/dsh-extensions-wallpaperskin
典型用法¶
下面按已核实的步骤操作：
1、打开 DSH，并进入 Extensions > External。
2、点击 @haibala-aii/dsh-extensions-wallpaperskin 对应的 extensions-wallpaperskin 行。
3、选择 Local library 查看已发现的所有项目，或选择 Wallpaper Engine 查看本地同步的 Workshop 项。
4、点击卡片，暂存所选壁纸。
5、调整 Surface transparency，预览壁纸透过 DSH 基础表面的可见程度。
6、按下 Apply wallpaper，保存壁纸和透明度设置。
7、如果关闭对话框，或按下 Restore current selection，会恢复已保存状态。
8、按下 Disable wallpaper 可移除背景，但不会删除任何 Wallpaper Engine 文件。
配置位置¶
配置保存在：
$DSH_HOME/wallpaperskin.json
已核实的配置项包括：
surfaceTransparency: 0-70 的整数
默认值: 36
0 表示表面透明度最低，更大的值会让壁纸更明显地透过 DSH 基础表面显示出来。
适用场景与注意¶
这个插件适合以下情况：
- 使用 Windows。
- 使用 DeepSeek Harness web profile。
- Node.js 版本满足
^22.19.0或>=24.0.0。 - 希望使用本机已有的 Wallpaper Engine 图像、视频或兼容场景纹理作为 DSH 背景。
- 不希望壁纸文件离开本机，也不希望插件调用远程壁纸 API。
需要注意以下事项：
- 插件不上传壁纸、不发送遥测、不调用远程壁纸 API。
- 壁纸文件保留在本地机器上，并只通过本地 DSH host 提供服务。
- 本地 API 不是经过认证的公开媒体服务，不应将不受信任的 DSH 实例暴露到网络。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 没有 Wallpaper Engine 时，插件仍可加载，但选择器为空。
链接¶
仓库地址：
https://github.com/haibala-aii/dsh-extensions-wallpaperskin
目录页来自插件线索，未包含在本次已核实抓取的 README 中：
https://www.skillhub.cn/plugins/haibala-aii/dsh-extensions-wallpaperskin
该目录页是插件线索页，不应理解为官方应用商店。
