hinayoung23/dsh-live-wallpaper

DSH 动态壁纸

中文

为 DeepSeek Harness Web UI 提供动态壁纸与页面主题中心。插件不依赖 Steam、Wallpaper Engine 或额外 npm 依赖；无 App Key 时直接使用 ShaderToy 官方播放器，配置 App Key 后可获取源码并在浏览器 WebGL2 中本地渲染。

当前兼容基线为 DeepSeek Harness 0.1.2-rc.1 的 dsh web 浏览器界面。

0.3.2 修复 Windows 文件关联缺失导致本地 MP4/WebM/图片被拒绝的问题，并在恢复缓存 ShaderToy 源码时处理 WebGL2 不可用的情况。CI 覆盖 Windows/Linux、Node.js 22/24 和 Chromium 浏览器。插件支持范围为 Web UI；原生桌面客户端的 file:///IPC 加载方式不在此声明范围内。

功能

- 四款离线程序化动态壁纸：极光、星云、落日流光、霓虹网格
- 粘贴 ShaderToy ID 或官方链接即可应用；App Key 可选
- 未配置 App Key 时使用官方 Embed，配置后优先本地渲染 Common + Image 源码
- 应用 HTTP(S) 视频、图片或网页 URL
- 临时应用本地视频、GIF 和图片
- 调整背景暗度、模糊、界面遮罩透明度和视频速度
- 5 套页面主题预设，并可分别自定义主题底色、强调色和按钮颜色
- 圆角、胶囊、直角、玻璃和 DSH 原生共 5 种按钮形态
- 系统无衬线、圆体、衬线、等宽共 4 种字体风格，以及 90%–115% 字号缩放
- 壁纸与主题可独立开关；关闭主题或卸载插件后自动恢复 DSH 原生外观
- 页面隐藏、系统开启“减少动态效果”时自动暂停可暂停的动画
- 除本地文件和标签页捕获外，配置、ShaderToy ID 与已获取源码保存在浏览器 localStorage 中

本地安装

dsh plugin --profile web add ./dsh-live-wallpaper
dsh --profile web --dump-config
dsh web

打开 DSH 后，点击右下角的圆形壁纸按钮。

从 GitHub 安装

dsh plugin --profile web add github:hinayoung23/dsh-live-wallpaper#v0.3.2

从 npm 安装

dsh plugin --profile web add dsh-live-wallpaper

素材使用方法

最简单、最稳定的方式是直接使用面板中的四款“内置动态”，它们不需要访问任何外部网站。

使用下载的视频：

1. 在插件面板的“下载壁纸素材”中打开 Pexels 或 Pixabay。
2. 在网站中选择作品并下载 MP4/WebM 文件，不要复制作品详情页地址。
3. 回到插件面板，在“本地文件”中点击“选择视频、GIF 或图片”。

使用 ShaderToy：

1. 粘贴作品 ID（例如 XXcyRn）或完整官方链接，点击“应用”；无需 App Key。
2. 未配置 App Key 时，插件直接嵌入 ShaderToy 官方播放器并保存 ID；刷新或重启 DSH 后会自动恢复。
3. 如需本地源码渲染，展开“App Key（可选）/ 高级兼容”，从 ShaderToy Apps 取得 App Key 并保存。之后插件会优先获取 Common + Image 源码并在本地 WebGL2 中编译。
4. 源码通道或本地编译不兼容时，插件会自动退回官方播放器；标签页捕获仍保留为高级兼容方式。

“视频 / 图片 URL”要求媒体直链，即在浏览器中打开后直接显示视频或图片；Pexels、Pixabay 等素材详情页不能作为媒体直链使用。

来源与安全

- ShaderToy App Key 存放在 DSH 凭据服务中；浏览器只能查询配置状态，无法读回明文。
- Host 接口只接受同源 JSON 请求，并只访问固定的 ShaderToy 官方 API，不是通用网络代理。
- 插件仅获取作者允许通过官方 API 访问的源码，不抓取网页或绕过 Cloudflare 和作品访问控制。
- 仅固定的 ShaderToy 官方 Embed 使用 allow-same-origin；用户自定义远程网页仍在更严格的 sandbox iframe 中运行。壁纸层默认不接收鼠标事件。
- 插件不会抓取、代理或绕过任何第三方壁纸市场的访问控制。
- 使用第三方视频、图片或 Shader 前，请确认其授权允许你的使用方式。

已知限制

- 浏览器不能在刷新后重新取得本地文件权限，因此本地文件壁纸仅在当前页面生命周期内有效。
- 无 App Key 模式需要持续联网，并依赖 ShaderToy 官方 Embed 可用且作品允许嵌入。
- 远程服务器可能禁止跨站嵌入或热链；这时请下载文件后通过“本地文件”使用。
- 当前本地渲染支持一个 Image 通道、可选一个 Common 通道且不含外部输入；Buffer A–D、纹理、音频、摄像头和立方体贴图会自动退回官方播放器。
- ShaderToy 官方 API 只返回作者标记为可通过 API 访问的作品；其他可嵌入作品会自动使用官方播放器。
- 本地 ShaderToy 渲染需要 WebGL2。高级标签页捕获仅在当前页面生命周期内有效，并可能要求浏览器的屏幕录制权限。
- 本地视频能否解码取决于浏览器和系统编解码器；建议 H.264 MP4 或 VP8/VP9 WebM。内置动画暂停时请检查系统“动画效果”及插件“尊重减少动态效果”选项。标签页捕获需要 HTTPS 或 localhost 安全上下文。

开发验证

pnpm check
pnpm exec playwright install chromium
pnpm test:browser
pnpm pack

许可证

MIT

