MIT 协议的 DSH 插件:在 DeepSeek Harness Web GUI 背后实时渲染 Wallpaper Engine 的 scene、视频、网页与图片壁纸,带自动轮播、本地壁纸库与多级降级链,不需要 WE 在后台运行。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-21
许可证
MIT
01它能帮你完成什么?
给 DSH Web GUI 换一张真正会动的壁纸
Wallpaper Engine 的 scene 壁纸在浏览器里实时算出来——粒子、水波、飘云、布料摆动——DSH 界面叠在它上面
整天开着 DSH 写代码、想要动态背景而不是静态图的人
把视频、网页、图片壁纸也当背景用,并让它自动轮换
视频壁纸循环播放、音轨跟随「声音」开关,网页壁纸在沙箱里加载,图片壁纸缓慢缩放,还能按 1 / 5 / 10 / 30 分钟顺序或随机轮播
本来就有 Wallpaper Engine 壁纸库、想把同一套壁纸搬到编码界面上的人
某张壁纸渲染不出来时,界面照样能用
多级降级链:内嵌 MP4 → 抓帧 PNG → 作者预览图 → 空态,每级失败只跳过,不弹错也不白屏、黑屏
壁纸库偏冷门、经常撞上复杂效果与作者脚本的用户
02如何接入 DeepSeek Harness?
前置条件
- Windows 10/11——README 里唯一完整支持且实测过的平台
- DeepSeek Harness 0.2.x——插件在 `engines.dsh` 里声明 `>=0.2.0-rc.1 <0.3.0`
- 本机装有 Wallpaper Engine——插件要读它的内置粒子与特效纹理,但 WE 本身不必在后台运行
- 浏览器支持 WebGL2(Chrome / Edge);想要最接近 WE 的观感推荐 Chrome
安装步骤
- 01
桌面版:打开侧边栏 **插件** 页 → **添加插件**,包名填 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`(GitHub)→ 点 **安装** → 刷新页面
- 02
`dsh web`:执行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`
$ dsh web
- 03
重启 `dsh web`,打开 GUI
$ dsh web
- 04
进入 **设置 → 侧边栏「Wallpaper 壁纸」**,填写壁纸目录(workshop)与引擎目录,或点 **自动探测**——典型路径是 `D:/Steam/steamapps/workshop/content/431960` 与 `D:/Steam/steamapps/common/wallpaper_engine`
- 05
在缩略图网格中点选壁纸即可生效
验证接入成功
- `GET /wallpapers/list` 返回 JSON 壁纸数组
- 浏览器 Console 出现 `[three] scene loaded id=… background=N particleLayers=M`,`M ≥ 1` 表示粒子层已建
回滚
- 执行 `dsh plugin --profile web remove "@dsh-use/wallpaper-engine"`,再 `dsh plugin --profile web install`,然后重启 `dsh web`
- 桌面版在同一「插件」页卸载(会二次确认)
03DSH 适配与能力边界
原生 DSH(Cordis)插件包:桌面版在侧边栏「插件」页添加 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`,web 版用 `dsh plugin --profile web add` + `dsh plugin --profile web install` 安装;装好后在 DSH Web GUI 里挂出背景层和 设置 →「Wallpaper 壁纸」设置面板。
Scene 壁纸实时渲染
本机 Steam workshop 目录里的 scene 壁纸→three.js 背景层 + 粒子 billboard,在浏览器里逐帧算出来
在浏览器里跑 WebGL 渲染循环,页面切到后台会自动暂停首次渲染成功后往 `~/.dsh-use-wallpaper/frames/` 写一张抓帧 PNG视频 / 网页 / 图片壁纸
同一壁纸库里的视频、网页或图片壁纸→浏览器原生视频元素循环播放、沙箱网页,或带缓慢缩放的预览图
浏览器解不了的编码(HEVC / H.265)回退到预览图并提示原因网页壁纸在沙箱 iframe 里加载:用局域网 IP / 隧道访问 GUI 时,依赖 WebGL 贴图的会空白壁纸库与自动轮播
标题搜索、类型筛选、仅收藏、隐藏 / 恢复、最近使用排序→筛选后的壁纸库,以及 1 / 5 / 10 / 30 分钟顺序或随机轮播
收藏、隐藏与最近使用只写浏览器 localStorage,不改壁纸文件画面、毛玻璃与光晕面板
遮罩不透明度、背景模糊、Ken Burns、画面适配、对话区毛玻璃、光晕阈值与强度→改完立即在 DSH Web GUI 里生效
壁纸自带的用户属性
当前壁纸真正引用的属性(bool / slider / color / combo)→对应属性的滑块与取色器,提交后重装配壁纸生效
调整属性会重装配当前壁纸;滑块与取色防抖提交降级链与省电
加载失败、装配失败或渲染不出可见对象的 scene 壁纸→内嵌 MP4 → 抓帧 PNG → 作者预览图 → 空态 逐级回退,另有一键暂停与 0.5× 画质档
每一级失败只跳过,不弹错、不白屏系统媒体联动与开机动画
Windows 系统媒体会话(SMTC),或 WE 库 / 本地视频素材→壁纸的专辑封面、歌名、歌手、主色与播放状态实时联动;打开 DSH 时全屏播一段片头
媒体元数据只在内存里读,不落盘开机动画声音默认开启,播放期间壁纸声音自动静音
04适合谁?何时不该用?
适合
- 整天开着 DSH 写代码、想要动态背景而不是静态图的人
- 本来就有 Wallpaper Engine 壁纸库、想把同一套壁纸搬到编码界面上的人
- 壁纸库偏冷门、经常撞上复杂效果与作者脚本的用户
不适合
- 只在 Windows 10/11 上完整支持并实测过;macOS / Linux 未测试,1.0 起包内声明 `dsh.bundle.platforms = ["win32"]`,DSH 会在其它平台跳过本插件并报告原因。
- 需要 DSH `>=0.2.0-rc.1 <0.3.0`;1.0 移除了 0.1.6 及更早的旧设置路径,还在用 0.1.x 的人必须先升级 DSH 再装。
- 本机必须装有 Wallpaper Engine——插件要从安装目录读内置粒子与特效纹理;没装或路径没配对时粒子会退化成纯色圆点,画面本身仍在。
05兼容性、维护与安全提示
- 只在 Windows 10/11 上完整支持并实测过;macOS / Linux 未测试,1.0 起包内声明 `dsh.bundle.platforms = ["win32"]`,DSH 会在其它平台跳过本插件并报告原因。
- 需要 DSH `>=0.2.0-rc.1 <0.3.0`;1.0 移除了 0.1.6 及更早的旧设置路径,还在用 0.1.x 的人必须先升级 DSH 再装。
- 本机必须装有 Wallpaper Engine——插件要从安装目录读内置粒子与特效纹理;没装或路径没配对时粒子会退化成纯色圆点,画面本身仍在。
- 渲染能力有边界:子粒子(子发射器)、绳索类拖尾(`ropetrail`)与鼠标互动粒子尚未支持;多显示器下每屏独立壁纸也不支持,因为插件是单页背景层。
MIT · 活跃维护(最新 release v1.0.2,2026-11-17)
06常见问题
怎么在 DeepSeek Harness 里安装?
`dsh web` 上执行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`,然后重启 `dsh web`。桌面版是另一条路:侧边栏「插件」页 →「添加插件」→ 填包名 → 安装 → 刷新页面;README 说明 `dsh plugin` 命令对桌面 profile 会直接拒绝。
装完在哪里设置壁纸目录?
在 DSH GUI 里进 设置 → 侧边栏「Wallpaper 壁纸」,填壁纸目录(`D:/Steam/steamapps/workshop/content/431960`)与引擎目录(`D:/Steam/steamapps/common/wallpaper_engine`),或者点「自动探测」,然后在缩略图网格里点选。
需要 Wallpaper Engine 一直在后台运行吗?
不需要。插件只从你本机安装目录读取 WE 内置的粒子与特效纹理,WE 不必在后台跑,也不重新分发任何第三方素材;完全没装 WE 时粒子会退化成纯色圆点。
支持哪些 DSH 版本和平台?
DSH `>=0.2.0-rc.1 <0.3.0`——插件在 `engines.dsh` 里这样声明,1.0 还移除了 0.1.6 及更早的旧设置路径。平台只有 Windows 10/11 完整支持并实测过,1.0 起包内声明 `win32`,其它平台 DSH 会跳过本插件。
视频壁纸一直是黑的怎么办?
通常是编码问题。视频壁纸交给浏览器的原生视频元素解码,HEVC / H.265 需要系统装有对应解码扩展;缺扩展时插件会回退到预览图并在壁纸面板里说明原因。换 Chrome 或把视频转成 H.264 即可。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI
dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install
仓库根 `package.json` 已声明 `dsh.bundle`,bundle 由 `cordis.patch.yml` 自动注册
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
