DeepSeek Harness 背景圖插件 (dsh-bg-changer)

前言¶

DeepSeek Harness (DSH) 的默認界面背景固定，若需自定義視覺體驗，通常需要修改源碼或重繪。dsh-bg-changer 插件通過在設置中增加一行「背景圖」配置，允許用戶上傳本地圖片，並對圖片的佈局、透明度、模糊度以及界面自身的半透明程度進行精細調節。該插件不依賴外部構建工具，也不修改宿主源碼，旨在提供一種低侵入式的換膚方案。

核心功能¶

插件主要提供以下能力：

圖片上傳與管理
- 支持點擊或拖拽上傳。
- 兼容格式：PNG、JPEG、WebP、GIF（保留動畫）、BMP、AVIF、SVG。
- 可查看文件名、體積、格式及像素信息，支持更換或移除。
佈局與裁剪
- 提供「填充」「適應」「拉伸」「平鋪」四種模式。
- 支持縮放（50%-300%）和水平/垂直偏移（-100 至 100）。
- 預覽框與窗口同寬高比，支持在框內拖拽平移和滾輪縮放，所見即所得。
視覺效果調節
- 圖片效果：不透明度（0-100%）、模糊度（0-40px）、暗化（0-60%）。
- 界面效果：調節界面面板不透明度（默認 65%），降低此數值可讓背景圖透出，實現半透明效果。
技術特性
- 零依賴、零構建。
- 僅使用 require('react')（宿主共享模塊基線）。
- 通過 profile 插件機制註冊，不觸碰 DSH 的 src/ 目錄。

安裝與啓用¶

插件安裝與卸載通過腳本完成，支持遠程安裝和本地 link 安裝。

方式一：遠程安裝¶

dsh plugin --profile web add github:GIN0076/dsh-bg-changer

安裝後需重啓 DSH 服務並刷新頁面，進入「設置 → 通用」底部即可找到「背景圖」選項。

方式二：本地 Link 安裝¶

git clone https://github.com/GIN0076/dsh-bg-changer.git
cd dsh-bg-changer
node tools/install.cjs

驗證與卸載¶

# 驗證安裝（無需瀏覽器）
node tools/verify-bundle.cjs

# 卸載
node tools/install.cjs --uninstall

存儲與限制¶

存儲機制：所有參數存儲在 localStorage['dsh-bg-changer:config:v1']，圖片存儲在 IndexedDB dsh-bg-changer 庫的 assets['wallpaper'] 中。數據僅存在於當前瀏覽器及站點源，不隨會話或工作區變化。
已知限制：
- 界面不透明度：必須將界面不透明度調低（低於 100%）才能看到壁紙。
- 模糊擴散：模糊層向外擴張 3 倍模糊像素，以消除邊緣硬框。
- GIF 限制：超過 8MB 或最長邊超過 4096px 的 GIF 動圖不進行壓縮。
- 單圖支持：僅支持單張壁紙，不支持視頻或輪播。
- 內核限制：僅在 Chromium 內核驗證，其他內核未測試。

兼容性說明¶

插件已在 DSH v0.1.6-alpha.1 (Windows 源碼構建) + Chrome --app 模式下驗證通過。若升級 DSH 後插件失效，需檢查 settings.general.item 槽位、window.__ModuleLoader__ 協議及模塊表基線是否發生變化。