dsh-wallpaper-position

LIMITATIONS

Known limitations

**已验证** - `node --check` 语法通过；host 半 `apply` 存在；`dsh --profile web --dump-config` 退出码 0； - 设置行会注册进 `settings.dreamSkin.item`，控件用**原生 DOM** 构造（不吃 React 渲染歧义）。 **已知限制** - **只做位移**：没有缩放、旋转、翻转，也没有鼠标直接拖拽（想要这些要另写）； - 依赖 dream-skin 的 DOM 与 `localStorage` 键名，上游一改就可能失效（静默失效，不报错）； - **位移规则会匹配任何「body 下、内联含 `background-image` 且 `position:fixed` 的层」**， 没有限定到 dream-skin 那一个元素（dream-skin 的壁纸层是匿名 `div`，没有 class/id 可锚定）。 如果你同时装了别的整屏背景层插件，偏移量会同样作用到它们身上。 偏移为 0 时表达式等价于 `center`，与这些层的默认值一致，所以只有在你主动设了非 0 位移时才会看出来。 **这是刻意保留的取舍**：给选择器加更多条件（例如 `z-index:-1`）一旦和上游的内联样式序列化 不一致，功能就会静默失效，代价比这点交叉影响大； - 位移是「裁切平移」：`cover` 模式下把画面推太多会露出背景边缘，属预期行为； - 早期版本用 `react/jsx-runtime` 的 `jsx()` 渲染控件时在界面上显示为**空白方块**， 现已全部改为 `document.createElement` —— 如果你改了 UI 代码，请保持这个做法； - 主题变量缺失时用固定颜色兜底；极端主题下观感可能一般。 ---