前言¶
DeepSeek Harness（dsh）的 Web 界面默认是纯色或主题 token 背景，长时间在本地调试智能体时，界面容易显得单调。若只在浏览器里用 CSS 或扩展换背景，换端口、换浏览器或重装后往往要重来，图片也不一定能和浅色/深色主题一起协调。
下面介绍社区插件 ferii-dsh-wallpaper（维护者 ferii-87）：在 Harness 主机上保存一张本地图片，由 Web UI 绘制在窗口后方，并提供原图、清晰、平衡、柔和四档显示效果，随当前浅色/深色主题自动调整。图片不发起外网请求，适合在本地 Web UI 里做轻量「换装」。
这是什么¶
ferii-dsh-wallpaper 是面向 DeepSeek Harness Web 界面的背景图片插件，npm 包名为 @ferii87/dsh-wallpaper，源码托管于 GitHub。在 SkillHub 等社区目录中归类为「趣味换装」。
它解决的是：上传一次本地图片，由 Harness 主机持久化存储；在 Settings → General → 背景图片 中预览、切换效果或移除，无需每次手动改样式。
核心功能¶
根据项目 README，已核实能力如下。
- 设置入口：Settings → General → 背景图片 — 上传、替换、移除、预览，并显示文件名与尺寸。
- 主机侧存储：图片保存在
$DSH_HOME/wallpapers/（默认~/.dsh/wallpapers/），含image与meta.json，重启或 Web 端口变更后仍保留。 - 四档效果：原图（raw）、清晰（thin mask）、平衡（默认）、柔和（stronger mask）；切换立即生效，插件会测量图片平均亮度并在当前色板下做归一化。
- 无 Web 载体时的回退：若没有 Web carrier 路由，图片保存在当前浏览器的 storage 中。
- 隐私：不访问外网，图片不离开本机。
Host 端（index.js）在 Web carrier 上注册读写路由；浏览器端（client.js）负责设置项、亮度测量与主题 token 叠层渲染。无路由时回退到 localStorage。
安装与启用¶
安装时需指定 --profile web。官方 README 给出两种方式。
npm 包：
dsh plugin --profile web add @ferii87/dsh-wallpaper
GitHub：
dsh plugin --profile web add github:ferii-87/ferii-dsh-wallpaper
Desktop 应用可在 Settings → Plugins（或插件市场）中安装。若设置里暂时看不到「背景图片」一行，需重启 dsh web 或 Desktop 应用。
插件以当前 dsh 进程权限运行；安装前建议浏览 源码仓库 与 MIT 许可证。README 记载在 DeepSeek Harness 0.2.1-rc.5、Windows、Desktop Web UI 下测试；需要 composition 具备 Web UI、webServer 以及 settings.general.item 插槽。
典型用法¶
- 打开 Settings → General → 背景图片。
- 上传图片。长边会缩至最多 1920 px，并以 JPEG 形式存储。
- 在 效果 中选择一档：
- 原图 — 存储图，无遮罩与表面 tint。
- 清晰 — 轻量表面处理，接近原图。
- 平衡 — 默认，兼顾背景可见度与文字对比度。
- 柔和 — 更强表面 tint，利于文字可读性。 - 点击 移除 会删除主机上的图片并恢复默认背景。
适用场景与注意¶
适合谁：在本地或 Desktop 里长期使用 DSH Web UI、希望背景图持久化且随主题切换的开发者；分类上属于「趣味换装」，不改变 Harness 核心逻辑。
安全与绑定地址：插件路由默认无 session 鉴权；读接口只返回已存壁纸，写接口需要 JSON body 及请求头 x-dsh-wallpaper: 1。Harness 默认将 Web carrier 绑在 loopback；若将 Web 绑到局域网或公网接口，这些路由会对该网段暴露，不应在共享/公网 bind 下把壁纸当作私密数据。
生态说明：DSH 采用「一切皆插件」的扩展方式；SkillHub 目录页 是社区收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
ferii-dsh-wallpaper 把背景图收进 $DSH_HOME/wallpapers/，在 Web 设置里即可完成上传与四档效果切换，并适配浅/深色主题。需要细节时可查阅 SkillHub 插件页 与 GitHub 仓库 README。
