前言¶
DeepSeek Harness（DSH / Cordis）桌面版啓動後通常直接進入主界面。若你希望啓動過程帶一段固定的視覺儀式——全屏視頻、逐句字幕、HUD 風格邊框——而不是改客戶端源碼或自己寫注入腳本，社區插件 @shawsheepsussiah/dsh-haavk-boot 提供了一條可安裝、可開關的路徑。下面介紹它做什麼、怎麼裝、裝完在哪裏調。
這是什麼¶
哈夫克 Relink 節點啓動固件 是 DSH 的開機動畫插件，維護者爲 ShawSheepSussiah。一句話：讓 DSH 啓動時先播一段原生開機動畫，再進主界面。
插件在 SkillHub 目錄中歸類爲「趣味換裝」；npm 包名爲 @shawsheepsussiah/dsh-haavk-boot，當前 README 對應實現版本爲 0.2.7，許可證 MIT。DSH 生態主張「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
README 中列出的能力如下，均經 Host 路由與客戶端自舉配合實現：
| 能力 | 說明 |
|---|---|
| 全屏開機視頻 | H.264 1080p，object-fit: cover 滿屏；資源約 6.2 MB（lib/assets/boot.mp4） |
| 逐句字幕 | 6 條字幕按視頻播放時間點亮，時間軸由 splash.js 的 CUES 控制 |
| 粒子層 | Canvas 星塵與光塵，mix-blend-mode: screen 疊在視頻上 |
| HUD 邊框 | 四角光標、掃描線、右側數據流等哈夫克風格元素 |
| 標題欄隱身（Windows） | 通過 DSH preload 的標題欄 overlay 邏輯隱藏原生最小化/最大化/關閉按鈕，不需要全屏 |
| 設置面板 | 設置 → 插件 → 哈夫克Relink：開關動畫、視覺層、音頻、熱重載後重播等 |
| 安全兜底 | 任一步失敗都放行主界面；視頻 1.6s 內未起播則切牆鍾驅動，17s 硬兜底放行 |
桌面主頁面走 dsh-app://app/index.html，插件不走 Host 的 renderIndex 注入，而是由 client.js 在模塊加載後 apply() → mountSplash()，掛載 CSS/JS 並播放 /plugins/dsh-haavk-boot/asset/boot.mp4。靜態資源由 lib/index.js 註冊的 webServer 路由提供。
安裝與啓用¶
前置條件¶
- DeepSeek Harness 桌面版（Windows / macOS）
- DSH 版本 ≥
0.2.1-rc.2 - 能訪問 npm registry
一條命令安裝¶
Web profile：
dsh plugin --profile web add @shawsheepsussiah/dsh-haavk-boot
桌面版將 web 換成 desktop：
dsh plugin --profile desktop add @shawsheepsussiah/dsh-haavk-boot
裝上後 DSH 會自動把包加入 dsh.profile.bundles，無需手改 package.json 或 allowBuilds。--profile 後跟的是 profile 名；不確定時查看 ~/.dsh/profiles/ 下有哪些目錄。
必須完全退出 DSH（含托盤）再重新打開，插件在啓動時讀配置；只關窗口不算。
裝完沒效果時¶
查看日誌：
0.2.4及更早：~/.dsh/dsh-haavk-boot/boot.log- 較新版本：
~/.dsh/@shawsheepsussiah/dsh-haavk-boot/boot.log
正常應出現類似 apply()、route ok /plugins/dsh-haavk-boot/splash.css、tapIndex=function 等行。
卸載¶
dsh plugin --profile desktop remove @shawsheepsussiah/dsh-haavk-boot
再從 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 中刪除 "@shawsheepsussiah/dsh-haavk-boot"（pnpm 不會自動清 bundles），重啓 DSH。
典型用法¶
在設置裏控制行爲¶
安裝後打開 設置 → 插件 → 哈夫克Relink，可：
- 啓用 / 關閉節點
- 開關開機啓動屏
- 開關視覺層（粒子 / HUD）
- 開關音頻
- 開關「熱重載後重播」
- 一鍵重播啓動屏（會 POST
/preview）
配置寫入 ~/.dsh/@shawsheepsussiah/dsh-haavk-boot/settings.json。
自定義視頻與字幕（改源碼或 link 安裝時）¶
換視頻建議轉 H.264（README 給出 ffmpeg 示例，輸出到 lib/assets/boot.mp4）。改字幕需同時編輯 lib/splash.js 的 CUES 與 lib/client.js 裏 SPLASH_HTML 的對應 <p id="haavk-cN">，條數須一致。外觀在 lib/splash.css（作用域 #dsh-startup-root）。
適用場景與注意¶
適合誰： 長期在 Windows / macOS 上使用 DSH 桌面版、希望啓動時有統一品牌感或「節點啓動」儀式感的開發者；接受視覺風格參考《三角洲行動》哈夫克 Relink 開機儀式的用戶。
兼容性（README）：
- Windows 10/11 桌面版：標題欄隱身僅 Windows 生效
- macOS：無標題欄按鈕問題，其餘功能正常
- Web 版：啓動屏可顯示，但
/需登錄態，client.js加載時機可能略晚
安全與信任： 插件以當前 DSH 進程權限運行，會註冊本機迴環上的 Host 路由並提供 SSE、配置讀寫等接口；安裝前應閱讀 GitHub 源碼 與 MIT 許可證。README 提到 0.2.2 及更早存在 client 註冊 id 與包名不一致導致啓動失敗的問題，請使用 0.2.6+。
排錯要點： 確認 bundles 含插件且 cordis.patch.yml 存在；若出現 duplicate factory registration，檢查 __ModuleLoader__.load 的 id 是否爲 package.json 的完整 name。
結尾¶
@shawsheepsussiah/dsh-haavk-boot 把 Relink 風格的開機視頻、字幕與 HUD 封裝成 DSH 插件，安裝命令明確、設置面板可關可重播，並在多層兜底下避免鎖死主界面。目錄頁：https://www.skillhub.cn/plugins/ShawSheepSussiah/dsh-haavk-boot；源碼與完整說明：https://github.com/ShawSheepSussiah/dsh-haavk-boot。
