Skip to content
Back to search

dsh-wallpaper-engine

把本机 Wallpaper Engine 的壁纸搬进 DSH 网页界面:场景壁纸由内置 MIT 开源引擎 WebWallGL 实时 WebGL 渲染(粒子 / puppet 骨骼 / SceneScript / 音频反应 / 鼠标交互),失败自动降级内嵌 MP4 与场景静态帧;Web 壁纸严格沙箱 + WE API;iOS 风格液态玻璃 UI 高度自定义,遮挡暂停省电、ffmpeg 帧率上限转码、系统音频频谱与 Now Playing、自定义上传与自动轮播;设置存宿主端,对 agent 零 token 开销。Windows / macOS / Linux 三平台原生(同一个包、同一条命令)。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/elysia395/dsh-wallpaper-engine with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/elysia395/dsh-wallpaper-engine'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/elysia395--dsh-wallpaper-engine/badge.svg)](/listings/elysia395--dsh-wallpaper-engine)

HTML

<a href="/listings/elysia395--dsh-wallpaper-engine"><img src="/api/listings/elysia395--dsh-wallpaper-engine/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

普通用户

浏览器版安装或更新:

dsh plugin --profile web add dsh-plugin-wallpaper-engine

桌面版通过应用内插件市场安装;使用 CLI 时:

dsh plugin --profile desktop add dsh-plugin-wallpaper-engine

安装或更新后,**重启对应宿主**。桌面版需要完全退出应用后重新打开,而不只是刷新页面。

