用图片替换 DeepSeek Harness 的纯色背景

前言¶

DeepSeek Harness（DSH）默认使用纯色背景，在长时间对话或调试智能体时容易显得单调。如果你希望把界面换成自己偏好的图片，同时又不想离开当前页面，可以借助第三方插件。下面介绍的就是这样一个插件：它会在界面右侧边缘放一个低调的圆形按钮，点击后可以从本地任意文件夹导入图片，并在不离开当前页面的情况下调整铺满方式、模糊、遮罩和界面不透明度。

是什么¶

dsh-background-studio 是一个 DeepSeek Harness（DSH）插件，由维护者 wenhaolin-svg 开发。它的核心功能是用你自己的图片替换 DSH 的纯色背景，并提供一套简单的编辑器，让你调整图片与界面的关系，设置会自动保存。

功能¶

本地图片替换纯色背景：支持 JPG、PNG、WebP、GIF、AVIF，单张图片最大 25 MB。
从任意文件夹导入：点击按钮打开系统文件选择器，或者直接把图片拖进预览区域。
可拖动的小面板与按钮：按住标题栏移动面板，双击标题栏回到中间；右侧圆形按钮也可以拖动。两者都被限制在窗口内，不会拖出屏幕。
实时编辑：
铺满 / 完整 / 拉伸 / 平铺
图片可见度（10% 接近隐藏，100% 完全显示）
背景模糊（0–24px）
背景遮罩（亮色主题压白、暗色主题压暗）
界面不透明度（让文字更清晰，或让图片更明显）
自动保存：修改后约 0.45 秒写入磁盘；关闭面板或重启 DSH 后仍然有效。
跟随主题：亮色 / 暗色主题分别使用不同的表面透明度和遮罩颜色。
随时暂停：关闭“启用背景”开关即可暂时恢复原生纯色界面，图片和设置都保留。
一键移除：删除图片并把界面恢复到原生状态。
中英双语界面：跟随 DSH 的界面语言。

安装与启用¶

方式一：从 GitHub 安装（发布之后）¶

打开 DSH 左侧栏的 插件 / Plugins。
点击 添加插件 或右上角的 +。
选择 安装第三方插件。
在包名输入框中粘贴你的仓库地址，例如：

https://github.com/你的GitHub用户名/dsh-background-studio

点击安装，等待完成。
安装完成后，在插件列表里找到 dsh-background-studio 并打开开关。
刷新 DSH 页面（或重启 DSH）。界面右侧中部出现圆形图片按钮即安装成功。

包名现在是 dsh-background-studio。GitHub 仓库建议同名；如果你保留旧仓库名 dsh-background，安装 URL 用旧地址也可以，DSH 会以仓库里的 package.json 为准。仓库根目录必须直接包含 package.json，不要放进 packages/dsh-background-studio/ 之类的子目录。

从 1.0.x 升级：先在插件页卸载旧的 dsh-background，再安装新的 dsh-background-studio。图片和设置仍在 %USERPROFILE%\.dsh\dsh-background\，不会被删除。

方式二：从本地文件夹安装（开发 / 试用）¶

在 DSH 插件页选择 安装第三方插件，粘贴本文件夹的绝对路径：

D:\dsh\插件

安装并启用后刷新页面。

本地目录安装通常以链接方式接入。之后修改 client.js 或 index.js，在插件页关闭再打开该插件、或重启 DSH，即可加载新代码。正式发布前建议再从 GitHub 安装一次，确认打包后的文件完整。

方式三：命令行（可选）¶

如果你已经把 dsh 命令加入 PATH：

dsh plugin --profile desktop add "D:\dsh\插件"

这条命令只负责把包加入 profile；启用组合包仍建议在 DSH 的插件页操作。

典型用法¶

点击界面右侧边缘中部的圆形图片按钮（鼠标移上去会变清晰）。这个按钮本身也可以按住拖动；不移动直接松开就是打开面板。
如果面板挡住对话栏，按住面板顶部的标题栏拖动；双击标题栏可以回到屏幕中间。面板外的区域仍然可以正常点击。面板和按钮都只能在窗口内移动，四周会留出边距。
点击 选择图片，在系统文件选择器中进入任意文件夹，选中一张图片。
- 也可以直接把图片拖到预览区域。
用下面的控件调整效果，背景会立即变化：
- 铺满方式：铺满 会裁切图片填满窗口；完整 会保留整张图并留边；拉伸 会把图片拉到窗口比例；平铺 会重复图片。
- 图片可见度：10% 接近隐藏，100% 完全显示。
- 背景模糊：0–24px。
- 背景遮罩：在图片上叠加一层与主题匹配的纯色，提升文字对比度。
- 界面不透明度：控制聊天区、侧栏等界面表面的透明度。调高更容易读字，调低更容易看清图片。
点击完成。所有修改已经自动保存。

关闭、恢复与移除¶

关闭面板：点右上角 ×、按 Esc，或点完成。面板外的区域可以直接操作，所以点击外面不会自动关闭。
启用背景 开关：暂时关闭背景，图片和设置都保留。
恢复默认：把铺满方式、可见度、模糊、遮罩、界面不透明度恢复为默认值，但保留图片。
移除图片：第一次点击会变成“再次点击确认”，再点一次才真正删除图片并恢复原生界面。

图片与隐私¶

图片只保存在这台电脑上，不会上传到任何服务器，也不会写进对话记录。
数据目录：

%USERPROFILE%\.dsh\dsh-background\

其中：
- settings.json：显示设置和图片元信息；
- background-*.jpg|png|webp|gif|avif：当前图片。

卸载插件不会自动删除这个目录；如果确认不再使用，可以手动删除 %USERPROFILE%\.dsh\dsh-background。
大于 8 MB 或最长边超过 4096px 的静态图片会在浏览器里缩放、转成 WebP 再保存，以减少磁盘和内存占用。GIF / AVIF 不转码，以保留动画。
不支持 SVG（避免外部资源与脚本风险）。

适用场景与注意¶

适合希望在 DSH 界面中使用自定义壁纸，同时保持对话区可读性的开发者。
插件运行时不修改 DSH 安装目录，也不改写 profile 的 package.json；所有用户数据都在 $DSH_HOME 下。
插件以当前 DSH 进程的权限运行，安装前建议查看源码与许可证。

结尾¶

dsh-background-studio 让你用本地图片替换 DSH 的纯色背景，并提供一套可拖动的小面板，方便实时调整铺满、模糊、遮罩与界面不透明度，所有设置自动保存。如需更多信息，可访问插件目录页或 GitHub 仓库。

目录页：https://www.skillhub.cn/plugins/wenhaolin-svg/dsh-background
GitHub：https://github.com/wenhaolin-svg/dsh-background