前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在實際使用中，默認的界面配色可能無法滿足個人偏好，而手動修改宿主源碼不僅繁瑣，還可能導致宿主升級後出現兼容問題。dsh-skin-center 針對這一痛點，提供了一套官方插件化的換膚解決方案，允許在不觸碰宿主源碼的前提下，通過運行時注入的方式改變界面外觀。
插件簡介¶
dsh-skin-center 是由 bruce-hmz 維護的 DSH 官方插件。它通過加法安裝的方式提供皮膚功能，默認保留 DSH 原生外觀，新增皮膚選項列於原生選項下方。插件採用宿主端與瀏覽器端雙端架構，實現了零源碼改動、首屏零閃屏以及多標籤實時同步。
安裝與啓用¶
在安裝前，請確保你的 DeepSeek Harness 版本在 0.1.5-rc.2 及以上。
使用 CLI 安裝插件：
dsh plugin --profile web add dsh-skin-center
安裝完成後，啓動 Web 模式：
dsh web
在瀏覽器中訪問 http://127.0.0.1:3080，進入 設置 -> 通用設置 -> 皮膚 頁面，即可看到皮膚列表。點擊即可切換。
核心功能¶
該插件主要包含以下能力：
- 35 套內置皮膚：包含 21 套 ACG 風格皮膚（如 QQ 懷舊、原神、火影、鳴潮等）和 14 套開發者經典配色（如 Gruvbox、Nord、Dracula、Tokyo Night、Catppuccin 等）。
- 零宿主源碼改動：不覆蓋任何宿主文件，不進行源碼打補丁。界面鉤子由插件在瀏覽器運行時“蓋章”，即使宿主升級，插件也基本不受影響。
- 加法安裝：默認保留 DSH 原生外觀（淺色/深色/跟隨系統），皮膚選項作爲補充出現在下方。安裝後默認選中“默認”，不改變現有外觀。
- 皮膚包導入/導出：支持將當前皮膚導出爲 JSON 文件，或導入 JSON 文件使用。這方便了社區之間的皮膚分享。
- 一張圖自定義：支持上傳一張 PNG、JPG 或 WebP 圖片作爲皮膚背景，系統會自動進行 96px 採樣取色和 WebP 編碼處理。
- 多標籤實時同步：利用 BroadcastChannel 機制，一個標籤頁切換皮膚，所有打開的標籤頁會實時同步更新。
- 首屏零閃屏：皮膚選擇持久化在
~/.dsh/skins/selection.json，宿主在 HTML 中內聯首屏配色，避免切換時的視覺閃爍。
工作原理與數據存儲¶
插件採用“宿主半”與“瀏覽器半”的架構：
* 宿主半：負責註冊皮膚路由、背景圖讀寫與更新檢查，並在 HTML 中內聯首屏配色屬性。
* 瀏覽器半：通過官方瀏覽器名冊加載，負責設置行插入、DOM 界面蓋章、標題欄 DOM 島構建以及跨標籤廣播。
皮膚數據與配置存儲在用戶目錄下：
~/.dsh/skins/
注意事項¶
- 許可證：代碼遵循 MIT License，但第三方素材（皮膚圖片）有單獨的許可，商用前請自行覈對素材來源。
- 桌面端安裝：桌面端不再支持 CLI 插件安裝，需在應用自帶的“插件管理”界面中搜索
dsh-skin-center進行安裝。
