marlonLau/dsh-wallpaper-engine

README 摘要

dsh-wallpaper-engine DSH Web GUI 的一键换背景插件：从本机 Wallpaper Engine 素材库（图片 / 视频，目前只支持这2种）里选一张，一键应用到 DSH 界面背景，并可联动切换 DSH 深/浅色主题。 功能 - 壁纸库 ：侧边栏底部按钮打开选择面板（缩略图网格 + 搜索）。 - 两种素材来源 （ /we/list?source=auto 自动选择）： 1. Wallpaper Engine Web API ：WE 自带的本地 Web 服务（默认 http://localhost:26384/api/wallpaper/list ），仅在 WE 运行且其本地 Web 服务可用时生效；未启用/不可用时自动回退目录扫描； 2. 目录扫描（回退） ：自动发现所有 Steam 库（读取注册表 + libraryfolders.vdf ），扫描 steamapps/workshop/content/431960/ （创意工坊）和 steamapps/common/wallpaper engine/projects/myprojects/ （本地项目），解析 project.json 。 - 一键应用 ：图片 → CSS 背景；视频 → 静音循环 ；3D 场景 / 网页壁纸 → 用其 preview.jpg 静态展示。应用后 App 框架与侧边栏变为半透明 + 毛玻璃（ backdrop-filter ），壁纸透出。 - 明暗跟随 ：勾选后按壁纸亮度自动切换 DSH 深色 / 浅色主题（ theme.setTheme ）。 - 持久化 ：当前壁纸与设置存 localStorage ，刷新不丢；额外目录等配置存 $DSH HOME/storages/dsh-wallpaper-engine.json 。 - 随机 / 关闭背景 ：一键随机换，或一键恢复 DSH 默认背景。 功能展示 安装（以 web profile 为例） 从 npm 安装（推荐） 该命令会写入依赖，并自动把包追加进 dsh.profile.bundles ；随后重启 dsh web 生效（客户端改动刷新页面即可）。 从 GitHub 仓库安装（开发调试） 插件包已在 npm 发布，仓库安装仅供开发调试（需要 Node.js = 18 与 git）： 等价手动方式：在 profile 的 package.json 里加依赖 "@marlonlau/dsh-wallpaper-engine": "link: " ，并把它追加进 dsh.profile.bundles ，然后 pnpm install 。 宿主路由 路由 说明 GET /we/list 壁纸列表（ source=auto\ api\ scan ， refresh=1 强制重扫） GET /we/sta…

分类