前言¶
用 DSH 的人，大部分时间停留在 Web GUI 上。官方界面的样式是固定的，想给整个页面换一张背景图，或者把配色调成自己喜欢的样子，并没有现成入口。qe2592008/dsh-ui-customizer 解决的就是这个问题：它在官方设置弹窗里新增「背景图」「主题」两个子菜单，支持图片/视频壁纸与全界面颜色定制。下面介绍它的功能、安装与卸载方式，内容以插件 README 和 package.json 为准。
这是什么¶
dsh-ui-customizer（GitHub 仓库 qe2592008/dsh-ui-customizer，npm 包名 @dsh-external/dsh-client-ui-customizer，版本 0.1.0）是 DeepSeek Harness Web GUI 的界面定制插件，MIT 许可，维护者为 qe2592008。
它的做法不是另起一个独立界面，而是把「背景图」「主题」两个子菜单内嵌进官方设置弹窗，位置紧随「通用设置」之后，随官方弹窗一起打开/关闭。点侧边栏「设置」即可看到。
核心功能¶
背景图：整个 Web 界面的壁纸¶
「背景图」子菜单把背景铺在所有内容之下，形成壁纸效果：
1、「背景类型」图片/视频二选一，均支持网络 URL 或本地上传。
2、本地上传的文件自动保存到插件目录的 images/ 文件夹，换浏览器、清站点数据都不丢失。上传上限：视频 100 MB，图片 10 MB。
3、视频支持 mp4 / webm / ogv / mov，静音循环播放、不参与裁剪；预览区点击播放，设置弹窗开合期间播放进度不丢失。
4、透明度/模糊/暗化三个滑杆对图片和视频通用，实时生效；模糊范围 0–24px，暗化叠加 0–90%。
图片背景另有几项细化能力：
- 交互式裁剪预览：滚轮或按住中键上下拖动缩放，左键拖动平移，只有预览中框选出来的区域会作为背景，「复位」一键恢复整图。
- 拉伸方式四种：铺满（cover，默认）/ 适应（contain）/ 平铺 / 拉伸（fill）；裁剪生效时平铺回退为铺满。
- 最近使用：自动保留最近 10 张用过的背景图片，点缩略图即可切换，右上角 ✕ 可删除。
主题：50 项界面颜色定制¶
「主题」子菜单通过颜色选择器定制界面元素的颜色，共 50 项，覆盖背景、文字、弹窗、按钮、状态、字体等，分 8 组折叠面板，明暗主题下都生效。「恢复默认」可一键还原全部修改。
配好的主题可保存任意多份，保存时可以连同当前背景（图片或视频）一起，之后随时应用或删除。
字体预设¶
字体方面提供 2 个字体 token 共 42 种预设（系统字体 + 主流开源字体），下拉即选。插件会自动检测本机是否安装了对应字体，未安装的会标注「未安装」。
通用行为¶
所有设置自动保存，刷新页面后依然保留；界面中英双语。性能上，打开设置弹窗时背景视频自动暂停，关闭后无缝恢复，弹窗开合不受影响。
安装与启用¶
在 dsh 安装目录（能运行 dsh 的地方）执行：
dsh plugin --profile web add github:qe2592008/dsh-ui-customizer
开发场景可以用本地路径 link 方式安装，改源码即时生效：
dsh plugin --profile web add D:\Work\工作目录\dsh-ui-customizer
插件自带 dsh.bundle 激活层（cordis.patch.yml），安装后会自动激活 ui-customizer 条目，不需要手动修改 $DSH_HOME/profiles/web/cordis.patch.yml。经过上面的步骤，重启 DSH Web 后生效，点侧边栏「设置」即可看到「背景图」「主题」两个子菜单。
两点补充说明：
1、本插件不依赖任何 npm 包，安装时不需要网络。
2、dsh plugin 依赖 pnpm。若机器上没有，可按 README 给出的手工方式安装：把插件目录 junction 到 $DSH_HOME/profiles/web/node_modules/@dsh-external/dsh-client-ui-customizer，在 profile 的 package.json 登记依赖，并在 dsh.profile.bundles 中加入 @dsh-external/dsh-client-ui-customizer。
卸载¶
先执行：
dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer
然后重新构建 profile：再次执行 dsh plugin --profile web add（对任意已安装包），触发 reconcile，插件条目会随依赖移除自动从 bundles 列表删除。
适用场景与注意¶
这个插件不改变 DSH 的功能行为，只作用于 Web 界面观感，在社区目录中归为「趣味换装」，适合想长时间盯着一个顺眼界面的开发者。
使用前注意：
1、插件以当前 dsh 进程的权限运行，安装第三方插件前应先阅读源码、确认许可证。本插件为 MIT，README 与 package.json 的 license 字段一致。
2、本地上传有大小上限（视频 100 MB、图片 10 MB）；视频不参与裁剪，需要精确取景时用图片。
3、裁剪生效时，平铺拉伸方式会回退为铺满。
结尾¶
dsh-ui-customizer 把「换壁纸、调配色」这类观感需求做成了官方设置弹窗里的两个子菜单：设置自动保存、本地上传持久化、安装后自动激活，装完即用。项目地址：
- GitHub：https://github.com/qe2592008/dsh-ui-customizer
- 社区插件目录：https://www.skillhub.cn/plugins/qe2592008/dsh-ui-customizer
其中目录为独立社区站点，与 DeepSeek、幻方无官方从属关系。
