DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在构建或使用 Web 端会话时，页面背景通常是固定的。如果希望根据心情或场景切换动态背景，或者增加视觉层次感，静态背景往往难以满足需求。njuptlzf/dsh-dynamic-background 是一款基于 DSH 的背景切换插件，它允许用户上传动图或使用纯色，通过定时切换和图层叠加实现丝滑的视觉体验。
这是一个纯前端插件，不依赖后端。它利用浏览器 IndexedDB 存储用户上传的图片和设置。插件主要负责在 DSH Web 界面中维护背景图层，处理图片上传、格式支持（GIF、WebP 等）以及自动生成的可读性遮罩层。
核心功能¶
-
多媒体支持
插件支持上传动图与静态图，格式包括 GIF、WebP、APNG、PNG、JPG 和 SVG。单张图片大小限制为 25MB。上传界面支持多选与拖拽操作。 -
纯色调色板
内置 12 色纯色调色板（赤橙黄绿青蓝紫粉白灰黑棕），点击即可添加并立即应用到当前背景。 -
切换逻辑
支持定时切换，间隔范围 3-120 秒，默认为 15 秒。切换模式支持顺序播放或随机播放。过渡效果采用双图层 opacity 交叉淡入淡出，并包含慢速 Ken Burns 缩放效果。插件会自动遵守系统的“减少动态”偏好设置。 -
可读性保护
为了防止动态背景影响文字阅读，插件会自动在聊天内容列（[data-chat-flow]）、状态栏以及会话头部自动叠加一层 84% 透明度的主题表面色遮罩。 -
显示与美化
支持完整显示（contain）或铺满（cover）两种模式。可选美化功能包括背景虚化（0-12px）和遮罩强度（0-90%）。 -
持久化与运行
插件常驻运行，关闭设置页后背景仍会自动切换。所有图片与设置均存储在浏览器的 IndexedDB 中，重启 DSH 或刷新页面后自动恢复。
安装与启用¶
使用 DSH 官方命令安装：
dsh plugin --profile web add github:njuptlzf/dsh-dynamic-background
安装完成后，重启 dsh web，进入 设置 → 动态背景 页面即可启用。
典型用法¶
进入设置页后，可以进行以下操作：
- 添加背景：点击 12 色色板添加纯色背景，或者通过“选择图片”/“拖拽”上传本地动图与静态图。
- 配置参数：设置显示模式（完整显示/铺满）、切换间隔（3-120s）、过渡时长（0.3-3s）。
- 调整美化：根据喜好调整背景虚化程度（0-12px）和遮罩强度（0-90%）。
- 控制播放：使用底部的控制栏支持随机/顺序切换、播放/暂停、手动切换下一张以及清空列表。
适用场景与注意¶
该插件适合希望个性化 DSH Web 界面、展示个人动图或增加视觉趣味性的用户。
需要注意：
* 插件数据存储在浏览器的 IndexedDB 中。如果清除浏览器缓存或数据，已上传的图片和设置将一并清除。
* 插件采用预编译提交，安装过程无需构建步骤。
