前言¶
DeepSeek Harness（DSH）的界面配色走一整套 --dsw-* 设计 token，默认没有「换背景图」的入口。若你想给本地 Web GUI 加一点视觉区分，又不想手改主题源码，就需要一个挂在 Harness 插件体系里的方案。
Wallhaven（wallhaven.cc）是常见的壁纸来源，但在不少网络环境里，浏览器直连会碰到 DNS 污染、必须走代理，或公司网只放行白名单等问题。即便命令行能 curl，从图形界面启动的 DSH 进程也未必继承 HTTPS_PROXY。下面介绍的插件把「搜图、显示、下载」放在宿主端完成，浏览器只访问本机 127.0.0.1 上的插件路由，从而在连不上 wallhaven 的浏览器里照样能用。
这是什么¶
dsh-wallhaven-wallpaper 是 DeepSeek Harness 的联网类插件：在 设置 → 壁纸 里按条件搜索 wallhaven.cc，点选结果即可铺成界面背景，并支持模糊、遮罩、不透明度与填充方式等外观调节，以及一键把原图保存到本地。图片与 API 请求均由 DSH 宿主进程发出，浏览器无需能访问 wallhaven；插件声明为零运行时依赖，许可证为 MIT。
社区目录页：dsh-wallhaven-wallpaper（SkillHub）。源码与详细说明见 GitHub README（package.json 中仓库地址为 HaydenSmith1121/dsh-wallhaven-wallpaper）。README 标明与 @deepseek-ai/dsh 的 0.1.6-alpha.1 至 0.2.1-rc.2 等版本已实测；兼容性采用逐项接口探测而非单看版本号，报告在 设置 → 壁纸 → 兼容性。
核心功能¶
宿主端取图与代理¶
- wallhaven 的 API 与图片字节由宿主发出；Web 端只与本插件注册的本地路由通信。
- 访问 → 代理 可手动填写（例如
http://127.0.0.1:7897）；留空时读取HTTPS_PROXY/https_proxy/ALL_PROXY/HTTP_PROXY。页面进入时会测连通性，并可扫描常见本机 HTTP 代理端口（不支持 SOCKS，需在客户端开 HTTP 端口）。 - 图片仅允许
https下的w.wallhaven.cc与th.wallhaven.cc两个域名。
设置页与快捷操作¶
- 设置 → 壁纸：搜索条件、缩略图网格、翻页、当前背景预览，以及外观与访问相关选项。
- 侧边栏底部 ↻ 换一张：在当前搜索条件下随机换一张，无需每次打开设置。
- 默认只搜 SFW，无需 API Key；需要 Sketchy / NSFW 或账号过滤器时，在 wallhaven 账户设置生成 Key，填入 访问 → wallhaven API Key（以请求头
X-API-Key发送）。
背景如何叠在界面上¶
插件不替换官方 Slot 或节点，而是插入固定背景层，并按 界面不透明度 重算若干 --dsw-* 表面 token 的 alpha，让壁纸从既有主题里透出来；关闭 启用界面壁纸 会移除图层与样式。菜单、弹窗等浮层保持不透明，避免半透明控件难以阅读。
下载与本地存储¶
- 下载原图 保存到 访问 → 原图保存到 指定目录；留空时默认
图片/DSH Wallpapers（Windows 为%USERPROFILE%\Pictures\DSH Wallpapers）。 - 配置与缩略图缓存位于
$DSH_HOME/storages/dsh-wallhaven-wallpaper/。
插件不注册模型工具、不改写模型路由；写文件限于上述存储目录与用户指定的下载目录。
安装与启用¶
安装前须选对 profile，否则插件不会出现在对应环境里：
| 使用方式 | profile | 命令 |
|---|---|---|
| DeepSeek Harness 桌面版 | desktop |
dsh plugin --profile desktop add github:HaydenSmith1121/dsh-wallhaven-wallpaper |
dsh web / dsh tui |
web |
dsh plugin --profile web add github:HaydenSmith1121/dsh-wallhaven-wallpaper |
桌面版只加载 desktop profile；装进 web 不会在桌面版里出现，反之亦然。安装后重启 Harness 生效。README 亦提到可将 spec 换成 npm 包名或本地 .tgz 路径安装。
装完可在不打开界面的情况下粗查配置与路由：
dsh --profile desktop --dump-config | tail -3
末行应出现 dsh-wallhaven-wallpaper。另可请求兼容性端点（端口以你本地 DSH 为准）：
curl http://127.0.0.1:<端口>/plugins/dsh-wallhaven-wallpaper/compat
返回 Harness 版本、profile 及宿主路由是否注册等信息。
典型用法¶
1. 先处理连不上 wallhaven 的情况¶
打开 设置 → 壁纸，右上角状态行会显示连通性测试结果。若本机有 Clash / mihomo 等但 DSH 未继承代理，页面可能提示可用代理并一键 使用；也可在 访问 → 代理 自行填写。搜索前会先测连通性，失败则跳过搜索并说明原因。
2. 搜索并设为背景¶
- 调整分类、分级、排序、最低分辨率、比例等条件后会自动按新条件重搜；默认约为「榜单 · 近一月 · ≥1920×1080」。
- 在网格中点击一张图，即设为背景并打开总开关。
- 在 当前背景 可查看分辨率、分级、体积等，使用 下载原图 或 在 wallhaven 打开。
- 在 外观 调节界面不透明度（默认
0.72）、模糊、变暗遮罩、填充与对齐方式。
3. 换版本或异常时看兼容性页¶
设置 → 壁纸 → 兼容性 列出宿主路由、设置页席位、侧边栏、文案注册、主题 token 等探测结果。换 Harness 版本后建议先看该页，而不是凭版本号猜测是否可用。
适用场景与注意¶
适合在本地长期使用 DSH Web / 桌面 GUI、希望用 Wallhaven 壁纸且网络对浏览器不友好的开发者。默认仅回环访问时，写配置与下载等 POST 要求同源 Origin，但仍需意识到：谁若能连上 DSH 的 Web 端口，就具备与该插件暴露面相当的能力；不要把未加保护的实例随意暴露到局域网。
插件以当前 dsh 进程的用户与权限 运行，会发起对外 HTTPS 请求并写入 $DSH_HOME 与用户配置的下载目录。安装前请自行查看源码与 MIT 许可证，确认代理、API Key 与下载路径符合你的安全策略。/compat 为只读 GET，会回显版本、profile、$DSH_HOME 等路径类信息，评估暴露面时与 /status 一并考虑。
Node 引擎要求见包内 engines（^22.19.0 || >=24.0.0）；peerDependencies 对 @deepseek-ai/dsh 有分段版本范围，具体以 package.json 为准。
结尾¶
dsh-wallhaven-wallpaper 把 Wallhaven 搜索、GUI 背景与宿主侧代理取图绑在 DSH 插件模型里：浏览器不必访问 wallhaven，主题 token 仍随产品配色变化。需要安装命令与行为细节时，以 README 为准；社区索引见 SkillHub 目录页，源码见 GitHub。
