前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構。對於開發者或使用者而言，自定義 DSH Web 的外觀是一個常見需求。手動編寫 CSS 變量或維護 ZIP 資產結構較爲繁瑣。dsh-skin-studio 提供了一個本地優先的、可視化的皮膚製作工作臺，旨在降低皮膚定製的門檻，並確保導出資產的合規性。
這是什麼¶
dsh-skin-studio 是一個由維護者 zhangguiping-xydt 開發的插件。它直接在 DSH Web 的設置面板中註冊了一個一級的「Skin Studio」入口。插件運行在瀏覽器端，負責讀取 Skin Center 的已安裝主題，提取官方設計令牌，並提供可視化的編輯與導出功能。
安裝與啓用¶
安裝該插件需要使用 DSH 的命令行工具。
dsh plugin --profile web add github:zhangguiping-xydt/dsh-skin-studio
安裝完成後，重啓 dsh web 服務，打開 Settings → Skin Studio 即可使用。
核心功能¶
該插件主要提供以下能力：
- 主題關聯與令牌吸收：讀取 Skin Center 的目錄，關聯已安裝的主題。它會自動提取並吸收官方設計令牌（僅限於
--dsw-*顏色令牌），不復制主題的代碼或遠程資源。 - 可視化編輯：支持編輯淺色和深色調色板、語義表面半徑、密度、面板不透明度以及減少運動配置文件。
- 實時預覽與審查：提供實時預覽樣本，支持淺色/深色模式切換，並能審查文本對比度是否符合 WCAG 標準。
- 背景處理：接受本地 PNG、JPEG 或 WebP 格式的背景圖（需驗證 MIME 類型和魔術字節），並支持通過本地存儲保存項目草稿。
- 資產導出：生成符合標準的 v2 皮膚 ZIP 資產歸檔，包含
skin.json、skin.css、雙語文檔、生成預覽以及可選的本地背景圖。
典型用法¶
完成安裝後，可按以下步驟創建或修改皮膚：
- 填寫身份信息：在插件界面中填寫皮膚名稱、ID 和作者字段。
- 關聯主題：選擇已安裝的基礎主題，並點擊「關聯並吸收調色板」。
- 優化配色：在檢查實時樣本和 WCAG 對比度結果的同時，調整淺色和深色調色板。
- 調整細節：可選地選擇經過驗證的本地背景，並調整表面半徑、運動和背景控件。
- 應用皮膚：導出 ZIP 文件，將其目錄提取到
$DSH_HOME/skins/，刷新 DSH Web，並在「設置 → 皮膚中心」中應用。
注意事項與限制¶
使用該插件時需注意以下事實：
- 本地存儲：項目草稿保存在瀏覽器本地存儲中，背景圖像僅在當前頁面內存中保存，刷新頁面後需重新選擇背景。
- 導入限制：導入的項目 JSON 最大爲 128 KiB，背景圖像最大爲 8 MiB。
- 關聯範圍：主題關聯僅複製識別出的
--dsw-*顏色令牌值，不復制鉤子、自由選擇器、字體、背景資源或遠程 URL。 - 運行環境：插件沒有主機端配置、API 路由、模型訪問權限或文件系統寫入權限。其安全模型完全依賴瀏覽器的沙箱機制。
結尾¶
dsh-skin-studio 爲 DSH 生態提供了一套標準化的皮膚製作工具。它通過本地化的可視化操作，簡化了皮膚開發流程，同時通過合約驗證和令牌限制確保了導出資產的結構安全。此插件爲社區貢獻，相關目錄與源碼可訪問下方鏈接。
