前言¶
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
