前言¶
在 DSH 的日常使用里，WebUI 与 DSH Desktop 默认提供的是同一套界面。如果你希望聊天区、设置面板、输入框、代码块换成自己的颜色，或者想加入壁纸、视频背景、毛玻璃和背景遮罩，这类外观调整通常由插件完成。
dsh-ui-appearance 是 TQSY114514 维护的 DeepSeek Harness 外观自定义插件。它提供主题色板、壁纸/视频背景、毛玻璃与背景氛围设置，所有修改实时预览，并自动持久化；WebUI 与 DSH Desktop 均可使用。
核心功能¶
主题颜色¶
dsh-ui-appearance 提供 6 个颜色角色：
- 主色
- 背景色
- 面板色
- 输入框色
- 文字色
- 边框色
每个角色都支持取色器与 HEX 输入。应用预设后，也可以继续对这几个颜色角色单独微调。
壁纸背景¶
壁纸背景支持以下加载方式：
- 上传图片。
- 拖拽图片。
- 粘贴图片 URL 一键加载。
支持的图片格式包括 JPG / PNG / WebP / GIF。壁纸原画质存入 IndexedDB，不占用 localStorage 配额。
图片有 200MB 防呆上限。超过 4096px 的图片会等比缩边，并重新编码为 WebP；未超限的 GIF 保留动画。
视频背景¶
视频背景支持 MP4 / WebM，播放时静音循环，并与图片背景互斥。
视频上限为 50MB。建议使用 H.264 MP4 或 VP8/VP9 WebM。不支持的编码会自动降级回壁纸。
毛玻璃与半透明¶
dsh-ui-appearance 提供以下界面透明度控制：
- 面板不透明度
- 毛玻璃强度
- 输入框不透明度
- 代码块不透明度
输入框与代码块可以独立调节不透明度。面板、输入框和代码块都可以随壁纸背景一起呈现半透明效果。
背景氛围¶
背景氛围提供三个独立滑块：
- 背景不透明度
- 背景模糊
- 背景遮罩
背景不透明度控制壁纸浓淡，背景模糊让壁纸视觉上退到远处，背景遮罩在壁纸上叠加一层辅助阅读的蒙层。
预设与配色分享¶
dsh-ui-appearance 内置 6 套预设：
- 默认
- 午夜
- 海洋
- 森林
- 玫瑰
- 单色
预设可以一键应用，应用后仍可继续微调，不会被预设锁死。
配色分享也通过 JSON 文本完成：
- 在设置面板底部的「配色方案」区块点击「导出配色」。
- 复制 JSON 文本。
- 在其他浏览器或设备上粘贴到「导入」位置。
- 点击「导入」后应用该配色。
实时预览与持久化¶
所有修改实时生效，无需刷新，也无需手动保存。
设置保存在浏览器 localStorage。壁纸与视频原画质存入 IndexedDB，并向浏览器申请持久化存储，降低被清理的概率。
该插件支持 WebUI 与 DSH Desktop。卸载后界面恢复默认。
安装与启用¶
先确认目标 profile。DSH Desktop 默认 profile 为 desktop，Web 版通常为 web。插件需要安装到当前实际运行或激活的 profile。
使用 npm 安装命令：
dsh plugin --profile <name> add dsh-ui-appearance
其中 <name> 是当前使用的 DSH profile 名称。
如果采用源码直装，先克隆仓库：
git clone https://github.com/TQSY114514/dsh-ui-appearance.git
在插件装入当前 profile 的前提下，执行：
pnpm prepare
这会生成 lib/ 产物。之后重启 DSH 服务，例如：
dsh web
项目资料中声明的运行环境为：
Node >=18
pnpm@10.34.5
典型用法¶
- 打开 WebUI，进入侧栏「设置」→「通用」。
- 在「外观」行下方找到「个性化外观」，点击展开。
- 点预设快速换肤。
- 使用取色器或 HEX 输入微调 6 个颜色角色。
- 上传或拖入壁纸/视频，也可以粘贴图片/视频 URL 一键加载。
- 拖动背景氛围与界面滑块，调整不透明度、模糊、遮罩、毛玻璃等效果。
- 如果需要在其他浏览器或设备上恢复这套外观，在设置面板底部的「配色方案」区块点击「导出配色」，复制 JSON 文本，再在目标位置粘贴并点击「导入」。
- DSH Desktop 用户需要把插件装进 Desktop 实际激活的 profile，默认 profile 名为
desktop。
适用场景与注意¶
适合在 WebUI 或 DSH Desktop 中长期使用 DSH，并希望调整界面颜色、背景、毛玻璃和遮罩效果的用户。
使用前需要注意以下几点：
- 设置跟随浏览器。换浏览器或清除站点数据会丢失。
- 壁纸与视频原画质存入 IndexedDB。
- 图片有 200MB 防呆上限；超过 4096px 会等比缩边，并重新编码为 WebP；未超限 GIF 保留动画。
- 视频上限 50MB；建议使用 H.264 MP4 或 VP8/VP9 WebM；不支持的编码会自动降级回壁纸。
- 网络 URL 可能因防盗链或缺少 CORS 跨域头导致加载失败。
- 代码的语法高亮文字色是独立的语法语言配色，不随主色变化。
- 气泡跟随主色，没有独立的气泡颜色设置；主色未设置时保持默认浅蓝白。
- 与第三方插件可能产生视觉竞争；自 v0.1.5 起，壁纸图层沉底至
z-index: -1，用于降低层级遮挡。 - DSH 插件会由当前 dsh 进程加载并运行，安装前请检查源码、依赖与许可证。本插件许可证为 MIT。
结尾¶
dsh-ui-appearance 将 DeepSeek Harness 的外观调整收敛到设置面板中：主题色、壁纸、视频背景、毛玻璃、背景氛围和配色分享都可以直接在界面中调整，修改实时生效，并自动保存。
GitHub 仓库：
https://github.com/TQSY114514/dsh-ui-appearance
DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。本次已核实资料未提供可核实的目录页 URL，目录页请以实际站点展示为准。
