动态背景特效 mengjiemy/dsh-dynamic-bg

DSH 动态背景与特效

原名：dsh-dynamic-bg 一句话：把 DSH 那个灰底色，换成一整屏的图片 / 动图 / 视频，还能调模糊、蒙版、透明度。

它解决什么问题

DSH 默认界面是素灰色。看久了累，也没有「自己的空间」的感觉。

现有的同类插件只支持静态图片（另有一个只支持 Windows）。
这个能放视频 —— 循环播放、静音、支持倍速和拖进度条。

能放什么

| 类型 | 格式 |
| 静态图 | jpg / png / webp / avif / bmp / svg |
| 动图 | gif |
| 视频 | mp4 / webm / mov / m4v |

能调什么

| 效果 | 范围 | 说明 |
| 蒙版强度 | 0–100 | 背景上叠一层半透明，保证任何亮度的图上文字都看得清。深浅主题各一套配色 |
| 背景模糊 | 0–40px | 模糊后自动轻微放大，避免边缘露白 |
| 不透明度 | 0–100 | 背景本身的浓淡 |
| 填充模式 | 铺满 / 完整显示 | 铺满会裁边，完整显示会有留白 |
| 面板半透明 | 主区 / 侧边栏 各自调 | 让内容区透出背景 |
| 一键压暗 | 开关 | 临时把背景压暗，不改上面的参数 |

★ 为什么它比同类「不容易坏」

DSH 界面的样式里有一堆带哈希的类名（形如 .css-a1b2c3）。
那些名字每次版本更新都会变 —— 所以直接改它们的插件，升级后经常突然失效。

这个插件的做法：只改 DSH 自己的 CSS 变量（--dsw- 那些）， 一个哈希类名都不碰。⇒ 版本升级后照样能用。

还带了什么（隐藏功能）

除了背景，代码里还有一整套视觉特效（说明文档还在补）：

- 环境文字特效：诗词雨 / 二进制雨，7 条泳道防重叠
- 8 套文字配色：hacker-green / amber / magenta / cyan / white …
- 输入框聚焦毛玻璃
- 按会话独立背景（每个对话可以设不同的背景）

怎么用

1. 装完重启 dsh web，刷新页面
2. 在设置里找到背景设置，填一个本地文件的绝对路径（比如 ~/Movies/loop.mp4）
3. 打开开关，按需调蒙版 / 模糊 / 不透明度

★ 也可以让智能体帮你设 —— 它给了三个工具： dynamic_bg_set / dynamic_bg_get / dynamic_bg_off

安全边界

它读本地文件，所以做了限制：
- ✅ 只允许媒体扩展名，其它一律 403
- ✅ 只允许绝对路径，相对路径 400
- ✅ 拒绝敏感目录（/etc、/System、/dev 等）
- ✅ 单文件上限 2GB
- ✅ 不写你的任何文件（只往系统临时目录 /tmp 写一份诊断日志，可随时删）

说明文档待补：环境文字特效的详细用法。*

维护策略

这是一个个人项目，按现状发布（as-is）。

- Issue / PR 欢迎，但不保证及时回复 —— 我有正职，这是业余时间做的
- PR 我会看 diff 再决定要不要合并 —— 不会盲目合并（安全起见）
- 不接受「催更」 —— 有需要欢迎自己 fork 改
- 如果你发现了好用的改进，欢迎提 PR；如果我长期没回，你完全可以 fork 走

这个项目不承诺任何 SLA。 用之前请自己评估。