前言¶
DeepSeek Harness（DSH）採用插件化架構，其默認界面以實用爲主。對於需要更沉浸式視覺體驗的開發者或用戶而言，單一的純色或默認背景往往不夠。dsh-wallpaper 插件通過本地化資源支持，允許用戶將本地圖片和視頻設置爲 DSH 應用窗口的背景，同時保留操作界面的可讀性。
該插件由社區開發者 deepseaandhighsky-arch 維護，目前處於預發佈候選版本（v0.3.0-rc.7）階段。
核心功能¶
本地媒體支持¶
插件支持多種本地靜態和動態格式：
* 圖片：PNG、JPG、WebP。
* 視頻：H.264 編碼的 MP4 和 WebM 格式。
獨立設置與控制¶
- 設置分類：在 DSH 的設置菜單中，新增了獨立的“壁紙背景”分類。
- 分區不透明度控制：提供四個獨立的滑塊，分別控制“聊天正文”、“左側欄”、“頂部導航”和“輸入框”的底色不透明度。調節互不干擾，不會影響文字本身的顯示，也不會降低整張壁紙的可見度。
- 雙模糊調節：
- 壁紙自身模糊：對背景圖片/視頻畫面本身應用模糊。
- 面板磨砂強度：對 UI 面板（側欄、導航等）應用磨砂效果，使文字在背景上更清晰。
- 側欄視覺修復：啓用壁紙時，自動移除側欄底部的白色漸隱遮罩和硬截斷線，優化滾動體驗。
可恢復性與對比¶
- 一鍵恢復：關閉插件時自動撤銷樣式變更。
- A/B 對比：在調整滑塊或應用預設時，插件會自動記錄修改前的狀態。用戶可以實時預覽“修改前”與“當前”的效果，並通過“一鍵恢復”功能回到基準狀態。
- 外觀預設：提供“閱讀”、“均衡”、“沉浸”及自定義預設，一鍵應用多組參數配置。
本地隱私¶
- 所有壁紙文件存儲在瀏覽器的 IndexedDB 中。
- 外觀偏好和自定義預設存儲在 localStorage 中。
- 數據僅保存在本地客戶端，不上傳至遠端。
安裝與啓用¶
當前版本爲預發佈候選版（v0.3.0-rc.7），安裝方式如下：
方式一：通過 CLI 安裝¶
在終端中執行以下命令：
dsh plugin add github:deepseaandhighsky-arch/DSH-Wallpaper#v0.3.0-rc.7
方式二：通過 UI 界面安裝¶
- 打開 DSH 應用。
- 進入 插件 -> 添加插件。
- 輸入安裝地址：
github:deepseaandhighsky-arch/DSH-Wallpaper#v0.3.0-rc.7。 - 或者選擇本地的
.tgz文件進行安裝。
典型用法¶
- 導入媒體：通過插件設置界面導入本地圖片或視頻文件。
- 調整參數：拖動“分區不透明度”滑塊，調整聊天區域與側欄的底色深淺。
- 應用預設：選擇“沉浸”或“均衡”預設，或手動調整模糊與磨砂強度以獲得最佳閱讀體驗。
- 對比驗證：在調整過程中，利用 A/B 對比功能查看效果差異。
適用場景與注意¶
- 版本狀態：目前僅爲 v0.3.0-rc.7 預覽候選版，官方 Desktop 端的視覺驗收仍在進行中，部分功能可能存在適配問題。
- 技術限制：官方 DSH 暫未提供
shell.background插槽，該插件通過shell.overlay+ Portal 實現，若 DSH 調整佈局，部分區域可能需要重新適配。 - 視頻播放：視頻播放依賴 Chrome/Electron 的解碼能力以及 IndexedDB 的存儲配額。
- 隱私聲明：該插件爲非官方第三方插件，與 DeepSeek 無隸屬或認可關係。
總結¶
dsh-wallpaper 爲 DSH 用戶提供了靈活的本地化視覺定製能力。通過獨立控制不透明度、磨砂強度以及提供完善的對比與恢復機制，它在不改變系統壁紙的前提下，顯著提升了應用窗口的個性化程度。
