dsh-wallpaper：给 DeepSeek Harness 桌面端换一张自定义壁纸

前言¶

DeepSeek Harness（DSH）的桌面应用默认是统一的界面背景，用久了难免单调。对按「一切皆插件」理念构建的 DSH 来说，这类外观定制不需要改动主程序，装一个插件就能解决。

下面介绍的就是这样一款插件：dsh-wallpaper，作者 keke050，许可证为 MIT。它的作用是给 DeepSeek Harness 桌面应用设置自定义背景壁纸，支持预设、图片 URL、本地上传三种来源，并提供透明度滑块控制壁纸的显示强度。

dsh-wallpaper 是一个 DSH 插件，当前版本为 0.1.0，客户端平台为 web（安装时需要指定 --profile web）。它解决的问题是：让桌面应用的背景可以自定义，并且壁纸能透过对话区域显示，而不只是停留在侧边栏。

插件分为宿主端和客户端两部分，这是理解它行为方式的基础，后面单独说明。

按照 README 的描述，插件提供以下能力：

预设壁纸：内置 6 种渐变壁纸（aurora、ocean、sunset、forest、night、sakura），另有 none（无壁纸）选项。
图片 URL：粘贴任意 http(s) 图片地址作为壁纸。
本地上传：选择本地 PNG / JPG / GIF / WebP 图片，大小不超过 10MB。图片存储在宿主端，重启后仍保留。
透明度滑块：从 0%（隐藏）到 100%（主导显示）。拉到 100% 时，基础背景、卡片甚至消息气泡都会变为半透明，让壁纸铺满整个窗口。
持久化：配置和上传的图片存放在 $DSH_HOME/storages/wallpaper/，通过稳定的 /dsh-wallpaper/image 路径提供。桌面应用重新绑定随机回环端口时，数据不会丢失。

安装命令如下，注意带 --profile web 参数，因为插件的客户端平台是 web：

dsh plugin --profile web add github:keke050/dsh-wallpaper

安装完成后重启 DeepSeek Harness，然后打开 Settings → 壁纸 / Wallpaper，就能看到设置界面。

插件的 peerDependencies 为 @deepseek-ai/cordis ^4.0.1 和 react ^18.2.0，如果自行开发或排查依赖问题时可以参考。

进入设置界面后，按下面的步骤操作：

三种来源（预设、URL、上传）可以随时切换，配合滑块调整，几分钟内就能找到合适的显示效果。

了解插件的内部结构，有助于判断它的工作原理和数据去向。

宿主端注册了三个回环 HTTP 路由，分别负责配置、上传和图片读取：

壁纸数据持久化在 $DSH_HOME/storages/wallpaper/ 目录。由于图片通过稳定的 /dsh-wallpaper/image 路径提供服务，即使桌面应用重启后重新绑定了随机回环端口，已上传的壁纸和配置也不会失效。

客户端部分负责渲染设置区块，并注入 CSS 把壁纸放到 body 上。它通过覆盖 --dsw-alias-bg-* 和 --dsw-specific-* 两类设计令牌，让应用原有的背景表面变为半透明——这正是壁纸能透过对话区域（而不只是侧边栏）显示出来的原因。

这个插件适合长期使用 DeepSeek Harness 桌面端、希望界面更符合个人喜好的开发者。它只改动外观层，不涉及对话逻辑和数据处理，属于典型的「换装」类插件。

安装前有几点需要注意：

dsh-wallpaper 做的事情很单一：让你能自定义 DeepSeek Harness 桌面端的背景。三种壁纸来源、一个透明度滑块、可靠的持久化，功能克制但完整。如果你每天都对着这个界面工作，花两分钟换个背景是划算的。