前言¶

DeepSeek Harness（DSH）的 Web GUI 默認背景通常是純色或主題自帶樣式。若希望在不改主題的前提下，用本機圖片或短視頻做對話界面背景，並能在設置裏切換、定時輪換，就需要一個掛在 web profile 上的本地壁紙插件。dsh-wallpaper 由 whf-jx 維護，歸類爲社區目錄中的「趣味換裝」；素材不上傳外網，狀態與文件都落在本機 $DSH_HOME/wallpaper/。

下面介紹它的定位、能力、安裝方式與使用要點。事實以 GitHub 倉庫 README 與 package.json 爲準。

這是什麼¶

dsh-wallpaper 爲 DSH Web GUI 提供本地圖片 / 視頻壁紙：上傳素材、手動切換、按間隔自動輪換，改動在設置界面內完成並實時生效。它不依賴在線服務，運行時通過 shell.overlay 與 settings.section 注入，僅支持 web 形態的 DSH GUI。

插件要求 DSH 引擎版本 >=0.1.2-alpha.1（見 package.json 的 dsh.engines）。當前 package 版本爲 0.1.0，許可證 MIT。社區目錄頁：https://www.skillhub.cn/plugins/whf-jx/dsh-wallpaper。

核心功能¶

素材類型與播放¶

• 圖片：.jpg、.jpeg、.png、.webp、.gif、.bmp、.avif
• 視頻：.mp4、.webm、.ogv、.mov、.m4v，自動靜音循環；HTTP 層對視頻支持 Range 請求，便於瀏覽器流式播放

切換與輪換¶

• 手動：點選素材、上一張 / 下一張
• 定時輪換：7 檔間隔（30 秒、1 分鐘、5 分鐘、30 分鐘、1 小時、3 小時、6 小時），可獨立開關；計時在 Host 端，關閉頁面也會繼續推進
• 隨機順序：依次輪換或隨機抽取

觀感與可讀性¶

• 壁紙清晰度（5–100%）、文字壓暗（0–90%）、背景模糊（0–60px）、填充方式（鋪滿 / 完整 / 拉伸 / 平鋪；視頻不支持平鋪，按鋪滿處理）
• 深色主題且壁紙啓用時，自動提亮三檔文字色，便於閱讀正文
• README 建議深色主題下：清晰度 15–20%、文字壓暗 60–70%、背景模糊 10–15px

持久化¶

啓用狀態、間隔、當前素材等寫入 $DSH_HOME/wallpaper/index.json（默認 ~/.dsh/wallpaper/）。原始字節在 images/ 目錄。

安裝與啓用¶

README 說明本插件尚未發佈到 npm，推薦用 dsh plugin 從 GitHub 源碼安裝。安裝後需重啓一次 DSH（插件按啓動緩存發現），再刷新頁面。

dsh plugin --profile web add github:whf-jx/dsh-wallpaper

插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證，確認符合你的環境策略。本包零運行時依賴，profile 的 package.json 無需額外登記該包。

典型用法¶

1. 打開 設置 → 本地壁紙。
2. 使用「上傳圖片 / 視頻」多選本地文件；上傳後立即出現在素材列表。
3. 打開「啓用壁紙」總開關；需要輪播時再開「自動輪換」，並選擇間隔與是否「隨機順序」。
4. 按需調節清晰度、壓暗、模糊與填充方式；關閉總開關後背景層整體卸載（含視頻解碼）。

刪除素材爲兩步確認（首次點擊武裝，約 4 秒後自動解除），以防誤刪大文件。

數據與 API（排障參考）¶

數據目錄結構：

$DSH_HOME/wallpaper/
  index.json          # 狀態與素材清單
  images/             # 原始素材
  trace.log           # 可選，需環境變量 DSH_WALLPAPER_TRACE
  client-probe.json   # 可選，客戶端自檢快照

HTTP 路由前綴爲 /api/dsh-wallpaper，包括 GET /state、GET /revision（輕量輪詢）、GET /image/<id>、POST /upload、POST /config 等。上傳視頻時若系統 PATH 有 ffmpeg，會 best-effort 轉碼爲 1600×900 等參數後再入庫；缺失或失敗則保留原文件。設 DSH_WALLPAPER_NO_TRANSCODE=1 可關閉轉碼。

適用場景與注意¶

適合：長期在本地跑 DSH Web GUI、希望用私有素材做背景、需要定時或隨機換壁紙且不依賴第三方圖牀的用戶。

注意：

• 僅 web profile；其他 GUI 形態不適用。
• 視頻壁紙會持續佔用 GPU 解碼；上傳轉碼可將碼率壓到約 3 Mbps 量級（依賴 ffmpeg）。
• 無縮略圖；列表裏視頻以 preload="metadata" 預覽，懸停播放。
• 社區目錄（SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態本身是「一切皆插件」的擴展方式。

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/whf-jx/dsh-wallpaper
• 源碼與文檔：https://github.com/whf-jx/dsh-wallpaper