前言¶
DSH 可以通過插件擴展 DSH Web 的功能。下面介紹 leavestring/awesome-dsh-background-plugin，一個由 leavestring 維護的 DSH 背景設置插件。
它爲 DSH Web 提供可上傳圖片 / 預設氛圍的背景設置，設置持久化，重啓不丟失。如果你希望在 DSH Web 中調整工作區背景，它把背景調整放到設置入口裏：可以上傳 JPG / PNG / WEBP / GIF，也可以切換到極光、餘燼、宣紙三種預設氛圍，並在設置面板內即時預覽。
這是什麼¶
awesome-dsh-background-plugin 是 DSH 插件，許可證爲 MIT。資料中當前版本爲 0.1.9。
它解決的問題是：在 DSH Web 中提供一個背景設置項，用於調整背景圖片、預設氛圍和顯示參數。
已覈實的能力包括：
- 支持上傳圖片，並在瀏覽器本地處理，不發送給第三方圖片服務。
- 支持三種預設氛圍一鍵切換。
- 支持圖像存在感、暗色遮罩、柔焦、適配方式、焦點位置五維細調。
- 設置面板內即時預覽，所見即所得。
- 設置持久化，重啓不丟失。
- 支持中文 / English 雙語界面。
- 淺色 / 深色主題下正常工作。
核心功能¶
圖片上傳與本地處理¶
插件支持上傳 JPG / PNG / WEBP / GIF 圖片。
圖片在瀏覽器本地壓縮，長邊 ≤ 1600px，輸出爲 WEBP。圖片在瀏覽器本地處理，不發送給第三方圖片服務。
預設氛圍¶
支持三種預設氛圍：
- 極光
- 餘燼
- 宣紙
點一個預設即可切換。
顯示參數細調¶
支持五維細調：
- 圖像存在感
- 暗色遮罩
- 柔焦
- 適配方式
- 焦點位置
這些參數可以在設置面板內拖動預覽，所見即所得。
持久化與移除¶
設置持久化，重啓不丟失。上傳自動持久化自 0.1.6 及以上版本提供；資料中當前版本爲 0.1.9。
想移除背景時，可以關閉「已啓用」開關，或點擊「恢復默認」。資料說明關閉「已啓用」開關或點擊「恢復默認」即可完全移除。
安裝與啓用¶
資料中同時給出一鍵安裝命令與手動安裝流程，安裝方式不止一種。先準備環境，再按資料中的流程安裝。
環境要求¶
Node.js ≥ 18
pnpm
DSH
獲取代碼¶
倉庫地址：
https://github.com/leavestring/awesome-dsh-background-plugin
一鍵安裝¶
在倉庫目錄中運行：
node scripts/install.mjs
手動安裝¶
手動安裝命令引用本地插件包 awesome-dsh-background-plugin-0.1.9.tgz。按資料中的手動流程準備好該文件後，運行：
dsh plugin --profile web add ./awesome-dsh-background-plugin-0.1.9.tgz
該命令將插件安裝到 web profile。
白名單配置¶
必須把 ui-background 加入 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名單，否則保存會被拒絕。
涉及的命名空間和字段如下：
ui-background
WEB_SETTINGS_NAMESPACES
重啓與刷新¶
安裝後需完全停止並重啓 DSH。瀏覽器可能需 Ctrl+F5 強制刷新。
經過上面的步驟，打開：
設置 → 通用設置 → 背景
即可看到背景設置。
典型用法¶
1、打開 設置 → 通用設置 → 背景。
2、點一個預設，或上傳一張圖片。上傳後立即生效並持久化，無需點保存。
3、拖動「圖像存在感 / 暗色遮罩 / 柔焦」滑塊即時預覽，滿意後點 保存背景 持久化參數。
4、想移除背景：點 恢復默認，或關閉「已啓用」開關後保存。
適用場景與注意¶
適合使用 DSH Web、希望調整背景外觀、並偏好本地圖片處理的開發者。安裝前建議先檢查源碼與許可證；插件以當前 dsh 進程權限運行。
需要注意：
- 資料中當前版本爲
0.1.9，上傳自動持久化自0.1.6及以上版本提供。 - 若未配置
ui-background白名單，保存會被拒絕。 - 安裝後需完全停止並重啓 DSH，瀏覽器可能需
Ctrl+F5強制刷新。 - 社區目錄頁是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
