前言¶
在 DeepSeek Harness (DSH) 的 Web 模式下，默認壁紙往往不具備持久化特性，且 localStorage 的作用域包含協議、主機和端口。如果 Web 服務器端口發生變化，已保存的壁紙設置可能會失效。dsh-wallpaper 插件解決了這一痛點，它爲 Web 配置文件提供了持久化的自定義壁紙能力，並修復了端口相關問題。
插件介紹¶
該插件由 Frog755 維護，採用 MIT 許可證。它爲 DSH Web 配置文件添加了一個持久化的壁紙設置項，允許用戶選擇本地圖片或視頻作爲背景。插件利用本地存儲和文件系統來保存壁紙數據，確保重啓後設置依然存在。
核心功能¶
- 持久化存儲：壁紙設置和文件存儲在本地
~/.dsh/wallpapers目錄，數據同時也保存在瀏覽器的localStorage中。 - 媒體支持：支持本地圖片和 MP4 視頻文件（最大 300MB）。
- 視覺調整：提供“表面透明度”和“壁紙模糊度”調節選項。
- 視頻處理：
- 視頻靜音並自動循環播放。
- 如果系統安裝了
ffmpeg和ffprobe，視頻會被壓縮爲 H.264 格式（目標約 18MB，1080p 分辨率，30fps），音頻被移除；否則保留原文件。
- 端口鎖定：Bundle 補丁將 Web 服務器端口鎖定在 9191，以防止因端口變化導致
localStorage作用域改變而丟失壁紙。
安裝與啓用¶
安裝完成後需要重啓 dsh web 進程以加載新的 Bundle 補丁。
1. 安裝官方插件
dsh plugin --profile web add -w @frog755/dsh-wallpaper
2. 本地開發安裝
如果在克隆的倉庫根目錄進行開發，運行：
dsh plugin --profile web add -w .
3. 啓用與配置
安裝後重啓 dsh web，進入 設置 -> 通用 -> 壁紙。在此處選擇本地圖片或視頻文件，並調整透明度和模糊度。
注意事項¶
- 端口占用：插件默認將 Web 服務器鎖定在 9191 端口。如果該端口被佔用，需要停止佔用進程或修改
cordis.patch.yml文件中的端口配置。 - 視頻壓縮：視頻壓縮功能依賴於
ffmpeg和ffprobe，且需確保它們在 DSH Host 進程的PATH中。 - 依賴管理：插件依賴 Peer Dependencies（如
react ^18.2.0、@deepseek-ai/cordis ^4.0.1等），這些由 DSH Host 提供，無需手動安裝。 - 數據清理：更換或刪除壁紙時，舊的本地文件會被刪除；啓動時也會自動清理未引用的舊壁紙視頻。
總結¶
dsh-wallpaper 是一個專注於界面個性化的實用工具。通過持久化存儲和端口修復，它解決了 DSH Web 模式下壁紙配置不穩定的問題。對於需要深度定製 Web 界面的用戶，這是一個可靠的解決方案。
