前言¶
使用 DeepSeek Harness Web UI 時，如果只想調整頁面外觀，通常不希望引入 Steam、Wallpaper Engine 或額外 npm 依賴。DSH Live Wallpaper 是一個面向 DSH Web UI 的插件，用於添加動態壁紙和頁面主題中心。
項目由 hinayoung23 維護，許可證爲 MIT。當前版本 v0.3.1 在 DeepSeek Harness 0.1.0-rc.7 上完成驗證。
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解爲官方應用商店。
這是什麼¶
DSH Live Wallpaper 爲 DeepSeek Harness Web UI 提供兩類能力：
- 動態壁紙：內置離線程序化壁紙、本地媒體、遠程媒體、ShaderToy 作品
- 頁面主題中心：主題預設、顏色、按鈕形態、字體風格和字號縮放
插件不依賴 Steam、Wallpaper Engine 或額外 npm 依賴。
核心功能¶
內置動態壁紙¶
提供四款離線程序化動態壁紙：極光、星雲、落日流光、霓虹網格。
這些內置動態不需要訪問外部網站，適合希望離線使用壁紙的場景。
ShaderToy 作品¶
可以粘貼 ShaderToy ID 或官方鏈接應用作品。App Key 是可選配置。
- 未配置 App Key 時，使用 ShaderToy 官方 Embed。
- 配置 App Key 後，優先獲取源碼並在本地 WebGL2 渲染。
- 本地 ShaderToy 渲染需要 WebGL2。
- 當前本地渲染支持一個
Image通道、可選一個Common通道，且不含外部輸入。 Buffer A–D、紋理、音頻、攝像頭和立方體貼圖會退回官方播放器。
遠程與本地媒體¶
插件可應用 HTTP(S) 視頻、圖片或網頁 URL。
視頻 / 圖片 URL 需要使用媒體直鏈，即在瀏覽器中打開後直接顯示視頻或圖片。Pexels、Pixabay 等素材詳情頁不能作爲媒體直鏈使用。
也可以臨時應用本地視頻、GIF 和圖片。本地文件壁紙在刷新後不能重新取得本地文件權限，僅在當前頁面生命週期內有效。
外觀與主題¶
可以調整背景暗度、模糊、界面遮罩透明度和視頻速度。
主題中心提供：
- 5 套頁面主題預設
- 自定義主題底色、強調色和按鈕顏色
- 圓角、膠囊、直角、玻璃和 DSH 原生共 5 種按鈕形態
- 系統無襯線、圓體、襯線、等寬共 4 種字體風格
90%–115%字號縮放
壁紙與主題可獨立開關。關閉主題或卸載插件後，恢復 DSH 原生外觀。
動畫與系統適配¶
頁面隱藏，或系統開啓“減少動態效果”時，插件會自動暫停可暫停的動畫。
安裝與啓用¶
插件以當前 dsh 進程權限運行。安裝前建議先檢查源碼與 MIT 許可證。
本地安裝¶
在本地目錄中使用：
dsh plugin --profile web add ./dsh-live-wallpaper
dsh --profile web --dump-config
dsh web
這一步先將本地目錄作爲插件添加，再重新生成 Web profile 配置，然後啓動 DSH Web UI。
從 GitHub 安裝¶
dsh plugin --profile web add github:hinayoung23/dsh-live-wallpaper#v0.3.1
從 npm 安裝¶
dsh plugin --profile web add dsh-live-wallpaper
已覈實資料提供了本地、GitHub、npm 多種安裝命令，沒有明確哪一個爲唯一官方默認安裝命令。可按當前環境和網絡條件選擇。
打開 DSH 後，點擊右下角的圓形壁紙按鈕進入插件面板。
典型用法¶
使用內置動態¶
打開插件面板後，可以直接使用四款內置動態。
這種方式不需要訪問外部網站，也不需要 App Key。
使用下載的視頻¶
如果準備使用 Pexels、Pixabay 等素材，可以按下面的步驟做：
- 在插件面板的“下載壁紙素材”中打開 Pexels 或 Pixabay。
- 選擇作品並下載 MP4/WebM 文件，不要複製作品詳情頁地址。
- 回到插件面板，在“本地文件”中選擇視頻、GIF 或圖片。
注意：遠程服務器可能禁止跨站嵌入或熱鏈。此時應下載文件後通過本地文件使用。
使用 ShaderToy¶
- 粘貼作品 ID，例如
XXcyRn，或粘貼完整官方鏈接，然後點擊應用。 - 不配置 App Key 時，插件使用官方播放器。
- 如需本地源碼渲染，展開“App Key（可選）/ 高級兼容”，從 ShaderToy Apps 取得 App Key 並保存。
- 之後插件會優先獲取
Common + Image源碼，並在本地 WebGL2 中編譯；不兼容時退回官方播放器。
無 App Key 模式需要持續聯網，並依賴 ShaderToy 官方 Embed 可用，且作品允許嵌入。
調整外觀¶
在插件面板中調整背景暗度、模糊、界面遮罩透明度和視頻速度。
主題項可以獨立開關，也可以調整底色、強調色、按鈕顏色、按鈕形態、字體風格和字號縮放。
適用場景與注意¶
DSH Live Wallpaper 適合希望在 DeepSeek Harness Web UI 中更換背景、調整主題外觀，且不想安裝 Steam、Wallpaper Engine 或額外 npm 依賴的使用者。
使用前注意：
- 使用第三方視頻、圖片或 Shader 前，確認其授權允許你的使用方式。
- 本地文件壁紙僅在當前頁面生命週期內有效；刷新後瀏覽器不能重新取得本地文件權限。
- 無 App Key 使用 ShaderToy 官方 Embed 時需要聯網，並且作品必須允許嵌入。
- ShaderToy App Key 存放在 DSH 憑據服務中；瀏覽器只能查詢配置狀態，無法讀回明文。
- Host 接口只接受同源 JSON 請求，並只訪問固定的 ShaderToy 官方 API，不是通用網絡代理。
- 插件不抓取網頁，不繞過 Cloudflare 和作品訪問控制，也不抓取、代理或繞過第三方壁紙市場訪問控制。
- 用戶自定義遠程網頁仍在更嚴格的 sandbox iframe 中運行，壁紙層默認不接收鼠標事件。
- 高級標籤頁捕獲僅在當前頁面生命週期內有效，並可能要求瀏覽器的屏幕錄製權限。
鏈接¶
- GitHub：https://github.com/hinayoung23/dsh-live-wallpaper
- 目錄頁：https://www.skillhub.cn/plugins/hinayoung23/dsh-live-wallpaper
