自定义壁纸 Ansellwan/DSH-Custom-Wallpaper

DSH 自定义壁纸插件（DSH Custom Wallpaper）

Listed on dsh-plugin.org

一句话价值：装上它，你的 DeepSeek Harness 桌面版界面立刻拥有自定义壁纸——本机任意图片做背景，透明度、虚化、界面通透度实时可调，即时预览。

这是 DeepSeek Harness（DSH）社区插件，让你把本机任意图片设成应用壁纸，不透明度、虚化、界面通透度、压暗都能实时调。

截图：换壁纸后的整体效果

| 设置面板 | 说明 |
| 截图：壁纸设置面板 | 壁纸页内置在「设置」中：拖入 / 粘贴 / 选择本机图片，滑杆实时调节 |

- 能力分类：界面与外观（UI / Appearance · 主题与壁纸）
- 许可证：MIT
- 运行形态：DSH Web 客户端插件（profile：desktop）
- 安装包名：dsh-ui-wallpaper（npm 包 · 插件行 id：ui-wallpaper）

安装（复制即用）

要求：DeepSeek Harness 桌面版，CLI ≥ 11.7（内置 Node ≥ 18）。

方式一：从 npm 安装（推荐）
dsh plugin --profile desktop add dsh-ui-wallpaper

方式二：从 GitHub 仓库直装（无需 npm，github: 简写）
dsh plugin --profile desktop add github:Ansellwan/DSH-Custom-Wallpaper

方式三：完整 git 地址同样可行
dsh plugin --profile desktop add https://github.com/Ansellwan/DSH-Custom-Wallpaper.git

--profile 后写你想装进哪个 profile（桌面软件用 desktop）；名字不存在会自动创建。

装完 重启 DSH 应用 即可生效（客户端脚本随页面加载自动注入）。如果你在浏览器里用 DSH Web 界面，刷新页面（Ctrl+R / F5）同样可以。

卸载：

dsh plugin --profile desktop remove dsh-ui-wallpaper

也可以在 DSH 的 设置 → 插件 面板中直接卸载。

升级到新版本（注意：add 对已安装的包不会自动升版，要显式带上版本号）：

dsh plugin --profile desktop add dsh-ui-wallpaper@<新版本号>

怎么用

1. 打开左下角 设置，导航里点 壁纸
2. 点击虚线框挑一张本机图片；也可以把图片拖进面板，或在壁纸页内按 Ctrl+V 直接换
3. 拖动滑杆微调，面板背后即时预览

| 控件 | 作用 | 建议 |
| 铺满方式 | 铺满 / 完整显示 / 平铺 / 居中 | 大图用「铺满」 |
| 壁纸不透明度 | 壁纸自身的浓淡 | 60–100% |
| 界面通透度 | 界面底色让出多少给壁纸，决定壁纸是否看得见 | 0–30%，越大壁纸越明显、文字对比越低 |
| 压暗 | 压暗壁纸，深色主题下更耐看 | 0–20% |
| 压底薄纱 | 壁纸与界面之间的深色半透明底（提对比度下限） | 15–30% |
| 薄纱虚化 | 薄纱背后的 backdrop 虚化，负责抹掉细节 | 8–16px |

粘贴只在壁纸页内生效：只有焦点位于壁纸设置面板时，Ctrl+V 才被壁纸接管，不会影响你在对话框、编辑器等处的正常粘贴（早期版本的全局粘贴监听事故已修复，详见下文「粘贴闸门」）。

壁纸设置保存在本机浏览器存储（localStorage，键 dsh.ui-wallpaper/v1），不写入 DSH 配置，不随账号同步。大图入库前会自动用 canvas 压到长边 2560px、必要时转 JPEG，避免撑爆存储配额。

权限与隐私（风险声明）

- 纯本地运行：无任何外部服务、无网络请求，不上传任何数据
- 存储：仅写入本机 localStorage（壁纸参数与图片数据）
- 剪贴板：安装了捕获阶段 paste 监听与 navigator.clipboard.read()，但仅在焦点位于壁纸设置面板内时才接管（焦点判据见源码 client.js 的粘贴闸门），其余场景完全不干预
- DOM 注入：插件会插入一个 z-index: -1 的固定背景层，并将壳层容器（侧栏 / 中栏底色）改为半透明以露出壁纸；对话气泡、代码块、输入框等面板刻意保持不透，保证文字对比度

兼容性

| 项目 | 说明 |
| DSH 版本 | 桌面版 Web 客户端，CLI 11.7.0 实测通过 |
| Profile | desktop |
| Node | ≥ 18（由 DSH 内置运行时满足） |
| 主题 | 浅色 / 深色自动跟随（样式全部使用主题 token --dsw-alias-） |
⚠️ 已知限制：DSH 大版本更新后，壁纸有可能突然不显示（界面结构变化，插件需要跟着适配）。遇到这种情况请提 Issue 告知，会尽快适配；技术原因见下方「本地开发」一节。

设计依据（为什么默认值是这样）

对实际使用壁纸的实测（亮度 / 饱和度 / 对比度）得出三条结论：

1. 纯深色薄纱有天花板：能救浅色文字，救不了深色文字
2. 模糊比压暗有效：最差区域对比度从 1.00:1 抬到 2.10:1，中位从 3.34:1 抬到 5.03:1
3. 深色字与浅色字无法在同一张图上同时安全：选图要跟主题同向（深色主题配暗图）

默认值「薄纱 18% + 薄纱虚化 10px」= 薄纱托住下限、虚化抹平细节，缺一都治不了"花"。

文件结构

| 文件 | 作用 |
| package.json | bundle 清单：dsh.bundle.patch + dsh.client（platform/immediately/inject） |
| cordis.patch.yml | 插入插件行 id: ui-wallpaper |
| index.js | Host 半：空实现（壁纸纯浏览器侧，无 Host 状态） |
| client.js | 浏览器半：背景层 + 设置页 + 存储 |
| locale/zh.json、locale/en.json | 插件列表的标题与描述（中英双语） |
| icon.svg | 插件列表图标 |
| tools/ | 自检与回归测试脚本 |
| docs/ | 截图 |

本地开发与回归测试

node tools/check-plugin.mjs .
node tools/smoke-client.mjs client.js

回归测试会模拟一个迷你浏览器环境，把真实的 client.js 完整跑一遍，自动检查几十项关键行为：壁纸能否正常显示、各滑杆参数是否生效、快捷键粘贴会不会误伤其他页面、卸载后能否清理干净等。结尾输出 ALL CHECKS PASSED 即为全部通过。

开发要点（改代码前先看）

- 客户端入口是 window.__ModuleLoader__.load({ id, factory })，id 必须等于包名 dsh-ui-wallpaper；factory(require) 里只能 require react（官方警告：抛错的组件会让整个插槽条目空白）
- 设置页注册在 settings.section（整页插槽），组件只拿 close 一个 owner prop
- 「界面通透度」的值写在根元素内联样式（--wlp-surface）；任何中间层都不许声明该变量（子元素声明会压过祖先继承值，导致滑杆失灵），兜底只能写在读取侧 var(--wlp-surface, 34%)
- 选择器只匹配类名后缀（[class="_frame"]），宿主改版时先核对这些后缀

许可证

MIT © 2026 Ansellwan