前言¶
DeepSeek Harness（DSH）桌面版每次启动会换本地端口，页面 origin 随之变化，localStorage 与 IndexedDB 无法长期保存外观偏好。若只在浏览器里改 CSS 或临时换肤，重启后往往回到默认界面。社区插件 dsh-background-studio（维护者 SoulZhou，分类：趣味换装）在宿主侧持久化设置，并在设置里注册独立「背景」页，不替换原生设置、不改动 DSH 组件，只通过 html 上的 data-dsh-qbg* 属性与少量主题 token 覆盖实现多风格背景。
这是什么¶
dsh-background-studio 是面向 DeepSeek Harness 的多风格背景插件：提供 6 套可切换配色、本地自定义图片或任意纯色，可调背景不透明度与「面板透出」，并随 DSH 浅色 / 深色主题自动切换各套背景的深浅版本。源码与说明见 GitHub：SoulZhou/dsh-background-studio；社区目录页：SkillHub - dsh-background-studio。当前 package 版本为 0.3.2，许可证 MIT，依赖 Node >=20。
核心功能¶
六套内置背景¶
六套风格分别为：曜石、极光、星云、蓝图、燕麦、樱雾。每套都有深色与浅色两版，随 DSH 外观模式切换。背景层由渐变光晕、网格、噪点与缓慢漂移组成；用户开启 prefers-reduced-motion 时动画会停止。
自定义背景图¶
可在设置页选择或拖入本地图片，支持铺满、适应、平铺；可随时停用图片但保留文件。单张上传上限 24 MB，类型按文件头嗅探，仅接受 JPEG / PNG / WebP / GIF。超过 2560px 或 1.2 MB 时会在浏览器内先压缩为 WebP（失败则回落 JPEG），再写入宿主磁盘；图片只留在本机，不上传网络。
纯色背景¶
提供取色器、HEX 输入与 8 个快捷色。开启后会盖住风格背景与自定义图，关闭即恢复。若重新选择任一风格或启用图片，会自动退出纯色模式。
不透明度与光晕¶
「光晕强度」可选轻 / 标准 / 浓。「背景不透明度」为 0–100% 滑块：100% 时背景完全可见，调低逐渐淡出，0% 回到 DSH 原生外观；设置页顶部预览会同步变化。从 0.2.0 升级需注意：旧字段「背景透明度」语义相反（100% 表示完全隐去）；0.2.1 起改为「背景不透明度」，旧配置里的 transparency 读取时会视为 opacity: 100，升级后背景会先完全显示。
面板透出与浮层¶
开启「面板透出」时，侧栏、主画布与 Windows 标题栏会透出背景：侧栏不再叠半透明主题色，也没有毛玻璃模糊。关闭后恢复实色面板。开启透出时，菜单、下拉、提示气泡等浮层改用不透明主题面板色（浅色 #fff / 深色 #2c2c2e），并关闭毛玻璃，避免壁纸混进浮层导致文字对比度不足。0.3.1 起将透明表面变量从 body 收窄到 #root，并给浮层不透明底色；0.3.2 锁定原生 <select> / <option> 的 color-scheme 与文字色，避免深色主题下出现白底近白字、选项不可见的问题。
设置存储位置¶
桌面版端口变化导致页面侧存储不可靠，因此配置与图片均放在宿主目录：
~/.dsh/background-studio/
settings.json 主题、纯色、不透明度、面板透出、填充方式等
image.json 图片元数据（名称、尺寸、类型、版本号）
background.<ext> 图片本体
页面启动时先读本地镜像立即上色，再向 /dsh-background-studio/api/state 拉取权威值并覆盖。
安装与启用¶
在 PowerShell 中执行（命令来自项目 README）：
dsh plugin --profile desktop add github:SoulZhou/dsh-background-studio
该命令会把包写入 profile 的 dependencies，并因声明了 dsh.bundle.patch 而写入 dsh.profile.bundles。安装后需要完全退出并重新打开 DeepSeek Harness：桌面 profile 由 Electron 管理，运行中的窗口不会热加载新 bundle，宿主 API 路由也要随进程重启才注册。重启后打开 设置 → 背景。
从其他机器安装可先打包再添加：
pnpm pack
dsh plugin --profile desktop add .\dsh-background-studio-0.3.2.tgz
本地开发可链接源码目录（示例路径以 README 为准）：
dsh plugin --profile desktop add "D:\Documents\deepseek-harness\default-workspace\dsh-background-studio"
卸载：
dsh plugin --profile desktop remove dsh-background-studio
卸载后 ~/.dsh/background-studio/ 仍会保留，可手动删除。
典型用法¶
- 按上文命令安装并重启 DSH，进入 设置 → 背景。
- 在六套风格中选一套，按需调整光晕强度与背景不透明度滑块，观察页顶预览。
- 需要壁纸时拖入或选择本地图片，设置铺满 / 适应 / 平铺；暂不用时可停用图片而不删文件。
- 需要统一色块时开启纯色模式；若要恢复渐变或图片，选风格或重新启用图片即可。
- 若希望侧栏与主区域看到底图，开启「面板透出」；若浮层可读性有问题，可关闭透出或依赖插件对菜单表面的不透明处理（见 README 版本说明）。
宿主侧提供三条同源 API（供界面读写，一般无需手调）：GET /dsh-background-studio/api/state、PUT /dsh-background-studio/api/settings、GET/POST/DELETE /dsh-background-studio/api/image。
适用场景与注意¶
适合长期在 DSH 桌面版工作、希望界面有辨识度又不改核心 UI 结构的开发者。插件在当前 DSH 进程权限下运行，会读写 ~/.dsh/background-studio/ 并在本地 Web 服务注册路由；安装前应阅读 源码仓库 与 MIT 许可证，自行评估是否满足环境要求。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的趣味换装类插件，并非官方应用商店内置项。
结尾¶
dsh-background-studio 把多套渐变背景、本地壁纸、纯色与不透明度收敛到单独设置页，并把持久化放在宿主目录，规避桌面版 origin 变化带来的配置丢失。需要细节与截图时可查阅 GitHub README 与 SkillHub 目录页。
