前置要求:DeepSeek Harness 0.1.5-rc.1+(DSH Desktop ≥ 2.0.7)且 dsh-better-sidebar ≥ 0.19.0,安装或更新本插件前请先更新两者。把本机 Wallpaper Engine 的 Video/Web 壁纸实时播放到聊天界面后方,Scene 壁纸由内置渲染器输出完整场景帧,支持内容分级/类型过滤、自定义壁纸上传与 iOS 液态玻璃设置窗口。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-plugin-wallpaper-engine
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:elysia395/dsh-wallpaper-engine
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
把本机 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
源码安装会构建客户端并注册主包与子包;安装后不要移动或删除源码目录。完整说明见 安装与升级 与 贡献指南;没有命令行经验请先看 入门指南。
- 打开 设置 → Wallpaper Engine → 壁纸库,或在聊天顶部从吉祥物拉绳进入壁纸仓库。
- 在页内壁纸库选择缩略图,按需调整播放与外观;修改即时生效并保存到宿主端。
- 暂停 / 播放只控制当前播放;清除当前壁纸不会删除原文件。
- Windows / macOS / Linux 使用同一份源码;macOS 没有 WE 客户端,可上传图片 / 视频或指向 WE 项目目录。
- Scene 渲染依赖浏览器 WebGL 与显卡驱动,复杂工坊项目可能存在兼容差异;失败会逐级降级。
- 遮挡暂停、窗口失焦暂停与音频回环采集按平台适配。
- 与其他皮肤 / 插件同时启用时,先看 共存说明。
欢迎提交 Bug 复现、平台兼容反馈、文档修正和功能 PR。反馈时请附宿主 / 插件版本、操作系统、壁纸类型、复现步骤与脱敏日志。
感谢所有贡献者对本项目的贡献 ❤️
链接
同类插件
Small-tailqwq/dsh-deep-whale#maid-atelier★ 3103
DSH Web 鲸鱼娘皮肤系列(深海女仆工坊 maid-atelier)。
Nwflower/dsh-claude-style★ 596
为 DSH Web GUI 复刻 Claude Code Desktop 的视觉与交互——象牙白/暖黑双画布、陶烬橙强调色、三字体排版、权限分段控件与品牌切换,以 CSS 覆盖与客户端 DOM override 实现。
d-dev0101/open-sea-skin★ 393
实时 WebGPU 海洋皮肤,可快捷调节波浪、日光、玻璃不透明度与自动昼夜循环。
kingOfSoySauce/dsh-liang-skin★ 387
自适应推理等级滑块皮肤,将当前模型可用档位映射到 0–30 视觉强度,并同步人物、背景和界面配色。
RevolutionLA/dsh-dream-skin★ 301
一键换肤插件:8 套原创主题、背景壁纸(透明度/模糊)、强调色、主题包导入/导出+分享链接、收藏与随机,纯原生 token 系统接入。
webkubor/dsh-bloom-theme★ 273
Bloom 莫兰迪主题:十五款变体(黛蓝 mist、朱砂 cinnabar、桃夭 petal、天青 ripple、竹青 sage、赭石 stone、青金 lapis、琥珀 amber、落霞 aurora、青莲 lavender、草色 mint、橙黄 tangerine、银红 silverrose、粉霞 dawn、轻黄 osmanthus)基于 OKLCH 调色,明暗切换不跳变;顶栏切换器精选 12 套并按色系相邻排列,每套配色右侧标出处诗句,30 组「主色 + 底色」实测全部达到 WCAG AA。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。