前言¶
DeepSeek Harness（DSH）的 Web 界面默認只有官方的淺色 / 深色 / 跟隨系統配色，改外觀通常只能動全局主題偏好。若你希望在不改 DSH 核心的前提下，給界面套上侘寂、終端、賽博朋克等完整視覺風格，並在側邊欄快速切換、隨時恢復原生樣式，就需要一套獨立於 ThemeRuntime 的皮膚機制。下面介紹社區插件 dsh-skin-collection 的定位與用法。
這是什麼¶
dsh-skin-collection 是面向 DeepSeek Harness Web GUI 的多風格皮膚集合：每個皮膚註冊一套主題 token 與作用域內的裝飾 CSS，並通過側邊欄皮膚管理器切換；選「默認樣式」可完全恢復 stock UI。
維護者與社區目錄條目爲 flyingludens，分類爲「趣味換裝」。項目在 npm 上發佈爲 dsh-skin-collection，當前版本 0.2.5，許可證 MIT（以倉庫爲準）。插件以預構建產物分發，安裝階段不執行構建腳本。
核心功能¶
九套皮膚¶
每套皮膚有固定 theme id、視覺風格、基礎配色方案（light / dark）及典型效果，摘要如下（完整表格見 GitHub README）：
| Theme id | 風格 | Scheme | 要點 |
|---|---|---|---|
wabi-sabi |
Wabi-Sabi 侘寂 | light | 大地色、紙紋、襯線字體、Enso 啓動淡入等 |
terminal |
Terminal 終端 | dark | 磷光綠、VT323、CRT 掃描線與文字輝光 |
cyberpunk |
Cyberpunk 賽博朋克 | dark | 青/品紅霓虹、Space Grotesk、掃描線 |
film-noir |
Film Noir 黑色電影 | dark | 明暗對比、膠片顆粒、灰度圖 hover 恢復 |
swiss |
Swiss 國際主義 | light | 網格、Inter 大寫標題、瑞士紅點綴 |
bauhaus |
Bauhaus 包豪斯 | light | 紅藍黃幾何、Jost、無陰影 |
brutalism |
Brutalism 野性主義 | light | 粗黑邊框、硬陰影、警示黃塊 |
dark-glass |
Dark Glass 暗黑玻璃 | dark | 深藍底、藍紫青環境光、磨砂代碼面板 |
pixel-retro |
Pixel Retro 像素復古 | dark | 街機 indigo、Press Start 2P、像素陰影 |
各皮膚的設計參考 uiprompt.dev web-styles 提示詞：palette 映射到 --dsw-alias-* token，關鍵視覺效果寫在 scoped CSS 中。
皮膚與官方主題的關係¶
插件文檔強調了幾條行爲，便於預期界面變化：
- 皮膚 ≠ 主題偏好。 官方 ThemeRuntime 只持久化
light/dark/system；若把 skin id 放在那裏，每次保存設置或切換 run-mode 可能被還原。本插件用獨立持久化標誌驅動body[data-dsh-skin-<id>]，避免被自動流程清掉。 - 激活皮膚時鎖定配色方案。 皮膚生效期間，基礎 color scheme 與皮膚的
colorScheme一致，避免 dark 皮膚外圈仍是淺色 chrome；選默認樣式會解除鎖定並恢復你之前的偏好。 - 調色板隨 attribute 下發。 各皮膚的
--dsh-alias-*也會作爲普通 CSS 掛在對應 attribute 上，客戶端樹重建後顏色仍可用。 - 底層「跟隨系統 / 淺色 / 深色」與皮膚 overlay 分離。 在皮膚層之下仍可切換基礎 scheme。
- 若在官方 Settings → Appearance 裏選了某 skin id，插件會自動採納。
安裝與啓用¶
在已配置 DSH Web profile 的環境中，安裝命令以 README 原文爲準：
# from npm
dsh plugin --profile web add dsh-skin-collection
# or straight from GitHub (prebuilt lib/ committed — no build scripts run)
dsh plugin --profile web add github:NonchalantLudens/dsh-skin-collection
安裝後重啓 dsh web。側邊欄底部使用 皮膚 按鈕選擇皮膚；默認樣式恢復原生外觀。皮膚也會出現在 Settings → Appearance 中。
包結構要點（便於自查或二次開發）：lib/client.js 爲隨 loader 下發的客戶端 bundle；lib/index.js 爲 Node 側 no-op stub；cordis.patch.yml 負責把插件寫入 Web roster。
典型用法¶
日常流程可以概括爲：
- 按上一節命令安裝並重啓 Web 服務。
- 打開 DSH Web，在側邊欄底部點 皮膚，從九套風格中選一套；需要原生 UI 時選默認樣式。
- 也可在 Settings → Appearance 中與官方外觀選項一併切換。
若你要新增一套皮膚（需改插件源碼並自行承擔維護），README 給出的步驟是：
- 在
lib/client.js的EXTRA_SKINS中追加條目（id、label、theme.tokens、可選 Google Fonts 的imports、scopedcss）。 - 註冊、選擇器菜單、palette 下發與 attribute 守衛均爲數據驅動，無需再寫樣板代碼。
- 提高版本號後重新安裝。
注意：所有皮膚的 Google Fonts @import 會被提升到合併裝飾表頂部；應把 @import 放在各皮膚的 imports 數組裏，而不是寫在 CSS 正文中間。
適用場景與注意¶
適合誰： 長期在 DSH Web 上調試智能體、希望界面風格與個人或演示場景匹配、又需要一鍵還原官方 UI 的開發者。
生態說明： DSH 奉行「一切皆插件」；SkillHub 插件目錄 是社區站點，與 DeepSeek / 幻方無官方從屬關係，不要當作官方應用商店。
安全與權限： 插件隨當前 DSH 進程權限運行，會向 Web 客戶端注入主題相關邏輯與 CSS。安裝前請閱讀倉庫源碼與 MIT 許可證，確認可接受後再在生產環境啓用。
依賴： package.json 要求 Node >=18，peer 依賴 @deepseek-ai/cordis ^4.0.1；客戶端注入依賴 @deepseek-ai/dsh-client-ui-theme，平臺爲 web，immediately: true。
結尾¶
dsh-skin-collection 把多套獨立視覺皮膚與側邊欄管理器接到 DSH Web 上，並與官方 Appearance 設置互通；默認樣式保證可完整回到 stock UI。目錄頁：https://www.skillhub.cn/plugins/flyingludens/dsh-skin-collection；源碼與說明：https://github.com/flyingludens/dsh-skin-collection。
