前言¶
DeepSeek Harness（DSH）通過客戶端主題插件可以改配色、注入 UI，但多數主題只動 CSS 變量，聊天區背景仍是默認空白。若你希望在不改側欄佈局的前提下，給中心對話列加上靜態或視頻壁紙、開屏、環境音和輕量粒子，需要自己處理媒體存儲、輪播和控制條交互。下面介紹社區維護者 morningluu 發佈的 dsh-theme-scaramouche（倉庫名，SkillHub 分類爲「趣味換裝」）：一套圍繞《原神》角色散兵 / 流浪者視覺風格設計的非官方粉絲主題，媒體已嵌入本地 bundle，安裝後可在 DSH 0.2.x 桌面端或 dsh web 上直接使用。
這是什麼¶
dsh-theme-scaramouche 是 DeepSeek Harness 的客戶端 UI 主題插件，當前 package.json 版本爲 0.2.0，聲明 engines.dsh >= 0.2.0。倉庫 README 標題爲「散兵 · 浮世雷音」，定位是完整的 Scaramouche 風格暗色主題：墨黑底、深海藍 × 青藍 × 霧紫藍配色、暗金細線，並附帶開屏視頻、預設壁紙、環境音樂與右下角可拖動玻璃控制條。
主題不修改 DSH 側欄佈局，不做 fixed 覆蓋 frame 軌道；預設與自定義壁紙只在聊天中心列顯示，側欄保持純黑。倉庫爲「完整本地媒體版」：開屏、最後一幀預設壁紙、環境音樂已寫入 lib/client.js，開箱可見完整效果；同時支持導入自有圖片/視頻、粒子與遮罩透明度調節。代碼與原創 SVG 爲 MIT；README 明確開屏視頻、最後一幀與 HOYO-MiX 音樂僅用於非商業粉絲演示，不在 MIT 授權範圍內，項目與米哈遊 / HoYoverse、DeepSeek 均無關聯。
核心功能¶
視覺與設計令牌¶
- 91 個
--dsw-*設計令牌，colorScheme: dark。 - 原生 DSH 側欄，壁紙層與預設/自定義共用同一套顯示邏輯。
壁紙¶
- 靜態 / 視頻壁紙：多張導入、縮略圖庫、任意勾選、輪切或循環；遮罩透明度 0–100%（默認 70%），只調黑色遮罩層，不改變素材本身亮度。
- 圖片與視頻存入本機 IndexedDB；視頻以 Blob 保存並自動抽幀做 poster，靜音循環、點擊穿透。
- 輪切播完所選後停下；循環則回到第一張。
開屏、音樂與粒子¶
- 完整開屏視頻（含音頻），帶聲音開關與跳過；無視頻時開屏直接關閉。
- 環境音樂爲內置 96k MP3，
<audio loop>；瀏覽器自動播放策略可能要求先點擊頁面一次。 - 粒子三種：青藍光點、雷光、雪；渲染在聊天內容下方，不影響閱讀。
控制條¶
右下角可拖動玻璃控制條；小屏自動收緊/橫排；位置按距右下角的相對距離保存，窗口縮放或全屏後跟隨邊緣。
安裝與啓用¶
從 GitHub 安裝（README 推薦方式）。desktop 爲官方桌面端 profile；若使用 dsh web，將 desktop 換成 web，自定義 profile 換成實際名稱。
dsh plugin --profile desktop add github:morningluu/dsh-theme-scaramouche
從源碼安裝時，README 給出本地 link 方式（需已有源碼目錄，本文不展開 clone 步驟）：
dsh plugin --profile desktop add link:"$PWD"
安裝後完全退出 DSH 再重開，以便客戶端 bundle 重新加載。客戶端主題依賴宿主支持 dsh.client 與 @deepseek-ai/dsh-client-ui-theme。
典型用法¶
安裝並重開 DSH 後，界面右側有四個入口，對應 README 中的控制項：
| 入口 | 內容 |
|---|---|
| 壁紙 | 當前縮略圖；預設 / 自定義；圖片或視頻導入；縮略圖庫；勾選參與輪播；關閉 / 輪切 / 循環；遮罩透明度；移除 |
| 開屏 | 視頻 / 關閉；聲音開啓 / 靜音；重播 |
| 音樂 | 關閉 / 九徹生識；播放 / 暫停；音量 |
| 粒子 | 關閉 / 青藍 / 雷光 / 雪 |
壁紙縮略圖右上角勾選圈決定哪些進入輪播。若需替換爲自有媒體或生成不含官方素材的乾淨版，倉庫提供 scripts/intro-video.cjs，例如：
node scripts/intro-video.cjs \
--video "/path/to/your-opening.mp4" \
--fallback "/path/to/your-fallback.mp4" \
--music "/path/to/your-music.mp3"
查看媒體標記狀態：
node scripts/intro-video.cjs --check
生成不含官方素材的乾淨版：
node scripts/intro-video.cjs --clean
腳本將壓縮後的視頻/音頻以 base64 嵌入 lib/client.js；替換後的素材版權仍歸其權利人，請勿超額分發。
適用場景與注意¶
適合誰：已在 DSH 0.2.x 上使用桌面端或 Web，希望聊天區有壁紙/視頻背景、開屏與氛圍音，且接受暗色粉絲向視覺的用戶。SkillHub 目錄頁分類爲「趣味換裝」。
運行與信任邊界：插件隨當前 DSH 進程加載，安裝前應閱讀倉庫源碼、LICENSE 與 NOTICE.md，確認許可證與官方媒體使用邊界。公開版倉庫內含《原神》相關官方演示媒體，不用於商業用途；若需對外發布無官方素材版本，應使用 --clean 構建流程。
兼容性（來自 README）：DeepSeek Harness 0.2.x；桌面端與 dsh web 均可。
結尾¶
dsh-theme-scaramouche 把散兵向暗色令牌、聊天區壁紙（含視頻與輪播）、開屏、環境音樂、粒子與可拖動控制條收進一個 DSH 客戶端主題，並在 README 中寫清 MIT 代碼與官方粉絲演示媒體的版權分界。目錄與收錄信息可在 SkillHub 查看：morningluu/dsh-theme-scaramouche；源碼與完整說明見 GitHub 倉庫。
