前言¶

在 DeepSeek Harness（DSH）里長時間寫提示、看對話和代碼塊，界面配色如果不統一、對比度不達標，亮暗切換時還容易「閃一下」。社區裏有不少換膚方案，有的只改少量變量，有的用自定義 CSS 綁宿主內部類名，宿主一升級樣式就對不上。下面介紹 Wildchiken 維護的 棱鏡 Prism（dsh-prism-skin）：用「配色種子」重算宿主全部顏色變量，亮暗成對，並做對比度校驗；同時支持壁紙、玻璃感、省電和導入導出主題文件。插件歸社區開發者維護，目錄站在 SkillHub，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

棱鏡是 DSH 的換膚插件（分類：趣味換裝）。一句話定位：種子生成整套配色，覆蓋宿主聲明的顏色接口（overrideTokens），本身不用 !important，也不依賴宿主的哈希類名來改色（主題文件裏自帶的自定義 CSS 除外）。

• 維護者：Wildchiken
• 許可證：MIT（見倉庫 LICENSE）
• 源碼與說明：GitHub — Wildchiken/dsh-prism-skin

核心能力（README 已寫明部分）¶

配色與對比度¶

• 一套主題覆蓋宿主 224 個顏色變量（含 markdown、diff、代碼高亮），亮暗各一份。
• 每套主題對 258 組文字與背景做檢查，WCAG 與 APCA 均需通過；不足時主要調明度直到達標；懸停文字按 4.5:1。
• 內置 十套 主題；可拖滑桿調色相、彩度、中性色調、對比度、明暗、強調色，棱鏡會重算全部顏色變量。
• 代碼配色可單獨選 GitHub、One、Solarized、Dracula、Monokai、Nord，對比度仍自動處理。

背景、玻璃與省電¶

• 背景支持圖片（選文件、拖拽、粘貼鏈接）、漸變、純色、鏈接輪播、文件夾輪播；「玻璃感」滑桿統一控制表面。
• 圖片只模糊一次，不開啓實時 backdrop-filter；文字對比度按壁紙明暗區域計算，不夠則降透明度；可一鍵從壁紙取色。
• 省電：跟隨系統 / 開 / 關；系統「減少透明度」或電量低於 20% 且未充電時可自動省電（部分瀏覽器無電池接口，見下文限制）。

自定義與主題文件¶

• 字體、字號（與「通用 → 字體」同一份設置）、圓角倍數；可按名稱搜索並編輯宿主變量。
• 自定義 CSS 上限 16384 字符，禁止 @import 與帶外部鏈接的 url()。省電時 body 帶 data-prism-saving，動畫主題可用 :not([data-prism-saving]) 停動效。
• 主題文件爲 JSON（配色種子，可含變量覆蓋、自定義 CSS、圓角、Material 動態取色規則）；支持短分享碼、從 dream-skin 遷移、導出爲 skin-center 皮膚（zip）。

性能與加載¶

• 保存的配色在首屏繪製前生效，減少閃爍。
• README 給出分包體積：入口約 21 KB；配色引擎與設置界面約 97 KB（首次打開設置或快捷面板時加載）等。

安裝與啓用¶

環境要求（README / package.json）：需要 DSH 0.2.1-rc.5 及以上、0.3 以下；README 寫明已在 0.2.1-rc.5（網頁版）和 0.2.2-rc.1（網頁版、macOS 桌面版）實測。package.json 中 engines.dsh 爲 >=0.2.1-rc.5 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0。支持網頁版與 macOS 桌面版。尚未發佈到 npm，安裝用 Release 裏的 .tgz 鏈接。

插件在 當前 dsh 進程權限 下運行；安裝前建議自行查看倉庫源碼與 MIT 許可證。

命令行 / 網頁版¶

第一次安裝可用 latest 鏈接（總是指向最新版）：

dsh plugin --profile <名字> add https://github.com/Wildchiken/dsh-prism-skin/releases/latest/download/dsh-prism-skin.tgz

將 <名字> 換成你的 DSH profile 名稱。

macOS 桌面版¶

先用 ⌘Q 完全退出 DeepSeek Harness，用應用內置 CLI 裝到 desktop 配置，裝完再打開：

