前言¶
DeepSeek Harness（DSH）的 Web 界面默认是纯色或主题自带的背景。若你长时间在聊天区、侧栏和设置页之间切换，只改聊天区背景往往显得割裂；侧栏与标题栏仍是系统默认色，整体观感不统一。
社区维护者 Sostay 发布的 dsh-wallpaper（仓库 Sostay/dsh-wallpaper）是面向 DSH 的 Cordis 插件，在 SkillHub 目录中归类为「趣味换装」。它把壁纸铺到整个窗口（含标题栏、左右侧栏与主内容区），并支持预设、外链、本地上传与磨砂面板等可调项。下面介绍其定位、能力与安装用法。
这是什么¶
dsh-wallpaper 是纯 JavaScript、零构建的 UI 插件（Client half）：Host 侧 index.js 仅导出空的 apply()，样式与配置面板在浏览器侧的 client.js 中完成。配置持久化在浏览器 localStorage 的键 dsh_wallpaper_config_v2。
许可证为 MIT；package.json 中当前版本为 1.0.4。插件不引入外部运行时包，React 由 DSH 浏览器模块表提供。
核心功能¶
全窗口与作用域¶
- 全窗口壁纸：覆盖标题栏、左侧栏、右侧栏与聊天区，而非仅聊天区。
- 作用域可选：「全部（含侧栏）」或「仅聊天区」。
壁纸来源与预设¶
- 三种来源：精选预设 / 网络图片链接 / 本地图片上传（本地文件转为 Data URL 存储；上传前经 Offscreen Canvas 等比缩放与压缩，减轻
localStorage配额压力）。 - 10 个内置预设：5 个深色渐变（深邃极光、赛博霓虹、落日晚霞、幽蓝深海、暗夜微芒）+ 5 张摄影类壁纸（清晨薄雾、星辰宇宙、静谧雪山、赛博都市、晨雾密林）。
- 自定义链接：任意可访问的图片 URL。
- 适配方式：
cover/contain/repeat。
视觉效果¶
- 亚克力磨砂面板：可调壁纸不透明度、遮罩不透明度与背景模糊；侧栏遮罩自动取聊天区遮罩值的 60%，侧栏更通透。
- 主题自适应顶部渐变：跟随 DSH 主题，暗色约为
#151517，亮色约为#FFFFFF，与body[data-ds-dark-theme]一致。 - 动态参数：通过
--dsh-wp-*CSS 变量驱动，拖动滑块时只更新变量，避免整表重算。 - 主面板适配：对话区、插件页及 Schedules 等
[data-slot="main"]下页面均可透出磨砂壁纸；底部覆盖 DSH 默认渐变节点，壁纸可延伸至窗口底边。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证；插件在当前 DSH 进程对应的前端环境中运行，与你在该实例中启用的其他插件相同，无额外沙箱。
方式一：从 GitHub 安装（README 推荐）¶
将 <profile> 换成你的 DSH profile 名称：
dsh plugin --profile <profile> add github:Sostay/dsh-wallpaper
README 说明：本插件无需 prepare 或编译，安装后即可使用。若希望生产环境锁定源码，可指定 commit：
dsh plugin --profile <profile> add github:Sostay/dsh-wallpaper#<commit-sha>
方式二：DSH Web GUI¶
打开 设置 → 插件 → 添加插件，填入仓库地址 https://github.com/Sostay/dsh-wallpaper（或目录页给出的同源信息）。
方式三：从 tarball 安装¶
在已下载的插件源码目录中打包并安装（README 示例包名为 dsh-wallpaper-plugin-1.0.2.tgz，以你本地 pnpm pack 产出为准）：
pnpm pack
dsh plugin --profile <profile> add ./dsh-wallpaper-plugin-1.0.2.tgz
安装并在 设置 → 插件 中启用后，进入 设置 → 通用 → 背景壁纸 打开配置面板。
典型用法¶
配置面板中的主要项如下（与 README 表格一致）：
| 配置项 | 说明 |
|---|---|
| 启用壁纸 | 总开关；关闭后不注入任何样式 |
| 壁纸来源 | 精选预设 / 网络图片链接 / 本地图片上传 |
| 预设 | 10 个内置背景（5 渐变 + 5 图片） |
| 自定义链接 | 任意可访问的图片 URL |
| 本地上传 | 选择本地图片文件 |
| 不透明度 | 壁纸本身的透明度 |
| 遮罩不透明度 | 磨砂面板遮盖强度 |
| 模糊 | 壁纸 blur() 半径 |
| 适配方式 | cover / contain / repeat |
| 作用域 | 全部（含侧栏）或仅聊天区 |
常见流程：先打开「启用壁纸」，再选「精选预设」快速试色，或切到「网络图片链接」填入 HTTPS 图床地址；若需离线或私有图，用「本地图片上传」。侧栏过暗时可略降「遮罩不透明度」，或把「作用域」改为「仅聊天区」做对比。
适用场景与注意¶
适合：希望在 DSH Web GUI（Electron PWA 与浏览器）中长期使用统一视觉、又需要跟亮/暗主题联动的开发者或日常用户。
兼容性（据 README）：需要支持 dsh.bundle 与 dsh.client 的 DSH 版本；亮色与暗色主题均已适配。
卸载：
dsh plugin --profile <profile> remove dsh-wallpaper-plugin
SkillHub 上的插件目录由社区维护，与 DeepSeek / 幻方无官方从属关系；星标与分类以目录展示为准（当前简介侧重全窗口壁纸与磨砂效果）。
结尾¶
dsh-wallpaper 把 DSH 界面从「仅聊天区换肤」扩展到全窗口，并把预设、外链、本地上传和磨砂参数收到同一设置入口。需要详情与 issue 时，见 GitHub 仓库 与 SkillHub 目录页。
