前言¶
在 DSH 的日常使用裏，WebUI 與 DSH Desktop 默認提供的是同一套界面。如果你希望聊天區、設置面板、輸入框、代碼塊換成自己的顏色，或者想加入壁紙、視頻背景、毛玻璃和背景遮罩，這類外觀調整通常由插件完成。
dsh-ui-appearance 是 TQSY114514 維護的 DeepSeek Harness 外觀自定義插件。它提供主題色板、壁紙/視頻背景、毛玻璃與背景氛圍設置，所有修改即時預覽，並自動持久化；WebUI 與 DSH Desktop 均可使用。
核心功能¶
主題顏色¶
dsh-ui-appearance 提供 6 個顏色角色：
- 主色
- 背景色
- 面板色
- 輸入框色
- 文字色
- 邊框色
每個角色都支持取色器與 HEX 輸入。應用預設後，也可以繼續對這幾個顏色角色單獨微調。
壁紙背景¶
壁紙背景支持以下加載方式：
- 上傳圖片。
- 拖拽圖片。
- 粘貼圖片 URL 一鍵加載。
支持的圖片格式包括 JPG / PNG / WebP / GIF。壁紙原畫質存入 IndexedDB，不佔用 localStorage 配額。
圖片有 200MB 防呆上限。超過 4096px 的圖片會等比縮邊，並重新編碼爲 WebP；未超限的 GIF 保留動畫。
視頻背景¶
視頻背景支持 MP4 / WebM，播放時靜音循環，並與圖片背景互斥。
視頻上限爲 50MB。建議使用 H.264 MP4 或 VP8/VP9 WebM。不支持的編碼會自動降級回壁紙。
毛玻璃與半透明¶
dsh-ui-appearance 提供以下界面透明度控制：
- 面板不透明度
- 毛玻璃強度
- 輸入框不透明度
- 代碼塊不透明度
輸入框與代碼塊可以獨立調節不透明度。面板、輸入框和代碼塊都可以隨壁紙背景一起呈現半透明效果。
背景氛圍¶
背景氛圍提供三個獨立滑塊：
- 背景不透明度
- 背景模糊
- 背景遮罩
背景不透明度控制壁紙濃淡，背景模糊讓壁紙視覺上退到遠處，背景遮罩在壁紙上疊加一層輔助閱讀的蒙層。
預設與配色分享¶
dsh-ui-appearance 內置 6 套預設：
- 默認
- 午夜
- 海洋
- 森林
- 玫瑰
- 單色
預設可以一鍵應用，應用後仍可繼續微調，不會被預設鎖死。
配色分享也通過 JSON 文本完成：
- 在設置面板底部的「配色方案」區塊點擊「導出配色」。
- 複製 JSON 文本。
- 在其他瀏覽器或設備上粘貼到「導入」位置。
- 點擊「導入」後應用該配色。
即時預覽與持久化¶
所有修改即時生效，無需刷新，也無需手動保存。
設置保存在瀏覽器 localStorage。壁紙與視頻原畫質存入 IndexedDB，並向瀏覽器申請持久化存儲，降低被清理的概率。
該插件支持 WebUI 與 DSH Desktop。卸載後界面恢復默認。
安裝與啓用¶
先確認目標 profile。DSH Desktop 默認 profile 爲 desktop，Web 版通常爲 web。插件需要安裝到當前實際運行或激活的 profile。
使用 npm 安裝命令：
dsh plugin --profile <name> add dsh-ui-appearance
其中 <name> 是當前使用的 DSH profile 名稱。
如果採用源碼直裝，先克隆倉庫：
git clone https://github.com/TQSY114514/dsh-ui-appearance.git
在插件裝入當前 profile 的前提下，執行：
pnpm prepare
這會生成 lib/ 產物。之後重啓 DSH 服務，例如：
dsh web
項目資料中聲明的運行環境爲：
Node >=18
pnpm@10.34.5
典型用法¶
- 打開 WebUI，進入側欄「設置」→「通用」。
- 在「外觀」行下方找到「個性化外觀」，點擊展開。
- 點預設快速換膚。
- 使用取色器或 HEX 輸入微調 6 個顏色角色。
- 上傳或拖入壁紙/視頻，也可以粘貼圖片/視頻 URL 一鍵加載。
- 拖動背景氛圍與界面滑塊，調整不透明度、模糊、遮罩、毛玻璃等效果。
- 如果需要在其他瀏覽器或設備上恢復這套外觀，在設置面板底部的「配色方案」區塊點擊「導出配色」，複製 JSON 文本，再在目標位置粘貼並點擊「導入」。
- DSH Desktop 用戶需要把插件裝進 Desktop 實際激活的 profile，默認 profile 名爲
desktop。
適用場景與注意¶
適合在 WebUI 或 DSH Desktop 中長期使用 DSH，並希望調整界面顏色、背景、毛玻璃和遮罩效果的用戶。
使用前需要注意以下幾點：
- 設置跟隨瀏覽器。換瀏覽器或清除站點數據會丟失。
- 壁紙與視頻原畫質存入 IndexedDB。
- 圖片有 200MB 防呆上限；超過 4096px 會等比縮邊，並重新編碼爲 WebP；未超限 GIF 保留動畫。
- 視頻上限 50MB；建議使用 H.264 MP4 或 VP8/VP9 WebM；不支持的編碼會自動降級回壁紙。
- 網絡 URL 可能因防盜鏈或缺少 CORS 跨域頭導致加載失敗。
- 代碼的語法高亮文字色是獨立的語法語言配色，不隨主色變化。
- 氣泡跟隨主色，沒有獨立的氣泡顏色設置；主色未設置時保持默認淺藍白。
- 與第三方插件可能產生視覺競爭；自 v0.1.5 起，壁紙圖層沉底至
z-index: -1，用於降低層級遮擋。 - DSH 插件會由當前 dsh 進程加載並運行，安裝前請檢查源碼、依賴與許可證。本插件許可證爲 MIT。
結尾¶
dsh-ui-appearance 將 DeepSeek Harness 的外觀調整收斂到設置面板中：主題色、壁紙、視頻背景、毛玻璃、背景氛圍和配色分享都可以直接在界面中調整，修改即時生效，並自動保存。
GitHub 倉庫：
https://github.com/TQSY114514/dsh-ui-appearance
DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。本次已覈實資料未提供可覈實的目錄頁 URL，目錄頁請以實際站點展示爲準。
