前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在 dsh web 中做界面定制时，常见的问题是：背景太明显会影响阅读，面板太透明又会让界面不够清晰。HaoyueQin/deepseek-harness-background 针对这个场景，为 DeepSeek Harness Web GUI（dsh web）提供自定义背景图片：可以上传本地图片，也可以粘贴图片 URL，并调节不透明度、可读性遮罩、面板透明度和毛玻璃模糊。

社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍该插件的定位、能力、用法和注意事项。

这是什么¶

• 插件：HaoyueQin/deepseek-harness-background
• 维护者：HaoyueQin
• 目标界面：DeepSeek Harness Web GUI（dsh web）
• 许可证：MIT
• 仓库：https://github.com/HaoyueQin/deepseek-harness-background

它把自定义背景渲染在应用表面后方，并在设置面板内提供实时预览。本地图片会存储在 harness home 下，并通过同源路由提供；远程图片支持 http(s) 链接。

核心功能¶

图片来源¶

支持两类来源：

1、上传本地 JPG / PNG / WebP / GIF 图片。
2、粘贴 http(s) 图片链接。

本地上传只有在声明 MIME、检测签名和扩展名一致时才接受。

预览与提交¶

• 在设置面板内实时预览图片、遮罩和毛玻璃效果。
• 比例滑块按 5% 步进。
• 模糊半径按 1/2px 步进。
• 拖拽滑块时仅重绘，松手后提交。

五项控制¶

插件提供以下控制：

1、背景不透明度
2、可读性遮罩
3、面板不透明度
4、毛玻璃模糊
5、背景模糊

适配模式支持：

cover
contain

其中 cover 是填充裁剪，contain 是完整显示。

遮罩¶

插件根据明暗主题自动使用白色或黑色遮罩。

毛玻璃¶

插件对指定表面启用毛玻璃效果，并保留阅读表面的官方不透明绘制。

如果需要恢复白名单表面的官方不透明绘制，可以将 panelOpacity 设为 100%：

panelOpacity = 100%

第三方玻璃注册¶

插件提供第三方玻璃注册接口：

window.__DSH_BACKGROUND_GLASS__

以及事件：

dsh-background-glass:ready

第三方插件可以注册自己的玻璃面板。当该插件缺失时，这一注册接口会优雅降级。

会话时间线增强¶

插件为 dsh ≥ 0.1.2 提供会话时间线增强，例如已加载节点平滑滚动。该行为通过能力检查而非版本比较来限定。

依赖声明¶

package.json 中声明的 peerDependencies 包括：

@deepseek-ai/cordis ^4.0.1
react ^18.2.0

以及特定 @deepseek-ai/dsh-client-* 版本范围。

安装与启用¶

已核实资料中没有给出官方安装命令，因此这里不提供 dsh plugin add ... 形式的命令，也不根据仓库名拼接安装命令。启用前请以仓库文档或插件目录中的说明为准。

插件会以当前 dsh 进程权限运行。安装前建议检查源码、许可证和依赖范围。该插件许可证为 MIT。

典型用法¶

资料中给出的用法如下：

1、在设置面板上传本地 JPG / PNG / WebP / GIF 图片。
2、粘贴 http(s) 图片链接并按 Enter。
3、拖拽滑块实时预览，松手后自动提交。
4、选择 cover（填充裁剪）或 contain（完整显示）适配模式。
5、将 panelOpacity 设为 100%，以恢复白名单表面的官方不透明绘制。
6、通过 window.__DSH_BACKGROUND_GLASS__ 和 dsh-background-glass:ready 事件注册第三方玻璃面板。

适用场景与注意¶

适合：

• 想给 dsh web 添加自定义背景，同时保持文字可读性的用户。
• 需要调节背景、遮罩、面板透明度和模糊效果的开发者。
• 需要把自定义面板接入统一玻璃效果的第三方插件作者。
• 在 dsh ≥ 0.1.2 会话时间线上希望获得已加载节点平滑滚动的用户。

注意：

• 本地上传仅在声明 MIME、检测签名和扩展名一致时接受。
• 上传图片会存储在 harness home 下，并通过同源路由提供。
• 插件会以当前 dsh 进程权限运行；安装前应检查源码与许可证。
• panelOpacity 设为 100% 会恢复白名单表面的官方不透明绘制。
• 第三方玻璃注册接口在插件缺失时会优雅降级。
• 会话时间线增强面向 dsh ≥ 0.1.2，并通过能力检查而非版本比较限定行为。
• 本文不给出未核实的安装命令；星标数和目录页内容未在本次抓取资料中核实。

链接¶

• GitHub：https://github.com/HaoyueQin/deepseek-harness-background
• 插件目录页线索：https://www.skillhub.cn/plugins/HaoyueQin/deepseek-harness-background（该 URL 来自插件线索，未在本次抓取资料中核实）