dsh-wallpaper-engine

项目详情摘要

dsh-plugin-wallpaper-engine English | 中文 | 小白向指南 🆕 **没用过命令行？先看这里：小白向使用指南（新手快速上手）→** —— 给完全没接触过命令行的用户准备的简化说明。 一个 DSH bundle，把你电脑上的 **Wallpaper Engine** 壁纸变成 **DSH 网页界面（`dsh web`）的背景**。 壁纸 + 磨砂遮罩 + iOS 液态玻璃，渲染在 DSH 界面后方。 目录 能做什么 · 更新前置条件 · 支持哪些壁纸类型 · 工作原理 安装 · 使用 · 配置 · 与 dsh-better-sidebar 的兼容适配 · 已知限制 · 开发 / 重建 · 联系方式 · 致谢 版本号、issue 号与性能数字见 `docs/CHANGELOG.md`；升级前置条件见 `docs/UPGRADING.md`。 📦 npm 包**不带 `docs/`**（随包的是运行期文件：`lib/**`、`cordis.patch.yml` 与三份 README）⇒ 上面这些 `docs/…` 链接在 npm / 插件市场里点不开，请到**源码仓库** 的同名路径阅读。 能做什么 它会自动发现你本机的 Wallpaper Engine 安装，列出你的壁纸，并把*可移植*的类型渲染到 DSH 对话界面**后方**的固定图层，配以 iOS 风格的**液态玻璃**界面改造。 版本号、issue 号与性能数字一律记在 `docs/CHANGELOG.md`。 壁纸渲染（核心）** **三类壁纸，三条渲染路径**：**Video** 直接播放；**Web / HTML** 走内置 WebWallGL 的网页挂载（宿主注入 WE API + 严格沙箱隔离）；**Scene（场景）** 由内置 **WebWallGL** 实时 WebGL 引擎渲染 —— 粒子系统、puppet 骨骼模型、SceneScript 脚本、鼠标视差与点击交互、包内音频与音频反应。 **实时优先、逐级降级**：场景 / 网页壁纸由内置渲染器**实时**渲染；渲染页有**心跳看护**，真的出不了帧就按一条**降级链**逐级回退，**首帧之前不留黑屏**，最后一级允许**诚实留空**。 降级链的**顺序、看护判据、失败记忆分层与垫底画面来源**只在 `docs/HOW-IT-WORKS.md` 定义一处 —— 本文只承诺"不会黑屏、不会被一张坏帧永久卡住"， 不重复它的步骤（重复一份就会在下一次改动时漏改一处）。 **高帧率源可降载**：**帧率上限**把 4K120 这类源一次性转成上限帧率（4K 保留 + AV1），**显著降低 GPU 占用**；**遮挡暂停**三档在最小化 / 失焦 / 电池供电时直接停解码。 **能搬的都搬**：本地 JPG / PNG / MP4 可直接上传当壁纸；自定义轮播列表按各自的间隔与顺序自动换壁纸（就绪后才切，不黑屏）。 界面改造（核心）** **跟随 DSH 的界面语言**：插件界面接进宿主的语言设置（设置 → 通用 → 语言）—— **语言目录与 dsh web 完全一致**（内置 `中文` / `English`，装了语言包也一并跟随）；切换即时生效，不需要重载页面，设置页、选择器、右栏 / 抽屉、吉祥物、字体集与更新说明全部跟着换。 **整个设置窗口液态玻璃（恒开）**：DSH 原生设置窗口整体（对话框 + 左导航 + 全部原生分区）都走玻璃配方 —— 原先那个"设置窗口液态玻璃"总开关**已退役**（实测那个"关"回不到原生纯色），配色 / 玻璃底色 / 透明度 / 雾化仍可调；逐面细调见「设置窗口玻璃·独立配置」。 **文字面保底**：承载文字的面固定压一层主题底色，最坏情况正文对比度 **4.63:1** —— 滑条调到极端也不会把字压得看不清。 **字体与光标可细调**：字体按**颜色角色 / 排版角色 / 组件**三层细化（字号、字重、字族各自可设）；输入光标独立取色。整套外观可存成**字体集**（随包自带预设，可新建 / 重命名 / 删除 / 恢复原样，也能**导出导入** `.json` 分享）。 **壁纸与界面融合可细调**：壁纸模糊、亮度 / 对比度 / 饱和度、