前言¶

如果你要在 DSH Web 中更换网页背景，又不希望直接修改主题或自行写样式，dsh-background 提供了一个独立入口：在「设置 → 通用设置 → 外观」的「背景图片」行填写本地图片文件的绝对路径，即可把该图片设为网页背景，并通过蒙层强度调整文字可读性。

DSH 的插件生态通常以独立插件形式接入，社区目录也不是官方应用商店。下面只根据该插件已提供的能力，说明它适合做什么、怎么装、有哪些限制。

这是什么¶

dsh-background 是 luoyu-xingu 维护的 DeepSeek Harness Web 插件，许可证为 MIT。它解决的是“把网页背景换成本地图片，同时保留默认外观、明暗主题和文字可读性”的需求。

安装后，它会在外观设置中增加「背景图片」行，让你通过本地绝对路径替换背景，并提供实时预览和 0–100% 蒙层强度滑块。

本地路径设置：在「设置 → 通用设置 → 外观」的「背景图片」行填写本地图片文件的绝对路径，将图片以 cover 方式填充为网页背景。
特殊字符路径：支持包含空格等特殊字符的本地图片绝对路径，输入后回车或失焦生效。
实时预览：提供与默认外观控件同尺寸（180 × 88，圆角 16px）的实时预览框；输入框聚焦时，预览跟随输入实时变化。
宿主端图片路由：浏览器本身无法直接加载本地文件路径，图片由宿主端通过 /dsh-background/image 路由提供给浏览器。
持久化：配置保存到 $DSH_HOME/settings.yaml 的 ui-background 段，刷新、重启后自动恢复；未配置时无背景，且插件不内置默认图片。
跟随明暗主题：兜底色自动跟随浅色/深色静态色板，并自动叠加浅色主题白蒙层或深色主题深蒙层，以提高文字可读性。
蒙层强度可调：外观行内提供 0–100% 滑块，步进 5，默认 70%，实时调整蒙层透明度并持久化。
图片格式与大小：支持 jpg / jpeg / png / gif / webp / avif / svg / bmp / ico，单个文件上限 25MB。

先执行安装命令：

dsh plugin --profile web add dsh-background

安装完成后需重启 dsh web，刷新页面后才会在「设置 → 通用设置 → 外观」中看到「背景图片」行。

1、打开「设置 → 通用设置」，在外观下方找到「背景图片」。

2、在输入框粘贴本地图片路径，按回车或点击其它位置生效。

3、拖动「蒙层强度」滑块，调整文字可读性与图片可见度的平衡。

4、预览框会实时反映效果；刷新页面后背景依然保留。

5、如果不想保留背景，点击「清除背景」恢复默认外观。

该插件的配置保存在 $DSH_HOME/settings.yaml 的 ui-background 段。图片由宿主端读取本地文件后，通过 /dsh-background/image 路由提供给浏览器，而不是让浏览器直接读取本地路径。

当前版本（dsh 0.1.0-rc.6）的 settings 网关只对硬编码白名单内的命名空间开放浏览器读写，第三方插件注册的命名空间会收到 settings-not-exposed 拒绝；插件改用自定义 RPC 通道。

dsh-background 把“换背景”收进通用设置的外观行，用本地路径、实时预览和蒙层强度处理 DSH Web 界面的背景个性化需求。

GitHub：https://github.com/luoyu-xingu/dsh-background

目录页链接未在本文材料中提供；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。