English
DSH 动态壁纸为 DeepSeek Harness Web UI 添加了动态壁纸和页面主题中心。它既不需要 Steam、Wallpaper Engine，也不需要额外的 npm 依赖。没有 App Key 时，它使用官方 ShaderToy 播放器；有 App Key 时，它可以通过本地 DSH Host 获取源码，并用 WebGL2 进行渲染。

当前的兼容性基线是 DeepSeek Harness 0.1.2-rc.1 中的 dsh web 浏览器 UI。

版本 0.3.2 在 Windows 文件关联提供空或通用 MIME 类型时接受本地 MP4/WebM/图片，并在缓存的着色器源码无法使用 WebGL2 时回退到官方播放器。CI 覆盖 Windows/Linux、Node.js 22/24 和 Chromium。支持的界面是 Web UI；原生桌面 file:///IPC 加载不在本声明范围内。

功能

- 四种离线程序化动态壁纸：Aurora、Nebula、Sunset Flow 和 Neon Grid
- 粘贴 ShaderToy ID 或官方 URL 即可应用，无需 App Key
- 无需密钥即可使用官方 Embed，也可选择使用密钥获取并在本地渲染 Common + Image 源码
- 使用 HTTP(S) 视频、图片或网页 URL 作为壁纸
- 临时应用本地视频、GIF 和图片
- 调整背景变暗、模糊、UI 叠加不透明度和视频播放速度
- 五种页面主题预设，可独立自定义基础色、强调色和按钮颜色
- 五种按钮样式：圆角、胶囊、方形、玻璃和原生 DSH
- 四种字体样式——系统无衬线、圆体、衬线和等宽——并支持 90%–115% 字体缩放
- 可独立启用壁纸和主题；禁用主题或卸载插件可恢复原生 DSH 外观
- 当页面隐藏或系统请求减少动态效果时，自动暂停支持的动画
- 将配置、ShaderToy ID 和获取的源码存储在浏览器 localStorage 中，本地文件和标签页捕获除外

本地安装

dsh plugin --profile web add ./dsh-live-wallpaper
dsh --profile web --dump-config
dsh web

打开 DSH 后，点击右下角的圆形壁纸按钮。

从 GitHub 安装

dsh plugin --profile web add github:hinayoung23/dsh-live-wallpaper#v0.3.2

从 npm 安装

dsh plugin --profile web add dsh-live-wallpaper

如何使用壁纸来源

最简单、最可靠的选择是使用四种内置动画预设之一。它们不需要访问任何外部网站。

要使用下载的视频：

1. 从插件面板中的“下载壁纸媒体”部分打开 Pexels 或 Pixabay。
2. 选择一个视频并下载其 MP4/WebM 文件。不要复制素材详情页 URL。
3. 返回插件面板，点击“本地文件”下的“选择视频、GIF 或图片”。

要使用 ShaderToy：

1. 粘贴作品 ID（例如 XXcyRn）或完整的官方 URL，然后点击“应用”。无需 App Key。
2. 在没有密钥的情况下，插件会嵌入官方 ShaderToy 播放器并保存 ID，以便壁纸在刷新或 DSH 重启后恢复。
3. 对于本地源码渲染，展开 App Key (Optional) / Advanced Compatibility，从 ShaderToy Apps 获取密钥并保存。后续应用会优先使用 WebGL2 在本地获取并编译 Common + Image 源码。
4. 如果源码通过或本地编译不兼容，插件会自动回退到官方播放器。标签页捕获仍可作为高级兼容性选项使用。

Video / Image URL 字段需要直接媒体 URL——即在浏览器中打开后直接显示视频或图像本身的 URL。Pexels 和 Pixabay 的素材详情页不是直接媒体 URL。

来源与安全

- ShaderToy App Key 由 DSH 凭据服务存储。浏览器可以查询其配置状态，但无法读取已保存的明文值。
- Host 端点仅接受同源 JSON 请求，并且只面向固定的官方 ShaderToy API；它不是通用网络代理。
- 插件仅获取作者通过官方 API 允许的源码。它不会抓取页面，也不会绕过 Cloudflare 或作品访问控制。
- 只有固定的官方 ShaderToy Embed 会获得 allow-same-origin；用户提供的远程页面仍保留在更严格的沙盒 iframe 中。壁纸层默认不接收指针事件。
- 插件不会抓取、代理或绕过任何第三方壁纸市场的访问控制。
- 在使用第三方视频、图像或着色器之前，请确认其许可证允许你预期的用途。

已知限制

- 浏览器无法在页面重新加载后恢复本地文件权限，因此本地文件壁纸仅在当前页面生命周期内可用。
- 无密钥模式需要网络连接，并依赖官方 ShaderToy Embed 可用且允许用于该作品。
- 远程服务器可能会阻止跨源嵌入或热链接。在这种情况下，请下载文件并使用 Local File 选项。
- 本地渲染目前支持一个 Image pass、一个可选的 Common pass，并且不支持外部输入。Buffer A–D、纹理、音频、摄像头和立方体贴图会自动回退到官方播放器。
- 官方 ShaderToy API 仅返回作者允许 API 访问的作品。其他可嵌入作品会自动使用官方播放器。
- 本地 ShaderToy 渲染需要 WebGL2。高级标签页捕获仅在当前页面生命周期内有效，并且可能需要屏幕录制权限。
- 视频解码取决于浏览器和操作系统编解码器；优先使用 H.264 MP4 或 VP8/VP9 WebM。如果内置动画暂停，请检查操作系统动画设置以及插件的减少动态效果选项。标签页捕获需要 HTTPS 或 localhost。

开发验证

pnpm check
pnpm exec playwright install chromium
pnpm test:browser
pnpm pack

许可证

MIT