dsh-thirteen-bg：DeepSeek Harness Web GUI 动态背景插件

前言¶

DeepSeek Harness（DSH）采用插件化架构，Web GUI 作为其中的一部分也支持通过插件扩展功能。默认界面较为简洁，对于希望在开发或使用过程中增加视觉个性的用户，静态背景难以满足需求。dsh-thirteen-bg 旨在为 DSH Web GUI 提供动态背景支持，通过引入 GIF、视频或静态图片，使界面具备类似 Live Wallpaper 的效果。

这是什么¶

dsh-thirteen-bg 是一个由 feng78-boop 维护的 Live Wallpaper 插件，专门用于 DeepSeek Harness 的 Web GUI。它支持将本地文件或网络链接的媒体资源设置为浏览器窗口的动态背景，并内置了压暗控制功能，以确保前景文字的可读性。

核心功能¶

多格式支持：支持 GIF、动图 WebP、APNG、静态 PNG 以及 JPG 图片，同时也支持 MP4、WebM 和 MOV 视频。
自动格式识别：插件会根据文件扩展名或 MIME 类型自动判断是使用图片渲染还是视频渲染。
渲染方式：
- 视频：使用 HTML5 <video> 标签渲染，配置为静音、循环播放、开启硬件加速，并在切后台时自动暂停。
- 图片：使用 CSS background-image 渲染。
存储机制：完全基于客户端运行。设置参数保存在浏览器的 localStorage 中，用户上传的本地文件则存储在 IndexedDB 中，支持不限大小的文件上传。
压暗滑块：内置调节背景亮度的滑块，防止背景过亮影响界面阅读。

安装与启用¶

插件安装后需重启 Web 进程方可生效。

执行安装命令：

    dsh plugin --profile web add dsh-thirteen-bg

安装完成后，重启 DSH Web 服务或直接刷新浏览器。
在浏览器中硬刷新页面（Ctrl+F5）。
进入「设置」→「通用」，找到「动态背景」卡片。

典型用法¶

在「动态背景」卡片中，支持以下两种操作：

上传本地文件：点击上传按钮选择本地文件（支持不限大小的动图或视频）。
粘贴 URL：粘贴有效的 HTTP(S) 媒体链接。

设置生效后，使用滑块调节背景的压暗程度，以获得最佳的视觉体验。

注意事项¶

本地路径限制：浏览器安全策略禁止直接使用本地文件路径（如 C:\... 或 file:///...）作为 URL。必须通过「上传」按钮选择本地文件，远程媒体才可使用 URL。
兼容性：背景层是一个真实的 DOM 元素（div 或 video），挂载在 <html> 下，不占用伪元素。因此它与 dsh-client-ui-skins、dsh-dream-skin 等依赖伪元素的皮肤插件零冲突，动态背景始终可见。
性能建议：为保证流畅度，建议图片长边不超过 1920px，视频分辨率控制在 1080p，文件体积建议在几十 MB 以内。

参考资料¶

插件目录：https://www.skillhub.cn/plugins/feng78-boop/dsh-thirteen-bg
源码地址：https://github.com/feng78-boop/dsh-thirteen-bg