前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，Web 界面默认风格较简洁，但开发者往往希望为聊天界面增加个性化外观。本地图片或视频背景方案在早期需要自行编写样式或使用外部资源，维护成本高且存在隐私风险。
是什么¶
dsh-chat-background 是一个为 DSH Web 界面提供背景美化的插件。由 yezitotempeace 维护，归类为「趣味换装」。它允许使用本地图片、本地视频或内置预设渐变作为聊天背景，通过悬浮面板实时调节清晰度、透明度、缩放、位置、遮罩、动效与玻璃面板效果，所有文件仅存储在浏览器本地，不发起网络请求，不读取聊天内容。
核心功能¶
支持的媒体类型¶
- 本地图片：JPG / PNG / WebP / GIF
- 本地视频：MP4 / WebM / MOV
- 预设背景：晨雾、海盐、蜜桃、青提、夜色、墨岩 6 套渐变
可调节参数¶
| 控件 | 作用 |
|---|---|
| 清晰度 | 0–100%，越低越朦胧（映射到 0–14px 模糊） |
| 背景透明度 | 背景图自身的透明度 |
| 界面不透明度 | 界面底色透出多少背景 |
| 对话栏不透明度 | 输入框卡片与用户气泡的透明程度（默认 90%） |
| 亮度 / 对比度 / 饱和度 | 背景图的色彩调节 |
| 缩放 / 水平位置 / 垂直位置 | 自定义构图，适合人像或大图 |
| 暗色遮罩 | 背景上压一层黑，保证文字可读 |
| 显示方式 | 铺满 / 适应 / 平铺 |
| 动效 | 静态 / 漂浮 / 缓慢呼吸（系统“减少动态效果”时自动关闭） |
| 视频自动播放 | 循环播放；关闭后停在第一帧（省电） |
| 玻璃质感面板 | 侧边栏、卡片、浮层变半透明玻璃 |
| 启用背景美化 | 一键开/关，关闭即恢复原界面 |
交互与持久化¶
- 右下角悬浮小圆钮可上下拖动并记住位置
Esc或点面板外关闭- 刷新后设置仍在
安装与启用¶
- 将仓库放到
/root/dsh-chat-background - 在 profile 的
dependencies中添加：
{
"dsh-chat-background": "link:/root/dsh-chat-background"
}
- 在
dsh.profile.bundles中添加：
{
"dsh-chat-background": true
}
- 建立
node_modules/dsh-chat-background软链接 - 重启 Web；若页面未出现小圆钮，刷新一次即可
典型用法¶
启用后，右下角会出现悬浮小圆钮。点击打开调节面板，选择本地图片或视频，或使用预设渐变。调节清晰度、透明度、缩放、位置等参数，确认动效与玻璃面板效果。关闭面板或按 Esc 退出。
适用场景与注意¶
适合希望为 DSH Web 界面增加个性化外观的开发者。使用前应检查源码与许可证（MIT）。
结尾¶
该插件在本地完成所有渲染与存储，不依赖外部网络或读取聊天内容，适合对隐私与性能敏感的使用场景。
- 目录页：https://www.skillhub.cn/plugins/yezitotempeace/dsh-chat-background
- GitHub：https://github.com/yezitotempeace/dsh-chat-background