版本要求以 npm 包声明和 [升级指南](https://github.com/elysia395/dsh-wallpaper-engine/blob/main/docs/UPGRADING.md) 为准。历史桌面端版本号与 DSH 内核版本号不是同一个概念,不要混用。

macOS / Linux

三平台使用同一个包。系统媒体链路分别使用 Windows 的 GSMTC、macOS 的 MediaRemote、Linux 的 MPRIS。

macOS 没有 Wallpaper Engine 官方客户端。可以上传图片 / 视频,或把「自定义壁纸 → 存储位置」指向包含 WE 项目的目录。含 `project.json` 与场景包、网页入口或视频的项目会按对应类型收录;这些项目目录只读,不参与上传文件的删除操作。

安装失败

`ERR_PNPM_UNEXPECTED_VIRTUAL_STORE` 等安装错误的处理见 [故障排查](https://github.com/elysia395/dsh-wallpaper-engine/blob/main/docs/TROUBLESHOOTING.md)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 166 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <p>
  3. <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>
  4. <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>
  5. <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>
  6. </p>
  7. <h1>
  8. <picture>
  9. <source media="(prefers-color-scheme: dark)" srcset="assets/readme/hero-dark.png">
  10. <img src="assets/readme/hero-light.png" alt="DSH Wallpaper Engine" width="1440">
  11. </picture>
  12. </h1>
  13. [![npm Version](https://img.shields.io/npm/v/dsh-plugin-wallpaper-engine?style=flat-square&logo=npm&label=npm&color=8fd6a0&labelColor=5a544a)](https://www.npmjs.com/package/dsh-plugin-wallpaper-engine) [![正式主仓 Stars](https://img.shields.io/github/stars/elysia395/dsh-wallpaper-engine?style=flat-square&label=Upstream%20Stars&color=ffd84a)](https://github.com/elysia395/dsh-wallpaper-engine/stargazers)[![正式发布](https://img.shields.io/github/v/release/elysia395/dsh-wallpaper-engine?style=flat-square&label=Upstream%20Release&color=8fd6a0)](https://github.com/elysia395/dsh-wallpaper-engine/releases) [![npm 月下载量](https://img.shields.io/npm/dm/dsh-plugin-wallpaper-engine?style=flat-square&label=npm%20Downloads&color=8fd6a0)](https://www.npmjs.com/package/dsh-plugin-wallpaper-engine)
  14. <p>
  15. <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>
  16. <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>
  17. </p>
  18. <p>
  19. <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>
  20. <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>
  21. <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>
  22. <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>
  23. </p>
  24. </div>
  25. <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>
  26. 把本机 **Wallpaper Engine** 的 Scene、Web 与视频壁纸带进 DSH 对话界面,再配上液态玻璃、字体、吉祥物与可分享的外观预设。插件不向 agent 注册工具、不注入提示文本,**不增加模型 token 开销**。
  27. <a id="界面预览" href="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/main-interface.gif">
  28. <img src="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/main-interface.gif" alt="DSH 对话界面中的壁纸、液态玻璃与吉祥物演示" width="960">
  29. </a>
  30. <p align="center"><sub>真实界面演示;历史素材与当前安装版本可能略有不同。</sub></p>
  31. <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>
  32. <table>
  33. <tr>
  34. <td width="40%" valign="middle">
  35. <ul>
  36. <li><a href="#界面预览">界面预览</a> · <a href="#主要能力">主要能力</a> · <a href="#支持哪些壁纸">支持哪些壁纸</a></li>
  37. <li><a href="#快速开始">快速开始</a> · <a href="#使用">使用</a> · <a href="#兼容与限制">兼容与限制</a></li>
  38. <li><a href="#开发与贡献">开发与贡献</a> · <a href="#致谢">致谢</a></li>
  39. <li><a href="#赞赏">赞赏</a> · <a href="#联系方式">联系方式</a></li>
  40. </ul>
  41. </td>
  42. <td width="30%" align="center" valign="middle">
  43. <a href="assets/readme/mascot-eating-rice-1280x1784.jpg">
  44. <img src="assets/readme/mascot-eating-rice-1280x1784.jpg" alt="吉祥物干饭插画" width="320">
  45. </a>
  46. </td>
  47. <td id="赞赏" width="30%" align="center" valign="middle">
  48. <a href="assets/about/sponsor-fish.png"><img src="assets/about/sponsor-fish.png" alt="生鱼的赞赏码" width="260" height="260"></a>
  49. <br><strong>生鱼的赞赏码</strong>
  50. <br><sub>项目保持开源,赞赏完全自愿,不影响安装、使用或问题反馈。</sub>
  51. </td>
  52. </tr>
  53. </table>
  54. <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>
  55. - **壁纸**:Scene / Web 实时渲染,Video 直接播放;支持自定义图片 / 视频上传与 WE 项目目录。
  56. - **外观**:设置窗、对话区与侧栏液态玻璃;配色、透明度、模糊、边框与字体可调。
  57. - **玻璃子包**:液态玻璃是独立子包行 `wallpaper-engine-glass`,可在插件管理器单独停用;停用后,除内容区壁纸外界面回到宿中原生外观,壁纸、字体与吉祥物等功能不受影响。
  58. - **扩展**:吉祥物、会话头像、点击 / 拖尾特效、3D 视差;可选桌宠联动 [dsh-pet-dshwe](https://github.com/Fish-under-sea/dsh-pet-dshwe)(dsh-pet 全量 fork),设置页卡片可一键安装,未装 / 关闭 / 版本过旧时回落原生吉祥物。
  59. - **壁纸库**:筛选、隐藏 / 恢复、自动轮播;外观预设整套导入导出。
  60. <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>
  61. | 类型 | 在 DSH 中的路径 | 支持情况 |
  62. |---|---|---|
  63. | **Scene(场景)** | 内置 WebWallGL 实时渲染,失败时按降级链回退 | 支持,不需要 WE 在后台运行 |
  64. | **Web(网页)** | 网页挂载、WE API 注入与沙箱隔离 | 支持;效果取决于网页与浏览器能力 |
  65. | **Video(视频)** | 浏览器播放,配合转码、帧率上限与暂停控制 | 支持 |
  66. | **Picture(图片 / 幻灯片项目)** | 读取 WE `preset` 项目的图片目录,按 WE 里设的周期在本机交叉淡化轮播 | 支持;图片不上传、留在本机 |
  67. | **自定义图片 / 视频** | 上传本地 JPG / PNG / MP4 | 支持,文件保存在本机 |
  68. Application(应用)类壁纸需要启动第三方程序,**不支持**,也不会进入壁纸库或轮播候选。
  69. <h2 id="快速开始"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-start-dark.png"><img src="assets/readme/section-start-light.png" alt="快速开始" width="1440"></picture></h2>
  70. 前置:**Node.js >= 22.12.0**、**DSH 0.2 内核**(含 `0.2.0-rc.1/rc.2`)与 **pnpm**。安装前完全退出 DSH。
  71. **npm(推荐)**
  72. ```sh
  73. dsh plugin --profile web add dsh-plugin-wallpaper-engine
  74. ```
  75. 桌面端把 `web` 改为 `desktop`。
  76. 本仓按**多包发布集**发布:主包与同版本子包一起解析(具体包数、tarball 数与 `publishOrder` 见[发布流程](CONTRIBUTING.md#发布流程维护者),各版本变化见[变更记录](docs/CHANGELOG.md))。
  77. **源码**
  78. ```sh
  79. node scripts/install-source.mjs --profile desktop --dsh-home "<DSH 数据目录>" --app-closed
  80. ```
  81. 源码安装会构建客户端并注册主包与子包;安装后不要移动或删除源码目录。完整说明见 [安装与升级](docs/UPGRADING.md) 与 [贡献指南](CONTRIBUTING.md);没有命令行经验请先看 [入门指南](README.beginner.md)。
  82. <h2 id="使用"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-usage-dark.png"><img src="assets/readme/section-usage-light.png" alt="使用" width="1440"></picture></h2>
  83. 1. 打开 **设置 → Wallpaper Engine → 壁纸库**,或在聊天顶部从吉祥物拉绳进入壁纸仓库。
  84. 2. 在页内壁纸库选择缩略图,按需调整播放与外观;修改即时生效并保存到宿主端。
  85. 3. 暂停 / 播放只控制当前播放;清除当前壁纸不会删除原文件。
  86. <a href="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/settings-ui.gif">
  87. <img src="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/settings-ui.gif" alt="设置界面功能展示">
  88. </a>
  89. <a href="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/wallpaper-library.gif">
  90. <img src="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/wallpaper-library.gif" alt="壁纸库与壁纸仓库">
  91. </a>
  92. <h2 id="兼容与限制"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-compat-dark.png"><img src="assets/readme/section-compat-light.png" alt="兼容与限制" width="1440"></picture></h2>
  93. - Windows / macOS / Linux 使用同一份源码;macOS 没有 WE 客户端,可上传图片 / 视频或指向 WE 项目目录。
  94. - Scene 渲染依赖浏览器 WebGL 与显卡驱动,复杂工坊项目可能存在兼容差异;失败会逐级降级。
  95. - 遮挡暂停、窗口失焦暂停与音频回环采集按平台适配。
  96. - 与其他皮肤 / 插件同时启用时,先看 [共存说明](docs/HOW-IT-WORKS.md#共存玻璃表面与其他-ui-插件)。
  97. <a href="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/better-sidebar-font.png">
  98. <img src="https://github.com/elysia395/dsh-wallpaper-engine/releases/download/media-v1/better-sidebar-font.png" alt="侧栏玻璃与字体适配">
  99. </a>
  100. <h2 id="开发与贡献"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-develop-dark.png"><img src="assets/readme/section-develop-light.png" alt="开发与贡献" width="1440"></picture></h2>
  101. 欢迎提交 Bug 复现、平台兼容反馈、文档修正和功能 PR。反馈时请附宿主 / 插件版本、操作系统、壁纸类型、复现步骤与脱敏日志。
  102. - [工作原理](docs/HOW-IT-WORKS.md) · [故障排查](docs/TROUBLESHOOTING.md) · [升级指南](docs/UPGRADING.md)
  103. - [更新记录](docs/CHANGELOG.md) · [共存说明](docs/HOW-IT-WORKS.md#共存玻璃表面与其他-ui-插件) · [代码结构](docs/CODE-STRUCTURE.md)
  104. - [贡献指南](CONTRIBUTING.md) · [发布流程](CONTRIBUTING.md#发布流程维护者)
  105. <h2 id="联系方式"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-community-dark.png"><img src="assets/readme/section-community-light.png" alt="联系方式" width="1440"></picture></h2>
  106. <p align="center">
  107. <a href="lib/about/qq-group.png"><img src="lib/about/qq-group.png" alt="QQ 群:DSHWE | LLM 讨论群" width="260" height="259"></a>
  108. &nbsp;
  109. <a href="lib/about/douyin-group.png"><img src="lib/about/douyin-group.png" alt="抖音群:dshwe 交流 2 群" width="260" height="260"></a>
  110. </p>
  111. <h2 id="star-history"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-stars-dark.png"><img src="assets/readme/section-stars-light.png" alt="Star History" width="1440"></picture></h2>
  112. <a href="https://star-history.com/#elysia395/dsh-wallpaper-engine&Date">
  113. <picture>
  114. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=elysia395/dsh-wallpaper-engine&amp;type=Date&amp;theme=dark">
  115. <img src="https://api.star-history.com/svg?repos=elysia395/dsh-wallpaper-engine&amp;type=Date" alt="上游项目 Star History 趋势图" width="960">
  116. </picture>
  117. </a>
  118. <h2 id="致谢"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-credits-dark.png"><img src="assets/readme/section-credits-light.png" alt="致谢" width="1440"></picture></h2>
  119. 感谢所有贡献者对本项目的贡献 ❤️
  120. <a href="https://github.com/elysia395/dsh-wallpaper-engine/graphs/contributors">
  121. <img src="https://contrib.rocks/image?repo=elysia395/dsh-wallpaper-engine" alt="Contributors">
  122. </a>
  123. <p align="center"><sub>代码以 <a href="LICENSE">MIT License</a> 开源;壁纸、角色与字体素材的授权可能不同,再分发或商用前请核对 <a href="assets/readme/SOURCES.md">素材说明</a>。</sub></p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.