dsh-theme：DeepSeek Harness 的可配置皮膚插件

DeepSeek Harness (DSH) 的 Web UI 支持通過配置調整外觀，但直接修改樣式文件不僅繁瑣，而且難以維護。dsh-theme 插件提供了一套配置化的皮膚方案，將調色板、字體和圖片槽位封裝爲配置項，內置了兩套預設主題，且不修改 DSH 源代碼。

插件定位¶

這是一個爲 DeepSeek Harness Web UI 提供的“皮膚”插件，由開發者 naniwet 維護。其核心價值在於：將複雜的樣式調整轉化爲配置文件的修改。你只需調整 YAML 配置即可更換整套 UI，無需修改 DSH 源碼。

核心功能¶

• 配置化皮膚：調色板、字體和圖片槽位均可配置。
• 內置預設：包含 Code Geass 和 SPY×FAMILY 兩套預設。
  • Code Geass：使用金色 #c9a227 和深紅 #a01c26，配合宋體/襯線體。
  • SPY×FAMILY：使用森林綠 #2f5d50 和玫瑰紅 #d4788a，配合蘋方/圓體無襯線體。
• 全面覆蓋：覆蓋背景、側邊欄、按鈕、消息氣泡、滾動條等所有 UI 表面。
• 本地存儲：設置保存在本地，無需修改 DSH 的配置文檔。
• 無侵入卸載：插件卸載時會自動移除樣式，恢復默認 UI。

安裝¶

使用官方命令安裝插件：

dsh plugin --profile web add /path/to/dsh-theme

注意：如果使用 link: 方式安裝本地目錄，不會自動安裝依賴。需在插件目錄下手動運行 npm install，否則 profile 啓動時會報錯。

配置與使用¶

1. 啓用插件：執行上述安裝命令。
2. 切換皮膚：進入 DSH Web UI 的 Settings → General，在皮膚選項中選擇預設（如 Code Geass 或 SPY×FAMILY）。選擇即刻生效，瀏覽器會記住偏好。
3. 自定義配置：將預設文件複製到 $DSH_HOME/profiles/web/cordis.patch.yml。修改其中的圖片路徑或調色板數值。注意：config 塊會替換整個條目配置，而非逐鍵合併，因此需保留所有需要的鍵。

注意事項與限制¶

• border9Slice 行爲：該配置項僅繪製四個角落的裝飾，並非完整的邊框。
• 側邊欄摺疊：當側邊欄摺疊時，角色藝術會被隱藏。
• 圖標匹配機制：內置圖標通過 CSS 模塊類名的子字符串匹配，若上游重命名類名，匹配可能會失效。
• active 配置：active 配置僅決定瀏覽器未做出選擇前的初始視圖，切換皮膚後以用戶選擇爲準。
• 圖片來源與許可：插件內置的粉絲藝術爲 AI 生成，非官方素材，不包含在 MIT 許可證下。
• 權限範圍：圖片通過主機進程服務，瀏覽器無需文件系統訪問權限。