前言¶
DeepSeek Harness（DSH）的界面默认是纯色面板。长时间写提示词、看会话时，有人希望窗口背后有一张自己的图，又不想动系统桌面壁纸，也不想把图片发到网上。
社区插件 dsh-wallpaper 做的是另一件事：在侧边栏 deepseek HARNESS 字标旁加一个圆形按钮，从本机选图，按可调不透明度铺满 DSH 窗口；图片和设置只存在本机 IndexedDB 里。下面介绍它是什么、怎么装、怎么用，以及安装前要注意的权限与兼容性。
这是什么¶
dsh-wallpaper 由维护者 VictorGol 发布，归类为「趣味换装」。一句话：给 DSH 提供一个壁纸选择器，选本地图片作为窗口壁纸，默认 70% 不透明度（滑杆可在 0–100% 调节）。
- 目录页：https://www.skillhub.cn/plugins/VictorGol/dsh-wallpaper
- 源码与说明：https://github.com/VictorGol/dsh-wallpaper
- 许可证：MIT（README 与
package.json一致） - 当前包版本：
package.json中为 1.0.5；引擎要求dsh>=0.2.0-rc.1；README 写明需要 DSH 0.2.x 桌面版，纯 JavaScript，无构建步骤
核心功能¶
以下能力均来自仓库 README，安装后可直接对照界面验证。
字标旁的入口按钮¶
圆形按钮注册在 shell.overlay 槽位，贴在侧边栏 deepseek HARNESS 字标右侧。配色跟随主题反转：深色主题白底黑图标（--dsw-alias-button-primary-fill / --dsw-alias-label-primary-foreground），浅色主题相反。侧边栏收起时随品牌行一起隐藏，不替换内置控件。
选图与不透明度¶
- 点按钮打开面板后，可用「选择图片」，或将图片拖入预览框。
- 不透明度默认 70%，拖动滑杆即时生效，范围 0–100%。
面板半透明与移除¶
壁纸存在时，插件通过 ctx.theme.overrideTokens 调整 --dsw-alias-bg-base，使会话区、侧边栏、右栏、底栏一起半透明，壁纸才能透出来。点「移除」会去掉壁纸并恢复原来的纯色界面。
本地持久化与语言¶
图片以 Blob 存入 IndexedDB，透明度一并保存；不上传、不发网络请求。重开 DSH 会自动恢复。界面文案跟随 DSH 语言（中文/英文）。
安装与启用¶
插件在 DSH 进程内运行，安装前建议浏览 GitHub 源码与 MIT 许可证，确认符合你的使用环境。
- 打开 DSH → 插件 → 添加插件
- 填入本仓库地址（须与官方 README 一致）：
https://github.com/VictorGol/dsh-wallpaper
- 确认安装。圆形按钮应出现在字标右侧；若未出现，重开一次 DSH。
典型用法¶
经过上面的步骤装好插件后，日常操作如下。
- 点圆形按钮打开面板。
- 「选择图片」或拖入图片 → 壁纸立刻铺满窗口底层。
- 用「不透明度」滑杆调整浓淡（默认 70%）。
- 不需要壁纸时，点「移除」，界面恢复默认纯色。
卸载：在插件页卸载即可。若要连本地保存的图片一并清除，先打开面板点「移除」。
实现要点（便于排查问题）¶
README 中给出了实现摘要，遇到「有壁纸但看不见」或按钮位置异常时可对照：
- 壁纸层：
position: fixed; inset: 0; z-index: -1的图片层插在#root之前；macOS 桌面端 frame 透明时，层落在所有面板之下。 - 按钮定位：按侧边栏品牌行实测定位（
[data-sidebar-toggle]等），窗口缩放、侧边栏拖宽会重新测量。 - 持久化：IndexedDB 存 Blob 与透明度。
适用场景与注意¶
适合谁：希望在 DSH 桌面客户端里个性化背景、且只使用本地图片、不关心云端同步的用户。
兼容性（以 README 为准，勿夸大验证范围）：
| 环境 | 说明 |
|---|---|
| macOS 桌面版 DSH 0.2.x | 实测通过 |
| Windows 桌面版 | 按钮按品牌行计算，避免压住标题栏菜单；README 注明未在 Windows 真机验证 |
| 浏览器标签页 | 面板可半透明，但宿主窗口不透明时壁纸可能只在部分区域可见，取决于壳层背景 |
插件与社区目录 SkillHub 均为社区生态，遵循 DSH「一切皆插件」的思路；目录站与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
安全提醒：插件以当前 DSH 进程权限运行，仅能访问其设计范围内的本地存储与 UI 槽位；仍应在安装前自行审阅 index.js、client.js 等入口文件。
结尾¶
dsh-wallpaper 用一个小按钮把「本地图 + 可调透明度 + 面板半透明」接到 DSH 窗口上，数据留在本机 IndexedDB。若你需要在 0.2.x 桌面版里换一张自己的背景，可按 README 地址安装试用。
