前言¶
在使用 DeepSeek Harness (DSH) Web 客户端时，默认的基础背景往往较为单调。dsh-client-background 插件接管了这一层，用 Unsplash 上精选的随机图片替换基础背景，并通过半透明表面来展示图片。
是什么¶
这是一个由 imcp-pro 维护的 DSH Web 客户端插件。它旨在为 Web 界面提供动态、可定制的背景层，不依赖框架，仅使用浏览器原生 API 实现。
核心功能¶
- 精选壁纸轮播：内置 100 张精选壁纸，支持配置间隔自动切换。
- 运行时控制：可以在不卸载插件的情况下通过设置面板开启或关闭背景效果。
- 客户端更新检查：插件会定期轮询 GitHub 仓库，检测新版本并提示具体的更新命令。
- 无框架耦合：视觉效果的实现仅依赖浏览器全局变量（
document、Image、setInterval），对宿主框架侵入性低。
安装与启用¶
安装前请确保已配置 dsh 的 web profile，并且该 profile 包含 web-app bundle。
官方安装命令：
dsh plugin --profile web add github:imcp-pro/dsh-client-background
注意：从 GitHub 安装时，prepare 脚本会在安装时构建 lib/ 目录。如果使用 pnpm ≥ 10，可能会遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 错误。此时需要将错误提示中生成的 allowBuilds 键添加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 中。
配置与用法¶
安装后，通过设置面板进行配置：
- 打开 Settings → Plugins → Plugin list。
- 展开 Wallpaper background（在 Global plugins 下）。
- 调整以下字段：
| 字段 | 默认值 | 说明 |
|---|---|---|
| Enable background | on | 运行时开关，关闭效果但不卸载插件 |
| Rotation interval | 20 | 图片自动切换的间隔（秒） |
| Check for updates | off | 是否开启自动更新检查 |
| Check interval | 21600 | 更新检查的间隔（秒） |
修改保存后立即生效。
注意事项¶
- 即时切换：图片切换为即时刷新，没有淡入淡出动画，但通过预加载机制减少了加载时的闪烁。
- iOS Safari 兼容性：在 iOS Safari 上，
background-attachment: fixed样式会被忽略，图片会随页面内容一起滚动。 - 更新机制：更新检查是纯客户端行为，浏览器直接对比 GitHub 默认分支的提交与构建时嵌入的提交哈希，不会修改正在运行的安装实例。
- 主题适配：插件会自动跟随 DSH 的主题切换（亮色模式显示半透明白，暗色模式显示半透黑），但暗色模式通常能提供更好的视觉对比度。
总结¶
该插件通过轻量级的方式为 DSH Web 客户端增加了视觉丰富度，适合希望快速定制界面风格的开发者或用户。
