前言¶
DeepSeek Harness（DSH）桌面版啓動時會先出現自帶畫面：HARNESS、轉圈、Loading plugins。不少掛在客戶端槽位上的開屏插件，README 裏會直接說明壓不住這張默認頁，動畫前仍會閃一下。Streamfish-lab 維護的 dsh-splash-fish 面向「每次打開 Harness 想先看一張插畫、再進工作區」的場景：用 webserver/index-inject 在 index 解析階段鋪封面，客戶端側在 shell.overlay 槽位播完即卸，並支持點擊、按鍵或滾輪跳過。下面介紹它是什麼、能做什麼，以及桌面版與 Web/CLI 各自的安裝方式。
這是什麼¶
dsh-splash-fish 是純客戶端 DSH 插件（當前版本 0.3.0，MIT 許可證）。倉庫：https://github.com/Streamfish-lab/dsh-splash-fish；社區目錄頁：https://www.skillhub.cn/plugins/Streamfish-lab/dsh-splash-fish。分類爲趣味換裝；GitHub 星標數爲 3。
一句話定位：把一張插畫做成 DSH 開屏——從黑場顯影、人物帶深度驅動的 2.5D 位移，淡出後進入工作區，並儘量壓住 DSH 自帶啓動頁。
核心功能¶
開屏時間線與交互¶
插件掛在 shell.overlay 槽位，每次頁面加載只播一次，播完自行卸載。完整啓動動畫約 5.07 秒（Release 附件 splash-25d-preview.mp4）。等不及時可點屏幕、按任意鍵或滾一下滾輪，立刻進入收尾；該次點擊會被消費，不會漏到下層界面。
與常見開屏做法的差異¶
- 壓自帶啓動頁：通過
lib/index.js向webserver/index-inject推送樣式與腳本，在 index.html 解析階段鋪同色封面，早於客戶端插件實例化；客戶端掛載後再摘封面，並設約 3.5 秒的兜底。 - 頭髮位移爲離線渲染：單張圖裏頭髮與臉共用像素，CSS 平移會連帶臉部。倉庫用深度圖、髮根到髮梢權重、空間相位與湍流離線渲染 108 幀，編碼爲帶 alpha 的 VP9 WebM（約 1MB）；運行時只播視頻，無逐幀 canvas 計算。
- 播完不擋操作：動畫層掛到
body下，z-index爲 2147483600；.sf-root等使用pointer-events: none，播完清理殘留，避免擋住界面。
換圖（可選）¶
默認插畫爲他人作品。僅換靜態開屏、不要髮絲飄動：Windows 可將圖片拖到 換自己的圖.bat；Mac 使用：
python3 tools/make_from_image.py 我的圖.jpg
腳本會居中裁成 16:9、縮到 1600×900 並重新打包；顯影、光暈、光掃、粒子、淡出仍保留，頭髮飄動層會消失（該層針對默認圖單獨計算）。若要新圖的 2.5D 飄動，需按 README 中 hair/tools/ 流程離線渲染（Python、torch、SAM2 權重等），README 估計約一小時量級，視機器而定。
已知限制（倉庫原文）¶
- 皮膚與純色背景區域位移肉眼幾乎不可見。
- Windows 標題欄三個系統按鈕網頁無法蓋住；README 建議 advanced 窗口模式以透明標題欄規避。
- 只播一次，重播需刷新頁面。
- DSH 仍爲 developer preview，
shell.overlay等接口可能變更。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證。社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
桌面版（Windows / Mac）¶
不要對桌面 profile 使用 dsh plugin add——desktop 爲 Electron 獨佔，CLI 會直接拒絕。README 強調：不要手改 profiles\desktop\package.json，應走應用內路徑。
自己安裝：
- 將倉庫放到本地長期目錄（若按 Agent 說明克隆，路徑示例爲
%USERPROFILE%\.dsh\bundles\dsh-splash-fish，目錄需保留，插件爲 link 引用）。 - 打開 設置 → 插件 → 添加插件，填寫指向含
package.json一層的絕對路徑。 - 徹底退出 DSH 再打開。
交給 Agent 時，README 給出一句即可：
幫我安裝這個 DeepSeek Harness 插件：https://github.com/Streamfish-lab/dsh-splash-fish
Agent 會讀倉庫內 AGENTS.md 完成步驟。若卡住，可附帶 README 中的克隆路徑、界面添加插件、重啓三項說明。
Web 版或已安裝 dsh CLI¶
dsh plugin --profile web add /你的絕對路徑/dsh-splash-fish
路徑需指向倉庫根目錄（含 package.json）。
典型用法¶
免安裝預覽¶
倉庫提供 preview.html，瀏覽器直接打開即可；加查詢參數 ?t=2600 可凍在某一幀。Release 另有預覽視頻與上一版頭髮層對照視頻鏈接，見 README。
構建與檢查（維護者 / 改資源後）¶
python3 build.py
node --check client.js
package.json 中 scripts.build 爲 python3 build.py，check 爲 node --check client.js。client.js 爲構建產物，圖與視頻內聯其中，README 建議不要手改。
更新¶
插件不會自動更新。git 方式安裝時在倉庫目錄 git pull 後徹底重啓 DSH；壓縮包安裝則重新下載覆蓋，解壓時不要清空目標文件夾中的 assets\。若曾用「換自己的圖」，更新可能覆蓋 client.js 回到默認畫面，需重新拖圖或跑 make_from_image.py。新版本見 GitHub Releases。
結尾¶
dsh-splash-fish 把 DSH 開屏從「默認 HARNESS 頁 + 簡單 overlay」做成可定製的顯影與 2.5D 視頻層，並在注入時機與層級上針對閃屏、縮放同步、資源內聯等坑做了說明。適合願意本地 link 插件、接受 MIT 條款、且使用桌面或 Web profile 的 Harness 用戶。
