壁纸与磨砂主题 yunshu-iii/dsh-wallpaper-theme

dsh-wallpaper-theme

DSH Harness 桌面端插件：给 Harness 窗口换壁纸——本机图片、浅色/深色各一张、历史图库、渐变预设，并把界面调成可读的磨砂玻璃。

配套插件：dsh-api-usage-meter —— 窗口底部的 API 余额与 token 用量状态栏。

壁纸效果

同一界面开启壁纸前后（左：原生外观；右：开启壁纸）：

默认外观与壁纸效果对比

入口在侧栏底部：

它是什么

侧栏底部（设置按钮上方那排）多一个「主题与壁纸」按钮，侧栏收起时自动变成纯图标。点开是一个居中面板：上传本机图片当窗口壁纸，按浅色 / 深色分别设置，管理图库与渐变预设，并逐项调节界面材质。

壁纸整窗铺满，不再是「把面板调透明」那种做法——文字可读性交给每个表面自己的玻璃下限。

两种布局

| 布局 | 效果 |
| 铺满（默认） | 壁纸从窗口一边铺到另一边；对话区盖一层可调的「画布地板」，侧栏更透，卡片/弹窗/设置页保持接近实心 |
| 浮窗 | 应用变成浮在壁纸上的圆角卡片，四周留 0–64px 边距，边距里壁纸 100% 原样显示 |

功能

- 先改草稿，点「应用」才生效：选图、调滑杆、开轮换都只改面板里的草稿；关闭弹窗会丢弃未应用的修改。
- 浅色 / 深色各一张：只设了一套时另一套自动沿用。
- 图库：上传过的图片全部保留（默认最近 30 张），点选即用，悬停删除（点两次确认）。
- 渐变预设：6 套内置浅/深渐变，不用存图片。
- 自动轮换：开关 + 间隔（1 / 3 / 6 / 12 / 24 小时），在库内图片之间轮换。
- 外观切换：面板里直接切 浅色 / 深色 / 跟随系统，与设置里的偏好是同一份。
- 数值可直接输入：每个滑杆右侧是数字框，回车或失焦生效；百分比 1% 一档。
- 每个滑杆都有独立说明，固定挂在对应项下方。

参数

| 参数 | 范围 | 说明 |
| 布局 | 铺满 / 浮窗 | 见上表 |
| 画布地板 | 30–70% | 对话区那层玻璃的可读下限，越低壁纸越明显 |
| 侧栏地板 | 25–70% | 侧栏单独的下限，比画布更透 |
| 输入栏不透明度 | 50–100% | 输入框单独一层底（默认 94%）+ 18px 磨砂 |
| 弹窗不透明度 | 50–100% | 设置弹窗自身的不透明度（默认 97%） |
| 卡片边距 / 卡片底色 / 侧栏磨砂 | 浮窗专用 | |
| 面板虚化 | 0–40px | 面板背后的磨砂强度 |
| 壁纸强度 / 壁纸模糊 / 暗化 | 0–100% / 0–40px / 0–80% | 壁纸自身的浓度、虚化和黑色蒙层 |
| 填充方式 | 铺满 / 适应 | |

分级兜底：卡片层 88% / 91% / 94%，输入框 94% + 独立磨砂，所以调低画布地板不会把设置页一起调透。

安装

方式一：命令行（推荐）

桌面端
dsh plugin --profile desktop add github:yunshu-iii/dsh-wallpaper-theme

Web 端
dsh plugin --profile web add github:yunshu-iii/dsh-wallpaper-theme

装完重启 Harness 生效。也可以从插件页「安装第三方插件」选择本仓库，或先装 dsh-plugin-market 在市场里一键安装。

存储

$DSH_HOME/wallpaper-theme/
├── index.json 图库索引 + 当前选择 + 参数 └── files/<id>.<ext> 图片本体（按内容哈希命名，重复上传自动去重）

- 单张上限 20MB，图库 30 张 / 300MB，超出时淘汰最旧且未被使用的。
- 上传前浏览器先缩到最长边 2560px 的 WebP，12MP 照片通常只有几百 KB。
- 图片只存本机，不上传任何服务器，也不走附件 / 会话通道。

实现要点

- 壁纸画在插件自持的 constructable stylesheet 里：html::before 固定定位、三层叠加（淡出底 → 暗化 scrim → 图片）。
- 「壁纸强度」用底色渐变实现而不是 opacity，保持这一层始终不透明——否则面板的 backdrop-filter 会静默失效。
- 铺满模式只改 token：--dsw-alias-bg-base（画布地板）、--dsw-specific-sidebar-fill（侧栏地板）、--dsw-alias-bg-layer-1/2/3（卡片）、--dsw-specific-input-major（输入框）。三列各读自己的 token 画背景，所以「对话区磨砂、侧栏更透、卡片接近实心」是同一张表算出来的。
- 桌面壳兼容：清掉 --dsh-desktop-frame-fill、.dshDesktopFrame 的背景与 extended/advanced 模式下 .dshDesktopSidebarSurface 的不透明底。
- 禁用兜底：客户端每 10 秒探一次宿主接口（单次 5 秒超时）；404 / 超时 / 连接失败都算「宿主不在了」，撤掉壁纸并隐藏按钮，重新启用后自动恢复。
- 卸载时整张样式表清空，所有覆盖同时消失。

已知限制

- 右上角的最小化 / 最大化 / 关闭是 Windows 原生窗口按钮，由系统绘制在网页之上，网页 CSS 无法覆盖；要统一需要主进程 setTitleBarOverlay。
- 个别控件若用了写死的颜色（不走 token），壁纸在那一小块上透不出来。
- 只做壁纸与表面材质：不改变强调色、字体、圆角等设计 token。
- 不做多方案分组保存（如「工作日 / 周末」两套）；浅深两套是最小单位。
- 轮换只在页面打开时检查——应用关着不会跳图。

License

MIT © yunshu-iii