dsh-ui-background
给 DeepSeek Harness Web 客户端加一层本地背景（图片 / 视频）+ 全界面毛玻璃。
dsh plugin --profile web add dsh-ui-background
> 装完必须重启一次 Host（DSH 的模块解析表在启动时构建）。
> 状态：0.8.2，在 DSH 0.2.0-rc.2 上开发与验证。RC 阶段内部契约会变，升级 DSH 后请重新验收。
它是什么（以及为什么不卡）
毛玻璃不靠扫描 DOM，而是改官方主题令牌：
ctx.theme.overrideTokens('dsh-ui-background', {
'--dsw-alias-bg-base': { light: 'rgba(255,255,255,.62)', dark: '…' },
'--dsw-specific-sidebar-fill': { light: '…', dark: '…' },
// 另外 3 个抬升面 / 弹层令牌
})
DSH 的 body、主框架、侧栏本来就用这些令牌画背景，所以：
- 零 DOM 扫描、零
MutationObserver、零逐面板backdrop-filter - 关掉 = 撤销令牌层，界面立刻回到出厂样式，无残留
- 背景层是一个
position:fixed; z-index:-1的图层（图片走纯 CSS，视频走一个 ``）
功能
- 背景来源：上传文件 / 本机路径（只读，不复制不移动）
- 视频背景：
mp4/webm循环播放，切到后台自动暂停 - 构图：
铺满(cover)/完整(contain)、缩放 50–300%、水平/垂直位置，预览里可直接拖动 - 壁纸引擎：自动扫 Steam 工坊
431960，只列出可直接播放的（视频/图片） - 最近使用：最多 12 条，带缩略图与构图参数，一键切回，可单条删除
- 上传文件可单个删除；删到正在用的那张会自动关掉背景
- 全部本地：不联网、不收集数据
安装
dsh plugin --profile web add dsh-ui-background
装完必须重启一次 Host（DSH 的模块解析表在启动时构建，新装的包当次不可导入）。
重启后：设置 → 背景与玻璃。
适合什么场景
- 用本地图片或视频当背景，界面跟着半透明
- 换图之后不用重新调构图：每条历史记录里都存着缩放与位置
做不到的：Wallpaper Engine 的 Scene 渲染。scene.pkg 需要它自己的引擎，本插件只读图片和视频文件。
已知限制
| 限制 | 原因 |
|---|---|
| Scene 壁纸不能当背景 | scene.pkg 是 Wallpaper Engine 私有格式，需要它的引擎渲染；包里没有现成图片 |
| 别拿 WE 预览图凑数 | 实测预览图只有 144–254 px，铺满 1920 宽会糊 7–13 倍 |
| 想要 WE 画面 → 截图 | 开着 WE，Win+Shift+S 截屏后点「粘贴截图」（1920×1080，清晰） |
mkv / mov 可能不播 |
Edge 不支持这些容器，用 mp4 / webm |
| 半透明会影响所有用基础背景令牌的地方 | 代码块顶栏、图片占位、弹层遮罩都会跟着透明，这是同一套令牌的代价 |
安全
- Host 端只读你在设置里显式填写的那一个本机文件，以及 Steam 工坊目录里的
project.json/ 媒体 / 预览图 - HTTP 路由仅回环；写操作拒绝
sec-fetch-site: cross-site - 上传目录内的文件名已净化，不接受路径穿越
- 状态存在
$DSH_HOME/storages/dsh-ui-background/（state.json+backgrounds/），卸载插件不会自动删除，请自行清理
开发
node selftest.mjs # 用假 Cordis 上下文挂载 host 半身，直接打自己的 HTTP 处理器
lib 端只依赖 node:fs / node:path / node:os，没有 npm 运行时依赖。
License
MIT
