前言¶
DeepSeek Harness（DSH）Web profile 提供了跟随系统、浅色和深色等基础应用主题。第三方主题插件通过 dsh-market 安装后，若要切换或管理，通常需要进入市场页面操作，不够集中。下面介绍 dsh-theme-picker，它为 DSH 增加了一个「主题」设置页，统一管理应用主题与已安装的主题插件，并确保同一时间仅有一个主题生效。
插件定位¶
dsh-theme-picker 是 DeepSeek Harness 的一个标准组件（Community dsh-plugin.json v0.15），由用户 yhPrime 维护，开源协议为 MIT。
核心功能¶
该插件通过 dsh-market API 维护状态，主要提供以下能力：
- 应用主题管理：列出跟随系统、浅色、深色以及皮肤插件注册的主题，点击即可切换。系统保证同一时间仅一个主题生效。
- 已安装主题插件列表：通过 dsh-market API 列出所有已安装的主题插件（包含被禁用的插件），显示注册表友好名，并随界面语言切换中英文描述。
- 单主题独享机制：启用某个主题插件时，会自动禁用其他所有已安装的主题插件。插件优先调用市场的
use-skin接口，若市场分类器无法识别，则降级为手动独享切换（/toggle）。 - 实时状态同步：列表每 6 秒刷新一次，与 dsh-market 页面状态互通。切换成功后，会提示刷新页面以应用新皮肤。
安装与启用¶
安装前请确认宿主内核版本满足要求，且当前 profile 已安装 @dsh-std/adapter-dsh。
安装命令：
# 使用 git 依赖安装
dsh plugin --profile web add git+https://github.com/yhPrime/dsh-theme-picker.git
或使用本地目录：
dsh plugin --profile web add file:./dsh-theme-picker
安装完成后，需要重启 DeepSeek Harness。重启后，在设置面板中会出现「主题」页面。你可以在市场的「插件」页面对该组件进行停用或启用操作。
工作原理¶
dsh-theme-picker 不是一个 cordis bundle（不包含 dsh.bundle 或 cordis.patch.yml），而是 DSH 标准组件。它利用 @dsh-std/adapter-dsh 在宿主激活时扫描普通依赖并装载 facets.host.entry。
- 应用主题：直接使用客户端的
theme服务（getTheme/setTheme）。 - 主题插件：通过同源路由调用 dsh-market 的 HTTP API，包括
GET /dsh-market/installed、GET /dsh-market/registry、POST /dsh-market/use-skin和POST /dsh-market/toggle。
插件依赖 dshmarket 来处理主题插件清单、启用/禁用逻辑以及持久化存储。
注意事项¶
- 本插件以当前 DSH 进程的权限运行。在安装前，建议检查源码和许可证。
- 生态背景：该插件目录收录在 SkillHub，与 DeepSeek 或幻方官方无从属关系。
结语¶
dsh-theme-picker 解决了 DSH 生态中主题管理分散的问题，通过统一的设置界面实现了应用主题与主题插件的集中控制。更多细节可参考插件目录或源码仓库。
