前言¶
DeepSeek Harness（DSH）的 Web GUI 默认外观固定，想换风格通常只能改系统主题或自己写 CSS，维护成本高，也容易在 DSH 升级后失效。社区插件 dsh-spectra（维护者 zhi-jie2778）专门做界面外观定制：一个总开关、六套内置方案、参数可调，配置可保存与分享。装好后默认不改界面，需要在 设置 → 界面美化 打开总开关后才会生效；关掉总开关会立刻回到原版。
这是什么¶
dsh-spectra 是 DSH 的界面美化插件，分类为「趣味换装」。它只覆盖 CSS 设计令牌并加少量 DOM 属性，不改 DSH 源码、不注入业务逻辑。状态写在 $DSH_HOME/ui-beautify/state.json（Windows 默认 C:\Users\<你>\.dsh\ui-beautify\state.json），浏览器 localStorage 另有一份缓存；升级插件不会动这份数据，上一版会留作 state.bak.json。
六套内置方案与明暗切换¶
README 列出的六套方案如下。
| 方案 | 风格 |
|---|---|
| 苹果玻璃 | 磨砂玻璃，大圆角，柔和阴影 |
| 赛博霓虹 | 深色底，霓虹紫青，发光边框 |
| 糖果极光 | 渐变，光晕，弹性动效 |
| 极简瑞士 | 高对比，细线框，留白多 |
| 暖色纸感 | 低饱和，暖调，护眼 |
| 终端复古 | 荧光绿，等宽字体，CRT 质感 |
浅色与深色各一套，可一键切换；明暗 可跟随 DSH 主题，或强制浅色 / 深色。
可调参数概览¶
下面按 README 归纳的主要能力说明用途，便于对照设置页。
总开关与区域
关掉总开关后样式表与属性一并移除，完全还原。区域 可对侧栏、对话、输入框、浮层、设置页、终端与预览、代码块、细节等八块分别开关。
颜色与材质
浅色与深色各 11 项颜色（主色、辅色、画布、面板等），带取色器和色值输入。材质 含玻璃开关、模糊半径、面板透明度、边框强度、阴影强度。
动效与布局
动效包括悬停、浮层进出场、消息进场、流式文字、输入框聚焦、思考呼吸、页面切换等，逐项 0–100。布局 含圆角倍率、界面密度（等比缩放；密度用 zoom 实现，非整数显示缩放时建议保持 1.00）。
背景与壁纸库
背景支持纯色 / 渐变 / 图片 / 动态流动，另有模糊、压暗、饱和度、流动速度。上传过的图留在壁纸库，点缩略图即换；设置里只存图片编号，地址按当前端口重新生成。分区着色 可在侧栏、对话区、输入框各设一色，其余跟随主题。
方案管理与分享
我的方案 可保存整套设置、命名、切回、删除。分享 支持配置码 UB1.… 复制粘贴，或导出 JSON。快捷键：Ctrl+Alt+B 开关，Shift+Alt+B 循环预设。恢复出厂 回到原版，已保存的自定义方案不受影响。
其它项包括护眼（低蓝光暖色滤镜，可设时段）、智能配色（从壁纸取主色生成配套配色），以及滚动条、光标、选中文字等细节。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。社区目录页：skillhub.cn/plugins/zhi-jie2778/dsh-spectra（独立站点，与 DeepSeek / 幻方无官方从属关系）。
克隆后用 dsh 安装¶
git clone https://github.com/zhi-jie2778/dsh-spectra.git
dsh plugin --profile desktop add link:<克隆目录的绝对路径>
Windows 上可用目录联接，便于日后 git pull 后不必重装：
New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-spectra" `
-Target "<克隆目录的绝对路径>"
手动安装¶
- 把插件目录放到
<DSH_HOME>/profiles/<profile>/node_modules/dsh-spectra（可用目录联接或 symlink）。 - 在
<DSH_HOME>/profiles/<profile>/cordis.patch.yml末尾追加：
- insert:
- id: ui-beautify
name: dsh-spectra
装完必须重启 DSH¶
彻底退出再打开（托盘图标右键 → 退出；只点窗口右上角 × 可能只是隐藏到托盘）。Loader 只在启动时读插件代码，桌面端生产版没有刷新菜单，Ctrl+R 无效。重启后打开 设置 → 界面美化。
升级时在克隆目录执行 git pull，同样彻底退出 DSH 再开；设置仍在 $DSH_HOME/ui-beautify/，升级不会动它。
典型用法¶
- 重启 DSH 后进入 设置 → 界面美化，打开总开关，界面开始应用主题。
- 在六套内置方案中选一种，或用 明暗、区域、颜色 等逐项微调。
- 需要背景时配置 背景 或 壁纸库；若对话区设了底色，壁纸会让位——想要壁纸需把对话区底色点回「跟随主题」（README 已知限制）。
- 满意后可在 我的方案 命名保存，或用 分享 生成配置码 / 导出 JSON 给他人。
- 日常可用
Ctrl+Alt+B快速开关，Shift+Alt+B循环预设。
排查问题时，设置 → 更多 → 诊断 内有重绘压力测试；宿主侧还有 GET /plugins/dsh-spectra/diagnostics，返回版本、状态文件路径和最近请求记录。
兼容性与卸载¶
选择器只用 DSH 暴露的语义锚点（如 [data-conversation-scroll]、[data-composer-seat] 等），不依赖编译后的哈希类名。与其它皮肤插件共存时，令牌声明在 body[data-ub-mode] 上，优先级高于皮肤默认层；想完全交给别的皮肤就关掉本插件。
卸载步骤：
- 设置里关掉总开关。
- 从
cordis.patch.yml删掉上述insert块。 - 删除
node_modules/dsh-spectra与$DSH_HOME/ui-beautify。
结尾¶
dsh-spectra 把 DSH Web GUI 的外观做成可开关、可预设、可细调、可分享的一套方案，适合长时间用 DSH 又希望界面更贴合个人习惯的用户。详情与 issue 见 GitHub，目录入口见 SkillHub 插件页。
