返回目錄

dsh-use-wallpaper

精選清單收錄維護狀態: 活躍

yu502950715yang/dsh-use-wallpaper

把 Wallpaper Engine 動態桌布搬進 DeepSeek Harness 的 Web GUI:瀏覽器內即時渲染 scene 桌布(three.js + Rust/WASM 粒子模擬),支援影片與 web 桌布,無需 Wallpaper Engine 執行時。

前往 GitHub專案首頁
$ dsh web

16

星數

0

Fork

TypeScript

語言

MIT

授權條款

2026-08-17

建立於

2026-11-20

最近推送

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

安裝步驟

  1. 01

    桌面版:打開側邊欄 **外掛** 頁 → **新增外掛**,套件名稱填 `@dsh-use/wallpaper-engine`(npm)或 `github:yu502950715yang/dsh-use-wallpaper`(GitHub)→ 按 **安裝** → 重新整理頁面

  2. 02

    `dsh web`:執行 `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`

    $ dsh web

  3. 03

    重新啟動 `dsh web`,打開 GUI

    $ dsh web

  4. 04

    進入 **設定 → 側邊欄「Wallpaper 壁纸」**,填桌布資料夾(workshop)與引擎資料夾,或按 **自動偵測**——典型路徑是 `D:/Steam/steamapps/workshop/content/431960` 與 `D:/Steam/steamapps/common/wallpaper_engine`

  5. 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 整合原生執行環境

原生 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`)與滑鼠互動粒子尚未支援;多螢幕下每螢幕獨立桌布也不支援,因為外掛是單頁背景層。
2026-08-172026-11-17v1.0.2

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 即可。

08資料與來源

  • 作者聲明github.comd3fc8fd6a09c…

    把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI

  • 作者聲明github.comd3fc8fd6a09c…

    dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install

  • 作者聲明github.comd3fc8fd6a09c…

    仓库根 `package.json` 已声明 `dsh.bundle`,bundle 由 `cordis.patch.yml` 自动注册

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-21。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。