前言¶
DSH 的理念是一切皆插件，Web 界面的主題也不例外。但想親手換一套配色，要面對 --dsw-alias-* 這一批語義 token：明暗兩套顏色分別要填、正文與背景的對比度要過 WCAG AA、派生色調整時還不能動已經鎖定的項。純手工逐項覈對，既慢也容易漏。
dsh-skin-studio 解決的就是這個問題：它在瀏覽器本地完成皮膚的生成、編輯、審計、預覽、持久化與導入導出，全程不向模型上下文寫入任何內容。
這是什麼¶
dsh-skin-studio 的定位是「本地 token 安全的 DSH 主題生成器、編輯器、審計器與導出器」，由 LeemanCheung 維護，許可證爲 MIT。
它兼容 DeepSeek Harness 0.1.2-rc.1（compatibility 範圍爲 >=0.1.2-rc.1 <0.1.3-0，僅對 web profile 生效）。
核心功能¶
皮膚庫與 token 編輯器¶
入口在 Settings → Skin Studio，提供響應式皮膚庫、語義 token 編輯器和明暗雙預覽。內置六套預設，支持鎖定、撤銷/重做、刪除確認和手動調色。
從圖片取色¶
可以把 PNG/JPEG/WebP 圖片丟進去做調色板取樣。插件限制圖片不超過 10 MB、40 兆像素，解碼像素降採樣到 128px，再用 OKLab k-means 提取最多六種顏色。後續的自動派生會始終保留已鎖定的 token。
對比度審計¶
對正文、次級文字、品牌按鈕這三類配色執行 WCAG AA 審計，並自動修正未鎖定的派生 token——包括必須加深才能達標的白色文字。
持久化與應用¶
通過 storageDomain 和生成的 Typert Remotes 實現持久的 Host CRUD 與當前皮膚狀態。Save & Apply 在替換可逆覆蓋之前，會先把當前草稿持久化。
導入導出與分享¶
支持嚴格的 .dshskin JSON 導出/導入、Stop Preview、帶聲明主題依賴的生成 Client 入口源碼，以及本地生成的 PNG 分享卡。
安裝與啓用¶
dsh plugin --profile web add github:LeemanCheung/dsh-skin-studio
安裝後需要重啓現有 DSH Web 進程，並刷新其頁面。
典型用法¶
以「從圖片生成一套皮膚」爲例：
- 進入 Settings → Skin Studio，從六套預設中選一套作爲基底；
- 導入一張 PNG/JPEG/WebP 圖片取樣（不超過 10 MB、40 兆像素），得到最多六個 OKLab k-means 候選色；
- 在編輯器和明暗預覽裏手動調整，把必須保留的顏色鎖定，之後的自動派生不會觸碰鎖定項；
- 跑一次 WCAG AA 審計，插件會修正未鎖定的派生 token，包括需要加深的白色文字；
- 確認後點 Save & Apply，插件先持久化當前草稿，再替換可逆覆蓋；
- 導出
.dshskinJSON 用於備份或遷移，也可以生成一張本地 PNG 分享卡。
本地開發驗證¶
如果你要自己構建或改代碼，在倉庫根目錄依次運行：
corepack pnpm typecheck
corepack pnpm test
corepack pnpm build
corepack pnpm pack:check
適用場景與注意¶
適合想自定義 DSH Web 界面配色、又不想手工維護語義 token 的用戶：預設和圖片取樣負責起稿，審計負責可讀性，持久化和導出負責沉澱與複用。
使用前有幾點邊界需要清楚：
- 插件不添加任何模型 prompt、tools、messages、token 用量或 KV-cache 內容。調色分析與主題預覽在瀏覽器運行，驗證過的皮膚持久化在 Host。
dshskin/v1格式限制：文件最大 100 KB、最多 128 個語義 token、嚴格元數據、六位十六進制顏色、指向現有 token 的唯一鎖定，且必須包含當前 DSH 核心的背景/標籤/品牌/邊框 token。- 導入解析爲純 JSON：拒絕覆蓋同 id 的現有皮膚，並拒絕未知字段、prototype 鍵、深層或超大值、非法 token 名、腳本、CSS 選擇器、URL、import、表達式與外部字體；導入數據永不執行。
- 圖像取樣只降採樣到 128px 且僅用單幀，不保留動畫與圖像元數據。
- 生成的插件源碼只是供用戶顯式導出的文本，Skin Studio 從不安裝或執行它。
- Typert Remote 方法僅面向掛載在同一受信 DSH Web composition 中的客戶端，不是面向不受信瀏覽器插件的授權層；Remote CRUD 與同一 composition 中的受信客戶端共享，而非按單個瀏覽器包身份隔離。
最後照例提醒：插件以當前 dsh 進程的權限運行，安裝前建議檢查倉庫源碼與許可證（本項目爲 MIT），並確認 compatibility 範圍覆蓋你手上的 DSH 版本。
小結¶
dsh-skin-studio 把 DSH Web 換膚的取樣、派生、審計、持久化和導出串成一條完整的本地流程，且不觸碰模型上下文。倉庫地址：https://github.com/LeemanCheung/dsh-skin-studio ；收錄頁面：https://www.skillhub.cn/plugins/LeemanCheung/dsh-skin-studio 。目錄爲社區維護的獨立站點，與 DeepSeek、幻方無官方從屬關係。
