插件定位¶
DeepSeek Harness (DSH) 的 web 平台采用插件化架构。在现有环境中，切换主题通常需要手动编辑配置文件或刷新页面。dsh-theme-manager 通过一个两级式的主题管理器解决了这个问题，用户无需接触代码即可通过界面选择并应用主题。
核心功能¶
该插件由 runcat-tommy 维护，基于 MIT 许可证开源。它主要提供以下能力：
- 两级选择界面：在设置页新增“主题管理器”入口。左侧展示第一层分类（文化/场景、开发者等），右侧展示具体的风格卡片，卡片包含配色预览。
- 实时生效：通过
theme服务注册，点击“使用”后立即切换，无需刷新页面。 - 状态记忆：当前选择的主题保存在浏览器 localStorage 中，刷新或重启后自动恢复。切换回系统默认外观时会自动清除记录。
- 双语支持：界面文案跟随系统语言（zh / en）。
- 内置 58 套风格：涵盖四个大类：
- 文化/场景（23 套）：如中国水墨、苏州园林、日本浮世绘、赛博朋克、DeepSeek 深海蓝等。
- 开发者主题（8 套）：如 Catppuccin Mocha、Dracula、Tokyo Night、Nord 等。
- 强烈对比（7 套）：如黑金对比、红黑对比、荧光绿酸等。
- 国旗系列（20 套）：基于
flagSpec()生成器自动派生配色层级，包括美国、中国、日本、德国等国旗配色。
- 更新机制：启动时自动检查 npm 最新版本，每 6 小时检查一次。发现新版本时，右下角弹出一次性 toast 和常驻气泡。支持在设置页进行“一键更新”、“忽略本版本”或“稍后提醒（24小时）”。
安装与启用¶
使用该插件前，请确保已安装 DeepSeek Harness web 0.1.0-rc.6 或更新版本。
安装步骤¶
通过 dsh 插件管理工具安装：
dsh plugin --profile web add github:runcat-tommy/dsh-theme-manager
安装完成后，重启 dsh web 进程使插件生效。
使用方法¶
- 打开 DeepSeek Harness 的 设置 页面。
- 点击 主题管理器 入口。
- 在左侧列表中选择第一层分类（例如“中国”、“开发者”、“国旗”）。
- 在右侧风格卡片中点击 使用 按钮。
- 界面会立即切换至选定的主题风格。刷新页面后，该风格会自动保留。
若需恢复默认外观，可点击底部的“恢复默认外观”，或在“设置”页的“外观”行切换系统默认选项。
更新与维护¶
插件内置了自动更新检查逻辑。
* 检查频率：应用启动时以及运行期间每 6 小时。
* 更新方式：npm 安装和 GitHub 安装方式均支持一键更新。更新过程会解析最新版本并自动重启（或提示手动重启）。
* 回滚功能：支持一键回滚到上一个版本。
* 开发安装：如果使用 link: 方式或手动安装，不支持自动更新，需在源码目录更新后重启。
结语¶
dsh-theme-manager 为 DeepSeek Harness web 提供了一套结构化、可视化的主题管理方案。通过内置的 58 套风格和自动更新机制，开发者可以快速调整界面风格以适应不同场景或个人偏好。更多细节与源码可参考项目仓库：https://github.com/runcat-tommy/dsh-theme-manager
