一段循环短片怎么变成 DSH 的界面底图
多数界面美化插件改的是颜色变量:把背景色从深灰调到炭黑,把边框调亮一档。视频皮肤走的是另一条路——它往页面里塞进一个 <video ,让整块界面浮在会动的画面上。这个差别决定了它必须和内核的渲染顺序、启动流程、主题体系同时打交道,任何一处接错,代价都不是「不好看」,而是应用起不来。
多数界面美化插件改的是颜色变量:把背景色从深灰调到炭黑,把边框调亮一档。视频皮肤走的是另一条路——它往页面里塞进一个 <video>,让整块界面浮在会动的画面上。这个差别决定了它必须和内核的渲染顺序、启动流程、主题体系同时打交道,任何一处接错,代价都不是「不好看」,而是应用起不来。
下面拆的是这条链路上真正会出问题的几个点,全部来自仓库 README 与站点详情页的记录。
底图是插进渲染管线的一层,不是一张背景图
插件在宿主侧只做两件事:把一行样式和一行脚本推进内核的索引注入表,再通过 webServer 服务把媒体文件以带 Range / ETag 的响应发出去。浏览器侧那段内联脚本负责把 <video> 挂成 body 的第一个子节点,position: fixed、z-index: -1。
这个选择很关键:底图压在最底下,意味着应用里没有任何元素需要为了它调整层级,也没有任何点击会被它挡住。面板、对话框、输入框的 pointer 事件完全不受影响。
三条不能破的接线约束
这三条每一条都是踩出来的,写错的表现从「不生效」到「整个应用启动失败」不等。
约束一 · 绝不用 script-src 类型的注入行
桌面版解释器对外部脚本行做 await。一次 rejection 就会把 __DSH_BOOT_READY__ 这个启动信号掐掉,后果是应用根本起不来,而不是某个功能缺失。内联的 script 行没有失败路径,所以插件只用这一种。
约束二 · 监听必须在 apply() 里同步注册
内核收集注入表只做一次。如果把注册包在对象级 inject 里,apply() 会被推迟到收集动作之后,那一行就永远落不了地。插件把 ctx.on('webserver/index-inject', …) 放在 apply() 的第一句,就是为了抢在这个一次性窗口里。
约束三 · 覆盖层挂 body,不进 #root
内核会对 #root 里已有的启动 DOM 做 hydrate,选择器是 :scope > [data-dsh-boot]。往这个容器里插节点会破坏水合过程。所以开机动画的覆盖层和背景视频都挂在 document.body 上。
抬升层为什么故意保持不透明
背景能透出来,但对话框不能。这条界线是插件的设计核心。
内核用 --dsw-alias-bg-layer-1/2/3 这三个令牌画对话框、气泡、菜单、卡片和设置页,源码里的写法是 _dialog_* { background: var(--dsw-alias-bg-layer-2) }。插件把画布和侧栏的表面令牌调成半透明,让画面清晰可见,但这三个抬升层令牌一个字都不动。
原因很直白:对话框后面往往还在滚动聊天记录。如果面板也半透明,底层文字会透上来,两层内容互相污染,谁都读不清。README 提到过一个历史版本把设置页那一层设成 layer-2、alpha 0.36,结果是聊天文字直接穿过对话框。
面板上确实有一个 surface 滑杆,默认值是 100%,即内核给出的初始浓度。往下拨能做出磨砂感,但代价由拨的人自己承担。
亮色主题:对比度是一笔必须还的账
素材本身偏暗,README 给的 YAVG ≈ 0.25。这个数字意味着同一套透明度在两种主题下不能通用:暗色主题下正文是浅色,亮色主题下正文是深色,而深色文字压在暗画面上,对比度掉得比想象中快。
实测数据(真实浏览器采样):
| surface | surfaceLight | 暗色 min / p5 / median | 亮色 min / p5 / median |
|---|---|---|---|
| 0.2 | 0.6 | 2.49 / 6.81 / 16.05 | 7.74 / 7.91 / 8.72 |
| 0.05 | 0.6 | 1.53 / 4.89 / 15.24 | 7.38 / 7.56 / 8.37 |
p5 覆盖 95% 的画面面积,是真正有意义的读数;min 只反映最差的那一小块,容易被一帧暗场拉低。默认的 surface 0.2 / surfaceLight 0.6 在暗色下 p5 是 6.81,亮色下 7.91,都高于 AA 要求的 4.5;拉到 0.05 时暗色 p5 掉到 4.89,及格但余量很小。
插件自己也知道这是个别扭的选择:素材偏暗,亮色下想保持可读就得把白色表面压到 0.6,画面会被冲淡;而多数人根本找不到主题开关。所以默认 theme.mode 是 ask,页面加载完问一次要不要切暗色,不点就不动。这个写入走 ctx.settings.update('ui-theme', …),不手改 profile 的 YAML,也绝不在 activation 期间做。
桌面有声,浏览器静音:同一段动画的两条路
开机动画是带声音的,这一点在两种运行环境下结果不同。
桌面 shell 没有设 webPreferences.autoplayPolicy,走 Electron 默认的 no-user-gesture-required,未静音的 play() 能成功,动画带声起播。普通浏览器(dsh web)默认拦截未静音的自动播放,运行时于是回退成静音播放,同时在左下角放一个独立的声音按钮——点它只开声音,不跳过。两个意图被刻意拆成两个控件,避免互相干扰。
还有一个时序细节:动画播到 ended 才淡出,淡出时长是配置里的固定 fadeMs。更早的实现把过场压在片尾,渐隐长度跟着片子剩下的走;宿主起得慢时它只剩一百多毫秒,看上去就是突然断开。现在默认 exitMode: 'end'。
调参与重启不是一回事
右下角那枚小圆钮的层级是 z-index: 900,内核的 Modal 是 1000。这不是随手写的数字:模态该盖住一切,一个调壁纸的控件不该抢走它的点击。参数写进 $DSH_HOME/dsh-video-skin.json 的四个键,其余字段原样保留,刷新就生效;但开机动画那几项进了启动快照,改完要重启。用文件而不是 localStorage,是因为桌面页由 dsh-app:// scheme 提供,Web Storage 在那里可用性没保证。写失败时面板会明说,不假装保存。
它现在的状态
站点当前记录为 115 星、综合分 58.9、版本 0.1.6,npm 周下载 12,176——这个数字含 CI 与镜像流量,不等于本站安装量。信任档位是「待复验」:L4 真实安装曾在 dsh 0.2.1-rc.2 下成功,如今站点已更新到 0.2.2-rc.1,却还没在新版复验。安全扫描为绿色「未发现敏感能力」,12 处证据全是 fetch 自身媒体与配置,尚无人工评估。
总结
把一段短片变成界面底图,难点从来不在解码或播放,而在它必须成为渲染管线里一个安分的成员:注入行要按时落地,覆盖层要避开 hydrate,抬升层要守住不透明,主题切换要尊重用户的沉默。想横向比较同类界面改造插件的做法,可以从 dpharness.com 的插件总览 看起。
适合与不适合
适合:想让工作区有点呼吸感、又不愿意改配色方案的开发者;手里有合适 mp4/webm 素材、想直接铺上自己片子的人;需要开会投屏时快速切出辨识度界面的人;愿意为一段开机片段接受一次完整关停的人。
不适合:只用一次就想删掉、不能接受「装完必须完全退出应用」的人;需要低功耗长跑的机器,循环解码视频是要耗电的;对对比度极端敏感、习惯把正文压到极限透明的用户——这个插件会逼你在可读性上还账。
标签:视频背景、界面注入、开机动画、透明度、Electron
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。