前言¶
DeepSeek Harness（DSH）桌面版每次啓動會換本地端口，頁面 origin 隨之變化，localStorage 與 IndexedDB 無法長期保存外觀偏好。若只在瀏覽器裏改 CSS 或臨時換膚，重啓後往往回到默認界面。社區插件 dsh-background-studio（維護者 SoulZhou，分類：趣味換裝）在宿主側持久化設置，並在設置裏註冊獨立「背景」頁，不替換原生設置、不改動 DSH 組件，只通過 html 上的 data-dsh-qbg* 屬性與少量主題 token 覆蓋實現多風格背景。
這是什麼¶
dsh-background-studio 是面向 DeepSeek Harness 的多風格背景插件：提供 6 套可切換配色、本地自定義圖片或任意純色，可調背景不透明度與「面板透出」，並隨 DSH 淺色 / 深色主題自動切換各套背景的深淺版本。源碼與說明見 GitHub：SoulZhou/dsh-background-studio；社區目錄頁：SkillHub - dsh-background-studio。當前 package 版本爲 0.3.2，許可證 MIT，依賴 Node >=20。
核心功能¶
六套內置背景¶
六套風格分別爲：曜石、極光、星雲、藍圖、燕麥、櫻霧。每套都有深色與淺色兩版，隨 DSH 外觀模式切換。背景層由漸變光暈、網格、噪點與緩慢漂移組成；用戶開啓 prefers-reduced-motion 時動畫會停止。
自定義背景圖¶
可在設置頁選擇或拖入本地圖片，支持鋪滿、適應、平鋪；可隨時停用圖片但保留文件。單張上傳上限 24 MB，類型按文件頭嗅探，僅接受 JPEG / PNG / WebP / GIF。超過 2560px 或 1.2 MB 時會在瀏覽器內先壓縮爲 WebP（失敗則回落 JPEG），再寫入宿主磁盤；圖片只留在本機，不上傳網絡。
純色背景¶
提供取色器、HEX 輸入與 8 個快捷色。開啓後會蓋住風格背景與自定義圖，關閉即恢復。若重新選擇任一風格或啓用圖片，會自動退出純色模式。
不透明度與光暈¶
「光暈強度」可選輕 / 標準 / 濃。「背景不透明度」爲 0–100% 滑塊：100% 時背景完全可見，調低逐漸淡出，0% 回到 DSH 原生外觀；設置頁頂部預覽會同步變化。從 0.2.0 升級需注意：舊字段「背景透明度」語義相反（100% 表示完全隱去）；0.2.1 起改爲「背景不透明度」，舊配置裏的 transparency 讀取時會視爲 opacity: 100，升級後背景會先完全顯示。
面板透出與浮層¶
開啓「面板透出」時，側欄、主畫布與 Windows 標題欄會透出背景：側欄不再疊半透明主題色，也沒有毛玻璃模糊。關閉後恢復實色面板。開啓透出時，菜單、下拉、提示氣泡等浮層改用不透明主題面板色（淺色 #fff / 深色 #2c2c2e），並關閉毛玻璃，避免壁紙混進浮層導致文字對比度不足。0.3.1 起將透明表面變量從 body 收窄到 #root，並給浮層不透明底色；0.3.2 鎖定原生 <select> / <option> 的 color-scheme 與文字色，避免深色主題下出現白底近白字、選項不可見的問題。
設置存儲位置¶
桌面版端口變化導致頁面側存儲不可靠，因此配置與圖片均放在宿主目錄：
~/.dsh/background-studio/
settings.json 主題、純色、不透明度、面板透出、填充方式等
image.json 圖片元數據（名稱、尺寸、類型、版本號）
background.<ext> 圖片本體
頁面啓動時先讀本地鏡像立即上色，再向 /dsh-background-studio/api/state 拉取權威值並覆蓋。
安裝與啓用¶
在 PowerShell 中執行（命令來自項目 README）：
dsh plugin --profile desktop add github:SoulZhou/dsh-background-studio
該命令會把包寫入 profile 的 dependencies，並因聲明瞭 dsh.bundle.patch 而寫入 dsh.profile.bundles。安裝後需要完全退出並重新打開 DeepSeek Harness：桌面 profile 由 Electron 管理，運行中的窗口不會熱加載新 bundle，宿主 API 路由也要隨進程重啓才註冊。重啓後打開 設置 → 背景。
從其他機器安裝可先打包再添加：
pnpm pack
dsh plugin --profile desktop add .\dsh-background-studio-0.3.2.tgz
本地開發可鏈接源碼目錄（示例路徑以 README 爲準）：
dsh plugin --profile desktop add "D:\Documents\deepseek-harness\default-workspace\dsh-background-studio"
卸載：
dsh plugin --profile desktop remove dsh-background-studio
卸載後 ~/.dsh/background-studio/ 仍會保留，可手動刪除。
典型用法¶
- 按上文命令安裝並重啓 DSH，進入 設置 → 背景。
- 在六套風格中選一套，按需調整光暈強度與背景不透明度滑塊，觀察頁頂預覽。
- 需要壁紙時拖入或選擇本地圖片，設置鋪滿 / 適應 / 平鋪；暫不用時可停用圖片而不刪文件。
- 需要統一色塊時開啓純色模式；若要恢復漸變或圖片，選風格或重新啓用圖片即可。
- 若希望側欄與主區域看到底圖，開啓「面板透出」；若浮層可讀性有問題，可關閉透出或依賴插件對菜單表面的不透明處理（見 README 版本說明）。
宿主側提供三條同源 API（供界面讀寫，一般無需手調）：GET /dsh-background-studio/api/state、PUT /dsh-background-studio/api/settings、GET/POST/DELETE /dsh-background-studio/api/image。
適用場景與注意¶
適合長期在 DSH 桌面版工作、希望界面有辨識度又不改核心 UI 結構的開發者。插件在當前 DSH 進程權限下運行，會讀寫 ~/.dsh/background-studio/ 並在本地 Web 服務註冊路由；安裝前應閱讀 源碼倉庫 與 MIT 許可證，自行評估是否滿足環境要求。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區維護的趣味換裝類插件，並非官方應用商店內置項。
結尾¶
dsh-background-studio 把多套漸變背景、本地壁紙、純色與不透明度收斂到單獨設置頁，並把持久化放在宿主目錄，規避桌面版 origin 變化帶來的配置丟失。需要細節與截圖時可查閱 GitHub README 與 SkillHub 目錄頁。
