前言¶
DSH 的桌面端和 Web 端默認外觀是統一的，想換個視覺氛圍時，通常只能忍受默認配色，或者自己改樣式、改配置文件，改完又怕升級後被覆蓋。dsh-theme-mist 是 ffyfox 維護的社區插件，把 DSH Go 參考設計的色彩、材質與圓角語言移植到桌面/Web 端，做成一個可熱插拔的客戶端主題：內置六套強調色，支持淺色 / 深色 / 跟隨系統，禁用後不殘留樣式。下面介紹它的定位、功能、安裝與使用方式。
這是什麼¶
一句話：dsh-theme-mist 是 DeepSeek Harness（桌面端與 Web 端）的客戶端視覺主題插件，包名 dsh-theme-mist，作者 ffyfox，當前版本 0.1.0，以 MIT License 開源。
它解決的問題是：讓界面換膚變成「裝插件 + 在官方設置裏點一下」，而不是手改配置文件。它屬於社區目錄的「趣味換裝」分類，是第三方社區插件，不是官方商店裏的東西，與 DSH Go、DeepSeek 官方均無關聯或背書。
核心功能¶
六套配色 × 明暗三態¶
內置霧藍、黛青、暮紫、松石、琥珀、石墨六套強調色，並與官方「淺色 / 深色 / 跟隨系統」疊加使用。淺色是微染冷白紙面，深色是偏藍的深石板色（不是純黑）。README 說明這 12 種組合全部通過 WCAG AA 對比度校驗。
強調色只用在主操作按鈕、關鍵選中態和右上角柔和光暈上，大面積背景與卡片靠明度層級和 0.5px 髮絲描邊拉開空間感，避免整屏着色。
兩種側欄材質¶
左側欄提供兩種材質：
- 玻璃（默認）：半透明抽屜底板，配 0.5px 髮絲描邊與右側大圓角。
- 平鋪：去掉底板，讓頁面漸變與右上角光暈直接貫穿三欄。
底部輸入區採用懸浮毛玻璃，滾動對話時消息會從輸入卡背後透出。
原生設置集成與零殘留卸載¶
所有開關都嵌入官方「設置 → 通用設置」面板，無需手改配置文件。禁用或卸載後，所有令牌與樣式表會還原爲官方默認外觀。
零 DOM 重寫¶
插件包名描述裏寫明 “zero DOM rewrite”，即主題不依賴重寫頁面 DOM，而是通過注入官方客戶端主題、設置與 locale 模塊來疊加樣式。
安裝與啓用¶
桌面端¶
打開桌面端左側欄 「插件」→「添加插件」，輸入：
dsh-theme-mist
Web 端¶
dsh plugin --profile web add dsh-theme-mist
個性化設置¶
安裝啓用後打開 「設置 → 通用設置」，會看到新增的兩項：
| 設置項 | 選項 | 說明 |
|---|---|---|
| 配色 | 霧藍 · 黛青 · 暮紫 · 松石 · 琥珀 · 石墨 | 點擊色塊即時切換。 |
| 側欄材質 | 玻璃（默認） · 平鋪 | 玻璃爲半透明抽屜底板；平鋪去掉底板，讓漸變與光暈直接貫穿三欄。 |
卸載¶
桌面端在 「插件」 頁面找到 Mist 主題 (dsh-theme-mist)，點擊移除即可。
Web 端：
dsh plugin --profile web remove dsh-theme-mist
開發與檢查¶
倉庫提供完整的本地校驗流程：
pnpm install # 安裝依賴
pnpm build # 構建 lib/index.js 與 lib/client.js
pnpm verify # 構建 + 類型檢查 + 單元測試 + 配色/令牌/打包契約校驗
pnpm verify 實際串聯的是 build、typecheck、test、check:palettes、check:tokens、check:pack 六個環節。底層實現細節見倉庫內的 docs/architecture.md、docs/visual-spec.md 與配色色階表 docs/reference/palette-tables.md。
適用場景與注意¶
適合想給 DSH 桌面端 / Web 端換一個統一視覺風格、又希望隨時能幹淨卸載的開發者和團隊。主題只在外觀層生效，不改變對話或插件行爲。
需要注意三點：
- 插件以當前 dsh 進程的權限運行，安裝前應先閱讀源碼與許可證。該項目爲 MIT License，另有
NOTICE聲明獨立重實現與第三方致謝。 - 插件聲明的運行要求是
engines.dsh爲>=0.2.1-alpha.1 <0.3.0，安裝前確認本機 dsh 版本在該範圍內。 - 這是社區插件，與 DeepSeek 官方無關聯，功能與樣式以倉庫 README 爲準。
小結¶
dsh-theme-mist 的價值在於把換膚收斂到一個插件：六套強調色、明暗跟隨系統、兩種側欄材質，且卸載後零殘留。適合需要統一界面氛圍但又不想維護自定義補丁的場景。
目錄頁：https://www.skillhub.cn/plugins/ffyfox/dsh-theme-mist
代碼倉庫：https://github.com/ffyfox/dsh-theme-mist
