前言¶
DeepSeek Harness (DSH) 提供了基于插件的扩展架构。默认的 Web 界面风格固定，若需修改背景、配色或布局细节，通常需要修改源码。dsh-theme-customizer 将这些定制需求封装为插件，提供可视化的配置面板，支持实时预览、持久化保存以及配置文件的导出与导入。
插件简介¶
该插件由 lxxz1918 维护，开源协议为 MIT。核心价值在于对 DSH Web 界面的主题进行全可视化调整，覆盖背景、文字、框线及细节样式。配置通过 localStorage 本地持久化，支持导出为 .tczp 文件并在其他设备上导入还原整套效果。
核心功能¶
-
多区域背景定制
支持对 7 个区域的背景进行设置，包括主界面、侧边栏、对话区、输入区、设置界面、浮窗面板以及 Cordis 插件界面。- 每个区域支持纯色、图片（支持选区裁剪）、透明度及底色。
- 主界面支持“包含侧边栏”与“不包含侧边栏”两种显示模式的独立配置。
- 侧边栏图片支持淡出效果，不影响顶部 UI。
-
全局细节调整
- 框线与字体：支持独立设置各区域的边框/分隔线颜色与透明度，以及正文、过程、辅助、弱化、强调五类文字颜色。
- 标志与欢迎页：可调整左上角 Logo 颜色、侧边栏收起后的图标样式，以及新会话欢迎页的图标、标题与徽章颜色。
- 对话区与输入区：定制气泡样式、代码块（背景与滚动条）、输入框高度、统计条显示项及按钮样式。
-
管理与工具
- 预设系统：支持预设的导入、导出（
.tczp格式，含图片）、重命名、删除及拖拽排序。 - 浮动面板：提供可拖动的迷你设置面板，方便快速调整。
- 布局调整：设置界面面板支持拖动位置及一键复位。
- 全局恢复：支持一键重置所有设置。
- 预设系统：支持预设的导入、导出（
安装与启用¶
使用官方安装命令添加插件，安装后需重启 DSH Web 使改动生效。
dsh plugin --profile web add dsh-theme-customizer
使用方法¶
- 常规调整：进入 DSH 设置，点击“主题”，在面板中逐项调整背景、颜色和样式，改动即时生效。
- 快速调整：点击界面右上角的“↗ 打开浮窗”按钮，使用迷你面板快速切换设置。
- 效果验证：在对话区发送指令，直接测试对话区细节选项（如气泡、代码块）的实际效果。
注意事项¶
- Cordis 按钮常驻：若需在主题设置中启用“Cordis 按钮常驻”功能，需依赖
dsh-client-ui-cordis补丁。插件包内提供了apply-patch.cjs脚本，需运行该脚本进行打补丁。
node apply-patch.cjs
- 版本兼容：DSH 官方包升级后会覆盖插件目录，升级后需重新执行打补丁命令。
- 卸载：卸载时执行移除命令。
dsh plugin --profile web remove dsh-theme-customizer
结语¶
该插件通过可视化手段解决了 DSH Web 界面定制的问题，适合需要统一视觉风格或在不同设备间同步主题配置的开发者。相关源码与文档可参考 GitHub 仓库。
