Skip to content

dsh-wallpaper-engine

Verified

@mhhhmy/dsh-wallpaper-engine · v1.5.0 · MIT

自动识别 Steam 壁纸引擎(Wallpaper Engine,工坊 431960)里的壁纸并导入 DeepSeek Harness 作为背景:视频/网页/场景分别处理,内置 Relax Ambience [4K] 默认壁纸;支持鼠标滑动涟漪特效(WebGL 水面高度场、波峰扩散、折射壁纸 + 镜面高光,移植自 github.com/Yaki-Blake/mouse-ripple,上游 sirxemic/jquery.ripples,MIT)与性能显示。安装后需完全退出并重启 DSH,右下角的「壁纸」按

Install

dsh plugin add @mhhhmy/dsh-wallpaper-engine

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

# dsh-wallpaper-engine

自动识别 Steam 壁纸引擎(Wallpaper Engine,工坊 appid 431960) 里的壁纸并导入 DeepSeek Harness 作为背景,支持鼠标滑动涟漪特效。

  • 自动定位壁纸引擎:Steam 注册表 → libraryfolders.vdf 全部库 → WE 卸载项 → 常见安装路径(多库时选壁纸最多的),结果缓存到 $DSH_HOME/wallpaper/we-location.json;没装 Wallpaper Engine 也能用(见下一条);
  • 开箱即用的默认壁纸:内置一张 4K 的 Relax Ambience [4K] 静帧(assets/wallpaper/relax-ambience.jpg),装完就有背景,不需要 Steam 或壁纸引擎;本机装有 Wallpaper Engine 且订阅了原工坊条目(3208739106)时,默认会自动换成原视频,内置静帧从列表里隐藏;
  • 鼠标滑动涟漪:WebGL 水面高度场 + 波峰扩散 + 折射壁纸 + 镜面高光,移植自 Yaki-Blake/mouse-ripple(上游 sirxemic/jquery.ripples,MIT)。移动按距离触发;加速度越大涟漪越强;面板里的「强度」滑杆同时控制传播速度、水波宽度、振幅、触发间距和加速度灵敏度;点击另有更大的落水涟漪;可随时开关;
  • 壁纸预览:进入 DSH 或切换壁纸时,先只显示壁纸 N 秒(1–5 秒滑杆)再出现界面,可开关;
  • 自动扫描工坊全部壁纸(视频 / scene / web),按类型处理:
    • 视频:Range 流式播放,不整文件读入内存;
    • 网页:iframe 直接跑它自己的 index.html(「固化」= 把整套资源复制进插件目录);
    • 场景(scene):解析 scene.json,按每层 origin/size/scale/alpha 用 Pillow 合成一张大图(左下角原点、Y 轴向上);纯 PNG/JPEG 贴图才能合成;
    • 实时 3D 渲染场景(scene.json 引用 .mdl 模型,如 3D 地球):标记为「3D / 不可静态化」,不生成误导性的图;
  • 列表:收藏 / 其他两段,按最近使用时间排序;缩略图、搜索框;每行有「提取 / 重提 / 3D」动作;
  • 「重提」交给 DSH Agent(dsh headless)现场处理复杂纹理(DXT/BCn 等)。

安装

dsh plugin --profile <profile> add @mhhhmy/dsh-wallpaper-engine

或在桌面版 / Web 版 插件 → Discover → Add index source 添加市场索引后安装:

https://unpkg.com/@mhhhmy/dsh-wallpaper-engine/index.json

安装完成后需要完全退出并重启 DSH:前端注入只在应用启动时下发,重启后右下角才会出现「壁纸」按钮。

首次启动会直接套用内置的 Relax Ambience [4K],无需安装 Wallpaper Engine。

配置

环境变量 默认 说明
DSH_WALLPAPER_DIR $DSH_HOME/wallpaper 缓存与配置目录(转换结果、we-location.json、state.json)
DSH_WALLPAPER_NO_AGENT 未设置 设为 1 禁用 Agent 兜底,只走内置提取
DSH_WALLPAPER_KEEP_DATA 未设置 设为 1 时关闭卸载兜底清理(详情页弹窗仍会询问并按勾选执行)
DSH_BIN 自动探测 dsh CLI 的 bin.js 路径(Agent 步骤用)

依赖

  • Node ≥ 22.12(DSH 自带);
  • 可选:Python 3 + Pillow —— 场景分层合成需要,缺失时退回单张贴图;
  • 可选:DEEPSEEK_API_KEY —— 「重提」交给 Agent 时需要(用当前用户自己的环境变量或 $DSH_HOME/.credentials.yaml,不使用任何作者凭据)。

卸载

在 DSH 的插件详情页点「卸载」时,会先弹出确认框,带一个默认勾选的 「同时删除缓存数据」:

  • 勾着卸载:先删 $DSH_HOME/wallpaper/we-location.json 和 $DSH_HOME/wallpaper/.wallpaper/(收藏、默认壁纸、最近使用、提取的原画、手动添加的壁纸列表),默认目录清空后连 $DSH_HOME/wallpaper 一起移除,然后继续卸载;
  • 取消勾选再卸载:只卸载插件,缓存保留,重新安装后收藏和默认壁纸还在;
  • 点「取消」:不卸载。

兜底:如果这次弹窗没出现(比如 DSH 未运行时用 dsh plugin remove 卸载),插件在被卸载后会用自己的包目录是否消失来判断,并清理缓存;想一直保留就设 DSH_WALLPAPER_KEEP_DATA=1。DSH_WALLPAPER_DIR 指向自定义目录时只删这两个插件产物,不动目录里的其他文件。

判断依据不是「插件停止」本身:卸载时插件先被停止,随后包目录被 pnpm 删除,插件在停止后确认自己的包目录已经消失才执行兜底清理。所以重启、禁用、升级都不会误删缓存。

例外:如果 DSH 没在运行、直接用 dsh plugin --profile <profile> remove @mhhhmy/dsh-wallpaper-engine(或启动型 profile 只能停掉再卸载)卸载,弹窗和兜底都不会执行,需要手动删掉 $DSH_HOME/wallpaper。

已知限制

  • 场景合成的是静态一帧:动画、粒子、水面/光照等着色器效果不会出现;
  • 3D 渲染场景(.mdl)无法静态还原,已显式标记为不可提取;
  • 合成依赖场景里的 PNG/JPEG 贴图,纯 DXT 压缩的场景会走 Agent 或保持单图。

开发与发布

本仓库同时是 npm 包与本地维护项目,目录结构与发布流程见 docs/MAINTAIN.md。

License

MIT