dsh-we-wallpaper-sync:批量管理 Wallpaper Engine 壁紙並接入 DSH 皮膚中心

DSH 智能體開發中,桌面壁紙的動態切換是常見需求。手動從 Wallpaper Engine 創意工坊挑選並下載壁紙效率較低,且國內網絡環境對 Steam 訪問有諸多限制。這個插件旨在解決上述問題,將 Steam Web API 與 steamcmd 集成到 DSH 中,實現壁紙的自動化管理。

插件介紹

dsh-we-wallpaper-sync 是由 tiger0012 維護的一個聯網工具類插件(MIT 許可證)。它是一個可複用技能,主要功能是批量瀏覽、搜索、下載 Wallpaper Engine(Steam 應用 431960)的創意工坊壁紙,並將下載好的文件接入 DSH 皮膚中心,使其成爲智能體的 GUI 背景。

核心功能

  1. 搜索與預覽
    插件支持通過 Steam Web API Key 進行搜索或瀏覽創意工坊。用戶可以按訂閱數、趨勢、最新發布或關鍵詞進行篩選。插件會抓取作品的標題、訂閱數和預覽圖,並生成網格列表供用戶選擇。

  2. 批量下載
    使用 steamcmd 配合 Docker 執行批量下載。這種方式無需安裝 Steam 客戶端,也不依賴系統級的 32 位庫,直接在容器環境中運行。

  3. 網絡突破
    針對國內網絡環境,插件支持通過代理配置繞過對 Steam HTTP 的封鎖,以及解決異地登錄攔截問題。這需要出口 IP 與賬號常住地保持一致,並配置相應的代理策略。

  4. 落盤與接入
    下載完成後,壁紙會落盤到 ~/Steam/steamapps 目錄。用戶需要在 ~/.dsh/settings.yaml 中配置 skin-wallpaper.weLibraryDirs,DSH 皮膚中心的 Wallpaper Engine 橋(WE 橋)掃描到該目錄下的 workshop/content/431960 文件夾後,即可應用爲 GUI 背景。

使用方式

安裝插件後,在 DSH 中調用技能 dsh-we-wallpaper-sync,按照步驟執行即可。也可以直接讀取插件包內的 SKILL.md 文件查看具體命令。

注意事項

該插件以當前 DSH 進程的權限運行,安裝前應檢查源碼與許可證。以下是使用過程中需要注意的關鍵點:

  • 勿硬編碼憑證:技能內用 <賬號>/<KEY>/<密碼> 佔位,請勿在配置中硬編碼 Steam API Key 或密碼。
  • 網絡與代理:國內封禁 Steam 的 HTTP 域名,但 steamcmd 走 Steam CM 網絡(不看 HTTP),直連往往能通。然而,Steam 會比對登錄 IP 與賬號常住地;不匹配會攔截登錄。需使用出口 IP 與賬號一致的代理,並在 steam.cfg 中使用 SocksProxy 解決。
  • 容器路徑:容器內 steamcmd 目錄是 /root/.local/share/Steam/steamcmd,請勿用空目錄掛載覆蓋(會導致 steamcmd.sh not found),需使用 +force_install_dir 指定落盤路徑。
  • 第三方站點:不建議依賴第三方下載站(如 steamworkshopdownloader.io),其後端常報 500 錯誤。
  • 掃描路徑:皮膚中心 WE 橋掃描路徑爲 <庫根>/steamapps/workshop/content/431960。

總結

該插件爲 DSH 開發者提供了一個標準化的入口來管理 Wallpaper Engine 資源,省去了手動操作和配置網絡代理的繁瑣步驟。相關目錄與源碼見下:

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