前言¶
DeepSeek Harness（DSH）的 Web GUI 默認外觀固定，想換風格通常只能改系統主題或自己寫 CSS，維護成本高，也容易在 DSH 升級後失效。社區插件 dsh-spectra（維護者 zhi-jie2778）專門做界面外觀定製：一個總開關、六套內置方案、參數可調，配置可保存與分享。裝好後默認不改界面，需要在 設置 → 界面美化 打開總開關後纔會生效；關掉總開關會立刻回到原版。
這是什麼¶
dsh-spectra 是 DSH 的界面美化插件，分類爲「趣味換裝」。它只覆蓋 CSS 設計令牌並加少量 DOM 屬性，不改 DSH 源碼、不注入業務邏輯。狀態寫在 $DSH_HOME/ui-beautify/state.json（Windows 默認 C:\Users\<你>\.dsh\ui-beautify\state.json），瀏覽器 localStorage 另有一份緩存；升級插件不會動這份數據，上一版會留作 state.bak.json。
六套內置方案與明暗切換¶
README 列出的六套方案如下。
| 方案 | 風格 |
|---|---|
| 蘋果玻璃 | 磨砂玻璃，大圓角，柔和陰影 |
| 賽博霓虹 | 深色底，霓虹紫青，發光邊框 |
| 糖果極光 | 漸變，光暈，彈性動效 |
| 極簡瑞士 | 高對比，細線框，留白多 |
| 暖色紙感 | 低飽和，暖調，護眼 |
| 終端復古 | 熒光綠，等寬字體，CRT 質感 |
淺色與深色各一套，可一鍵切換；明暗 可跟隨 DSH 主題，或強制淺色 / 深色。
可調參數概覽¶
下面按 README 歸納的主要能力說明用途，便於對照設置頁。
總開關與區域
關掉總開關後樣式表與屬性一併移除，完全還原。區域 可對側欄、對話、輸入框、浮層、設置頁、終端與預覽、代碼塊、細節等八塊分別開關。
顏色與材質
淺色與深色各 11 項顏色（主色、輔色、畫布、面板等），帶取色器和色值輸入。材質 含玻璃開關、模糊半徑、面板透明度、邊框強度、陰影強度。
動效與佈局
動效包括懸停、浮層進出場、消息進場、流式文字、輸入框聚焦、思考呼吸、頁面切換等，逐項 0–100。佈局 含圓角倍率、界面密度（等比縮放；密度用 zoom 實現，非整數顯示縮放時建議保持 1.00）。
背景與壁紙庫
背景支持純色 / 漸變 / 圖片 / 動態流動，另有模糊、壓暗、飽和度、流動速度。上傳過的圖留在壁紙庫，點縮略圖即換；設置裏只存圖片編號，地址按當前端口重新生成。分區着色 可在側欄、對話區、輸入框各設一色，其餘跟隨主題。
方案管理與分享
我的方案 可保存整套設置、命名、切回、刪除。分享 支持配置碼 UB1.… 複製粘貼，或導出 JSON。快捷鍵：Ctrl+Alt+B 開關，Shift+Alt+B 循環預設。恢復出廠 回到原版，已保存的自定義方案不受影響。
其它項包括護眼（低藍光暖色濾鏡，可設時段）、智能配色（從壁紙取主色生成配套配色），以及滾動條、光標、選中文字等細節。
安裝與啓用¶
插件以當前 DSH 進程權限運行，安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。社區目錄頁：skillhub.cn/plugins/zhi-jie2778/dsh-spectra（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
克隆後用 dsh 安裝¶
git clone https://github.com/zhi-jie2778/dsh-spectra.git
dsh plugin --profile desktop add link:<克隆目錄的絕對路徑>
Windows 上可用目錄聯接，便於日後 git pull 後不必重裝：
New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-spectra" `
-Target "<克隆目錄的絕對路徑>"
手動安裝¶
- 把插件目錄放到
<DSH_HOME>/profiles/<profile>/node_modules/dsh-spectra（可用目錄聯接或 symlink）。 - 在
<DSH_HOME>/profiles/<profile>/cordis.patch.yml末尾追加：
- insert:
- id: ui-beautify
name: dsh-spectra
裝完必須重啓 DSH¶
徹底退出再打開（托盤圖標右鍵 → 退出；只點窗口右上角 × 可能只是隱藏到托盤）。Loader 只在啓動時讀插件代碼，桌面端生產版沒有刷新菜單，Ctrl+R 無效。重啓後打開 設置 → 界面美化。
升級時在克隆目錄執行 git pull，同樣徹底退出 DSH 再開；設置仍在 $DSH_HOME/ui-beautify/，升級不會動它。
典型用法¶
- 重啓 DSH 後進入 設置 → 界面美化，打開總開關，界面開始應用主題。
- 在六套內置方案中選一種，或用 明暗、區域、顏色 等逐項微調。
- 需要背景時配置 背景 或 壁紙庫；若對話區設了底色，壁紙會讓位——想要壁紙需把對話區底色點回「跟隨主題」（README 已知限制）。
- 滿意後可在 我的方案 命名保存，或用 分享 生成配置碼 / 導出 JSON 給他人。
- 日常可用
Ctrl+Alt+B快速開關，Shift+Alt+B循環預設。
排查問題時，設置 → 更多 → 診斷 內有重繪壓力測試；宿主側還有 GET /plugins/dsh-spectra/diagnostics，返回版本、狀態文件路徑和最近請求記錄。
兼容性與卸載¶
選擇器只用 DSH 暴露的語義錨點（如 [data-conversation-scroll]、[data-composer-seat] 等），不依賴編譯後的哈希類名。與其它皮膚插件共存時，令牌聲明在 body[data-ub-mode] 上，優先級高於皮膚默認層；想完全交給別的皮膚就關掉本插件。
卸載步驟：
- 設置裏關掉總開關。
- 從
cordis.patch.yml刪掉上述insert塊。 - 刪除
node_modules/dsh-spectra與$DSH_HOME/ui-beautify。
結尾¶
dsh-spectra 把 DSH Web GUI 的外觀做成可開關、可預設、可細調、可分享的一套方案，適合長時間用 DSH 又希望界面更貼合個人習慣的用戶。詳情與 issue 見 GitHub，目錄入口見 SkillHub 插件頁。
