dsh-plugin-background-image

LIMITATIONS

已知限制

本插件通过**覆写 DSH 主题 token** 与**注入 CSS** 实现，会改动全局界面表现，使用时需留意以下几点： 1. **覆写全局背景 token `--dsw-alias-bg-base`**：所有引用该 token 的界面区域都会显示背景图。插件已用 CSS 把已知的面板/按钮强制回表面色（`--dsw-alias-bg-layer-2`），但 DSH 升级后新增的引用该 token 的元素可能需要同步补充。 2. **依赖 DSH 内部 hashed 类名**：连续背景、玻璃效果与对话区偏移依赖 `.pI_x6G_frame`、`.wSkVaW_root`、`.ydkMvW_root`、`.hHd-Xa_root`、`.pI_x6G_sidebarCol`、`.uV2eYG_card`、`.wSkVaW_composerSeat`、`.wSkVaW_viewArea`、`.wSkVaW_composerHero` 等内部类名；DSH 升级若改动这些类名，对应效果会失效或错位。 3. **侧栏毛玻璃依赖伪元素方案**：侧栏的毛玻璃不直接加在侧栏祖先上，而是承载在 `.pI_x6G_sidebarCol::before` 伪元素（`position: absolute` 覆盖层，承担半透明填充与 `backdrop-filter`）上。这样 `backdrop-filter` 落在无 `fixed` 后代的伪元素上，侧栏祖先不再成为 `fixed` 后代的包含块，因此 `.VOzbGW_overlay` 这个 `position: fixed` 的设置弹层不会被锁进侧栏。该方案仍依赖 DSH 内部类名 `.pI_x6G_sidebarCol`、`.hHd-Xa_root` 等，DSH 升级若改动这些类名，侧栏玻璃效果会失效或错位。 4. **本地图片路由**：本地图片依赖主机端只读路由（仅回环、引用即授权），图片文件被移动或删除后背景会失效，需重新设置路径。插件会在页面加载与每次打开设置页时以 HEAD 请求静默探测（不传输文件内容），失效后在设置页顶部与状态行给出提示。 5. **关闭即还原**：上述 token 覆写与内部类名样式只在插件启用（侧栏规则还要求处于「沉浸式全屏」模式）时存在于页面；关闭插件或切换到「仅对话区域」后，对应样式表会整体移除，DSH 原生样式完整还原，不会残留 `!important` 覆写。