前言¶
DeepSeek Harness（DSH）的 Web GUI 使用 --dsw-* 系列的设计 token，界面配色是固定的，没有提供设置壁纸的入口。同时，wallhaven.cc 这类图站在很多网络环境下属于“浏览器打不开、命令行也打不开”的那一类——通常涉及 DNS 污染或需要特定代理。
本插件通过将搜索与图片获取转移到 DSH 宿主进程，解决了这两个问题。浏览器不需要直接访问 wallhaven，宿主端负责取图，插件通过路由与宿主通信，从而在设置页提供搜索和设置背景的功能。
安装与启用¶
安装前需要确认当前使用的 profile。桌面版只会启动 desktop profile，命令行工具使用 web profile。
# DeepSeek Harness 桌面版
dsh plugin --profile desktop add github:HaydenSmith1121/dsh-wallhaven-wallpaper
# dsh web / dsh tui 命令行
dsh plugin --profile web add github:HaydenSmith1121/dsh-wallhaven-wallpaper
安装后重启 Harness 生效。
核心功能¶
- 搜索与设为背景：在设置页搜索 wallhaven，点击缩略图即可将图片铺满界面背景。
- 宿主端取图：宿主端负责调用 API 和获取图片字节，浏览器仅与本地插件路由通信，因此即使浏览器被网络策略限制，壁纸依然能显示。
- 代理支持：支持自动探测可用代理（扫描常见端口）或手动填写代理地址。宿主端实现 HTTP CONNECT 隧道，支持复用环境变量
HTTPS_PROXY。 - 下载与外观：支持一键下载原图到本地；提供透明度、模糊、变暗遮罩控制。
- 分级过滤：支持 API Key 过滤分级，默认只搜索 SFW 内容。
典型用法¶
- 打开 设置 -> 壁纸。
- 在搜索框输入关键词或选择分类，点击缩略图将图片设为背景。
- 如需下载原图，点击“下载原图”按钮，文件将保存到默认目录（如
图片/DSH Wallpapers）或指定的下载目录。 - 如遇网络问题，打开 设置 -> 访问 -> 代理，可以手动填写代理地址，或点击自动探测结果。
- 在 外观 设置中调整透明度、模糊度和遮罩，以平衡壁纸显示与界面文字的可读性。
技术细节与限制¶
- 兼容性探测：插件按接口探测兼容性，不按版本号判断。若某接口缺失，会在设置页的“兼容性”栏目中显示，但不会导致插件失效。
- 网络边界：只允许
w.wallhaven.cc和th.wallhaven.cc两个域名。写操作（如配置修改、下载）要求同源，确保安全性。 - 资源占用：不触碰模型，不影响 KV cache；零运行时依赖。配置文件存储在
$DSH_HOME/storages/dsh-wallhaven-wallpaper/，缩略图缓存也会存放在该目录下。
结语¶
这是一个轻量级的插件，通过将网络请求从浏览器移至宿主端，解决了在受限网络环境下更换壁纸的需求。
