前言¶
DSH 的插件機制允許在 Web 界面中擴展能力。對 dsh web 來說，背景通常由宿主樣式決定；如果希望把 Wallpaper Engine 的 .mpkg、Steam 創意工坊原始目錄、本地視頻/網頁/圖片作爲背景，就需要一個專門處理背景加載和外觀適配的插件。
下面介紹 dsh-mpkg-wallpaper。
這是什麼¶
dsh-mpkg-wallpaper 是 XHR666 維護的 DSH Web 壁紙引擎插件，用於給 DeepSeek Harness Web 界面（dsh web）添加背景壁紙。它把 Wallpaper Engine .mpkg 解析、Steam 創意工坊原始目錄發現、視頻/網頁/圖片壁紙、時間變化壁紙、虛化、主題外觀、本地壁紙庫、輪換、播放控制、設置持久化和更新檢查放在一個插件裏。
- 倉庫：GitHub: XHR666/dsh-mpkg-wallpaper
- 許可證：
MIT - 運行環境：
node >=20
核心能力¶
壁紙來源¶
.mpkg：在瀏覽器內直接解析，不上傳第三方。- Steam 創意工坊原始目錄：自動發現，支持
video、web、scene類型。 - 普通壁紙：支持視頻、網頁、圖片/GIF/URL 壁紙加載。
時間變化壁紙¶
支持時間變化壁紙的多時段自動切換，也支持手動鎖定某個時段。
虛化與外觀¶
- 統一虛化控制整屏背景模糊。
- 對話框、設置面板、彈層、遮罩、側邊欄等可獨立控制虛化。
- 提供主題顏色、統一霧、面板匹配壁紙色等玻璃外觀能力。
- 液態玻璃仍爲實驗性功能，默認全關，不建議日常啓用。
壁紙庫與輪換¶
支持本地壁紙庫、自定義目錄、壁紙切換與定時輪換。可以使用上一個/下一個切換壁紙，也可以設置定時自動輪換。
播放控制與省電¶
- 視頻/網頁壁紙支持暫停/播放控制。
- 調整無關設置不觸發重播。
- 可開啓頁面隱藏時暫停、窗口失焦時暫停、電池供電時暫停三檔省電策略。
大文件播放¶
支持大文件 hybrid 模式流式播放，支持大於 600MB 的文件。
設置與更新¶
- 設置會持久化到瀏覽器
localStorage與~/.dsh-mpkg-wallpaper/settings.json。 - 支持導出/導入外觀類設置 JSON 文件，用於備份與恢復。
- 支持「檢查更新」按版本號對比，以及「一鍵更新」從 GitHub 拉最新代碼並重啓生效。
- 可檢測並適配
dsh-better-sidebar。
安裝與啓用¶
已覈實資料未給出官方安裝命令，本文不拼接安裝命令。啓用前請先查看倉庫說明或插件目錄說明，並確認運行環境滿足：
node >=20
由於插件會在 DSH 的 Web 界面中執行本地邏輯，安裝前應檢查源碼、依賴和許可證。
典型用法¶
1、進入設置頁後，可在「可調參數」摺疊區查看 .mpkg 的只讀參數；部分網頁壁紙的分辨率、語言、音量等參數可在同一摺疊區修改。
2、當前壁紙爲視頻或網頁壁紙時，點擊設置頁的暫停/播放按鈕控制畫面；調整無關設置不會重播。
3、在「其他」tab 中開啓頁面隱藏時暫停、窗口失焦時暫停、電池供電時暫停。
4、在「其他」tab 中導出或導入外觀類設置 JSON 文件。
5、使用上一個/下一個切換壁紙，或設置定時自動輪換。
6、使用「檢查更新」按版本號對比，或使用「一鍵更新」從 GitHub 拉最新代碼並重啓生效。
適用場景與注意¶
適合想在 dsh web 中使用 Wallpaper Engine 壁紙、本地視頻/網頁/圖片背景，並需要控制虛化、主題外觀、輪換和省電策略的用戶。
注意：
- 網頁壁紙（HTML）爲實驗性，部分依賴外網 SDK/特殊交互邏輯的壁紙未完全適配。
Application（.exe）壁紙被完全排除，用於防病毒注入。- 場景壁紙無法在 Web 端完整還原，僅提供靜態幀提取或圖層合成折中方案。
- 瀏覽器兼容性參考：Chrome/Edge 推薦；Firefox/移動端可能受自動播放策略、性能或 API 支持限制。
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
獲取¶
GitHub 倉庫：https://github.com/XHR666/dsh-mpkg-wallpaper
目錄頁 URL 未在已覈實資料中出現；社區目錄屬於獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應視爲官方應用商店。
