夜雨聆风学习资料网

ARTICLE · 1239743

DSH插件测评:壁纸引擎要装 8 个包才生效

DSH插件测评:壁纸引擎要装 8 个包才生效

关注我,每天给你分享有用有趣的DSH使用技巧。

AURORA LAB · 前沿观察

DSH插件测评:壁纸引擎要装 8 个包才生效

dsh-wallpaper-engine 是 elysia395 做的 DSH 网页外观插件,把本机 Wallpaper Engine 的壁纸搬进聊天界面。Scene 类壁纸由内置的 WebWallGL 引擎实时渲染,不需要 WE 在后台跑。同赛道有 dsh-dream-skin 这类换色皮,只能改配色,动不了壁纸。截至 2026-10-24,仓库 2,139 星,npm 上周下载 19,419(10-12~18,官方口径)。

我照着市场页装了三遍都没生效,最后发现是包的数量问题。

01

一、它是什么:把 WE 壁纸搬进 DSH 网页

它不是完全离线的插件:首次启动要下载运行时,开在线歌词才向 LRCLIB 发歌名和歌手。

02

二、能力与作用:四条能立刻用上的

渲染 Scene 壁纸 → 不用让 WE 常驻

WebWallGL 接管粒子、puppet 骨骼和 SceneScript。渲染失败会自动降级成内嵌 MP4 或静态帧。边界:依赖浏览器 WebGL 和显卡驱动,复杂工坊项目不一定跑得动。

挂 Web 壁纸 → 不用另装播放器

网页在沙箱里挂载,插件注入 WE API,鼠标交互能传给壁纸。边界:效果取决于那张网页本身和浏览器能力。

给视频档设帧率上限 → 不用自己压片

ffmpeg 转码出缓存后按上限播放,加载时不冲满显卡。边界:拿不到 ffmpeg 就只能原片播放。

设置存宿主端 → 不用清缓存后重配

配置写在 ~/.dsh-wallpaper-engine/config.json,换端口、重启浏览器都不丢。边界:环境变量优先于面板里填的路径。

03

三、三个场景:三种人各自的第一步

场景 1:晚上改脚本的开发者

十点你还在改一个跑不通的脚本,界面还是那片白。打开「设置 → Wallpaper Engine → 壁纸库」,缩略图选一张 Scene 壁纸;到「播放」页把帧率上限压到 30、打开遮挡暂停;再在「外观」页存一份预设。全程不用启动 Wallpaper Engine 本体。产出是一份能导出的预设 JSON,换机器导入就能复原这套外观,预设里连字体和吉祥物一起打包。

场景 2:要把屏幕共享给同事

下午要共享屏幕过代码,花哨壁纸既分心又不合适。壁纸库能按内容分级和类型筛选,也能批量隐藏:先筛出普通档,把不合适的那几张隐藏;会开完回「外观」页切回自己的预设。全程在浏览器里点,不用关插件。产出是一套「评审用」预设,导出后发给同事导入即可。

场景 3:整天开着浏览器写稿的运营

你想换张自己的图当背景,又不会做 WE 项目。壁纸库的「自定义壁纸」能直接上传 JPG、PNG、MP4,存在本机 uploads 目录;「播放」页调暗化和模糊,让字压得住图;「系统」页开遮挡暂停省电。产出是一张自己上传的壁纸加一份导出预设,重装后还在。

04

四、对比与版本对应

维度
官方 Wallpaper Engine
本插件
跑在哪
桌面客户端常驻
浏览器里由 WebWallGL 渲染
要 WE 在跑吗
要
Scene 不用
Application 壁纸
支持
不支持
配置存哪
Steam 目录
~/.dsh-wallpaper-engine/config.json

版本对应:1.4.0 起八个包全部上了 npm

engines 要求 dsh ^0.2.0-rc.1、node >=22.12.0;peer 依赖是 cordis ^4.0.4 和 react ^18.2.0。上一版 1.3.3 在 10 月 15 日,1.4.0 在 10 月 22 日。子包没发全的版次,主包会在你机器上直接回滚。发布集压缩后 25.12 MiB,比上一版小约七成(我本地实测,不含另装的 pet)。

05

五、踩坑清单 + 三步上手

三个坑,我都踩过

1. 市场页写「先升级 dsh-better-sidebar 到 0.19.0 以上」,但包自己的 package.json 写的是 No version restriction。以包为准,别为一个可选依赖动 sidebar。 2. 八个包少一个就 ERR_PNPM_FETCH_404 回滚,看起来像「只拿到母包」。用一条 add 装主包,别单独启用子包 bundle。 3. 桌面宿主必须先完全退出应用再装,装完重启;行级开关不是即时生效。 4. 想开在线歌词得联网:本地找不到歌词时,插件把歌名、歌手、专辑发给 LRCLIB。

三步上手

1. dsh --version 看到 0.2.x,node -v 别低于 22.12。 2. dsh plugin --profile web add dsh-plugin-wallpaper-engine(桌面宿主把 web 换成 desktop)。 3. 重启 dsh web,进「设置 → Wallpaper Engine → 壁纸库」选壁纸。

写在最后

看到这儿,说明你把它读完了。这类文章能走多远,只取决于两件事:你的在看和转发。

顺手关注并设为星标,下一篇更新第一时间见。

END

一起聊聊

你装壁纸引擎时卡在哪一步:DSH 版本、Node 版本,还是八个包没齐?

欢迎在评论区说说你的做法。

乌鸦君疯狂学AI

让天下没有难用的AI

#DSH插件# #壁纸引擎# #版本对应#

相关学习资料