前言¶
DeepSeek Harness (DSH) 的插件化系統允許開發者通過插件擴展功能。除了常規的功能增強，視覺層面的定製也是插件生態的一部分。現有的界面定製方案多基於 CSS，形式較爲單一。dsh-video-skin 插件引入了視頻背景與開機動畫的概念，在不改變 DSH 核心邏輯的前提下，爲桌面端和瀏覽器端提供了更豐富的視覺表現。
插件簡介¶
該插件由 Something11235 維護，採用 MIT 許可證。其核心價值在於“零依賴”設計，將一段無聲視頻循環作爲聊天背景，另一段有聲視頻作爲開機動畫。通過配置，用戶可以調節透明度與對比度，使視頻背景與界面文字保持可讀性。
核心功能¶
插件主要提供以下能力：
- 聊天背景：一段短片循環鋪滿整個界面，默認靜音。界面層的透明度可在 UI 中實時調節，無需重啓。
- 有聲開機動畫：開機時播放有聲動畫，動畫結束後自動交叉溶解進主界面。用戶在播放期間點擊畫面即可跳過。
- 透明度控制：右下角提供半透明小圓鈕，打開後包含兩個滑塊（面板透明度與視頻遮罩），並支持三種預設。調完刷新即可生效，無需重啓。
- 實時對比度讀出：面板顯示當前視頻幀的文本對比度數據，輔助調節。
- 主題適配：支持暗黑與明亮主題的自動切換與配置。
安裝與啓用¶
安裝插件需要通過 DSH 的插件管理界面進行。
- 進入 設置 → 插件 → 添加插件。
- 在輸入框中粘貼以下命令並確認安裝：
github:Something11235/dsh-video-skin#main
- 必須完全退出並重新打開 DSH 纔會生效。在桌面版（Electron）中，由於索引注入表是在宿主啓動時收集的快照，刷新頁面不足以完成注入。
使用方法¶
安裝完成後，可以通過以下方式使用：
- 調節透明度：右下角會出現一個半透明小圓鈕，點擊打開面板。拖動滑塊調節遮罩透明度，按
Alt+B快捷鍵亦可切換面板。 - 跳過開機動畫：啓動時若不想等待開機動畫，直接點擊畫面即可跳過。
- 關閉面板：點擊面板外部區域，或按
Esc鍵關閉。 - 瀏覽器端音量：瀏覽器（dsh web）默認阻止未靜音自動播放，會回退到靜音播放並顯示獨立的音量按鈕。點擊音量按鈕即可開啓聲音。
注意事項¶
- 配置文件路徑：配置文件保存在
<plugin>/video-skin.config.或%USERPROFILE%\.dsh\dsh-video-skin.。修改文件後刷新頁面即可生效，桌面版安裝除外。 - 層級限制：透明度控制面板的 z-index 爲 900，低於內核的 Modal overlay (1000)，確保模態框能正常覆蓋控制面板。
- 依賴情況：插件完全零依賴，構建產物不包含外部
import，通過github:安裝路徑可直接使用。
總結¶
dsh-video-skin 提供了一種無需編寫代碼即可爲 DeepSeek Harness 添加視頻背景與開機動畫的方案。通過精細調節透明度與對比度，可以在保證視覺美觀的同時維持界面的可讀性。更多細節與源碼可查閱 GitHub 倉庫。
