返回目录

dsh-use-wallpaper

精选清单收录维护状态: 活跃

yu502950715yang/dsh-use-wallpaper

把 Wallpaper Engine 动态壁纸搬进 DeepSeek Harness 的 Web GUI:浏览器内实时渲染 scene 壁纸(three.js + Rust/WASM 粒子模拟),支持视频与 web 壁纸,无需 Wallpaper Engine 运行时。

前往 GitHub项目主页
$ dsh web

16

星标

0

Fork

TypeScript

语言

MIT

许可证

2026-08-17

创建于

2026-11-20

最近推送

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

安装步骤

  1. 01

    桌面版:打开侧边栏 **插件** 页 → **添加插件**,包名填 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`(GitHub)→ 点 **安装** → 刷新页面

  2. 02

    `dsh web`:执行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`

    $ dsh web

  3. 03

    重启 `dsh web`,打开 GUI

    $ dsh web

  4. 04

    进入 **设置 → 侧边栏「Wallpaper 壁纸」**,填写壁纸目录(workshop)与引擎目录,或点 **自动探测**——典型路径是 `D:/Steam/steamapps/workshop/content/431960` 与 `D:/Steam/steamapps/common/wallpaper_engine`

  5. 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 适配原生运行时

原生 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`)与鼠标互动粒子尚未支持;多显示器下每屏独立壁纸也不支持,因为插件是单页背景层。
2026-08-172026-11-17v1.0.2

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 即可。

08数据与来源

  • 作者声明github.comd3fc8fd6a09c…

    把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI

  • 作者声明github.comd3fc8fd6a09c…

    dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install

  • 作者声明github.comd3fc8fd6a09c…

    仓库根 `package.json` 已声明 `dsh.bundle`,bundle 由 `cordis.patch.yml` 自动注册

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。