前言¶
在 DeepSeek Harness（DSH）桌面端里长时间写提示、看流式输出，界面往往是纯色底。若希望用本地图片或视频做壁纸，又要调侧边栏和输入区的透明度、避免文字与背景叠在一起，通常只能改客户端样式或找带在线皮肤中心的方案——后者会发起出站请求，对只想本地换肤的开发者并不友好。
下面介绍社区插件 dsh-bg（维护者 sodakitten，分类：趣味换装）。它是上游 beauticode-dsh 的 Fork，保留画面裁切、界面透明度、背景轮播等能力，并去掉在线皮肤中心，全插件不做任何出站网络请求。数据与主题保存在本机，适合在 Windows 官方桌面端配合 DSH 使用。
这是什么¶
dsh-bg 是给 DeepSeek Harness 用的本地背景插件：支持图片 / 视频壁纸、自由裁切构图、界面透明度与浓度调节、背景轮播，以及磨砂边缘缝合、窗口控制区透明等桌面细节优化。
- 当前版本：5.6.14（见仓库
package.json） - 目标环境：Windows 官方桌面端 DSH 0.2.0-rc.2 / Electron 44；README 注明 DSH 0.2.1-alpha.1 尚未完成兼容性验证
- 许可证：MIT；派生自 beauticode-dsh，版权声明与改动说明见仓库
NOTICE - 目录页：skillhub.cn/plugins/sodakitten/dsh-bg
- 源码：github.com/sodakitten/dsh-bg
与上游最主要的区别：不含任何出站网络请求（已删除在线皮肤中心相关代码与路由）。
核心功能¶
去联网¶
上游的在线皮肤中心（gallery.js、gallery-host.mjs、skin-center.json 及 /__beauticode/ui/gallery/* 路由）已移除。安装后换肤、轮播、已保存主题均依赖本地文件与 %LOCALAPPDATA%\beautiCode 下的数据，不访问外网。
画面裁切¶
上游用 object-fit: cover 居中裁切，无法选择保留画面哪一部分。本插件将媒体放大到 cover 尺寸后再做平移与缩放，可构图到 cover 会裁掉的区域。
- 裁切控制在抽屉里，默认收起
- 仅提供滑块缩放（已移除滚轮缩放，避免误触）
- 行上有重置按钮，一键恢复默认并持久化
- 「画窗」等预设下裁切作用于实际显示的那一层背景
界面透明度¶
- 侧边栏跟随内容（默认开）：左栏与右栏共用同一层材质；关闭时别名下移到侧栏列，窗口底衬不受影响
- 工作时浓度（默认 80%，范围 15%–150%）：开始对话后界面变实，可调；新设置与重置为 80%，已有手动保存值保留
- 顶部浓度（默认 130%，范围 50%–150%）：独立滑块，100% 与正文一致；实时保存，可一键恢复默认
- 弹窗浓度固定：对话框不随浓度滑块变化，避免背后正文透出叠字
- 提问框与计划确认框：5.6.14 起通过 DSH 的
data-question-key/data-plan-review-key定位，使用当前主题不透明底色，失焦后也不依赖磨砂维持可读性
输入框磨砂¶
输入框半透明时，滚动聊天记录容易与输入文字叠在一起。插件在输入框背后模糊内容并加薄底；DSH 提问卡片同样覆盖。
磨砂边缘缝合与窗口描边¶
- 默认开启，适用于普通图片、视频及画窗预设；在媒体上方、界面下方模糊可见背景，保留每张图的裁切与缩放
- 背景磨砂为 0 时不生成模糊层；关闭缝合时边缘可能重新变淡
- Windows 11：可通过官方 DWM 接口隐藏 DSH 主窗口原生描边，跟随「磨砂边缘缝合」开关；关闭开关、清除背景、断开最后一个桌面客户端或停用插件时恢复系统默认（已知问题：4K / 200% 缩放下窗口白边尚未完全解决，5.6.14 未加入新的原生边框试验）
窗口控制区透明¶
将网页探针色设为 rgba(255,255,255,0.01)，在 Electron 44 下使右上角最小化 / 最大化 / 关闭区域不再挡壁纸。
背景轮播¶
- 分组：新建、改名、删除；一组即一个轮播列表
- 背景项：从已保存主题与内置预设挑选，可排序、移出；失效项会标注
- 间隔：5 秒至 24 小时；支持顺序或随机（随机不连续同一张）
- 下一张：可手动推进；启用开关后立即应用第一张
- 每张背景各自记住裁切，切换时带着构图切换
内置预设含「雨中百合」「深色百合」等（5.6.10 起与「画窗」一样可直接使用，标记为内置且不可删）。
其它¶
- 会话滚动条自动隐藏：设置 → 背景，默认关；可设 1–30 秒闲置后隐藏（默认 2 秒），带 180ms 淡入淡出
- 面板内 刷新页面 按钮（桌面版无系统刷新入口）
- 兼容文件预览、会话「更多操作」、画窗水纹等；切换背景时保留旧图直至新图解码完成再淡入
- 已移除上游「自动全屏」，保留手动全屏
安装与启用¶
需要 DSH 的 desktop profile。插件以源码形式安装，不是拖进应用目录。
- 通过桌面端菜单 「管理 dsh 命令」 安装 DSH 自带 CLI。
- 首次安装可指定解压目录的绝对路径（示例路径请换成你的实际位置）：
dsh plugin --profile desktop add "file:C:/plugins/dsh-bg"
- 更新时 README 建议用带版本号的 TGZ，避免本地目录被包管理器缓存成旧内容：
dsh plugin --profile desktop add "file:C:/plugins/dsh-bg-5.6.14.tgz"
开发者可在仓库中运行 npm pack 生成 TGZ。通过官方插件管理器安装，不要手工覆盖 profile 的 node_modules、包清单或补丁配置。
装好后在 设置 → 背景 里使用。背景、已保存主题、轮播分组保存在 %LOCALAPPDATA%\beautiCode，与插件代码分离。
改代码后何时生效¶
- 服务端（
index.mjs、ui-host.mjs、carousel.mjs、browser-injection.mjs等）：仅在 DSH 进程启动时加载一次，修改后需完全退出并重启 DSH。 - 客户端脚本（
client.js、console.js、framing.js、atmosphere.js等）：每次请求重读，刷新页面即可。 - 用不同版本号的 TGZ 更新时，运行中的宿主可能仍指向旧安装目录，需完全退出并重启 DSH；只刷新页面不会切换安装目录。
典型用法¶
- 安装插件并重启 DSH（若刚装或改了服务端代码）。
- 打开 设置 → 背景，从内置预设或 已保存的背景 选一张图 / 视频，或添加本地媒体。
- 需要构图时展开 裁切 抽屉，用滑块缩放并拖动画面，满意后状态会持久化；点重置恢复默认。
- 按习惯调节 工作时浓度、顶部浓度、侧边栏跟随内容；打开对话后观察 readability，提问框应保持不透明可读。
- 需要多张轮换：在轮播里建分组，加入已保存主题或内置项，设间隔与顺序 / 随机，打开启用开关即可立即看到第一张。
- Windows 11 若边缘有系统描边感，可尝试 磨砂边缘缝合（并了解 DWM 描边隐藏随开关与插件生命周期恢复默认的行为）。
适用场景与注意¶
适合谁：在 Windows 上使用 DSH 桌面端、希望本地壁纸与界面透明度可控、且不希望换肤插件访问网络的开发者或日常用户。
生态说明：DSH 强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文不以「官方应用商店」口吻描述安装渠道。
安全与权限：插件以当前 DSH 进程权限运行，会通过 Cordis 补丁注入客户端脚本并在 Windows 上可能启动辅助进程处理 DWM 等。安装前应阅读仓库源码、LICENSE 与 NOTICE，确认可接受 Fork 关系与 MIT 条款。
环境限制：README 明确面向 DSH 0.2.0-rc.2 / Electron 44；Node 引擎要求 >=22。其它 DSH 版本或纯网页端部分能力（如 DWM 描边）行为不同，以 README 为准。
结尾¶
dsh-bg 把 DeepSeek Harness 的桌面界面做成可本地配置的壁纸与透明度方案：无出站请求、裁切与轮播可持久化，并针对输入区、提问框和 Windows 窗口边缘做了较多实测向的修补。若你在找 beauticode-dsh 的离线替代，可直接从目录页或 GitHub 查看说明与版本发布。
- 目录页：https://www.skillhub.cn/plugins/sodakitten/dsh-bg
- GitHub：https://github.com/sodakitten/dsh-bg
