前言¶
DeepSeek Harness (DSH) 採用插件化架構，默認工作區背景往往較爲單調。在長時間進行智能體開發或對話時，一個貼合場景的背景能提升沉浸感。dsh-scenery 旨在通過視覺疊加的方式，爲 DSH 工作區注入環境氛圍，而不改變原有的 UI 佈局和交互邏輯。
插件簡介¶
dsh-scenery 是一個由 wbaws 維護的背景類插件。它模擬了 Capy 風格的環境背景：選取一張圖片後，插件會將其與巨大的底部黑色漸變以及環繞編輯器的柔和徑向光暈進行合成，使 UI 看起來像是“置身於場景之中”，而非浮在平色之上。該插件僅做加性疊加，不觸碰現有 UI、佈局和交互行爲。
核心功能¶
- 環境背景：爲 DSH 工作區提供氛圍感背景。
- 圖像支持：支持本地上傳圖片（通過 PUT 存儲在用戶 DSH 主目錄）或直接粘貼圖片 URL。
- 圖像控制：支持 fit（cover/contain/fill）、pan（位置 X/Y）、zoom（縮放）、blur（高斯模糊）以及整體透明度控制。
- 底部漸變：生成一個巨大的底部黑色線性漸變，平滑過渡，無色帶。
- 編輯器光暈：在編輯器周圍生成一個徑向光暈，該光暈會自動跟蹤真實的編輯器座位（粘性底部欄）。
- 實時預覽：內置獨立頁面
preview/index.html，可在瀏覽器中獨立預覽和微調視覺效果。 - 持久化：配置和壁紙文件存儲在
~/.dsh/dsh-scenery/config目錄下。 - 重置功能：提供一鍵重置設置和清除當前圖片的功能。
安裝與啓用¶
通過官方 CLI 安裝：
dsh plugin --profile desktop add dsh-scenery
安裝完成後，重啓或重新加載 DSH，進入 Settings → Scenery background，選擇一張圖片並開啓 Enable 開關。
典型用法¶
- 啓動 DSH 並確保已安裝
dsh-scenery。 - 打開設置菜單，找到 “Scenery background” 區域。
- 上傳一張本地圖片或輸入圖片 URL。
- 根據需要調整 Fit、Position、Zoom、Opacity 等參數。
- 如需精細調整，可打開插件目錄下的
preview/index.html進行離線預覽和調試。
適用場景與注意¶
- 加性疊加：該插件僅在對話列後添加一個點擊穿透層，不重新設計 UI，不改變現有組件的佈局。
- 權限要求：插件以當前 DSH 進程權限運行，需要 DSH 配置文件支持客戶端插件系統（與
dsh-pet、dsh-better-sidebar等同類插件一致）。 - 存儲路徑：配置持久化路徑爲
~/.dsh/dsh-scenery/config，壁紙文件存儲在對應目錄或$DSH_HOME/dsh-scenery/下。 - 許可證：MIT 許可證。
總結¶
dsh-scenery 提供了一種低侵入式的視覺增強方案。如果你希望在保持 DSH 原生交互體驗的同時，爲工作區增添一點氛圍感，這個插件是合適的工具。
