DeepSeek Harness（DSH）的 Web UI 提供了基础的智能体开发环境。在默认配置下，界面风格较为统一。如果你希望调整界面的配色、字体或布局深度，可以使用 DSH Pretty Extension 插件。它通过一个原生的设置页面提供主题编辑能力，而非依赖外部 CSS 覆盖。
插件定位¶
这是一个由 Rheasilvia 维护的 DSH 插件，专门用于 DeepSeek Harness Web UI 的主题美化。它利用 DSH 的插件、设置、插槽和主题 API，在 Web UI 的设置中添加了一个独立的编辑入口，支持从预设或自定义两个维度修改界面外观。
核心功能¶
插件提供了以下可用的配置项：
- 28 种主题预设：包含 Ayu、Catppuccin、Dracula、GitHub、Nord、Tokyo Night 等常见风格。
- 独立调色板：可分别配置浅色和深色模式下的强调色、背景色、前景色和侧边栏颜色。
- 实时预览：在修改设置时，侧边栏、对话区域和会话选中状态会实时更新，无需保存即可预览效果。
- 排版与深度控制：支持单独选择 UI 字体和代码字体，并可调节界面层级（表面、边框、次要文本、悬停状态），支持 82% 透明度的侧边栏渲染。
- 无障碍修正：自动对低对比度的前景色进行最小化调整，以保持至少 4.5:1 的文本对比度。
- 原生集成：使用 DSH 的菜单系统和语义化主题令牌，支持设置持久化和版本保护。
安装与启用¶
安装前请确保你的环境满足以下条件：
- 已安装 DeepSeek Harness 并配置了
web配置文件。 pnpm可在系统PATH中找到（dsh plugin依赖 pnpm 管理依赖）。
执行以下命令安装插件：
dsh plugin --profile web add github:Rheasilvia/dsh-pretty-extension
安装完成后，插件默认处于禁用状态。你需要重启 DSH Web 进程使其生效：
dsh web
使用步骤¶
- 启动 DSH Web，访问其回环地址（通常为
http://127.0.0.1:3080）。 - 打开 Settings（设置） 菜单，选择 Pretty。
- 打开 Enable Pretty theme 开关。
- 切换 Light 或 Dark 模式，选择一个预设主题，或手动调整颜色、字体和界面效果。
- 在预览区域确认效果无误后，点击 Save and apply。
注意事项与配置¶
- 默认禁用：插件安装后不会立即改变界面，必须手动在设置中启用。
- 持久化存储：配置信息保存在
$DSH_HOME/settings.yaml文件中的ui-pretty.theme命名空间下。点击“Restore defaults”可移除此配置覆盖，恢复 DSH 原生主题。 - 本地字体限制：若要加载系统字体，浏览器必须支持该功能，且必须在回环地址或安全上下文（HTTPS）中运行，并显式授权。
- 只读限制：如果浏览器不是通过回环地址（如
127.0.0.1）访问 DSH，Pretty 设置在当前会话中将是只读的。这属于安全设计，远程会话仅使用内存设置。
总结¶
DSH Pretty Extension 通过插件化的方式扩展了 DSH Web UI 的定制能力。它适合需要在长时间使用 DSH 时调整视觉体验的开发者，提供了从预设快速应用到精细像素级调整的完整工作流。
