前言¶
DeepSeek Harness (DSH) 是一個插件化架構的平臺。默認的深色或淺色界面雖然實用，但在個性化定製上往往比較受限。開發者或用戶如果希望改變側邊欄的視覺風格，通常需要修改配置文件或編寫額外的樣式代碼。dsh-plugin-wallpaper 插件提供了一個更直接的解決方案，通過在側邊欄添加選擇器，讓用戶能夠快速切換壁紙並調整遮罩濃度。
插件介紹¶
該插件由開發者 shukookie 維護，專注於界面視覺的個性化。它解決的是“如何在不修改核心主題代碼的情況下，爲 DSH Web 界面增加動態背景和亮度控制”的問題。插件通過側邊欄面板管理壁紙資源，支持本地文件導入和一鍵切換，旨在降低用戶定製 UI 的門檻。
核心功能¶
- 本地圖片上傳：支持 jpg、png、webp 和 gif 格式。大尺寸圖片會在瀏覽器端被裁剪至 2560px 寬度，以保證界面流暢度。
- 遮罩濃度滑塊：提供 0% 到 100% 的滑塊控制，步長爲 5%。它會在背景圖上覆蓋一層淺色（淺色模式）或深色（深色模式）遮罩，確保文字內容清晰可見，默認濃度爲 60%。
- 一鍵切換：提供快速切換按鈕，無需打開設置面板即可循環切換下一張壁紙。
- 預設資源：內置 7 種漸變壁紙，且每種都針對明暗模式進行了單獨調色。
- 主題集成：通過
theme.overrideTokensAPI 修改主題，卸載插件後會自動恢復默認狀態。 - 明暗模式適配：遮罩層顏色會根據當前界面的明暗模式自動在白色和黑色之間切換。
安裝與啓用¶
使用官方 CLI 工具安裝該插件。安裝後需要刷新頁面或重啓 dsh web 服務以使插件生效。
dsh plugin --profile web add dsh-plugin-wallpaper
使用方法¶
- 打開壁紙面板：刷新頁面後，點擊側邊欄底部的 Wallpaper 按鈕，打開壁紙選擇器。
- 選擇壁紙：在面板中點擊預設的漸變卡片，或點擊上傳按鈕選擇本地圖片文件。
- 調整遮罩：在面板中拖動滑塊，觀察背景與文字的對比度，直至滿意。
- 快速切換：點擊面板中的 Switch 按鈕，直接切換到下一張壁紙，無需再次打開面板。
- 恢復默認：如果需要重置所有設置，點擊 Restore default 按鈕即可。
注意事項¶
- 內存存儲：上傳的圖片僅在當前頁面的內存中保存，刷新頁面或重啓服務後，本地上傳的圖片將丟失，不會寫入磁盤或上傳到網絡。
- 實現方式：插件僅通過公開的
theme.overrideTokensAPI 修改主題，不使用 DOM 欺騙等侵入性手段，確保系統穩定性。
總結¶
dsh-plugin-wallpaper 是一個輕量級的視覺定製工具。它通過側邊欄管理器、本地圖片支持和實時預覽功能，讓用戶能夠快速定製 DeepSeek Harness 的界面風格，且不會對系統性能造成負擔。
