前言¶

在 DeepSeek Harness（DSH）的 Web 界面中，背景通常是固定的。对于希望根据项目、演示或本地工作区临时更换背景的人，DSH 的插件机制提供了一种扩展方式。dsh-bgwall-plugin 用于把 Web 界面背景换成任意图片，图片来源可以是远程 URL，也可以是服务器本地文件，并提供透明度、模糊和铺放方式调节。

下面介绍这个插件能做什么、如何安装、如何使用，以及使用时需要注意的事项。

这是什么¶

dsh-bgwall-plugin 是一个 DSH 插件，用于修改 DeepSeek Harness Web 界面背景。它由 hubo980205 维护，许可证为 MIT，实现方式为纯 JavaScript，无构建步骤。

安装启用后，DSH Web 界面的「设置」中会增加「背景图片」页，控制面板就位于：

设置 → 背景图片

这个插件主要解决的是 Web 界面背景不可自定义的问题。你可以使用远程图片 URL，也可以使用服务器上的本地文件路径，并在界面中实时调节显示效果。

核心功能¶

已核实的插件能力包括：

• 背景图片来源：
• 远程图片 URL
• 服务器本地文件路径
• 相对路径基于工作区根目录解析
• 透明度：0–100% 实时调节，图片与原始界面背景色平滑混合，不会出现黑屏
• 模糊：0–40px
• 铺放方式：铺满 / 适应 / 拉伸
• 「侧边栏背景也透明」开关
• 一键「清除背景」
• 本地图片经 Host HTTP 路由同源加载，规避超长 data URL 在 CSS 中失效的问题
• 本地图片单张上限：15MB

安装与启用¶

使用 dsh 插件命令从 GitHub 安装：

dsh plugin --profile web add github:hubo980205/dsh-bgwall-plugin

安装完成后，重启 dsh 的 web profile，并刷新浏览器：

dsh --profile web

这一步是必要的，因为 Host 行与 client 名单在启动时扫描。刷新后，左下角「设置」中会出现「背景图片」页。

如果需要手动安装，可以把本包放入：

$DSH_HOME/profiles/node_modules

然后在该 profile 的 cordis.patch.yml 中追加：

- insert: [{ id: bgwall, name: dsh-bgwall-plugin }]

卸载时使用：

dsh plugin --profile web remove dsh-bgwall-plugin

典型用法¶

安装并重启后，打开左下角「设置」，进入新增的「背景图片」页。

1、使用远程图片 URL¶

在图片来源处粘贴图片 URL，例如：

https://example.com/wallpaper.jpg

然后点「应用」。

2、使用服务器本地文件¶

在图片来源处填写服务器本地路径，例如：

dog.jpg

或：

/root/pic.png

然后点「加载」。

相对路径会基于工作区根目录解析。本地图片通过 Host HTTP 路由同源加载，单张文件上限为 15MB。

3、调节显示效果¶

应用或加载图片后，可以：

• 拖动「透明度」滑杆
• 拖动「模糊」滑杆
• 选择「铺放方式」：铺满 / 适应 / 拉伸
• 打开或关闭「侧边栏背景也透明」

这些调整会在页面中实时预览。

4、还原默认背景¶

如果需要取消当前背景，点「清除背景」即可一键还原。

适用场景与注意¶

这个插件适合以下几类使用场景：

• 使用 DSH Web 界面，希望临时更换背景
• 希望使用远程图片 URL 或服务器本地文件
• 需要调节透明度、模糊和铺放方式
• 不想引入构建步骤，只需要纯 JavaScript 插件

使用前需要注意：

• 插件会在当前 DSH 进程中加载，因此安装前应检查源码与许可证。
• 本插件许可证为 MIT。
• 背景状态为会话内存态，不持久化；页面刷新后背景恢复默认。
• 本地图片单张上限为 15MB。
• 相对路径基于工作区根目录解析。
• 安装或手动安装后，需要重启 dsh --profile web 并刷新浏览器。

链接¶

GitHub 仓库：

https://github.com/hubo980205/dsh-bgwall-plugin

已核实资料中未包含可确认的社区目录页 URL，因此本文不列具体目录页地址。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。