使用

打开 设置 → Wallpaper Engine，或向下拉聊天顶部的吉祥物拉绳，展开「壁纸仓库」抽屉。
在「壁纸库」中点 选择壁纸，进入页内库视图。它不是额外的模态弹窗。
通过缩略图选择壁纸，按需调整播放与外观。修改即时生效并保存到宿主端。
暂停 / 播放控制视频；清除当前壁纸不会删除原文件。

设置界面功能展示

六个设置页签

页签	主要内容
壁纸库	壁纸选择、筛选、自定义上传与轮播列表
外观	主题预设、配色、玻璃、侧边栏圆角、全局 UI 配色与字体
播放	画面滤镜、取景、倍速、过场、音频与媒体联动
系统	吉祥物、宿主适配、遮挡暂停、缓存与高级选项
扩展	会话头像、点击与拖尾、3D 视差等可选效果
关于	项目入口、Star 数、交流群与贡献者信息

壁纸库与自动轮播

筛选：按内容分级与类型过滤；筛选同时作用于库视图与轮播候选。
隐藏 / 恢复：只改变列表，不删除源文件。支持批量隐藏与恢复；隐藏当前壁纸不会中断播放。
自动轮播：创建列表，选择壁纸并设置间隔与顺序 / 随机播放。至少需要两张可播放壁纸。
准备后切换：下一张准备完成后再交接；失败候选自动跳过。可选择硬切、淡化、推移等过场，系统「减少动态效果」开启时使用硬切。
壁纸属性：Scene / Web 壁纸可显示作者定义的颜色、开关、滑块等属性，按壁纸保存，并可恢复默认。

壁纸库与壁纸仓库

演示素材保留历史界面；当前交互以安装版本为准，壁纸选择在页内库视图完成。

液态玻璃、字体与预设

设置窗口玻璃当前恒开；可调整颜色、透明度和雾化，没有恢复原生纯色的总开关。
额外补雾化的选择器：第三方插件面板自身没有 backdrop-filter，全局「雾化」到不了它们 —— 在这里填它们的 CSS 选择器即可补上毛玻璃（逗号或换行分隔，最多 8 条、每条最多 120 字；超长的单条与超出 8 条的都整条丢弃，绝不截断成半截选择器；目标元素需自己已定位 fixed / absolute，载体挂在它的 ::before 上，所以不影响面板内部的定位弹层。留空 = 关；#200）。
设置页与侧栏均可调整外观，各节支持折叠；侧栏的圆角、全局 UI 配色与全局字体默认收起。
主题随壁纸默认关闭。开启后才按作者配色与画面取色切换深浅主题；本张壁纸下手动改过主题后，自动切换会让位。
字体支持按角色 / 组件细调、系统字体枚举与字体集管理。终端里的 Nerd Font 图标需要对应字体。
「主题预设」保存的是整套配置，不只是玻璃参数。导入只加入列表，不立即应用；分享时可选择携带字体、吉祥物和头像。
套用预设前注意覆盖范围：预设可能更换或清除自定义资产。保存、导出与套用前，阅读对应确认提示。

默认值、枚举与取值范围以设置 schema 和当前控件为准，避免在文档中维护一套容易过时的数值。

吉祥物与扩展

3D 转盘提供 Deepseek_Pro、菲比啾比 与 Claude、DeepSeek、Gemini、GPT、GLM、Grok、Kimi、Qwen，默认形态是 DeepSeek。支持拖动、方向键与圆点导航，也可导入自己的立绘；自定义生效后仍可选择内置项，但切回前会要求确认清除自定义立绘。

「小女仆」不在内置转盘中，由「作者自用」预设携带。会话头像、点击 / 拖尾与 3D 视差在「扩展」中按需启用。

播放、省电与音乐联动

画面可调模糊、亮度、对比度、饱和度、透明度、暗化与取景。视频支持倍速与翻转。
帧率上限由 ffmpeg 转码生成缓存：先播放原片，完成后切换；优先使用可用的硬件编码器，失败回退原片或软件编码。
遮挡暂停覆盖视频解码和场景实时渲染；窗口失焦暂停只在原生浏览器适配目标下提供，纯网页 iframe 不受同样的暂停控制。
系统音频反应采集的是输出回环，不是麦克风。媒体中间件按需下载并校验，不可用时回退内置实现。
Now Playing 提供歌名、歌手、专辑、封面与播放进度；支持这些 WE API 的壁纸可显示它们。
在线歌词默认关闭。开启后，本地歌词不可用时才向 LRCLIB 查询，请求会发送歌名、歌手和专辑。

配置与数据

全部设置保存在宿主端 ~/.dsh-wallpaper-engine/config.json，不依赖浏览器端口。重启、换端口或清浏览器数据不影响这份配置；旧 localStorage 配置可自动迁移。

数据	默认位置	调整入口
设置与插件数据	`~/.dsh-wallpaper-engine/`	环境变量 `DSH_WE_DATA_DIR`
可再生成缓存	`~/.dsh-wallpaper-engine/cache/`	系统 → 高级 → 缓存位置；或 `DSH_WE_CACHE_DIR`
上传的壁纸	`~/.dsh-wallpaper-engine/uploads/`	壁纸库 → 自定义壁纸 → 存储位置；或 `DSH_WE_UPLOAD_DIR`
按需下载的运行时	数据目录下的 `bin/` 等子目录	由插件管理

修改缓存 / 上传位置时会迁移对应的插件文件，不移动目标目录中不认识的文件。环境变量优先于面板中的路径设置。

常用环境变量：

变量	用途
`DSH_WE_DATA_DIR`	覆盖整个数据目录
`DSH_WE_CACHE_DIR` / `DSH_WE_UPLOAD_DIR`	覆盖缓存 / 上传目录
`DSH_WE_STEAM_ROOT`	指定 Steam 根目录，支持多个候选
`DSH_WE_ASSETS_DIR`	覆盖 WE 官方资源路径
`DSH_WE_FFMPEG` / `DSH_WE_FFMPEG_URL`	指定 ffmpeg 文件 / 下载源
`DSH_WE_TRANSCODE_TIMEOUT_MS`	单次转码的超时预算
`DSH_WE_MEDIA_BRIDGE` / `DSH_WE_MEDIA_BRIDGE_URL`	指定媒体中间件文件 / 下载源
`DSH_WE_MEDIA_BRIDGE_TAG` / `DSH_WE_MEDIA_BRIDGE_SHA256`	指定中间件版本与校验值；自定义版本必须给出 SHA-256
`DSH_WE_MEDIA_LEGACY`	`=1`，强制使用内置媒体实现
`DSH_WE_MEDIA_NO_AUDIO`	`=1`，只读取媒体信息，不采集系统音频
`DSH_WE_MEDIA_PROVIDER`	`=mock`，使用模拟播放器联调
`DSH_WE_MEDIA_IDLE_MS` / `DSH_WE_MEDIA_DEBUG`	中间件空闲回收时间 / 调试日志

插件不向模型注册工具，不上传你的壁纸；但下载运行时、查询仓库 Stars 和主动开启在线歌词会访问外部服务。它不是「完全离线」插件。

dsh-plugin-wallpaper-engine

同名パッケージの別リポジトリ

インストール

ドキュメント

使用