前言¶

DeepSeek Harness (DSH) 桌面客户端的默认背景通常较为单调。如果你希望在开发或工作间隙使用本地图片或视频作为动态壁纸，同时保持界面清晰可读，dsh-client-ui-wallpaper 插件提供了一个直接的解决方案。它通过铺满窗口、背景模糊、独立调节面板与侧栏透明度，以及根据壁纸亮度自动切换文字颜色，解决了背景与内容可读性冲突的问题。

核心功能¶

背景与布局¶

• 铺满整窗：图片或视频按 object-fit: cover 铺满窗口，弹窗保持不透明。
• 模糊与纱层：背景模糊支持 0–60px 调节，并可选纱层（浅色/深色外观）。
• 独立透明度：面板与右侧栏透明度可分别调节（0–100%）。

智能显示¶

• 墨水模式：根据壁纸亮度自动切换深色或浅色文字。
• 代码块适配：代码块只跟随外观调整，不受 pre.shiki 透明背景干扰。

素材管理¶

• 静态/动态分离：静态图片与同名视频分开管理，网格中可一键切换。
• 轮换控制：支持轮换（间隔 15 秒–24 小时）与随机轮换，支持手动选择不打断轮换。
• 自动入库：新素材自动加入轮换列表。

稳定性保障¶

• 图层自愈：每 10 秒审计一次壁纸层，回收残留节点。
• 探针上报：通过 /_probe 路由实时上报状态。
• 大文件处理：超过 50MB 的素材不预热。
• 错误上报：加载失败与选择器失效时通过探针静默记录，不静默报错。

安装与启用¶

本插件要求宿主 DSH 版本 >= 0.2.0-rc.2。

桌面客户端安装¶

DSH 的 desktop profile 由 Electron 应用独占管理，命令行会拒绝直接安装。请在 设置 → 插件市场 中搜索并安装 dsh-client-ui-wallpaper。

Web Profile / CLI 安装¶

对于 web profile 或自建 profile，使用以下命令：

dsh plugin --profile web add dsh-client-ui-wallpaper

注意：命令需要 pnpm 在 PATH 中。

手动安装¶

如果环境受限，可手动安装：

npm i dsh-client-ui-wallpaper
node node_modules/dsh-client-ui-wallpaper/scripts/install.mjs --profile desktop

注意：手动修改配置可能被 DSH 覆盖。

典型用法¶

使用 Dynamic Wallpaper.app 素材¶

默认配置下，插件会直接读取 Dynamic Wallpaper.app 的素材库：
~/Library/Containers/whbalzac.Dongtaizhuomian/Data/Documents/{Wallpaper,Videos}

使用自定义目录¶

在配置文件中指定绝对路径（插件不支持 ~ 展开）：

imageDir: /Users/you/.dsh/wallpapers
videoDir: /Users/you/.dsh/videos

同步播放列表¶

使用脚本同步 Dynamic Wallpaper.app 的播放列表：

./sync-wallpaper-playlist.sh

注意事项¶

• 权限要求：读取同步目录需要给 DSH 完全磁盘访问权限。
• 路径限制：配置路径必须是绝对路径。
• CLI 依赖：CLI 命令需要 pnpm 在 PATH。
• 升级限制：使用 dsh plugin add 时需指定版本号以避免 pnpm 11 的 24 小时限制。
• 手动安装风险：手动安装的配置可能被插件管理器覆盖。

结尾¶

该插件通过精细的图层控制和探针监控，实现了对 DSH 桌面客户端背景的深度定制。更多细节可参考 GitHub 仓库。