dsh-ui-wallpaper
DeepSeek Harness 自定义壁纸插件：在设置面板里选本机图片当背景，可调不透明度/模糊/界面通透度/压暗，即时预览。A DeepSeek Harness Web wallpaper plugin with a dedicated Settings section.
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Ansellwan/DSH-Custom-Wallpaper#b4a893ae87d7b773fc241230d20811c507316306
Ui Wallpaper 以 dsh-ui-wallpaper 发布，当前版本为 1.0.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一句话价值：装上它，你的 DeepSeek Harness 桌面版界面立刻拥有自定义壁纸——本机任意图片做背景，透明度、模糊、界面通透度实时可调，即时预览。
A DeepSeek Harness (DSH) community plugin that lets you set any local image as the app wallpaper, with real-time controls for opacity, blur, surface translucency and dimming.
| 设置面板 | 说明 |
|---|---|
| 截图：壁纸设置面板 | 壁纸页内置在「设置」中：拖入 / 粘贴 / 选择本机图片，滑杆实时调节 |
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@<新版本号>
| 控件 | 作用 | 建议 |
|---|---|---|
| 铺满方式 | 铺满 / 完整显示 / 平铺 / 居中 | 大图用「铺满」 |
| 壁纸不透明度 | 壁纸自身的浓淡 | 60–100% |
| 界面通透度 | 界面底色让出多少给壁纸，决定壁纸是否看得见 | 0–30%，越大壁纸越明显、文字对比越低 |
| 模糊 | 壁纸整体虚化 | 0–12px |
| 压暗 | 压暗壁纸，深色主题下更耐看 | 0–20% |
| 压底薄纱 | 壁纸与界面之间的深色半透明底（提对比度下限） | 15–30% |
| 薄纱虚化 | 薄纱背后的 backdrop 虚化，负责抹掉细节 | 8–16px |
| 壁纸饱和 | 壁纸色彩浓度 | 80–100% |
粘贴只在壁纸页内生效：只有焦点位于壁纸设置面板时，Ctrl+V 才被壁纸接管，不会影响你在对话框、编辑器等处的正常粘贴（早期版本的全局粘贴监听事故已修复，详见下文「粘贴闸门」）。
壁纸设置保存在本机浏览器存储（localStorage，键 dsh.ui-wallpaper/v1），不写入 DSH 配置，不随账号同步。大图入库前会自动用 canvas 压到长边 2560px、必要时转 JPEG，避免撑爆存储配额。
localStorage（壁纸参数与图片数据）paste 监听与 navigator.clipboard.read()，但仅在焦点位于壁纸设置面板内时才接管（焦点判据见源码 client.js 的粘贴闸门），其余场景完全不干预z-index: -1 的固定背景层，并将壳层容器（侧栏 / 中栏底色）改为半透明以露出壁纸；对话气泡、代码块、输入框等面板刻意保持不透，保证文字对比度| 项目 | 说明 |
|---|---|
| DSH 版本 | 桌面版 Web 客户端，CLI 11.7.0 实测通过 |
| Profile | desktop |
| Node | ≥ 18（由 DSH 内置运行时满足） |
| 主题 | 浅色 / 深色自动跟随（样式全部使用主题 token --dsw-alias-*） |
⚠️ 已知限制：DSH 大版本更新后，壁纸有可能突然不显示（界面结构变化，插件需要跟着适配）。遇到这种情况请提 Issue 告知，会尽快适配；技术原因见下方「本地开发」一节。
对实际使用壁纸的实测（亮度 / 饱和度 / 对比度）得出三条结论：
默认值「薄纱 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
