DeepSeek Harness（DSH）采用插件化架构。对于桌面版用户，dsh-theme-button 是一个挂件，允许在保持官方外观设置的同时，为 DSH 界面添加自定义背景。
安装¶
环境要求：DeepSeek Harness 桌面版（Windows），无额外依赖。
安装步骤：
1. 将插件文件夹放置在固定的位置（安装后不要移动）。
2. 执行安装命令：
dsh plugin --profile desktop add link:C:\dsh-plugins\dsh-theme-button
- 必须完全重启 DSH。插件的宿主部分只在启动时加载，刷新页面无效。
安装成功后，重启 DSH 应该在右下角看到挂件图标。访问 http://127.0.0.1:<DSH 端口>/dsh-theme-button/version 也能验证版本号。
核心功能¶
悬浮挂件¶
挂件默认位于右下角，可以拖动到任意位置。位置会自动记忆，重启后保持。轻点图标可打开/关闭设置面板，拖动时面板自动收起。
官方外观¶
面板提供浅色、深色、跟随系统三种模式。选择会同步写入 DSH 的官方外观设置，与官方设置页双向一致。
自定义背景¶
面板提供“自定义背景”总开关。开启后，可选择纯色或图片作为背景。
- 纯色：使用预设色块或取色器自定义。
- 图片：支持上传图片，最多 6 张。点缩略图切换，点 × 删除。
背景参数¶
提供独立调节项，分别作用于纯色和图片：
- 不透明度：0–10，控制背景显示强度（0 为关闭）。
- 模糊：0–24px，控制背景模糊程度。
- 亮度：0–10，5 为 100%。
- 饱和度：0–10，5 为 100%。
适配方式¶
支持四种填充方式：
* 填充（默认）：铺满区域，裁剪超出部分。
* 适应：完整显示整张图，可能留白。
* 平铺：按原尺寸重复。
* 拉伸：拉伸到铺满（会变形）。
视觉效果¶
挂件、面板、取色器均采用半透明毛玻璃效果。关闭自定义背景后，效果消失，恢复 DSH 原生外观。
取色器使用¶
面板内置自绘取色器，支持以下操作：
* 色相调整：拖动中间彩色条的手柄。
* 饱和度与明度：拖动上方方形区域的手柄。
* 手动输入：底部输入框支持 HEX、RGB、HSL 三种格式，回车或点击别处生效。
* 格式切换：点击 ▴ ▾ 按钮在 HEX / RGB / HSL 之间切换。
注意事项¶
- 平台限制：仅支持 Windows 桌面版 DSH。
- 图片数量：图片上传上限为 6 张。
- 浮层遮挡：取色器与面板绘制在独立浮层，当 DSH 原生菜单或对话框打开时，可能会被遮挡。
- 更新承诺：功能完整可用，但不承诺持续更新。
卸载¶
如需卸载，执行：
dsh plugin --profile desktop remove dsh-theme-button
再次重启 DSH。
