前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。如果你希望在啓動應用時展示一段自定義視頻或動圖，播完後自動淡出露出主界面，deepseek-splash-animation 插件可以滿足這個需求。該插件由 KDDKBD 維護，開源協議爲 MIT。
安裝¶
通過命令行安裝：
dsh plugin --profile web add github:KDDKBD/DeepSeek-splash-animation
安裝完成後需要重啓 DeepSeek Harness。插件自帶一段默認視頻，安裝後重啓即可直接使用。你也可以在設置頁面手動更換視頻或清除配置。
功能與配置¶
核心功能¶
該插件主要提供以下能力：
* 播放自定義視頻或圖片（支持 mp4, webm, gif, webp 等格式）。
* 播放插件自帶的默認視頻。
* 播放結束後 0.3 秒漸隱，露出 DSH 界面。
* 支持跳過按鈕，也支持鍵盤退出（ESC、空格、回車）。
* 支持配置靜音、音量、填充方式（cover/contain/fill）。
界面操作¶
在 設置 → 插件 → 開屏動畫 中：
* 點擊「選擇文件…」可在本機選擇視頻或圖片。
* 直接在輸入框中粘貼路徑。
* 點擊「清除」可徹底關閉開屏動畫功能。
配置文件¶
如果需要更精細的控制，可以在 profile 目錄下的 cordis.patch.yml 中覆蓋配置：
- id: dsh-splash-animation
config:
fit: contain # 填充方式：cover(鋪滿裁切), contain(完整顯示留黑邊), fill(拉伸填滿)
muted: false # 是否靜音（默認靜音，因 Chromium 會攔截自動播放聲音）
fadeOutMs: 600 # 漸隱時長（毫秒）
skip: click # 退出方式：button(按鈕), click(點擊任意處), auto(自動), never(不可退出)
行爲與注意事項¶
啓動過程¶
啓動時出現短暫黑屏是正常現象。插件在頁面第一幀就會覆蓋內容，只有當插件自身的畫面掛載完成後纔會顯示，因此啓動過程中無法看到 DSH 的原生界面。
聲音策略¶
默認靜音。Chromium 瀏覽器要求用戶先與頁面交互才允許播放帶聲音的媒體，而開屏動畫發生在用戶交互之前。如果需要聲音，需在配置中設置 muted: false。
常見問題¶
- 選了視頻但沒有播放：檢查設置頁是否顯示「下次啓動播放」，以及配置文件中的路徑是否正確。
- 格式兼容性：插件使用 HTML5
<video>和<img>標籤。推薦使用webm(VP9) 或mp4(H.264) 以獲得最佳兼容性。mov和mkv能否播放取決於內部編碼（如 ProRes/DNxHD 可能無法解碼）。