cd ~ && "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add https://github.com/Wildchiken/dsh-prism-skin/releases/latest/download/dsh-prism-skin.tgz

升級¶

不要用 latest 鏈接反覆升級（地址不變時 pnpm 可能認爲已是最新）。應使用帶版本號的 Release 鏈接，把 <版本> 換成 Releases 中的號（示例 README 寫法：0.6.0）：

dsh plugin --profile <名字> add https://github.com/Wildchiken/dsh-prism-skin/releases/download/v<版本>/dsh-prism-skin-<版本>.tgz

桌面版升級同樣先完全退出，再用桌面版自帶命令行執行。

典型用法¶

日常：側欄與設置¶

1. 側欄底部「換膚」：換主題、切明暗、隨機一套、撤銷；面板顯示當前主題名，有改動會標「已修改」。
2. 設置 → 棱鏡：當前主題行提供「丟棄修改」「存爲我的主題」「恢復默認」；下方爲主題畫廊、強調色、背景與玻璃、省電、字體、代碼配色、微調與圓角、高級覆蓋、導入導出、對比度檢查結果。

主題、你的微調、背景與玻璃是分層疊加的（README 有流程圖說明）：換主題會清掉之前的修改（對比度與明暗兩項個人偏好保留）；要保留改動就「存爲我的主題」（最多 24 個）。恢復默認會清掉主題、修改與背景。操作可撤銷，懸停預覽不會立刻換掉整個界面。

導入擴展示例主題¶

Material 3（需棱鏡 0.7.0 及以上）：下載 release 中的 material-3.json，在 設置 → 棱鏡 → 導入導出 導入並應用。強調色變化時通過 Google 開源的 material-color-utilities 按 Tonal Spot 現算整套配色。

賽博朋克 HUD：下載 cyberpunk-hud.json，在同一入口「選擇文件…」後點「應用」；僅暗色。框體依賴自定義 CSS 匹配宿主類名，DSH 升級後可能部分失效（配色不受影響）。

Release 直鏈示例（與 README 一致，指向 latest）：

• https://github.com/Wildchiken/dsh-prism-skin/releases/latest/download/material-3.json
• https://github.com/Wildchiken/dsh-prism-skin/releases/latest/download/cyberpunk-hud.json

與其他換膚插件、持久化路徑¶

同一時間建議 只開一個 換膚插件：若其他插件用樣式蓋住顏色變量，棱鏡配色會顯示不全。棱鏡可識別部分常見插件（README 寫明目前有 skin-center、claude-style），檢測到後僅在設置頁與快捷面板提示，不搶佔。

狀態保存在 $DSH_HOME/dsh-prism-skin/state.json（默認 ~/.dsh/dsh-prism-skin/state.json，權限 0600）；壁紙在同目錄 wallpapers/。瀏覽器 localStorage 僅作緩存，多標籤頁可同步。

適用場景與注意¶

適合：希望在 DSH 裏系統化換膚、要保證亮暗成對與可讀性、需要壁紙/玻璃/省電，或要分享 JSON 主題 / 從 dream-skin 遷移的開發者。

務必注意：

• 圓角約七成跟 --dsw-radius-* 與滑塊走，約三成仍寫死在宿主樣式裏。
• 桌面版分享主題宜用 分享碼，不要用帶當前地址的鏈接（端口每次啓動可能變）。
• 字體改動寫在宿主「通用」設置，不在 棱鏡撤銷棧裏。
• Safari、Firefox 無電池狀態 API，「跟隨系統」省電主要看「減少透明度」。
• 自定義 CSS 主題（如 Material 3 組件樣式、賽博朋克 HUD 框體）在 DSH 升級後可能需更新主題文件；倉庫提供 node scripts/check-theme.mjs、node scripts/audit-theme.mjs 等檢查手段（見 README「開發」）。

結尾¶

棱鏡把 DSH 換膚收成「種子 → 全變量重算 → 對比度達標 → 可選壁紙與深度自定義」一條鏈路，安裝用官方 Release 的 dsh-prism-skin.tgz，日常從側欄「換膚」或 設置 → 棱鏡 即可。進一步細節與截圖見倉庫 README。

• 目錄頁：SkillHub — dsh-prism-skin
• 源碼與安裝說明：github.com/Wildchiken/dsh-prism-skin