前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於 Web GUI 用戶而言，保持沉浸式的編碼環境往往比靜態背景更有價值。本插件旨在解決這一需求，它通過在瀏覽器中實時渲染 Wallpaper Engine 的場景文件，讓動態壁紙（粒子、水波、雲卷等）成爲 DeepSeek Harness 的背景，而無需在後臺運行完整的 Wallpaper Engine 應用程序。

這是什麼¶

這是一個爲 DSH Web GUI 設計的插件，由用戶 yu502950715yang 維護，採用 MIT 許可證。

它將 Wallpaper Engine 的 scene（場景）壁紙遷移到瀏覽器環境中，利用 WebGL 進行實時計算。插件不依賴 Wallpaper Engine 的運行時，也不重新分發任何第三方素材，而是直接讀取用戶本機安裝的壁紙文件和引擎資源。

核心能力¶

該插件提供以下能力：

1. 實時場景渲染：在瀏覽器中實時計算壁紙背景與粒子系統，還原原作者設定的縮放、透明度與亮度。
2. 完整粒子效果：支持雪、雨、花瓣、火星、霧、氣泡等粒子效果，包含重力、風向、湍流、壽命及顏色漸變。
3. 紋理解壓支持：支持主流壓縮格式（DXT1/3/5、RGBA、R8、RG88）及多幀精靈動畫（火把、霧、光暈）的解壓，不出現糊圖或黑邊。
4. 多格式支持：支持視頻循環播放、網頁壁紙（沙箱加載）以及圖片壁紙（預覽圖 + 緩慢縮放動效）。
5. 動態特效：常見特效會動，包括水波、漣漪、雲飄、植物擺動、脈衝等。
6. 文本對象顯示：壁紙中的時間/日期文本對象會實時顯示（如 VHS 時間與日期）。
7. 性能優化：支持一鍵暫停壁紙與自動暫停後臺渲染；畫質檔位可降至 0.5× 以節省顯存。
8. 容錯機制：任何壁紙渲染失敗時，會自動退回預覽圖，確保界面可用。
9. 自動探測：自動探測 Steam 壁紙目錄（通過註冊表、Steam 庫配置及常見路徑）。

安裝與啓用¶

根據使用的環境，選擇相應的安裝方式。

CLI 安裝（推薦）¶

在終端中執行以下命令添加插件：

dsh plugin --profile web add github:yu502950715yang/dsh-use-wallpaper

安裝完成後，刷新 Web GUI 即可生效。

桌面版 App 安裝¶

桌面版 App 不能使用上述 CLI 命令（desktop profile 由 App 獨佔管理）。

1. 打開桌面版，點擊側邊欄的 插件 頁面。
2. 點擊 添加插件。
3. 在包名框中輸入：
   • GitHub 方式：github:yu502950715yang/dsh-use-wallpaper
   • npm 方式：@dsh-use/wallpaper-engine
   • 本地開發方式：填寫本地倉庫的絕對路徑（如 E:/code/dsh-use-wallpaper）。
4. 點擊 安裝 並刷新頁面。

本地開發¶

如果在本地修改代碼以即時生效，可以使用鏈接安裝：

dsh plugin --profile web add link:E:/code/dsh-use-wallpaper

配置與使用¶

安裝完成後，需要在設置中配置路徑並選擇壁紙。

1. 啓動 dsh web 並打開 GUI。
2. 進入 設置，在側邊欄找到 Wallpaper 壁紙。
3. 填寫 壁紙目錄（Steam workshop 內容路徑）與 引擎目錄（Wallpaper Engine 安裝目錄），或點擊 自動探測。
   • 典型路徑示例：
     • 壁紙目錄：D:/Steam/steamapps/workshop/content/431960
     • 引擎目錄：D:/Steam/steamapps/common/wallpaper_engine
4. 在縮略圖網格中選擇壁紙即可生效。

常用功能：
* 畫質檔位：在設置中調整 qualityScale（0.5–1），數值越小越省顯存。
* 暫停控制：通過面板開關暫停壁紙渲染，或啓用切後臺自動暫停。

注意事項¶

1. 桌面版限制：桌面版 App 禁止使用 dsh plugin CLI 命令，插件管理必須在 App 界面內完成。
2. 兼容性：舊版 DSH（≤0.1.6）有兼容層，新版（0.1.7-alpha.1 起）已適配新的設置系統。
3. 視覺異常：部分壁紙（尤其是帶複雜遮罩或特殊混合方式的）可能出現黑塊；模糊、光軸等特效可能在特定對象上不可見。
4. 沙箱執行：文本腳本在沙箱環境中執行，不會影響主進程。
5. 構建產物：發佈包僅包含 lib、dist 和 cordis.patch.yml，安裝後無需本地構建。

結尾¶

該插件通過瀏覽器原生能力實現了 Wallpaper Engine 場景的實時復現，爲開發者提供了動態的編碼背景。更多詳情、目錄索引及源碼請訪問其 GitHub 倉庫 或 技能社區目錄。