DSH 的插件化架构允许开发者扩展功能，视觉层面的定制通常需要修改代码或使用复杂的主题配置。sz1698/dsh-bg-new 专注于解决网页界面的背景定制问题，它不依赖云端服务，而是通过本地媒体伺服和即时渲染，让用户能够快速更换系统预设、纯色、渐变、图片或视频作为背景。
这是一个给 DeepSeek Harness 网页界面换背景的插件。作者为 sz1698，开源协议为 MIT。它通过侧栏入口和抽屉式 UI，支持系统预设、纯色、渐变、图片和视频五种背景模式，并包含本地媒体伺服、毛玻璃质感及模型指令工具。
核心功能¶
- 五种背景模式：支持系统预设、纯色、渐变、图片和视频（支持本地文件或远程链接）。
- 抽屉式交互：点击侧栏（Settings 上方）的「壁纸」按钮唤起右侧抽屉。抽屉打开时，左侧栏与聊天区会自动收起并降低透明度，专注背景调整；点击抽屉外部即可关闭。
- 缩放与定位：针对小图，支持鼠标滚轮缩放和拖动定位。拖动指针在图片外时有 2 秒宽限，超时才释放。
- 适配与焦点：提供 fill / cover / contain 等 5 种适配模式，并支持水平和垂直焦点调整，另有自由缩放与放大聚焦选项。
- 毛玻璃质感：可让面板、气泡和输入框呈现半透明磨砂表面。
- 动态壁纸：支持本地 MP4 循环播放，可静音或调节音量，视频文件大小无限制。
- 模型指令工具：提供
bg_apply工具，模型可以直接通过指令修改背景（例如“把背景换成深蓝”或“用这张图做壁纸”）。 - 文字方案：支持根据背景亮度自动推断文字颜色，也允许手动指定亮色或暗色方案。
- 本地化存储：上传的图片和视频仅保存在本机数据目录，由插件自己的路由伺服，不会上传到任何云端服务。
安装与启用¶
前置条件：已安装 DSH 并能正常运行 dsh web。
方式一：git 通道¶
dsh plugin --profile web add github:sz1698/dsh-bg-new
如果 dsh 命令不在 PATH 中：
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add github:sz1698/dsh-bg-new
安装完成后，需要重启应用或 dsh web，再刷新浏览器即可生效。
方式二：本地 clone（开发 / 自用）¶
git clone https://github.com/sz1698/dsh-bg-new.git
cd dsh-bg-new
npm install && npm run build
dsh plugin --profile web add .
典型用法¶
通过界面操作：
点击侧栏的「壁纸」按钮，在弹出的右侧抽屉中选择背景类型进行配置。支持滚轮缩放图片，拖动调整位置。
通过模型指令：
在对话框中输入“把背景换成深蓝”或“用这张图做壁纸”，由 bg_apply 工具执行。
bg_apply 工具参数：
支持颜色、渐变、图片、视频、本地文件、关闭。
注意事项¶
- 这是非官方社区插件，请使用前自行评估兼容性与安全性。
- 所有媒体文件仅保存在本地，不会上传到云端服务。
- 插件版本为 0.7.0。
总结¶
该插件通过侧栏抽屉和本地媒体伺服，在不依赖云端的情况下提供了灵活的背景定制能力。适合希望深度自定义 DSH 网页界面视觉体验的用户。
