dsh-elaina-bg

August 14, 2026 · View on GitHub

自定义壁纸背景插件 —— DeepSeek Harness（dsh）Web 界面的轻量客户端插件（仅浅色主题）。

给你本地 dsh web 界面铺一张自定义壁纸：图片固定全屏、等比裁剪永不变形；侧边栏、输入框、设置弹窗等面板呈现液态玻璃质感（半透明 + 背景模糊 + 高光描边），文字保持可读；深色主题完全不受影响。

仓库不附带任何壁纸（版权原因，见下文）。装好后点界面右下角的 🎨 按钮，用「更换壁纸…」选一张你自己的图即可。

📸 效果预览

效果截图 1

效果截图 2

截图中显示的壁纸仅为示例；仓库本身不附带任何壁纸素材（版权原因，见下文）。

✨ 特性

自定义壁纸：控制面板里挑选本地图片，浏览器内自动压缩到 1920px 宽（保持比例、透明垫白），实时生效并存入 localStorage——换壁纸不用碰任何文件
液态玻璃面板：backdrop-filter 模糊 + 饱和度提升 + 镜面高光描边，且只挂在 ::before 伪元素上（真实容器挂 backdrop-filter 会把 position:fixed 弹层困进错误的包含块，本插件绕开了这个坑）
🎨 实时调参面板：右下角悬浮按钮，拖动即预览，自动持久化——
- 白纱浓度（图片压白程度）
- 主区域 / 侧边栏 / 输入框 / 提示面板 / 气泡的透明度
- 图片饱和度、构图水平位置
- 玻璃模糊强度、玻璃饱和度
等比不拉伸：background-size: cover，任何窗口比例下画面都不变形
参数持久化：全部存于 localStorage，刷新、重启 dsh web 都保留
零依赖：无框架、无构建依赖，纯 DOM + CSS 自定义属性（--elaina-*）

📦 安装

需要本机已在用 dsh web（npx --yes @deepseek-ai/dsh web）。

# 1. 克隆到 dsh 插件目录
git clone https://github.com/Gao-Yee/dsh-elaina-bg.git "$env:USERPROFILE\.dsh\plugins\dsh-elaina-bg"

# 2. 运行安装脚本（创建 junction + 注册 Loader 条目，幂等可重复执行）
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\plugins\dsh-elaina-bg\install.ps1"

# 3. 重启 dsh web，浏览器按 F5

install.ps1 做了两件手工容易漏的事：

把插件目录 junction 到 ~\.dsh\profiles\node_modules\dsh-elaina-bg（dsh Loader 按包名从这里解析）；

向 ~\.dsh\profiles\web\cordis.patch.yml 追加注册条目：

- insert:
    - id: elaina-bg
      name: dsh-elaina-bg

卸载：uninstall.ps1 一键还原；或手动删掉 patch 条目和 junction 后重启 dsh web。

🎛 使用

界面右下角出现 🎨 悬浮按钮：

更换壁纸…：选任意本地图片，自动压缩、立即生效；恢复默认回到内置渐变底图
拖动滑杆实时调参；重置默认回到出厂数值

🔧 开发

client.js 是构建产物（随仓库发布，clone 即用），源码是 styles.css（样式层）和 panel.js（控制面板）。改动后重新生成：

node gen-client.js

想烘焙一张自己的默认壁纸进 bundle：把它的 base64 放到 bg-1920.b64（已在 .gitignore 中）再运行上面的命令。请只烘焙你有权分发的图片。

⚠️ 兼容性

仅支持浅色主题：所有样式以 body:not([data-ds-dark-theme]) 隔离，深色主题下插件零副作用
依赖 dsh 的内部 CSS token（--dsw-*）和少量构建期类名（如 VOzbGW_panel）；dsh 大版本升级后个别选择器可能失效（表现为局部样式消失，不会破坏功能），欢迎提 issue

🖼 壁纸版权

本仓库刻意不附带任何第三方画作。通过面板选择的壁纸只保存在你自己浏览器的 localStorage，不会上传、也不会进入仓库。如果你 fork 后想内置默认壁纸，请确保拥有该图片的分发权（自摄、自绘、CC0 等）。