前言¶
DeepSeek Harness（DSH）的界面默认是独立主题背景。如果你希望聊天窗口和当前桌面在视觉上连贯——系统换壁纸时界面背景也跟着变，又不想手动上传图片——就需要在插件层读取系统壁纸并渲染到 Web 前端。dsh-wallpaper 由社区维护者 liuleiyu121520 开发，归类为「趣味换装」，在 macOS、Windows、Linux 上把当前桌面壁纸同步为 Harness 界面的半透明实时背景。
这是什么¶
dsh-wallpaper 是 DSH 社区插件，仓库地址为 github.com/liuleiyu121520/dsh-wallpaper。当前发布版本为 0.3.3，采用 MIT 许可证。插件不修改桌面设置，只读取壁纸并在 Harness 内以可调节的半透明层展示；设置、对话框等浮层保持不透明，避免文字难以辨认。
社区目录页：skillhub.cn/plugins/liuleiyu121520/dsh-wallpaper。该目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
实时同步与跟随系统¶
壁纸默认每 6 秒检查一次（可通过 intervalMs 调整）。只有画面确实变化时才更新，避免闪屏。macOS 的航拍/动态壁纸、Windows 幻灯片轮换会随系统当前图片自动跟上。
外观调节¶
在「设置 → 实时壁纸外观」中可调五个参数，修改即时生效：模糊（blurPx）、强度（opacity）、面板不透明度（surface）、压暗（scrim）、饱和度（saturate）。深色/浅色主题切换时，压暗默认值会分别适配（浅色主题下 scrim 默认更低，减轻画面发灰）。
更新提醒与热更新¶
后台每 6 小时检查一次 GitHub Release。有新版本时右下角弹出提示，约 14 秒后自动消失，设置页导航项会带标记。在设置页点击「有新版本可用」可直接安装，成功后立即生效，无需重启 Harness 或敲命令。
平台与读取方式¶
| 平台 | 读取方式 | 状态 |
|---|---|---|
| macOS | 截取系统壁纸窗口（screencapture） |
已验证（macOS 27.0.1） |
| Windows | 注册表 HKCU\Control Panel\Desktop\Wallpaper；失败时用 .NET 采样桌面 |
已实现，待实机验证 |
| Linux | GNOME gsettings、XFCE xfconf；需 ImageMagick 转码 |
已实现，待实机验证 |
未列出的平台插件不会崩溃，只是不显示背景（状态接口报告 unsupported platform）。
各平台依赖：
- macOS：Xcode Command Line Tools（
swiftc），用于编译一次性窗口枚举器 - Windows：系统自带 PowerShell 与 .NET（Windows 10/11 默认具备）
- Linux：
imagemagick（magick或convert）
安装与启用¶
插件以当前 dsh 进程权限运行。安装前建议阅读仓库源码与 MIT 许可证，确认权限与行为符合你的环境。
从 GitHub 安装¶
将 <你的 profile> 换成你实际使用的 DSH profile：
dsh plugin --profile <你的 profile> add github:liuleiyu121520/dsh-wallpaper
若希望固定到某一提交，避免上游变更影响本地：
dsh plugin --profile <你的 profile> add github:liuleiyu121520/dsh-wallpaper#<commit>
从 DSH Hub 安装¶
在 DSH Hub 插件页点击安装，或在 Harness「设置 → 插件」中搜索 dsh-wallpaper。
安装后¶
安装后重启 Harness，在「设置 → 实时壁纸外观」里调整参数。
典型用法与配置¶
参数可在设置页实时调节，也可写入 cordis.patch.yml 的 config 作为默认值：
| 参数 | 默认值 | 范围 | 说明 |
|---|---|---|---|
intervalMs |
6000 |
500–600000 | 壁纸检查间隔（毫秒） |
opacity |
1 |
0.02–1 | 壁纸整体强度 |
blurPx |
0 |
0–80 | 模糊半径，0 为原图 |
scrim |
0.35 |
0–1 | 压暗层强度 |
saturate |
1 |
0.2–3 | 饱和度 |
surface |
0.5 |
0.2–1 | 面板不透明度 |
示例片段：
- insert:
- id: dsh-wallpaper
name: 'dsh-wallpaper'
config:
intervalMs: 6000
blurPx: 12
scrim: 0.3
surface: 0.55
卸载：
dsh plugin --profile <你的 profile> remove dsh-wallpaper
或在「设置 → 插件」中停用/移除。卸载后半透明背景立即消失，桌面壁纸本身不受影响。
权限、工作原理与限制¶
权限与副作用¶
- macOS 首次使用需授予「屏幕录制」权限，否则截取结果为空白
- Windows 仅读取当前用户桌面壁纸路径，不修改注册表中的其他项
- 网络：仅在点击「检查更新」时访问 GitHub Releases API
- 不修改桌面壁纸或系统桌面相关设置
工作原理（概要）¶
平台后端（src/backends/）将壁纸读成 PNG；Host 半区压缩为 1600px JPEG，并用 32×32 灰度探针判断是否变化；浏览器半区轮询版本号，有新图时拉取并交叉淡入；通过重写 --dsw-alias-bg-base 等主题变量实现面板半透明。
已知限制¶
- 左侧设置导航图标由 Harness 白名单决定，第三方插件可能只显示通用图标
- macOS 动态航拍壁纸在桌面上多为静止帧，背景同步亦为静态
- 多显示器场景目前只同步主显示器（窗口 id 最小）
结尾¶
dsh-wallpaper 适合希望在 Harness 里与桌面视觉统一、又不想手动维护背景图的开发者。安装与参数以 README 为准；社区目录见 skillhub.cn/plugins/liuleiyu121520/dsh-wallpaper，源码与 Issue 见 GitHub 仓库。
