前言¶
DeepSeek Harness（DSH）采用插件化架构，Web UI 的外观通常由宿主内置的主题系统控制。bpz0726/dsh-bestui 插件通过覆盖层机制，为 DSH Web UI 提供了一套自适应壁纸与外观配置方案，允许用户上传本地图片作为背景，并独立调整各层级的透明度与配色。
核心功能¶
- 上传图片当背景：支持本地选图，超限图片自动压缩，动画 GIF 保留动画效果，设置持久保存在浏览器
localStorage。 - 透明部件不透明度：针对背景基底、第二层表面、侧边栏设置独立滑块与“默认”勾选，数值越小壁纸透出越多。
- 元素颜色自定义：支持 14 个设计 token 和 9 个额外元素色，分为浅色/深色两套方案，边框按透明度渲染。
- 自动配色：有背景图时通过 Canvas 采样生成配色；无背景图时使用中性配色或跟随系统深浅。
- 字体与界面：支持字体风格、大小、缩放、圆角等自定义。
- 方案导出/导入：支持导出完整方案为 JSON，便于迁移。
- 停用易恢复：基于
theme.overrideTokens覆盖层，不注册新主题 id，卸载后自动清除样式，可与其它主题插件并存。
安装与启用¶
安装该插件需在终端执行以下命令：
dsh plugin --profile web add dsh-bestui
安装后重启 dsh web，插件将在启动时自动加载。
典型用法¶
- 进入 设置 → 常规，在「外观」下方找到 「壁纸主题 · BestUI」。
- 勾选 启用，点击 上传图片（支持 JPG/PNG/WebP/GIF）。上传后自动生成一组推荐透明度，可手动微调。
- 使用 透明部件不透明度 滑块调整各层级的透出程度。
- 通过 元素颜色 取色器自定义浅色/深色方案的配色，此设置与壁纸启用状态无关。
- 若需自动配色，点击 自动配色，系统会根据图片生成配色方案。
- 完成配置后，可使用 导出方案 或 导入方案 进行保存或迁移。
架构与兼容性¶
该插件不注册新的主题 ID，而是通过 theme.overrideTokens 叠加一层 token 覆盖层。这意味着它可与其它注册了主题 ID 的插件并存。视觉效果通过 CSS 变量实现，卸载时会自动移除覆盖层。插件在构建时需要 Node.js >= 18，但运行时仅需浏览器环境。所有配置均存储在浏览器的 localStorage 中。
适用场景与注意¶
- 适用场景：适合需要深度定制 DeepSeek Harness Web UI 外观的开发者，特别是希望为界面添加个性化壁纸或调整透明度/配色的用户。
- 注意事项：
- 该插件为预览版（0.1.x），面向 DeepSeek Harness Developer Preview，宿主升级后可能需要同步适配。
- 导出的方案 JSON 包含完整壁纸数据，分享前请确认隐私安全。
- 若曾按壁纸明暗自动切换主题，停用插件后需在宿主设置中手动切回主题。
短结尾¶
BestUI 提供了从壁纸到 UI 细节的全方位外观控制能力，且具备良好的兼容性与可恢复性。更多细节与源码，请参考 GitHub 仓库。
