leavestring/awesome-dsh-background-plugin

README excerpt

DSH Background 为 DSH Web 提供可上传图片 / 预设氛围的背景设置插件，设置持久化，重启不丢失。 简体中文 English 为什么需要它？ DSH Web 默认只有一套主题色背景。如果你和我一样，希望自己的工作空间 不再千篇一律 ，可能已经试过： - 直接改主题文件 / CSS —— 不可行。DSH 是插件化架构，主题走 CSS 变量，任何更新都会覆盖你的修改； - 用油猴脚本 / 浏览器插件改样式 —— 侵入性强、要写选择器、还要跟着 DSH 版本走，维护成本高； - 放弃个性化 —— 长时间盯着单调的纯色界面，容易疲劳也缺少归属感。 这个插件通过 DSH 官方的 Cordis 插件机制，把「背景」变成 设置页里的一个正式设置项 ，并解决了实现过程中最棘手的三个坑： 1. 设置保存被静默拒绝 —— DSH 的 Host 只允许白名单内的设置命名空间被浏览器读写，否则一点保存就回滚。插件附带了 expose-namespace.mjs 一键脚本，把 ui-background 加入白名单； 2. 对话区盖住背景 —— DSH 的对话主区、详情面板、布局框架都有不透明背景。插件在背景激活时让这些页面级容器透出背景层，同时保留侧栏、消息气泡、输入框的原有表面； 3. 图片上传即丢 —— 大图写设置文档慢、重启就消失。插件在浏览器端把图片压缩到 1600px / WEBP 后再写入设置， 上传即自动持久化 ，重启后原样恢复。 截图 暗色模式 + 自定义图片背景： 浅色模式 + 自定义图片背景： 功能 - 🖼️ 上传你自己的图片 ：支持 JPG / PNG / WEBP / GIF，浏览器本地 Canvas 压缩（长边 ≤ 1600px，WEBP 输出，兼顾画质与体积）。 上传即自动保存 ，无需再点保存按钮，重启后自动恢复。 - 🎨 三种预设氛围 ：极光（aurora）、余烬（ember）、宣纸（paper），一键切换、点击即时生效，不想找图也能快速换个心情。 - 🎚️ 五维细调 ：图像存在感（透明度）、暗色遮罩（保证前景可读）、柔焦（模糊）、适配方式（铺满 / 完整显示 / 拉伸）、焦点位置（居中 / 顶部 / 底部 / 左侧 / 右侧）。 - 🔄 实时预览 ：设置面板内所见即所得，拖动滑块即时看到对话区的效果；不满意随时「放弃修改」。 - 🔒 隐私友好 ：图片只在你自己的浏览器里处理，压缩后写入本地设置文档， 不会上传到任何服务器 。 - 🌐 双语界面 ：中文 / English。 - 🧩 低侵入、可随时移除 ：背景是浏览器内一个固定图层，不修改、不遮挡任何对话内容；关闭「已启用」开关或点击「恢复默认」即可完全移除，不留痕迹。 - 🌗 主题兼容 ：浅色 / 深色主题下都正常工作（附带的暗色模式截图就是真实效果）。 安装 ⚡ …

Category