dsh-plugin-wallpaper-engine

<div align="center">

<p>

<a href="README.md"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-lang-zh-dark.png"><img src="assets/readme/key-lang-zh-light.png" alt="中文" height="60"></picture></a>

<a href="README.en.md"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-lang-en-dark.png"><img src="assets/readme/key-lang-en-light.png" alt="English" height="48"></picture></a>

<a href="README.beginner.md"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-lang-start-dark.png"><img src="assets/readme/key-lang-start-light.png" alt="入门指南" height="48"></picture></a>

</p>

<h1>

<picture>

<source media="(prefers-color-scheme: dark)" srcset="assets/readme/hero-dark.png">

<img src="assets/readme/hero-light.png" alt="DSH Wallpaper Engine" width="1440">

</picture>

</h1>

  

<p>

<a href="https://trendshift.io/repositories/170341" target="_blank"><img src="https://raw.githubusercontent.com/elysia395/dsh-wallpaper-engine/badges/trendshift-daily.svg" alt="Trendshift · JavaScript 日榜最好名次" width="250" height="55"></a>

<a href="https://trendshift.io/repositories/170341" target="_blank"><img src="https://raw.githubusercontent.com/elysia395/dsh-wallpaper-engine/badges/trendshift-weekly.svg" alt="Trendshift · JavaScript 周榜最好名次" width="250" height="55"></a>

</p>

<p>

<a href="#快速开始"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-get-dark.png"><img src="assets/readme/key-get-light.png" alt="安装使用 GET" height="48"></picture></a>

<a href="README.beginner.md"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-setup-dark.png"><img src="assets/readme/key-setup-light.png" alt="新手指南 SETUP" height="48"></picture></a>

<a href="docs/README.md"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-docs-dark.png"><img src="assets/readme/key-docs-light.png" alt="文档 DOCS" height="48"></picture></a>

<a href="https://github.com/elysia395/dsh-wallpaper-engine/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/key-release-dark.png"><img src="assets/readme/key-release-light.png" alt="发布页 RELEASE" height="48"></picture></a>

</p>

</div>

<h2 id="简介"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-intro-dark.png"><img src="assets/readme/section-intro-light.png" alt="INTRO · 简介" width="1440"></picture></h2>

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

<a id="界面预览" href="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/main-interface.gif">

<img src="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/main-interface.gif" alt="DSH 对话界面中的壁纸、液态玻璃与吉祥物演示" width="960">

</a>

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

<h2 id="目录"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-index-dark.png"><img src="assets/readme/section-index-light.png" alt="目录" width="1440"></picture></h2>

<table>

<tr>

<td width="40%" valign="middle">

<ul>

<li><a href="#界面预览">界面预览</a> · <a href="#主要能力">主要能力</a> · <a href="#支持哪些壁纸">支持哪些壁纸</a></li>

<li><a href="#快速开始">快速开始</a> · <a href="#使用">使用</a> · <a href="#兼容与限制">兼容与限制</a></li>

<li><a href="#开发与贡献">开发与贡献</a> · <a href="#致谢">致谢</a></li>

<li><a href="#赞赏">赞赏</a> · <a href="#联系方式">联系方式</a></li>

</ul>

</td>

<td width="30%" align="center" valign="middle">

<a href="assets/readme/mascot-eating-rice-1280x1784.jpg">

<img src="assets/readme/mascot-eating-rice-1280x1784.jpg" alt="吉祥物干饭插画" width="320">

</a>

</td>

<td id="赞赏" width="30%" align="center" valign="middle">

<a href="assets/about/sponsor-fish.png"><img src="assets/about/sponsor-fish.png" alt="生鱼的赞赏码" width="260" height="260"></a>

<br><strong>生鱼的赞赏码</strong>

<br>_{项目保持开源，赞赏完全自愿，不影响安装、使用或问题反馈。}

</td>

</tr>

</table>

<h2 id="主要能力"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-features-dark.png"><img src="assets/readme/section-features-light.png" alt="能做什么" width="1440"></picture></h2>

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

<h2 id="支持哪些壁纸"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-formats-dark.png"><img src="assets/readme/section-formats-light.png" alt="支持哪些壁纸类型" width="1440"></picture></h2>

类型 · 在 DSH 中的路径 · 支持情况

Scene（场景） · 内置 WebWallGL 实时渲染，失败时按降级链回退 · 支持，不需要 WE 在后台运行

Web（网页） · 网页挂载、WE API 注入与沙箱隔离 · 支持；效果取决于网页与浏览器能力

Video（视频） · 浏览器播放，配合转码、帧率上限与暂停控制 · 支持

Picture（图片 / 幻灯片项目） · 读取 WE preset 项目的图片目录，按 WE 里设的周期在本机交叉淡化轮播 · 支持；图片不上传、留在本机

自定义图片 / 视频

…(truncated)