前言¶
DSH Web GUI 已經提供主題能力，但第三方開發者如果想加入自己的配色、圖片背景或淺色/深色基底，通常還需要一個可安裝、可驗證、不改核心的插件層。dsh-skins 就是做這件事的客戶端插件倉庫：把皮膚註冊進 DSH 的主題系統，並在設置頁提供即時切換入口。
下面按已覈實資料介紹它是什麼、能做什麼、怎麼安裝和驗證。
這是什麼¶
dsh-skins 是一個給 DeepSeek Harness (DSH) Web GUI 換膚的客戶端插件倉庫。
已覈實資料中出現的名稱和來源字段如下：
- 倉庫名：
dsh-external/dsh-skins package.json包名：@dsh-external/dsh-web-skins- GitHub URL：
https://github.com/Moeblack/dsh-skins - 資料中的版權作者：
mattheliu
這些字段並不完全一致，且資料同時說明倉庫當前爲私有倉庫、需要 dsh-external 組織讀權限；另一方面，抓取頁面可從 Moeblack/dsh-skins 訪問。公開狀態無法僅憑這些資料確認，使用前應先覈對實際來源、訪問權限和源碼。
核心能力¶
通過官方 ThemeService 註冊皮膚¶
按資料描述，本插件不直接改 DSH 核心前端，而是通過官方 ThemeService 註冊第三方主題，並使用 --dsw-* alias token 做覆蓋。資料將這種方式概括爲“零核心改動”。
安裝後，用戶可以在設置頁的通用區塊看到“皮膚”選擇器；點擊皮膚即時切換，偏好寫入 dsh.theme。
已列出的本地構建通過皮膚¶
資料列出四個本地構建通過的皮膚：
| 皮膚 ID | 基底 | 類型 | 說明 |
|---|---|---|---|
nord |
dark | token | 以 token 覆蓋爲主的皮膚 |
aurora |
dark | image | 圖片背景皮膚 |
paper |
light | image | 淺色圖片背景皮膚 |
dream |
dark | image | 圖片背景皮膚 |
資料同時列出 neon-bamboo、ink-wash、harbor-night 爲候選或未開工，不屬於已發佈皮膚。
圖片背景與自包含資源¶
支持 dark/light 基底皮膚。圖片皮膚會疊加 AI 生圖背景。
資料說明背景圖以 data URL 內聯進 bundle，不依賴外部託管。也就是說，皮膚資源隨插件交付，而不是要求用戶額外配置外部圖片地址。
本地構建與驗證腳本¶
倉庫提供本地構建和驗證腳本，包括：
pnpm typecheck
pnpm build
pnpm test
pnpm verify
pnpm i18n
pnpm preview
pnpm verify 用於一次跑完 typecheck、build、test、產物冒煙，以及 i18n 雙語一致性門禁。資料說明該門禁要求 README/docs 的中英文檔結構一致，併成對更新。
安裝與啓用¶
先確認自己可以訪問對應倉庫。資料說明正式公開前請勿公開分發；如果倉庫權限仍在 dsh-external 組織內，需要先獲得相應讀權限。
安裝和啓動命令如下：
omdsh market install dsh-web-skins --profile web --enable
omdsh activate --profile web
omdsh launch --profile web --
資料說明市場安裝條目會把 id 解析爲 @dsh-external/dsh-web-skins 與不可變 Git spec：
git+https://github.com/dsh-external/dsh-skins.git#78349585a85ab94fd3ad22bfcfa9816058da2d93
資料還說明每個 commit 作爲不可變身份，因此更換皮膚版本會體現爲更換 ref。OMDSH 默認禁用安裝腳本。以上命令按資料原樣列出。
典型用法¶
安裝後切換皮膚¶
安裝完成後，進入 DSH Web GUI：
- 打開 設置
- 進入 通用設置
- 在 皮膚 區塊選擇目標皮膚
- 點擊後即時換膚
切換偏好會寫入 dsh.theme。
新增一個皮膚¶
資料給出的新增路徑是：
- 在
packages/dsh-web-skins/src/client/skins.ts增加SkinDefinition - 在
locales.ts補充skins.name.<id>的中英文案 - 如需圖片背景，確保背景圖以內聯 data URL 進入 bundle
- 運行
pnpm verify做 typecheck、build、test、產物冒煙和 i18n 雙語一致性門禁 - 在 README/docs 中登記新皮膚信息
經過上面的步驟後，可以在本地預覽頁查看效果：
pnpm preview
資料說明本地安裝或預覽依賴倉庫旁的 fulltest-wt 快照或 Private DSH snapshot；資料未說明公開快照的獲取方式。
適用場景與注意¶
適合以下情況：
- 你需要給 DSH Web GUI 增加第三方皮膚，而不是改核心源碼
- 你需要 dark/light 基底皮膚，或需要疊加圖片背景
- 你需要把皮膚定義、設置頁入口和本地驗證腳本放在同一個插件倉庫中
- 你需要對 README/docs 中英文檔做結構一致性檢查
使用前注意：
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼、許可證、倉庫來源和可執行邏輯。 package.json聲明 license 爲MIT；資料同時說明版權歸mattheliu所有，倉庫僅包含原創插件代碼與 DSH 官方 logo 素材，不包含官方倉庫其餘源碼。- 資料說明當前爲私有倉庫，正式公開前請勿公開分發。由於抓取 URL 與倉庫名/包名不一致，公開狀態無法僅憑資料確認。
- 候選皮膚
neon-bamboo、ink-wash、harbor-night不在已發佈列表中，不要按已發佈皮膚使用。 - DSH 理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店。
結尾¶
dsh-skins 的價值在於把 DSH Web GUI 的換膚需求做成一個可安裝、可驗證的客戶端插件：皮膚通過官方 ThemeService 註冊，設置頁可以直接切換，本地腳本也能跑 typecheck、build、test、verify 和 preview。
已覈實資料提供的 GitHub 地址是：
https://github.com/Moeblack/dsh-skins
目錄頁未在已覈實資料中提供可用 URL，因此本文不列出。
