把本机 Wallpaper Engine 的 Scene、Web 与视频壁纸带进 DSH 对话界面，再配上液态玻璃、字体、吉祥物与可分享的外观预设。插件不向 agent 注册工具、不注入提示文本，不增加模型 token 开销。

_{真实界面演示；历史素材与当前安装版本可能略有不同。}

界面预览 · 主要能力 · 支持哪些壁纸 快速开始 · 使用 · 兼容与限制 开发与贡献 · 致谢 赞赏 · 联系方式

生鱼的赞赏码 项目保持开源，赞赏完全自愿，不影响安装、使用或问题反馈。

• 壁纸：Scene / Web 实时渲染，Video 直接播放；支持自定义图片 / 视频上传与 WE 项目目录。
• 外观：设置窗、对话区与侧栏液态玻璃；配色、透明度、模糊、边框与字体可调。
• 玻璃子包：液态玻璃是独立子包行 wallpaper-engine-glass，可在插件管理器单独停用；停用后，除内容区壁纸外界面回到宿中原生外观，壁纸、字体与吉祥物等功能不受影响。
• 扩展：吉祥物、会话头像、点击 / 拖尾特效、3D 视差；可选桌宠联动 dsh-pet-dshwe（dsh-pet 全量 fork），设置页卡片可一键安装，未装 / 关闭 / 版本过旧时回落原生吉祥物。
• 壁纸库：筛选、隐藏 / 恢复、自动轮播；外观预设整套导入导出。

类型	在 DSH 中的路径	支持情况
Scene（场景）	内置 WebWallGL 实时渲染，失败时按降级链回退	支持，不需要 WE 在后台运行
Web（网页）	网页挂载、WE API 注入与沙箱隔离	支持；效果取决于网页与浏览器能力
Video（视频）	浏览器播放，配合转码、帧率上限与暂停控制	支持
Picture（图片 / 幻灯片项目）	读取 WE preset 项目的图片目录，按 WE 里设的周期在本机交叉淡化轮播	支持；图片不上传、留在本机
自定义图片 / 视频	上传本地 JPG / PNG / MP4	支持，文件保存在本机

Application（应用）类壁纸需要启动第三方程序，不支持，也不会进入壁纸库或轮播候选。

前置：Node.js >= 22.12.0、DSH 0.2 内核（含 0.2.0-rc.1/rc.2）与 pnpm。安装前完全退出 DSH。

npm（推荐）

dsh plugin --profile web add dsh-plugin-wallpaper-engine

桌面端把 web 改为 desktop。

本仓按多包发布集发布：主包与同版本子包一起解析（具体包数、tarball 数与 publishOrder 见发布说明，各版本变化见变更记录）。

源码

node scripts/install-source.mjs --profile desktop --dsh-home "<DSH 数据目录>" --app-closed

源码安装会构建客户端并注册主包与子包；安装后不要移动或删除源码目录。完整说明见 安装与升级 与 贡献指南；没有命令行经验请先看 入门指南。

1. 打开 设置 → Wallpaper Engine → 壁纸库，或在聊天顶部从吉祥物拉绳进入壁纸仓库。
2. 在页内壁纸库选择缩略图，按需调整播放与外观；修改即时生效并保存到宿主端。
3. 暂停 / 播放只控制当前播放；清除当前壁纸不会删除原文件。

• Windows / macOS / Linux 使用同一份源码；macOS 没有 WE 客户端，可上传图片 / 视频或指向 WE 项目目录。
• Scene 渲染依赖浏览器 WebGL 与显卡驱动，复杂工坊项目可能存在兼容差异；失败会逐级降级。
• 遮挡暂停、窗口失焦暂停与音频回环采集按平台适配。
• 与其他皮肤 / 插件同时启用时，先看 共存说明。

欢迎提交 Bug 复现、平台兼容反馈、文档修正和功能 PR。反馈时请附宿主 / 插件版本、操作系统、壁纸类型、复现步骤与脱敏日志。

• 工作原理 · 故障排查 · 升级指南
• 更新记录 · 共存说明 · 代码结构
• 贡献指南 · 发布流程

 

感谢所有贡献者对本项目的贡献 ❤️

_{代码以 MIT License 开源；壁纸、角色与字体素材的授权可能不同，再分发或商用前请核对 素材说明。}