DeepSeek Harness (DSH) 提供了 Web 界面用于智能体的配置与运行。在长时间使用过程中，开发者可能需要调整界面风格以适应个人习惯或特定的视觉环境。dsh-ui-customizer 是一个为 DSH Web 提供的视觉自定义插件，允许用户在不修改源码的情况下，通过面板直接调整颜色、字体、背景和组件样式。
功能概览¶
该插件提供了一套完整的视觉定制方案，主要包含以下模块：
- 总开关：控制 DIY 主题的启用与禁用，关闭后所有覆盖设置将移除。
- 皮肤中心：提供 8 种一键预设方案，用户可在预设基础上进行微调。
- 色彩系统：支持品牌色、强调色、成功/警告/错误状态色，以及中性色方向（蓝灰、冷灰、暖灰、石墨）。
- 字体设置：可配置 UI 字体与代码字体，并支持整体缩放（80%-140%）和文本缩放（80%-130%）。
- 背景设置：支持自定义图片 URL（需浏览器安全策略允许），并调节面板的透明度与毛玻璃效果。
- 组件样式：调整阴影层级与圆角大小，控制视觉深度与圆润度。
- 我的方案：保存完整的主题配置为预设，并支持随时切换。
安装与启用¶
在安装前，请确保系统已安装 Node.js（用于运行 npx）。
- 执行安装命令：
dsh plugin --profile web add dsh-ui-customizer@latest
*(注：该插件在 v1.1.0 版本起声明为标准 bundle，会自动注册到 `dsh.profile.bundles`)*
- 完全重启 DSH Web 进程以加载插件：
npx @deepseek-ai/dsh web
- 在浏览器中打开 Web 界面，依次进入 Settings (设置) → DIY Theme (DIY 主题) 即可使用自定义面板。
使用方法¶
进入 DIY 主题面板后，所有修改均为实时预览。
- Apply：保存当前配置。
- Revert：撤销未保存的更改。
- Reset：恢复为工厂默认值。
数据存储与兼容性¶
- 数据存储：主题配置与方案保存在浏览器的
localStorage中；上传的媒体文件（如有）存储在IndexedDB。数据不会上传至 DSH 服务器。 - 图片加载：远程图片 URL 的加载受浏览器安全策略、CORS（跨域资源共享）及服务器响应头的限制。
- 兼容性：DSH 版本迭代较快，官方的 token、插槽和页面结构可能会发生变化，这可能影响插件功能的兼容性。
- 可读性设计：插件遵循“可读性优先”原则。环境表面（如主背景、侧边栏）会根据透明度设置变透明，而覆盖层（对话框、菜单、输入框）保持约 94% 的不透明度，以确保文本始终清晰可见。
总结¶
dsh-ui-customizer 为 DSH Web 提供了一个无代码的视觉定制入口。它利用本地存储管理配置，适合需要频繁调整界面风格或进行统一视觉风格管理的开发者。该插件开源（MIT 协议），维护者为 Final-LX。
