hinayoung23/dsh-live-wallpaper

Skin皮肤 Native原生 ⭐ 2 MIT UI & Themes界面与主题

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

catalog descriptioncatalog 简介 / catalog description:Dependency-free dynamic wallpapers for the DeepSeek Harness Web UI

Project Overview项目介绍

This is a purpose-built plugin for the DeepSeek Harness Web UI that adds animated wallpaper support and a full in-app theme customization center. It does not require Steam, Wallpaper Engine, or any additional npm dependencies to run on the target DSH web interface. Users can install it via three official DSH methods: cloning the repository for a local install, direct install from the GitHub repository URL, or pulling the published package from the npm registry. It is compatible with the dsh web browser UI starting from DeepSeek Harness version 0.1.2-rc.1, and continuous integration testing covers Windows, Linux, Node.js 22/24, and the Chromium browser.

After installation, users can open the plugin panel by clicking the round wallpaper button in the bottom right corner of the DSH web UI. The plugin ships with four built-in offline procedural animated wallpapers that do not require any external network access or extra configuration to use right away. Users can also paste a ShaderToy ID or official URL to apply custom shaders, load direct HTTP(S) links for static images and videos, or temporarily apply local videos, GIFs, and images as wallpaper. It also includes five theme presets, five button styles, and four font styles, all customizable with adjustable scaling and color options.

The plugin is released under the open source MIT license, and follows strict security practices for handling user credentials. Any ShaderToy App Key is stored via the DSH credential service, so the browser can only check if a key is configured, but cannot read the plaintext value back to the user. There are several known limitations to note: local file wallpapers only last for the current page session, keyless ShaderToy use requires an active internet connection, and local rendering only supports one Image channel with an optional Common pass. Users should always confirm that third-party assets like videos, images, and shaders have licenses that permit their intended use.

这是一款专为 DeepSeek Harness Web UI 开发的原生插件,提供动态壁纸功能与完整的页面主题自定义中心,支持自定义多种界面细节。它不依赖 Steam、Wallpaper Engine 或额外的 npm 依赖,可通过 DSH 官方插件命令从本地路径、GitHub 或 npm 安装,当前兼容基线为 DSH 0.1.2-rc.1 版本的 Web 浏览器界面。

用户安装后打开 DSH 即可点击右下角圆形壁纸按钮打开面板,可直接使用四款内置离线程序化动态壁纸,不需要访问外部网络就能使用。也能粘贴 ShaderToy ID 或链接应用自定义作品,支持添加 HTTP(S) 直链视频图片、临时本地视频/GIF/图片作为壁纸,提供多套主题、按钮和字体样式自定义选项。

插件遵循 MIT 许可开源,ShaderToy App Key 会存储在 DSH 凭据服务中,浏览器仅能查询配置状态无法读取明文。已知限制包括本地文件壁纸仅当前页面生命周期有效、无 App Key 模式需要持续联网、本地渲染仅支持单 Image 通道加可选 Common 通道,使用第三方素材前需确认授权符合使用需求。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 hinayoung23/dsh-live-wallpaper 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Live Wallpaper

中文 | English

中文

为 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 安全上下文。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-gpt-oauth 下一个 Next dsh-tui-pro →