前言¶
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 生態中主題管理分散的問題，通過統一的設置界面實現了應用主題與主題插件的集中控制。更多細節可參考插件目錄或源碼倉庫。
