MIT 授權的 DSH 外掛:在 DeepSeek Harness Web GUI 背後即時渲染 Wallpaper Engine 的 scene、影片、網頁與圖片桌布,內建自動輪播、本機桌布庫與多級降級鏈,不需要 WE 在背景執行。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-21
授權條款
MIT
01它能幫你完成什麼?
給 DSH Web GUI 換一張真的會動的桌布
Wallpaper Engine 的 scene 桌布在瀏覽器裡即時算出來——粒子、水波、飄雲、布料擺動——DSH 介面疊在上面
整天開著 DSH 寫程式、想要動態背景而不是靜態圖的人
把影片、網頁、圖片桌布也拿來當背景,並讓它自動輪換
影片桌布循環播放、音軌跟隨「聲音」開關,網頁桌布在沙箱裡載入,圖片桌布緩慢縮放,還能依 1 / 5 / 10 / 30 分鐘順序或隨機輪播
本來就有 Wallpaper Engine 桌布庫、想把同一套桌布搬到寫程式介面上的人
某張桌布渲染不出來時,介面照樣能用
多級降級鏈:內嵌 MP4 → 擷取畫面 PNG → 作者預覽圖 → 空態,每級失敗只跳過,不彈錯也不白屏、黑畫面
桌布庫偏冷門、經常撞上複雜效果與作者腳本的使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Windows 10/11——README 裡唯一完整支援且實測過的平台
- DeepSeek Harness 0.2.x——外掛在 `engines.dsh` 宣告 `>=0.2.0-rc.1 <0.3.0`
- 本機已安裝 Wallpaper Engine——外掛要讀它的內建粒子與特效紋理,但 WE 本身不必在背景執行
- 瀏覽器支援 WebGL2(Chrome / Edge);想要最接近 WE 的觀感建議用 Chrome
安裝步驟
- 01
桌面版:打開側邊欄 **外掛** 頁 → **新增外掛**,套件名稱填 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`(GitHub)→ 按 **安裝** → 重新整理頁面
- 02
`dsh web`:執行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`
$ dsh web
- 03
重新啟動 `dsh web`,打開 GUI
$ dsh web
- 04
進入 **設定 → 側邊欄「Wallpaper 壁纸」**,填桌布資料夾(workshop)與引擎資料夾,或按 **自動偵測**——典型路徑是 `D:/Steam/steamapps/workshop/content/431960` 與 `D:/Steam/steamapps/common/wallpaper_engine`
- 05
在縮圖格中點選桌布即可生效
驗證整合成功
- `GET /wallpapers/list` 回傳 JSON 桌布陣列
- 瀏覽器 Console 出現 `[three] scene loaded id=… background=N particleLayers=M`,`M ≥ 1` 表示粒子層已建立
復原
- 執行 `dsh plugin --profile web remove "@dsh-use/wallpaper-engine"`,再 `dsh plugin --profile web install`,然後重新啟動 `dsh web`
- 桌面版在同一「外掛」頁解除安裝(會二次確認)
03DSH 整合程度與能力邊界
原生 DSH(Cordis)外掛套件:桌面版在側邊欄「外掛」頁加入 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`,網頁版用 `dsh plugin --profile web add` + `dsh plugin --profile web install` 安裝;裝好後在 DSH Web GUI 裡掛出背景層與「Wallpaper 壁纸」設定面板。
Scene 桌布即時渲染
本機 Steam workshop 資料夾裡的 scene 桌布→three.js 背景層 + 粒子 billboard,在瀏覽器裡逐格算出來
在瀏覽器裡跑 WebGL 渲染迴圈,頁面切到背景會自動暫停首次渲染成功後往 `~/.dsh-use-wallpaper/frames/` 寫一張擷取畫面的 PNG影片 / 網頁 / 圖片桌布
同一桌布庫裡的影片、網頁或圖片桌布→瀏覽器原生影片元素循環播放、沙箱網頁,或帶緩慢縮放的預覽圖
瀏覽器解不開的編碼(HEVC / H.265)會回退到預覽圖並提示原因網頁桌布在沙箱 iframe 裡載入:用區網 IP / 通道存取 GUI 時,依賴 WebGL 貼圖的會空白桌布庫與自動輪播
標題搜尋、類型篩選、僅收藏、隱藏 / 復原、最近使用排序→篩選後的桌布庫,以及 1 / 5 / 10 / 30 分鐘順序或隨機輪播
收藏、隱藏與最近使用只寫瀏覽器 localStorage,不改桌布檔案畫面、毛玻璃與光暈面板
遮罩不透明度、背景模糊、Ken Burns、畫面適配、對話區毛玻璃、光暈門檻與強度→改完立即在 DSH Web GUI 生效
桌布自帶的使用者屬性
目前桌布真正引用到的屬性(bool / slider / color / combo)→對應屬性的滑桿與取色器,提交後重新裝配桌布生效
調整屬性會重新裝配目前桌布;滑桿與取色防抖提交降級鏈與省電
載入失敗、裝配失敗或渲染不出可見物件的 scene 桌布→內嵌 MP4 → 擷取畫面 PNG → 作者預覽圖 → 空態 逐級回退,另有一鍵暫停與 0.5× 畫質檔
每一級失敗只跳過,不彈錯、不白屏系統媒體連動與開機動畫
Windows 系統媒體工作階段(SMTC),或 WE 庫 / 本機影片素材→桌布的專輯封面、歌名、歌手、主色與播放狀態即時連動;開啟 DSH 時全螢幕播一段片頭
媒體中繼資料只在記憶體裡讀取,不落盤開機動畫聲音預設開啟,播放期間桌布聲音自動靜音
04適合誰?何時不該用?
適合
- 整天開著 DSH 寫程式、想要動態背景而不是靜態圖的人
- 本來就有 Wallpaper Engine 桌布庫、想把同一套桌布搬到寫程式介面上的人
- 桌布庫偏冷門、經常撞上複雜效果與作者腳本的使用者
不適合
- 只在 Windows 10/11 上完整支援並實測過;macOS / Linux 未測試,1.0 起套件內宣告 `dsh.bundle.platforms = ["win32"]`,DSH 會在其它平台跳過此外掛並回報原因。
- 需要 DSH `>=0.2.0-rc.1 <0.3.0`;1.0 移除了 0.1.6 及更早的舊設定路徑,還在用 0.1.x 的人必須先升級 DSH 再安裝。
- 本機必須安裝 Wallpaper Engine——外掛要從安裝目錄讀內建粒子與特效紋理;沒裝或路徑沒配對時粒子會退化成純色圓點,畫面本身仍在。
05相容性、維護與安全提醒
- 只在 Windows 10/11 上完整支援並實測過;macOS / Linux 未測試,1.0 起套件內宣告 `dsh.bundle.platforms = ["win32"]`,DSH 會在其它平台跳過此外掛並回報原因。
- 需要 DSH `>=0.2.0-rc.1 <0.3.0`;1.0 移除了 0.1.6 及更早的舊設定路徑,還在用 0.1.x 的人必須先升級 DSH 再安裝。
- 本機必須安裝 Wallpaper Engine——外掛要從安裝目錄讀內建粒子與特效紋理;沒裝或路徑沒配對時粒子會退化成純色圓點,畫面本身仍在。
- 渲染能力有邊界:子粒子(子發射器)、繩索類拖尾(`ropetrail`)與滑鼠互動粒子尚未支援;多螢幕下每螢幕獨立桌布也不支援,因為外掛是單頁背景層。
MIT · 活躍維護(最新 release v1.0.2,2026-11-17)
06常見問題
怎麼在 DeepSeek Harness 裡安裝?
`dsh web` 上執行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`,然後重新啟動 `dsh web`。桌面版是另一條路:側邊欄「外掛」頁 →「新增外掛」→ 填套件名稱 → 安裝 → 重新整理頁面;README 說明 `dsh plugin` 指令對桌面 profile 會直接拒絕。
裝完在哪裡設定桌布資料夾?
在 DSH GUI 裡進 設定 → 側邊欄「Wallpaper 壁纸」,填桌布資料夾(`D:/Steam/steamapps/workshop/content/431960`)與引擎資料夾(`D:/Steam/steamapps/common/wallpaper_engine`),或按「自動偵測」,然後在縮圖格中點選。
需要 Wallpaper Engine 一直在背景執行嗎?
不需要。外掛只從你本機安裝目錄讀取 WE 內建的粒子與特效紋理,WE 不必在背景跑,也不重新散布任何第三方素材;完全沒裝 WE 時粒子會退化成純色圓點。
支援哪些 DSH 版本與平台?
DSH `>=0.2.0-rc.1 <0.3.0`——外掛在 `engines.dsh` 裡這樣宣告,1.0 也移除了 0.1.6 及更早的舊設定路徑。平台只有 Windows 10/11 完整支援並實測過,1.0 起套件內宣告 `win32`,其它平台 DSH 會跳過此外掛。
影片桌布一直是黑的怎麼辦?
通常是編碼問題。影片桌布交給瀏覽器的原生影片元素解碼,HEVC / H.265 需要系統裝有對應解碼擴充;缺擴充時外掛會回退到預覽圖並在桌布面板裡說明原因。換 Chrome 或把影片轉成 H.264 即可。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛,高效能低佔用,可愛畫素鯨魚,流暢滑鼠互動,npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座,支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒體工作臺外掛:一句話記靈感,一鍵生成指令碼、封面、配圖和分鏡
dsh-drawai
作者 fourzkw
DSH 右側欄裡的可編輯畫布 —— 加上讓模型直接改圖的兩個工具
08資料與來源
把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI
dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install
仓库根 `package.json` 已声明 `dsh.bundle`,bundle 由 `cordis.patch.yml` 自动注册
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-21。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
