dsh-ui-customizer · 界面定制

DeepSeek Harness Web GUI 的界面定制插件：在官方设置弹窗中新增「背景图」「主题」两个子菜单（点侧边栏「设置」即可看到，紧随「通用设置」之后）。

「背景图」可设置整个 Web 界面的背景——图片或视频均可：网络 URL，或本地上传（图片与视频自动保存到插件目录的 images 文件夹，换浏览器也不丢失），并调节透明度、模糊、暗化等。背景显示在所有内容之下，形成壁纸效果；所有设置自动保存，刷新页面后依然保留。

功能

• 两个子菜单内嵌于官方设置弹窗：「背景图」「主题」紧随「通用设置」之后，随官方弹窗一起打开/关闭，无需独立入口
• 「主题」子菜单：通过颜色选择器定制几乎全部界面元素的颜色（背景/文字/弹窗/按钮/状态/字体等 50 项，分 8 组折叠面板），明暗主题下依然生效；「恢复默认」一键还原全部修改；支持把配置好的主题连同当前背景（图片或视频）一起保存（可保存任意多份），随时应用/删除
• 字体预设：2 个字体 token 共 42 种预设（系统字体 + 主流开源字体），下拉即选；自动检测本机是否已安装对应字体，未安装的标注「未安装」
• 图片/视频背景切换：「背景类型」图片 / 视频二选一；两者都支持 URL 或本地上传，透明度/模糊/暗化滑杆通用
• 视频背景：mp4 / webm / ogv / mov，本地上传上限 100 MB（图片上限 10 MB），静音循环播放、不参与裁剪；预览区点击播放；开关设置弹窗期间播放进度不丢失，关闭后无缝恢复
• 本地上传持久化：选中的本地图片/视频自动保存到插件目录的 images/ 文件夹，换浏览器/清站点数据都不丢失
• 交互式裁剪预览（仅图片）：滚轮或按住中键上下拖动 = 缩放，左键拖动 = 平移；「复位」一键恢复整图；只有预览中框选出来的区域会作为背景
• 最近使用：自动保留最近 10 张用过的背景图片，点击缩略图即可切换（当前使用的高亮，右上角 ✕ 可删除）
• 拉伸方式：铺满（cover，默认）/ 适应（contain）/ 平铺（tile）/ 拉伸（fill）；裁剪生效时平铺回退为铺满
• 模糊（0–24px）与暗化叠加（0–90%）滑杆，让壁纸更柔和或让文字更易读
• 透明度/模糊/暗化滑杆实时生效，调节即时可见
• 性能：打开设置弹窗时背景视频自动暂停、关闭后无缝恢复，弹窗开合流畅不卡顿
• 设置自动保存，刷新页面后保留
• 中英双语

安装

在 dsh 安装目录（能运行 dsh 的地方）执行：

dsh plugin --profile web add <本插件路径>
# 例如：
dsh plugin --profile web add D:\Work\工作目录\dsh-ui-customizer

然后往该 profile 的 cordis.patch.yml 追加激活行（运行中的实例会热监听 此文件，无需重启、刷新页面即生效）：

- insert:
    - id: ui-customizer
      name: '@dsh-external/dsh-client-ui-customizer'

卸载：dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer 并同时删除上面添加的激活行（否则残留行会尝试加载不存在的包）。

说明：本插件不依赖任何 npm 包，安装时不需要网络；link: 方式安装后改动 源码即同步生效，无需重新构建。若机器上没有 pnpm（dsh plugin 依赖它）， 可手工安装：把插件目录 junction 到 $DSH_HOME/profiles/web/node_modules/@dsh-external/dsh-client-ui-customizer， 在 profile 的 package.json 登记依赖，并按上文添加激活行。

卸载

dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer

许可

MIT。