壁纸铺满桥接 late-autumn-gif/dsh-wallpaper-bridge

dsh-wallpaper-bridge

把 Wallpaper Engine 的壁纸真正铺满 DeepSeek Harness 的网页界面。

一个 DSH 插件：它跟随 dsh-plugin-wallpaper-engine 的当前选择（图片 / 视频 / 场景实时渲染 / 网页壁纸），把画面铺满整个窗口，并把 DSH 的 UI 面层做成半透明 —— 不依赖桌面壳的 extended 模式。

English · 工作原理 · 安装 · 调试 API · 已知限制

它解决什么问题

DSH 社区壁纸插件把「界面透明化」这一步交给桌面壳：页面 URL 上的 ?dsh-desktop-mode=extended|advanced。壳没传这个参数时（不少版本就是没有），插件回落到 compatibility 模式，外壳材质规则整段不生效 ——

结果是：插件日志里 apply 明明成功了，画面上却一个像素都不显示，壁纸被不透明的面层整个盖住。

本插件不依赖壳层，直接在页面内部把面层做透，所以在这种环境下也能出画面。

实测（同一台机器、同一张壁纸，开关对照）：

| 指标 | 壁纸关 | 壁纸开 |
| 整窗 RGB 均值 | (16.7, 23.2, 43.4) | (35.2, 38.5, 46.4) |
| 整窗方差 | 31.3 | 55.0 |
| 与「壁纸关」的差分 | — | 平均 29.7 / 峰值 252 / 91.2% 像素发生变化 |

特性

- 跟随壁纸库选择：每 5 秒 + 页面重新可见时复查一次，在壁纸库里点哪张就铺哪张。
- 按类型选最合适的渲染方式：
| 壁纸类型 | 渲染方式 |
| image | （宿主 media 路由） |
| video | |
| scene（pkg 内嵌 MP4） | ，硬件解码 |
| scene（没有内嵌 MP4） | 嵌引擎自己的 WebGL 实时渲染页（清晰、能动） |
| web | |
| 都没有 / 未选择 | 可选的内联兜底图 |
- UI 面层透明化：把主题的 5 个背景别名 token（--dsw-alias-bg-base / bg-layer-1 / bg-layer-2 / bg-overlay / --dsw-specific-sidebar-fill）换成同色 + 半透明版本，并让 html/body/#root 透明。先临时禁用自家样式表读出主题原色再换算 —— 所以浅色 / 深色主题都不会串味。
- 按壁纸亮度自适应可读性：把当前画面缩到 32×18 采样平均亮度，越亮则面板越实、整体压暗越重，保证换成一张高亮壁纸时文字依然读得清。
- 低清兜底有柔焦：WE 的 preview 往往只有 160–192 px，拉满 1440p 会很糊 ——兜底时自动加 blur(30px)，宁可「有意的柔背景」，也不要「拉糊的马赛克」。
- 页面隐藏时暂停视频，省 CPU。
- 零依赖：浏览器半是单文件、无构建工具链；构筑脚本只用 Node 内置模块。

安装

需要先装 dsh-plugin-wallpaper-engine（提供壁纸库与媒体路由）以及一份 DSH ≥ 0.2.0-rc.1。

方式 A：直接从仓库装（仓库里已提交构筑好的 client.js，无需本地构建）

dsh plugin --profile desktop add github:late-autumn-gif/dsh-wallpaper-bridge

方式 B：本地构建后装 tgz

git clone https://github.com/late-autumn-gif/dsh-wallpaper-bridge.git
cd dsh-wallpaper-bridge
node scripts/build.mjs # 生成 client.js（仓库里已有一份默认的）
npm pack # 打出 dsh-plugin-wallpaper-bridge-1.0.0.tgz
dsh plugin --profile desktop add ./dsh-plugin-wallpaper-bridge-1.0.0.tgz

想让「没有选中任何壁纸」时也有一张底图，构筑时内联一张你自己的图：

node scripts/build.mjs --wallpaper=./my-wallpaper.webp

内联的图必须是你有权使用的。本仓库不附带任何素材，请勿把他人作品打进包里分发。

装完重启一次 DSH（见下方限制），然后打开 设置 → Wallpaper Engine → 壁纸库，点选任意一张。

调试 API

页面控制台：

__wpBridge.refresh() // 立刻重读壁纸库选择，不等 5 秒轮询
__wpBridge.current() // 当前生效的条目 + 渲染方式
__wpBridge.enable() // 打开
__wpBridge.disable() // 关掉（界面恢复原生不透明），可用来做开关对照

