# 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` 的地方）执行：

```sh
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`），安装后自动进入 profile 的
bundle 列表并激活 **ui-customizer** 条目，无需手动修改
`$DSH_HOME/profiles/web/cordis.patch.yml`；重启 DSH Web 后生效。

> **卸载**：`dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer`
> 并重新构建 profile（`dsh plugin --profile web add` 任意已安装包触发 reconcile），
> 插件条目会随依赖移除自动从 bundles 列表删除。

> 说明：本插件不依赖任何 npm 包，安装时不需要网络；`link:` 方式安装后改动
> 源码即同步生效，无需重新构建。若机器上没有 pnpm（`dsh plugin` 依赖它），
> 可手工安装：把插件目录 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`（激活行随插件自带）。

## 卸载

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

## 许可

MIT。