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