工作原理

三层，互相独立、都可单独关闭：

1. 透明化：注入一条 !important 的样式表覆盖 5 个背景 token + 让根节点透明。
每次重算前先把自己的样式表 disabled = true，用 getComputedStyle 读出主题原色，再换成 rgba(同色, α) —— 所以主题切换（明/暗、注册主题）不会把配色弄坏，靠 MutationObserver 盯 html/body 的属性变化自动重算。
2. 壁纸层：body 第一个子节点上一个 position:fixed; z-index:0 的容器，里面按候选链挂一个媒体节点（img / video / iframe），外层再叠一层渐变压暗（左侧更重，因为侧栏与标题都在左边）。
3. 候选链：任何一个源加载失败（error 事件）就自动往下一个退，所以某张壁纸的编码不被支持、或场景渲染页起不来时，不会只剩黑屏。

场景实时渲染页的 URL 与引擎客户端 liveRenderUrl() 完全一致：

/wallpaper-engine/scene-live/index.html
?type=scene&fit=cover&sceneFps=30&muted=true
&src=<sceneLiveSrc>
&mediaBase=<inventory.sceneMediaBase + /wallpaper-engine/scene-files>

已知限制

- 升级插件后需要重启一次 DSH。DSH 只把新模块推给已打开的页面，同名模块的升级不会热推送；而这个 Electron 壳又禁用了 F5 / Ctrl+R / Ctrl+Shift+R。首次安装是立即生效的。
- 只在 dsh.client.platform = web 的配置档（桌面端 / dsh web）里有意义。
- 依赖 dsh-plugin-wallpaper-engine 的 HTTP 路由（/wallpaper-engine/*，同源、无需鉴权）。
没装或停用该插件时，本插件只会保留透明化与可选的内联兜底图。
- 场景实时渲染需要把 scene.pkg（常见 20–90 MB）拉到渲染页，首次切换会有等待，且会占用 GPU/CPU；这是引擎自己的渲染链，本插件只是把它嵌进来。

生态里的其他壁纸插件

| 插件 | 说明 |
| dsh-plugin-wallpaper-engine | 壁纸库本体（读本机 WE 库、上传、转码）。本插件依赖它 |
| nishuoyang/dsh-wallpaper-bg | 内置风景图 + 上传 |
| TQSY114514/dsh-ui-appearance | 主题色 + 背景图/视频 |
| XieRW/dsh-beauty-skins | 源码级皮肤系统（要覆盖 ui-theme 并全量重编） |

本插件不做壁纸管理（不上传、不转码、不建库），只做「把选中的壁纸真正画出来」这一件事。

许可

代码 MIT © 2026 late-autumn-gif。
本仓库不包含任何第三方素材；--wallpaper= 内联的图片由使用者自负版权责任。

dsh-wallpaper-bridge 把你在 dsh-plugin-wallpaper-engine 里选中的壁纸，渲染成 DeepSeek Harness Web UI 里真正的全屏背景 —— 不依赖桌面壳的 extended 模式。

社区壁纸插件都靠 ?dsh-desktop-mode=extended|advanced 把 UI 透明化交给桌面壳。壳没传这个参数时，它们就退回 compatibility 模式，壳材质规则永远不生效，壁纸被不透明表面完全盖住 —— 一个像素都看不见，尽管插件日志里 apply 是成功的。

本插件改从页面内部下手：

1. 用同色相的半透明值覆盖五个背景别名 token（先读主题原始颜色，所以亮色/暗色主题都能用），并让 html/body/#root 透明；
2. 挂一个固定壁纸层，跟随壁纸库当前的选择（图片 → ，视频 → ，带内嵌 MP4 的场景 → ，不带内嵌 MP4 的场景 → 引擎自己的 WebGL 实时渲染页，放进 ，web → ）；
3. 按壁纸亮度调整面板不透明度，保证文字可读。

实测把壁纸关掉/打开：91.2% 的像素发生变化，窗口方差从 31.3 升到 55.0。

安装：node scripts/build.mjs && npm pack，然后
dsh plugin --profile desktop add ./dsh-plugin-wallpaper-bridge-1.0.0.tgz，再重启一次 DSH （DSH 只热推送全新的客户端模块，而这个 Electron 壳禁用了 F5/Ctrl+R）。

MIT 许可。不打包任何第三方素材。