前言¶
DeepSeek Harness (DSH) 的插件生态强调模块化扩展。dsh-dream-skin 插件提供了全屏铺满的壁纸显示能力，默认将背景定位在屏幕中心（background-position: center）。当壁纸构图偏左或偏上时，会遮挡聊天区域，而原插件未提供位置微调功能。dsh-wallpaper-position 旨在解决这一痛点，通过在设置中增加 X/Y 像素位移控制，并按壁纸内容进行记忆，让用户可以针对不同图片单独调整显示位置。
插件简介¶
这是一个为 dsh-dream-skin 设计的卫星插件。它利用 CSS 变量在纯前端层面实现壁纸位移，不修改 dream-skin 的核心文件。插件通过读取壁纸内容的哈希值来匹配对应的位移记录，确保换图时自动恢复上次的调整。项目采用 MIT 协议，由 ArimaKana-Akane 维护。
核心功能¶
- 设置项注册：在
设置 → 外观中注册专门的壁纸位移设置行。 - 像素级微调：提供 X/Y 两个方向的位移设置，步进 1px，有效范围 ±5000px。界面包含
−10 / −1 / +1 / +10的快捷按钮以及“恢复默认位置”功能。 - 按图记忆：系统会根据当前壁纸的内容哈希（区分 image/url/gradient 类型）存储位移值。更换壁纸后，会自动加载该图片对应的记忆值。
- 纯前端实现：通过注入 CSS 规则修改
background-position，无需后端支持或重启 DSH 进程。 - 依赖关系：必须依赖
dsh-dream-skin插件才能工作。
安装与启用¶
使用 DSH 内置的插件命令安装：
dsh plugin --profile web add dsh-wallpaper-position
安装完成后，重启 dsh-web-profiled 服务即可生效。
使用步骤¶
- 在
dsh-dream-skin中选择一张壁纸。 - 进入
设置 → 外观，滚动到页面底部找到「壁纸位移（仅对当前这张图生效）」选项。 - 使用微调按钮（
−10/−1/+1/+10）或直接输入数值调整 X/Y 轴位置（X 向右为正，Y 向下为正）。 - 切换到其他壁纸，新的壁纸会自动应用其记忆的位移值。
- 点击「恢复默认位置」可将当前图片的位移重置为 0。
依赖与限制¶
- Vibe coding 产物：代码由 AI 生成并迭代，未经人工逐行审计。请勿将其直接用于生产环境或涉及敏感信息的场景。
- 硬依赖与兼容性：必须安装
dsh-dream-skin。如果上游修改了壁纸层的 DOM 结构或localStorage键名，本插件可能会静默失效（不报错，但功能不工作）。 - Host 半限制：Host 半必须导出一个空的
apply()函数，否则会导致 DSH 插件加载失败，进而引发整个 DSH 进程启动失败。 - 功能范围：仅支持位移，不支持缩放、旋转或鼠标拖拽。
- 潜在冲突：选择器会匹配
body下所有position:fixed且带有background-image的元素。如果同时安装了其他背景插件，位移设置可能会影响这些插件的背景层。 - 环境要求：需要 Node.js 版本 >= 20。
目录与源码¶
- 目录页：https://www.skillhub.cn/plugins/ArimaKana-Akane/dsh-wallpaper-position
- 源码仓库：https://github.com/ArimaKana-Akane/dsh-wallpaper-position
