前言¶
DeepSeek Harness Web 提供了换肤功能，但在刷新页面或跟随系统设置时，常出现短暂的白屏闪烁，且官方主题定制能力有限。dsh-client-ui-theme-manager 作为一个客户端插件，通过持久化样式注入和本地存储，提供了可视化的主题管理方案，支持零闪烁换肤、背景图配置以及主题的导入导出。
插件简介¶
该插件由 thooy 维护，采用 MIT 许可证。它通过 cordis.patch.yml 注册客户端入口，向官方主题服务注册自定义主题，并在设置面板中添加了“Dream Skin 换肤”选项。所有主题数据存储在浏览器本地，无需重启 dsh 即可生效。
核心功能¶
该插件提供以下功能：
* 内置主题：提供 10 套预设主题，包括财神金、深空红、米金白、极夜蓝、青竹绿、樱花粉、薄荷苏打、紫晶、柠檬汽水和石墨灰。
* 主题管理：支持创建新主题（命名、深浅外观、配色）、导入主题（支持 .zip 格式或 theme.json 文件）、导出当前主题。
* 背景图配置：可为主题配置背景图（自动压缩至 1600px 以下）、设置文字遮罩（安全区），无图时自动生成渐变背景。
* 官方换肤控制：支持暂停/继续换肤（保留记忆）以及还原官方外观。
* 零闪烁：刷新或重开页面后，主题即时生效，全程不出现官方浅色。
* 轻量体检：提供状态条提示，用于检测背景挂载类名是否失效（例如 dsh 升级后可能出现）。
* 持久化存储：主题和背景图数据保存在浏览器的 localStorage 中。
安装与启用¶
安装有两种方式，二选一即可。混用会导致重复入口。
方式 A：原生插件安装¶
通过 dsh 插件管理命令安装。这种方式加载瞬间可能会闪一下官方浅色（约 0-8ms）。
dsh plugin --profile web add dsh-client-ui-theme-manager
安装完成后重启 dsh web 并刷新页面。
方式 B：一键安装（推荐）¶
下载最新版 zip 包，运行安装脚本。这种方式包含零闪烁的首帧引导样式。
- 从 Release 页面下载最新版压缩包（如
dsh-client-ui-theme-manager-1.4.0.zip），解压到任意目录。 - 在该目录下运行 PowerShell 脚本：
powershell -ExecutionPolicy RemoteSigned -File .\install.ps1
- 重启 dsh web 进程，并在浏览器中执行 Ctrl+F5 硬刷新。
卸载¶
若要卸载，先根据安装方式执行对应命令：
# 方式 A
dsh plugin --profile web rm dsh-client-ui-theme-manager
# 方式 B
powershell -ExecutionPolicy RemoteSigned -File .\install.ps1 -Uninstall
重启 dsh web 并刷新页面。
使用说明¶
打开 设置 → 找到 Dream Skin 换肤。
* 换肤：点击内置的主题卡片即可切换。
* 导入：点击导入按钮，选择本地的 .zip 压缩包或 theme.json 文件，插件会自动解析并应用。
* 导出：点击导出按钮，可下载当前的 theme.json 配置文件（若包含背景图，会一并打包）。
注意事项¶
- 安装冲突：两种安装方式不可混用，若已安装 A 请先卸载再安装 B。
- 数据丢失：主题和背景图存储在浏览器 localStorage 中，更换浏览器、清除缓存或换设备会导致数据丢失，建议定期使用“导出主题”进行备份。
- 版本兼容：升级 DeepSeek Harness 后，可能需要重新运行一次
install.ps1以更新前端入口的引导样式和插件副本。
