dsh-plugin-wallpaper-engine

<a href="README.md"></a> <a href="README.en.md"></a> <a href="README.beginner.md"></a>

<a href="package.json"></a> <a href="#支持哪些壁纸类型"></a> <a href="#吉祥物与扩展"></a> <a href="cordis.patch.yml"></a>

<a href="#快速开始"></a> <a href="README.beginner.md"></a> <a href="docs/README.md"></a> <a href="https://github.com/elysia395/dsh-wallpaper-engine/releases"></a>

<h2 id="简介"></h2>

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

[!NOTE] 本页描述 elysia395/ Fish-under-sea 当前维护源码。正式项目由 elysia395/dsh-wallpaper-engine 维护；上方 Stars、Forks、贡献者、Release、npm 版本与下载量，以及下方 Star History，均来自正式主仓或同名 npm 包，不是本分支的统计。动态徽章有缓存，不代表本分支改动已经发布。

当前源码与正式发行的区别

项目	当前说明
源码入口	Fish-under-sea 维护仓库，灰测请下载这里的完整源码
正式版本与贡献记录	以 正式主仓 Release、Contributors 和 npm 页面为准；相同源码版本号不表示代码完全相同
部署闭包	主包加七个子包，共八包；完整源码安装器登记依赖，更新后不会因临时链接被包管理器清除而丢失子包
官方 pet 联动	通过 dsh-pet 公开接口接入，不再捆绑 pet、Electron 或第三方文件补丁；官方 pet 自行安装
外观预设与深浅	「作者自用」预设携带深色偏好，套用即把界面一并切到深色；全新安装默认套用它。发布版仍是「一次性二选一」弹窗询问，且套用预设不改深浅
体积变化	本次本地发布集压缩体积实测约 84.88 MiB → 25.12 MiB，减少约 70.4%；不含另装的官方 pet，不是内存或 Git 仓库体积
验收边界	已验证隔离部署、协议、排播与自有气泡 / 面板，预设与深浅联动已在本机真机实测；官方完整宠物及桌面端四套演出的真机视觉验收仍需补齐

源码包、正式发行和旧演示图应分别看待。不要用 npm 线上版本号或主仓热度推断本分支已经发布、已合并或完成所有平台验收。

<h2 id="目录"></h2>

    <li><a href="#能做什么">能做什么</a> · <a href="#支持哪些壁纸类型">支持哪些壁纸类型</a> · <a href="#安装">安装</a> · <a href="#使用">使用</a></li>
    <li><a href="#可选桌宠联动">可选桌宠联动</a> · <a href="#配置与数据">配置与数据</a> · <a href="#兼容与限制">兼容与限制</a> · <a href="#开发与贡献">开发与贡献</a></li>
    <li><a href="#联系方式">联系方式</a> · <a href="#致谢">致谢</a> · <a href="#支持与赞赏">支持与赞赏</a> · <a href="#star-history">Star History</a></li>
  <br><strong>生鱼的赞赏码</strong>
  <br><sub>“大肥鱼的白饭告急，收到的赞赏将统统用于本插件的维护与更新”</sub>
  <br><sub>自愿赞赏 · 不影响安装与使用</sub>

<h2 id="界面预览"></h2> <p align="center">_{真实界面演示；历史素材与当前安装版本可能略有不同。}</p> <h2 id="快速开始"></h2>

先下载本仓 ZIP 并解压，进入插件目录，完全退出目标 DSH 应用，然后执行：

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

网页宿主将 desktop 改为 web。完成后重启对应宿主，打开 设置 → Wallpaper Engine → 壁纸库。目标目录和 CLI 说明见 安装。

前置条件：DSH 0.2 内核（包括 0.2.0-rc.1/rc.2）、Node.js >=22.12.0 和 pnpm。自 1.4.0 起八包已发布到 npm，可直接按包名安装（见 npm 通道）；dsh-better-sidebar 是可选配套插件，不是必装依赖。

没用过命令行？从 新手指南 开始。

<h2 id="能做什么"></h2>

方向	能力
实时壁纸	内置 WebWallGL 渲染 Scene / Web 壁纸，支持粒子、puppet 骨骼、SceneScript、鼠标交互与音频反应；视频直接播放
液态玻璃	设置窗口、对话区与侧边栏玻璃效果，支持配色、透明度、雾化、边框与独立侧栏参数
外观预设	整套配置快照，字体、吉祥物与头像资产可按需携带；「作者自用」还携带深色偏好，套用即同步切换界面深浅；支持 JSON 导出、导入与分享
字体与配色	按颜色角色、排版角色和组件细调字体；支持系统字体、终端字体、字体集与独立光标颜色
吉祥物	10 只内置立绘 + 自定义导入，通过 3D 圆环选择；拉绳展开壁纸仓库抽屉
壁纸库	内容分级与类型筛选、批量隐藏与恢复、自定义图片 / 视频上传、WE 项目目录收录、自动轮播
播放与降载	帧率上限、转码缓存、倍速、水平翻转、切换过场、遮挡暂停与可迁移的缓存目录
音乐联动	系统输出回环频谱、Now Playing 歌曲信息与封面；在线歌词按需启用
扩展效果	可选的会话头像、点击 / 拖尾特效、壁纸与界面视差；不需要的效果可关闭
官方 pet 联动	对接独立安装的 dsh-pet，支持侧栏后拉、抓绳、踢腿弹飞和哈气；按 petId 选目标，桥接自行绘制气泡
宿主适配	Windows / macOS / Linux 使用同一套源码与发布集；界面跟随 DSH 的语言设置

…