前言¶
DSH（DeepSeek Harness）支持通过插件扩展功能，其中个性化类插件用于调整界面样式。在早期版本中，更换背景通常需要手动修改宿主代码或依赖外部主题方案，操作繁琐且难以统一管理。dsh-bg-panel 针对这一需求，在 DSH 侧提供了一套面板化的背景自定义能力，允许直接在 Web 界面中导入并应用图片、GIF 与视频作为背景，同时支持裁剪、位置与缩放调整，以及历史记录回溯。
是什么¶
dsh-bg-panel 是一个 DSH 个性化插件，由维护者 theroi 开发。它通过 dsh.bundle.patch 形式挂载到宿主，并在浏览器端声明 dsh.client。插件在侧边栏提供「个性化」入口，点击后可进入「自定义背景」面板。其核心价值在于将背景配置与宿主分离，通过独立面板管理背景素材、裁剪与参数，避免修改宿主代码。
核心功能¶
- 导入素材：支持点击或拖拽导入图片 / GIF / 视频，导入后先展示待应用预览，确认无误后再点「应用为背景」。
- 分层预览：底层按 contain 完整显示图片，亮框标出屏幕实际可见区域，框外压暗提示会被裁掉；框内可直接拖动调整位置，节流写回配置，背景层实时同步。
- 裁剪能力：进入裁剪器后可选择比例（16:9 / 21:9 / 4:3 / 3:2 / 1:1 / 原图比例）、拖动选位、滚轮或滑杆缩放 1–4×；确认后裁出的结果存入历史并成为待应用项。
- 历史背景：以网格图库展示，缩略图按原比例显示，视频带有角标；点选可预览，右上角 × 可删除。
- 参数调整：铺满方式（cover / contain / repeat）、缩放 1–4×、暗化 0–80%、模糊 0–20px、面板半透明（实验性）。
- 清除与刷新：「清除背景」可还原皮肤原背景；「刷新」可重新拉取文件列表。
安装与启用¶
从 GitHub 安装：
dsh plugin --profile desktop add github:theroi/dsh-bg-panel
安装后需要重启 DSH，侧边栏会新增「个性化」入口。
典型用法¶
- 打开「个性化」面板，点击「背景」进入自定义背景面板。
- 拖入一张图片，在预览框中调整位置与缩放，确认后点击「应用为背景」。
- 如需裁剪，点击「裁剪 / 拖动位置」，选择比例后拖动图片，确认后裁剪结果自动存入历史。
- 在历史图库中点选某项作为当前背景，或删除不再需要的素材。
适用场景与注意¶
本插件以当前 dsh 进程权限运行，安装前建议查看源码与许可证（MIT）。数据默认存放在 ~/.dsh/bg-panel/，其中包含配置文件与历史素材目录。卸载后该目录会保留，如需清理需手动删除。插件已知限制包括：面板文案为中文硬编码、GIF 帧率上限滑块暂未生效、路由未走宿主鉴权栅栏等。在排障时，可通过路由返回 401/404/405 区分宿主路由是否正确注册。
短结尾¶
dsh-bg-panel 提供了在 DSH 中直接调整背景的可行路径，通过面板化操作与所见即所得的预览，降低了主题与背景的维护成本。如需了解目录页与源码，可访问 https://github.com/theroi/dsh-bg-panel。
