dsh-wallpaper-rotator (Enhanced)

前言¶

DeepSeek Harness (DSH) 采用插件化架构，允许开发者通过插件扩展 Web UI 的表现层。在开发或使用 Web UI 时，背景壁纸直接影响视觉沉浸感。原版插件仅支持静态图片，且存在毛玻璃模糊失效、视频转图片过渡黑屏等技术缺陷，导致在复杂界面下可读性不足。本插件在原版基础上进行二开，重点修复了渲染兼容性问题并增强了多媒体支持。

是什么¶

dsh-wallpaper-rotator (Enhanced) 是基于 liceses/dsh-wallpaper-rotator 的二开增强版。它作为 DSH Web UI 插件运行，旨在解决动态背景下的渲染稳定性与多媒体支持问题，同时保持原版的 MIT 许可证授权。

核心功能¶

本插件通过以下机制提升背景切换体验与界面可读性：

多媒体支持与无缝切换
- 支持 mp4、webm、mov、m4v 格式的视频背景，自动循环静音播放。
- 图片与视频在轮换过程中通过淡入淡出效果无缝衔接，避免视觉突兀。
视频层独立渲染
- 视频层拥有独立的压暗层，与图片层共用“壁纸压暗”设置。切换至视频背景时，压暗渐变不会丢失。
- “毛玻璃模糊”设置对视频层同样生效（已修复原版 CSS 语法错误）。
- 单个视频文件上限放宽至 1GB（图片仍为 64MB）。
表面中和
- 新增自动清除大尺寸不透明面板背景的功能。侧边栏、文件树、绘画面板、输入条等面板的背景色会被自动设为透明，使壁纸铺满整个页面。
- 识别纯色、半透明及渐变背景，并清除装饰性的淡出蒙层。
- 使用 data-wp-neutralized 标记和 CSS !important 确保在 React 重渲染时保持透明度，同时保护插件自身的视频层不被误清除。
兼容性与修复
- 毛玻璃修复：修正了原版 filter: blur(blur(8px)) 的非法 CSS 写法，使模糊滑块恢复正常工作。
- 黑屏修复：解决了视频转图片轮换结束时 cur 图层不透明度未恢复导致的黑屏问题。
- rc.6 兼容：移除已废弃的 client timer 服务，改用原生 setInterval、setTimeout 及自实现的 debounce，确保在较新的 DSH 版本（rc.6）中能正常加载。

安装与启用¶

使用官方命令行工具安装插件：

dsh plugin --profile web add github:Jieice/dsh-wallpaper-rotator-enhanced

安装完成后，重启 dsh web，进入 设置 → 壁纸轮换 即可开始配置。

典型用法¶

配置数据持久化存储在 $DSH_HOME/wallpaper-rotator.json。可配置项包括：

资源管理：壁纸文件夹路径（支持图片与视频混合），轮换间隔（秒/分/时），顺序或随机。
界面调节：面板透明度、壁纸压暗程度、毛玻璃模糊半径（0-24px）、文字阴影样式。

注意事项¶

本插件二开版本全部使用原生定时器实现，不再依赖废弃的 client 服务。
视频文件较大（上限 1GB），加载速度取决于网络带宽与主机性能。
插件以当前 dsh 进程的权限运行，安装前建议检查源码与许可证。

结语¶

dsh-wallpaper-rotator (Enhanced) 为 DSH Web UI 提供了从静态到动态、从单一到混合的完整壁纸解决方案。通过修复渲染细节并引入视频支持，它提升了界面的美观度与实用性。更多细节可查阅插件目录或源码仓库。