dsh-we-wallpaper: 將 Wallpaper Engine 壁紙庫接入 DSH Web GUI

前言¶

DeepSeek Harness (DSH) 是一套用於構建 LLM 智能體的模塊化框架，其 Web GUI 提供了可視化的操作界面。對於習慣使用 Wallpaper Engine 的用戶，默認的 DSH 界面顯得較爲單調。dsh-we-wallpaper 插件解決了這個問題，它允許將你本地的 Wallpaper Engine 壁紙庫直接映射到 DSH 的 Web GUI 背景中。

這是什麼¶

這是一個將 Wallpaper Engine 壁紙庫作爲 DeepSeek Harness (DSH) Web GUI 背景的插件。它支持視頻、Web、圖片和場景壁紙，並提供了相應的配置與緩存優化機制。

核心功能¶

多類型壁紙支持
- 視頻：作爲循環靜音的 <video> 元素播放，保持原生分辨率。
- Web：在沙盒化、點擊穿透的 <iframe> 中渲染。
- 圖片：直接顯示。
- 場景：首次加載時通過 Wallpaper Engine 渲染並錄製爲 12 秒 H.264 循環視頻緩存，後續加載直接使用緩存。
場景緩存機制
場景壁紙首次生成時，會在前臺展示約 15 秒以生成高清動畫緩存。後續啓動的 DSH 會直接讀取 ~/.dsh/we-wallpaper-cache/ 中的緩存文件，不再使用低分辨率的 160px Workshop 預覽圖。
插件配置界面
在 DSH 的 設置 → 插件配置 中新增“動態壁紙”卡片。支持瀏覽庫、實時預覽、搜索壁紙、一鍵應用，並顯示當前桌面正在運行的壁紙狀態。
閱讀性與性能
- 提供暗色遮罩、面板半透明、覆蓋/包含適配模式以及銳化控制。
- 資源友好：媒體元素複用，拖動進度條不會重啓視頻流。
- 持久化：壁紙選擇存儲在 ~/.dsh/we-wallpaper.json。

安裝與啓用¶

插件支持通過 profile 熱插拔方式安裝，無需修改 dsh 源碼。

git clone https://github.com/pbadgpmeb22791-sketch/dsh-we-wallpaper.git
dsh plugin --profile desktop add "<repository-path>\new"

安裝後，重啓或熱重載 DSH 主機，刷新 Web GUI 頁面，進入 設置 → 插件配置 → 動態壁紙。

注意事項¶

運行環境要求：HD 動畫緩存生成需要 Windows 桌面 Harness 和正在運行的 Wallpaper Engine。
交互時長：首次生成場景壁紙時，Wallpaper Engine 場景窗口會臨時置頂約 15 秒。
音頻策略：出於瀏覽器自動播放策略，音頻默認靜音。
安全策略：每個路由都拒絕跨站請求（CSRF 保護）；Web 壁紙在沙盒化 iframe 中運行。
透明度覆蓋：該插件的透明度設置會覆蓋官方的 --dsw-alias-* 代幣，可能影響依賴這些代幣的第三方插件。

短結尾¶

該插件爲 DSH Web GUI 提供了高度個性化的背景定製能力，無需離開 DSH 生態即可享受 Wallpaper Engine 的動態效果。項目維護者爲 pbadgpmeb22791-sketch。

GitHub: https://github.com/pbadgpmeb22791-sketch/dsh-we-wallpaper