DSH 的插件化架構允許開發者擴展功能，視覺層面的定製通常需要修改代碼或使用複雜的主題配置。sz1698/dsh-bg-new 專注於解決網頁界面的背景定製問題，它不依賴雲端服務，而是通過本地媒體伺服和即時渲染，讓用戶能夠快速更換系統預設、純色、漸變、圖片或視頻作爲背景。
這是一個給 DeepSeek Harness 網頁界面換背景的插件。作者爲 sz1698，開源協議爲 MIT。它通過側欄入口和抽屜式 UI，支持系統預設、純色、漸變、圖片和視頻五種背景模式，並包含本地媒體伺服、毛玻璃質感及模型指令工具。
核心功能¶
- 五種背景模式：支持系統預設、純色、漸變、圖片和視頻（支持本地文件或遠程鏈接）。
- 抽屜式交互：點擊側欄（Settings 上方）的「壁紙」按鈕喚起右側抽屜。抽屜打開時，左側欄與聊天區會自動收起並降低透明度，專注背景調整；點擊抽屜外部即可關閉。
- 縮放與定位：針對小圖，支持鼠標滾輪縮放和拖動定位。拖動指針在圖片外時有 2 秒寬限，超時才釋放。
- 適配與焦點：提供 fill / cover / contain 等 5 種適配模式，並支持水平和垂直焦點調整，另有自由縮放與放大聚焦選項。
- 毛玻璃質感：可讓面板、氣泡和輸入框呈現半透明磨砂表面。
- 動態壁紙：支持本地 MP4 循環播放，可靜音或調節音量，視頻文件大小無限制。
- 模型指令工具：提供
bg_apply工具，模型可以直接通過指令修改背景（例如“把背景換成深藍”或“用這張圖做壁紙”）。 - 文字方案：支持根據背景亮度自動推斷文字顏色，也允許手動指定亮色或暗色方案。
- 本地化存儲：上傳的圖片和視頻僅保存在本機數據目錄，由插件自己的路由伺服，不會上傳到任何雲端服務。
安裝與啓用¶
前置條件：已安裝 DSH 並能正常運行 dsh web。
方式一：git 通道¶
dsh plugin --profile web add github:sz1698/dsh-bg-new
如果 dsh 命令不在 PATH 中：
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add github:sz1698/dsh-bg-new
安裝完成後，需要重啓應用或 dsh web，再刷新瀏覽器即可生效。
方式二：本地 clone（開發 / 自用）¶
git clone https://github.com/sz1698/dsh-bg-new.git
cd dsh-bg-new
npm install && npm run build
dsh plugin --profile web add .
典型用法¶
通過界面操作：
點擊側欄的「壁紙」按鈕，在彈出的右側抽屜中選擇背景類型進行配置。支持滾輪縮放圖片，拖動調整位置。
通過模型指令：
在對話框中輸入“把背景換成深藍”或“用這張圖做壁紙”，由 bg_apply 工具執行。
bg_apply 工具參數：
支持顏色、漸變、圖片、視頻、本地文件、關閉。
注意事項¶
- 這是非官方社區插件，請使用前自行評估兼容性與安全性。
- 所有媒體文件僅保存在本地，不會上傳到雲端服務。
- 插件版本爲 0.7.0。
總結¶
該插件通過側欄抽屜和本地媒體伺服，在不依賴雲端的情況下提供了靈活的背景定製能力。適合希望深度自定義 DSH 網頁界面視覺體驗的用戶。
