前言¶
使用 DeepSeek Harness Web UI 时，如果只想调整页面外观，通常不希望引入 Steam、Wallpaper Engine 或额外 npm 依赖。DSH Live Wallpaper 是一个面向 DSH Web UI 的插件，用于添加动态壁纸和页面主题中心。
项目由 hinayoung23 维护，许可证为 MIT。当前版本 v0.3.1 在 DeepSeek Harness 0.1.0-rc.7 上完成验证。
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解为官方应用商店。
这是什么¶
DSH Live Wallpaper 为 DeepSeek Harness Web UI 提供两类能力：
- 动态壁纸：内置离线程序化壁纸、本地媒体、远程媒体、ShaderToy 作品
- 页面主题中心：主题预设、颜色、按钮形态、字体风格和字号缩放
插件不依赖 Steam、Wallpaper Engine 或额外 npm 依赖。
核心功能¶
内置动态壁纸¶
提供四款离线程序化动态壁纸：极光、星云、落日流光、霓虹网格。
这些内置动态不需要访问外部网站，适合希望离线使用壁纸的场景。
ShaderToy 作品¶
可以粘贴 ShaderToy ID 或官方链接应用作品。App Key 是可选配置。
- 未配置 App Key 时，使用 ShaderToy 官方 Embed。
- 配置 App Key 后，优先获取源码并在本地 WebGL2 渲染。
- 本地 ShaderToy 渲染需要 WebGL2。
- 当前本地渲染支持一个
Image通道、可选一个Common通道，且不含外部输入。 Buffer A–D、纹理、音频、摄像头和立方体贴图会退回官方播放器。
远程与本地媒体¶
插件可应用 HTTP(S) 视频、图片或网页 URL。
视频 / 图片 URL 需要使用媒体直链，即在浏览器中打开后直接显示视频或图片。Pexels、Pixabay 等素材详情页不能作为媒体直链使用。
也可以临时应用本地视频、GIF 和图片。本地文件壁纸在刷新后不能重新取得本地文件权限，仅在当前页面生命周期内有效。
外观与主题¶
可以调整背景暗度、模糊、界面遮罩透明度和视频速度。
主题中心提供：
- 5 套页面主题预设
- 自定义主题底色、强调色和按钮颜色
- 圆角、胶囊、直角、玻璃和 DSH 原生共 5 种按钮形态
- 系统无衬线、圆体、衬线、等宽共 4 种字体风格
90%–115%字号缩放
壁纸与主题可独立开关。关闭主题或卸载插件后，恢复 DSH 原生外观。
动画与系统适配¶
页面隐藏，或系统开启“减少动态效果”时，插件会自动暂停可暂停的动画。
安装与启用¶
插件以当前 dsh 进程权限运行。安装前建议先检查源码与 MIT 许可证。
本地安装¶
在本地目录中使用：
dsh plugin --profile web add ./dsh-live-wallpaper
dsh --profile web --dump-config
dsh web
这一步先将本地目录作为插件添加，再重新生成 Web profile 配置，然后启动 DSH Web UI。
从 GitHub 安装¶
dsh plugin --profile web add github:hinayoung23/dsh-live-wallpaper#v0.3.1
从 npm 安装¶
dsh plugin --profile web add dsh-live-wallpaper
已核实资料提供了本地、GitHub、npm 多种安装命令，没有明确哪一个为唯一官方默认安装命令。可按当前环境和网络条件选择。
打开 DSH 后，点击右下角的圆形壁纸按钮进入插件面板。
典型用法¶
使用内置动态¶
打开插件面板后，可以直接使用四款内置动态。
这种方式不需要访问外部网站，也不需要 App Key。
使用下载的视频¶
如果准备使用 Pexels、Pixabay 等素材，可以按下面的步骤做：
- 在插件面板的“下载壁纸素材”中打开 Pexels 或 Pixabay。
- 选择作品并下载 MP4/WebM 文件，不要复制作品详情页地址。
- 回到插件面板，在“本地文件”中选择视频、GIF 或图片。
注意：远程服务器可能禁止跨站嵌入或热链。此时应下载文件后通过本地文件使用。
使用 ShaderToy¶
- 粘贴作品 ID，例如
XXcyRn，或粘贴完整官方链接，然后点击应用。 - 不配置 App Key 时，插件使用官方播放器。
- 如需本地源码渲染，展开“App Key（可选）/ 高级兼容”，从 ShaderToy Apps 取得 App Key 并保存。
- 之后插件会优先获取
Common + Image源码，并在本地 WebGL2 中编译；不兼容时退回官方播放器。
无 App Key 模式需要持续联网，并依赖 ShaderToy 官方 Embed 可用，且作品允许嵌入。
调整外观¶
在插件面板中调整背景暗度、模糊、界面遮罩透明度和视频速度。
主题项可以独立开关，也可以调整底色、强调色、按钮颜色、按钮形态、字体风格和字号缩放。
适用场景与注意¶
DSH Live Wallpaper 适合希望在 DeepSeek Harness Web UI 中更换背景、调整主题外观，且不想安装 Steam、Wallpaper Engine 或额外 npm 依赖的使用者。
使用前注意：
- 使用第三方视频、图片或 Shader 前，确认其授权允许你的使用方式。
- 本地文件壁纸仅在当前页面生命周期内有效；刷新后浏览器不能重新取得本地文件权限。
- 无 App Key 使用 ShaderToy 官方 Embed 时需要联网，并且作品必须允许嵌入。
- ShaderToy App Key 存放在 DSH 凭据服务中；浏览器只能查询配置状态，无法读回明文。
- Host 接口只接受同源 JSON 请求，并只访问固定的 ShaderToy 官方 API，不是通用网络代理。
- 插件不抓取网页，不绕过 Cloudflare 和作品访问控制，也不抓取、代理或绕过第三方壁纸市场访问控制。
- 用户自定义远程网页仍在更严格的 sandbox iframe 中运行，壁纸层默认不接收鼠标事件。
- 高级标签页捕获仅在当前页面生命周期内有效，并可能要求浏览器的屏幕录制权限。
链接¶
- GitHub：https://github.com/hinayoung23/dsh-live-wallpaper
- 目录页：https://www.skillhub.cn/plugins/hinayoung23/dsh-live-wallpaper
