前言¶
DeepSeek Harness（DSH）默认的聊天界面以简洁见长，但长期使用后，界面样式容易显得单调。对于偏好个性化、希望“让聊天窗口更像壁纸”的开发者来说，原生界面缺乏可配置的背景能力。DSH 的“一切皆插件”理念，让这类体验增强需求可以由社区插件实现，而不需要修改 DSH 源码。
是什么¶
dsh-bg-plugin 是一个为 dsh web 提供持久化全窗口背景的插件。维护者为 huangfuren，分类为“趣味换装”。它通过宿主端（Node 半）与客户端（Web 半）两部分的协作，让用户在设置面板上传图片，并实时调整面板实底、透明度、亮度、黑色遮罩、高斯模糊、位置（9 宫格）与填充方式（cover / contain / stretch），所有配置与图片以原始字节存盘，重启不丢失。
核心功能¶
- 全窗口背景图：覆盖聊天界面，作为底层视觉元素。
- 支持的格式与大小：PNG / JPEG / GIF / WebP，文件大小 ≤ 16MB。服务端按字节签名判定格式，并自动嗅探像素宽高。
- 实时预览与调节：
- 面板实底：控制聊天区域背景不透明度。
- 透明度、亮度、黑色遮罩、高斯模糊（SVG 滤镜）。
- 位置：9 宫格对齐方式。
- 填充方式：cover（裁剪）、contain（完整显示）、stretch（拉伸铺满）。
- 默认观感：壁纸当底纹、内容坐实底（模糊 6 / 遮罩 12 / 面板实底 70），保证文字对比度不随壁纸明暗漂移；支持一键“恢复推荐观感”，也可将面板实底拖到 0 回到壁纸铺满。
- 持久化存储：配置与图片以原始字节存盘（默认
$DSH_HOME/background），重启不丢失。1.0.1 及更早的 JSON 格式文件会在第一次被访问时自动迁移成原图并删除，无需手动处理。 - 优雅关闭：关闭开关即回到原生界面，不修改 DSH 源码。
- 孤儿回收：启动时清掉没有配置引用的残留文件（仅清理落盘超过 1 小时的文件），避免误删正在上传的图片。
安装与启用¶
本插件为单包，同时包含宿主端与客户端半。安装命令如下：
# 网页版 CLI（profile 换成 desktop 即为桌面版）
dsh plugin --profile desktop add link:/absolute/path/to/dsh-bg-plugin
# 或直接从 GitHub
dsh plugin --profile desktop add github:huangfuren/dsh-bg-plugin
# 本地开发时记得加 --ignore-scripts（沙箱会拦原生依赖的构建脚本）
不使用安装器时，可将仓库目录链接进 profile 的 node_modules，并在 cordis.patch.yml 中登记加载项：
# cordis.patch.yml
- insert:
- id: bg
name: 'dsh-bg-plugin'
1.2.0 版本起合并为单包，此前为 @deepseek-ai/dsh-bg + @deepseek-ai/dsh-client-bg 两个包，已装旧版者移除后按上面命令装一次即可；配置与图片在 $DSH_HOME/background，不受影响。
启用后，进入设置 → 通用设置 → 外观，即可在背景相关调节块中进行上传、预览与参数调整。
典型用法¶
- 使用 CLI 安装插件：
dsh plugin --profile desktop add github:huangfuren/dsh-bg-plugin
- 打开
dsh web，进入设置 → 通用设置 → 外观。 - 在背景设置中上传一张图片（PNG / JPEG / GIF / WebP，≤ 16MB）。
- 在面板实底、透明度、亮度、遮罩、模糊、位置与填充方式之间调整，观察实时预览。
- 关闭开关即可回到原生界面。
适用场景与注意¶
- 适合希望在
dsh web中拥有更个性化视觉体验的开发者。 - 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
- 图片以原始字节存盘，清空浏览器数据或重装 DSH 不会丢失（前提是宿主端配置与图片目录未被清理）。
短结尾¶
dsh-bg-plugin 通过宿主端与客户端的协作，提供了从上传、预览到持久化存储的一整套背景定制能力，无需修改 DSH 源码即可改变界面观感。目录页：https://www.skillhub.cn/plugins/huangfuren/dsh-bg-plugin；GitHub：https://github.com/huangfuren/dsh-bg-plugin
