@dshp-inx/custom-ui —— DSH 定製 UI 套件

DeepSeek Harness（DSH）的設計理念是“一切皆插件”。在默認的界面基礎上，開發者往往需要更貼合個人或品牌風格的視覺體驗。@dshp-inx/custom-ui 是一個專爲 DSH 定製的 UI 套件，旨在通過主題畫廊和外觀配置工具，解決界面風格單一和偏好持久化缺失的問題。

核心功能¶

該插件提供了外觀定製的一整套能力，主要包括：

• 主題畫廊：內置 23 套主題，包含 14 套品牌適配（如 Linear、GitHub、Notion 等）和 9 套原創主題。
• 一鍵切換：在設置頁的“外觀定製”模塊中，直接點擊色卡即可切換主題。
• 偏好持久化：補全了官方 ui-theme.preference 僅支持 light/dark/system 的缺陷，支持自定義主題 ID 的保存與讀取，重啓後自動恢復。
• 全局圓角配置：支持 -1（跟隨主題）、0（全銳角）、12（統一圓潤）三檔配置，保存即生效。
• 壁紙取色：基於 Material You 算法，上傳壁紙後提取調色板，生成包含 MD3 導出的 Token，支持一鍵啓用。
• 全量 Token 映射：每套主題包含約 110 個 --dsw-* 令牌，覆蓋背景、邊框、按鈕、交互態、文字、陰影等所有 UI 層面。

安裝與啓用¶

插件掛載在 DSH 的 Web Profile 層。執行以下命令完成安裝：

cd ~/.dsh/profiles/web
pnpm add --offline "@dshp-inx/custom-ui@link:../../plugins/dsh-custom-ui"
rm -rf node_modules/@dshp-inx/custom-ui
ln -s "$HOME/.dsh/plugins/dsh-custom-ui" node_modules/@dshp-inx/custom-ui

安裝完成後，重啓 DSH Web 即可生效。

典型用法¶

1. 切換主題：進入“設置” -> “外觀定製” -> “主題畫廊”。點擊色卡即可切換，當前使用的主題會有實時徽標跟隨。
2. 配置圓角：在“外觀定製”中找到“全局圓角”配置項，選擇 -1、0 或 12，點擊保存。
3. 壁紙取色：在“外觀定製”中找到“壁紙取色”區域，上傳本地壁紙。插件會生成 5 組調色板（亮/暗模式），支持一鍵啓用或複製 MD3 Token。

注意事項¶

• 數據源結構：主題數據源爲 lib/themes/，Host 端只下發 Token，Client 端只存儲元數據（id、label、swatch 等）。新增主題需在目錄添加文件、更新聚合索引，並運行校驗腳本。
• 版本衝突：如果系統中同時存在動態插件版（會話內 cordis_define）和靜態掛載版，會導致 WEB_DUPLICATE_PROVIDER 錯誤。靜態掛載前應先 cordis_undefine 動態版。
• 限制說明：官方主題服務的設置 Schema 僅支持 light/dark/system，本插件通過擴展 Settings 命名空間實現了自定義主題的持久化。

插件地址：https://github.com/Yinxe/dsh-custom-ui