前言¶
在 DSH 的“一切皆插件”場景下，Web 界面的背景通常依賴默認主題或手動替換靜態文件。如果你本機已經通過 Wallpaper Engine 下載了一批壁紙，並且希望在 DeepSeek Harness Web 中直接選擇圖片或視頻背景，dsh-wallpaper-engine 提供了這條路徑。
DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。下面介紹該插件的能力、安裝與配置方式。
這是什麼¶
dsh-wallpaper-engine 由 sakuraaa667 維護，許可證爲 MIT。它的定位是：把本機 Wallpaper Engine 中已經下載的壁紙接入 DeepSeek Harness Web 界面，作爲頁面背景。
核心功能¶
下面按使用路徑介紹它支持的內容。
自動發現已下載壁紙¶
- Steam 創意工坊壁紙：對應 app
431960，自動讀取libraryfolders.vdf，支持多 Steam 庫。 - Wallpaper Engine 本地項目：覆蓋
projects/myprojects與projects/defaultprojects。
瀏覽與同步¶
- 在“設置 → 壁紙 Wallpaper Engine”中瀏覽縮略圖、搜索、一鍵使用。
- 打開壁紙頁時每 30 秒靜默重掃磁盤，新下載的壁紙會自動出現。
- 也可以點擊「刷新」立即更新。
顯示與可讀性¶
- 視頻壁紙以
<video>方式播放，使用muted + loop。 - 圖片壁紙優先使用目錄內最高分辨率原圖，並支持「鋪滿 / 完整顯示」兩種適配模式。
- 提供「面板暗化（0–100%）」與「背景壓暗（0–50%）」滑桿，用於控制可讀性。
持久化¶
- 壁紙選擇會持久化到
$DSH_HOME/dsh-wallpaper.json。 - 重啓或刷新後自動恢復。
安裝與啓用¶
運行環境方面，package.json 聲明：
engines.node需要>=22peerDependencies包含@deepseek-ai/cordis ^4.0.1
在 DSH 安裝目錄或任意目錄執行安裝命令，把 file: 後的路徑替換爲本機插件目錄：
dsh plugin --profile web add file:C:\path\to\dsh-wallpaper-engine
安裝前應檢查源碼與 MIT 許可證。插件會以當前 dsh 進程權限運行。
典型用法¶
1、打開 DeepSeek Harness Web 界面。
2、進入“設置 → 壁紙 Wallpaper Engine”。
3、點擊任意壁紙卡片即可設爲背景。
4、再次點擊「清除背景」恢復默認。
如果在 Wallpaper Engine 中新增了壁紙，打開壁紙頁後會自動重掃；也可以點擊「刷新」立即更新。
配置¶
插件支持在 profile 的 cordis.patch.yml 中按 id 覆蓋目錄配置：
- id: dsh-wallpaper-engine
config:
workshopDir: "<workshop 目錄>"
projectsDir: "<projects 目錄>"
其中 workshopDir 用於指定創意工坊壁紙目錄，projectsDir 用於指定本地項目目錄。
也支持環境變量：
DSH_WALLPAPER_WORKSHOP_DIRDSH_WALLPAPER_STEAM_DIR
HTTP 路由¶
插件提供以下路由，用於壁紙列表、當前選擇、縮略圖和媒體文件訪問：
/dsh-wallpaper/list
/dsh-wallpaper/config
/dsh-wallpaper/preview/<id>
/dsh-wallpaper/file/<id>
所有 id 均通過掃描生成的映射查找，不參與路徑拼接，以避免路徑穿越。
適用場景與注意¶
適合在本機使用 Wallpaper Engine，並且希望把已下載壁紙直接用於 DeepSeek Harness Web 背景的場景。
需要注意：
- 場景型（scene）與網頁型（web）壁紙無法在瀏覽器背景中即時渲染，會回退爲預覽圖。
- 視頻通過本機 HTTP 流式傳輸，僅本機訪問，默認 loopback。
- 安裝命令中的路徑是佔位示例，需要替換爲實際插件路徑。
- 安裝前建議閱讀源碼，並確認
MIT許可證滿足你的使用要求。
鏈接¶
- GitHub：https://github.com/sakuraaa667/dsh-wallpaper-engine
- 目錄頁：本次材料未提供可覈實 URL，可按插件名
dsh-wallpaper-engine在 DSH 社區目錄中檢索。
