dsh-haavk-boot

哈夫克 Relink 节点启动固件 — DeepSeek Harness（DSH / Cordis）的开机动画插件。

信息与你无限，Relink 重塑未来。

一句话：让 DSH 启动时先播一段原生开机动画，再进主界面。

---

特性

特性	说明
🎬 全屏开机视频	H.264 1080p 原生渲染，object-fit: cover 满屏，不黑边
💬 逐句字幕	6 条字幕按视频真实播放时间点亮，与配音严格对齐
✨ 粒子层	Canvas 星尘 + 光尘，mix-blend-mode: screen 叠在视频上
🎛 HUD 边框	四角光标、扫描线、右侧数据流，哈夫克风格
🪟 标题栏隐身	Windows 上隐藏原生最小化/最大化/关闭按钮，不需要全屏
⚙️ 设置面板	挂在「设置 → 插件 → 哈夫克Relink」，可关动画、重播
🛡 绝不锁死	任何一步失败都放行页面，视频 15s 兜底放行

---

安装

前置条件

• DeepSeek Harness 桌面版（Windows / macOS）
• DSH 版本 ≥ 0.2.1-rc.2
• 能访问 npm registry

---

⚡ 安装（一条命令）

dsh plugin --profile web add @shawsheepsussiah/dsh-haavk-boot

桌面版把 web 换成 desktop：

dsh plugin --profile desktop add @shawsheepsussiah/dsh-haavk-boot

装上就生效。 不用改 package.json、不用配 allowBuilds、不用手动改 bundles —— DSH 会自动把它加进 dsh.profile.bundles。

装完后 完全退出 DSH（托盘也要退），重新打开，就能看到开机动画。

--profile 后面跟的是 profile 名。不确定有哪些，看 ~/.dsh/profiles/ 下面有哪些目录。

装完没效果？

看日志 ~/.dsh/@shawsheepsussiah/dsh-haavk-boot/boot.log（0.2.4 及更早写在 ~/.dsh/dsh-haavk-boot/boot.log），正常会有：

apply()  v=0.2.6  webServer=yes  inject=["webServer"]
route ok /plugins/dsh-haavk-boot/splash.css
...
tapIndex=function

注意：一定要「完全退出」DSH（托盘图标也要退），只关窗口不算——插件是启动时读配置的。

---

手动安装（不推荐）

只有在无法访问 npm registry 时才需要。

从 GitHub 源码装

cd ~/.dsh/profiles/desktop
mkdir -p plugins
git clone https://github.com/ShawSheepSussiah/dsh-haavk-boot.git plugins/dsh-haavk-boot

然后编辑 ~/.dsh/profiles/desktop/package.json：

{
  "dependencies": {
    "@shawsheepsussiah/dsh-haavk-boot": "link:./plugins/dsh-haavk-boot"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@shawsheepsussiah/dsh-haavk-boot"
      ]
    }
  }
}

⚠️ bundles 里插件必须放在最后。数组顺序就是加载顺序，@deepseek-ai/dsh-base / dsh-web-app 要先于插件。

最后 pnpm install，完全退出 DSH 再打开。

---

卸载

dsh plugin --profile desktop remove @shawsheepsussiah/dsh-haavk-boot

再手动从 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 里删掉一行：

"@shawsheepsussiah/dsh-haavk-boot"

（pnpm 不会自动清 bundles，这是当前 DSH 的行为。）

重启 DSH 即可。

---

目录结构

dsh-haavk-boot/
├── package.json           插件清单（含 dsh.bundle.patch 声明）
├── cordis.patch.yml       把插件插入 loader 树的 patch
├── lib/
│   ├── index.js           Host 端：注册路由 / 配置 / SSE / 遥测
│   ├── client.js          Web 端：自举启动屏 + 设置面板
│   ├── splash.js          启动屏运行时：视频 → 字幕 → 溶解
│   ├── splash.css         启动屏样式（全屏锁死 + HUD + 粒子层）
│   └── assets/
│       └── boot.mp4       开机视频（6.2 MB，H.264 1080p）
└── docs/screenshots/

---

工作原理（给想改的人）

启动屏怎么出现

DSH 桌面端的主页面是 dsh-app://app/index.html，直接从 dist 目录读文件返回，不经过 Host 的 renderIndex / tapIndex 注入流程。

所以本插件走的是客户端自举：

client.js 被 __ModuleLoader__ 加载
   └─ apply() → 读 localStorage 上次配置 → 首帧决定挂不挂（不等 HTTP）
        └─ mountSplash()
             ├─ 往 <body> 插入空壳 <div id="dsh-startup-root"></div>
             ├─ 挂载 /plugins/dsh-haavk-boot/splash.css
             └─ 加载 /plugins/dsh-haavk-boot/splash.js
                   ├─ 自己构建全部 markup（video / HUD / 6 条字幕 / 进度条）
                   └─ 播放 /plugins/dsh-haavk-boot/asset/boot.mp4
                        └─ 按 video.currentTime 点亮 6 条字幕
                             └─ 视频结束 → 溶解 → 移除 root → 解锁滚动

window.__DSH_HAAVK_CFG__ 由上层注入，splash.js 只读不写；markup 只有这一个来源，Host 的 tapIndex 也只注入空壳，避免两处漂移。

驱动只有一条回路：driver ∈ {'video','clock'}。视频能起播就用 video.currentTime；1.6 秒宽限期内没起播，整体切到墙钟；17 秒硬兜底一定放行（绝不锁死黑屏）。

/plugins/dsh-haavk-boot/* 这些路径会被桌面协议层转发给 Host 的 webServer，由 lib/index.js 注册的路由提供文件。

字幕时间轴

#	起	止	文字
1	0.00s	1.43s	信息与你无限，
2	1.53s	3.03s	Relink 重塑未来。
3	3.03s	5.37s	欢迎使用 Relink 三号体验版。
4	5.60s	8.00s	本设备将持续采集上传您的
5	8.00s	10.33s	生理体征、精神状态相关数据，
6	10.53s	13.63s	请在使用前，检阅并签署用户协议。

由 splash.js 里的 CUES 数组控制，改时间轴直接改这个数组。

标题栏按钮怎么隐藏（Windows）

那三个按钮是 Windows 原生绘制的，不是网页元素，z-index 再高压不住。

DSH 的 preload 里有一段逻辑：往 <body> 塞一个隐藏 <span> 探针，读它的计算色，通过 IPC 调 setTitleBarOverlay({color, symbolColor})。

本插件做的：

1. 找到那个探针 <span>，把它的内联色改成 rgba(0,0,0,0)
2. 同时在 body 上覆盖 --dsw-specific-sidebar-fill / --dsw-alias-label-primary（这两个变量定义在 body 上，写 html 无效）
3. poke 一次 body.style，触发 preload 的 MutationObserver 重发 IPC
4. 启动屏结束 → 恢复原值

不需要全屏，窗口模式下也能隐身。

安全兜底

• 首帧用 localStorage 缓存的上次配置决策，不等 /config 回来（避免主界面先闪一下）
• /config 回来若与缓存不一致，会纠正：该撤就撤、该挂就挂（unmountSplash() 会复位 splashScheduled）
• 视频 1.6s 内没起播 → 切墙钟驱动字幕，17s 硬兜底放行
• 视频加载失败 → 直接切墙钟
• splash.js 加载失败 → client.js 的 onerror 移除 root 并解锁
• 任何 try/catch 都吞掉异常，绝不阻塞 DSH 主界面
• 视频路由支持 Range / 206 / ETag 304 / 416，Electron 重播不再重新拉 6.2MB

Host 路由

路径	方法	作用
/splash.css	GET	启动屏样式
/splash.js	GET	启动屏运行时
/asset/boot.mp4	GET	开机视频（支持 Range / 206 / 304 / 416）
/config	GET / PATCH	读 / 写配置
/events	GET	SSE 状态推送
/status	GET	当前状态快照
/logs	GET	遥测日志
/preview	POST	手动触发一次序列预览
/task	POST	后台任务

访问控制基于「本机回环 socket」；Origin: dsh-app://app（桌面壳自定义协议）放行，跨源 http Origin 一律 403。

---

自定义

换视频

# 建议先转成 H.264（HEVC 在 Electron 里可能不播）
ffmpeg -i 你的视频.mp4 -c:v libx264 -profile:v high -pix_fmt yuv420p \
       -crf 20 -preset medium -vf "scale=1920:-2" \
       -c:a aac -b:a 128k -movflags +faststart \
       lib/assets/boot.mp4

改字幕

编辑 lib/splash.js 里的 CUES，同时改 lib/client.js 里 SPLASH_HTML 的 <p id="haavk-cN"> 文案。两边必须条数一致。

改外观

lib/splash.css 里全部是 #dsh-startup-root 作用域下的样式，字体、颜色、位置都在那。

---

设置面板

装好后打开 设置 → 插件 → 哈夫克Relink，可以：

• 启用 / 关闭节点
• 开关开机启动屏
• 开关视觉层（粒子 / HUD）
• 开关音频
• 开关「热重载后重播」
• 一键重播启动屏（同时会 POST 一次 /preview）

改动会写入 ~/.dsh/@shawsheepsussiah/dsh-haavk-boot/settings.json。

---

排错

启动屏不出现？

1. 确认 ~/.dsh/profiles/desktop/package.json 的 bundles 里有 dsh-haavk-boot
2. 确认 plugins/dsh-haavk-boot/cordis.patch.yml 存在（缺这个 loader 不会加载）
3. 完全退出 DSH 再打开（关窗口不算）
4. 看 ~/.dsh/@shawsheepsussiah/dsh-haavk-boot/boot.log，正常应该有：

   apply()  v=0.2.6  webServer=yes  inject=["webServer"]
   route ok /plugins/dsh-haavk-boot/splash.css
   ...
   tapIndex=function
   

打开就弹「应用无法启动或已意外停止 / 1 entry did not activate」？

这是 client.js 注册 id 与包名不一致造成的。控制台里会有：

client-modules: duplicate factory registration for "dsh-haavk-boot"

含义：__ModuleLoader__.load({ id }) 用了不带 scope 的 dsh-haavk-boot，而 Host 的 graph row id 是完整包名 @shawsheepsussiah/dsh-haavk-boot，两边对不上，combo 脚本注册失败后 Host 回退单资源 URL 再执行一次，于是撞 duplicate，整条 boot entry 卡死。

修法：id 必须是 package.json 的完整 name。0.2.2 及更早都有这个 bug，请升到 0.2.6+。

页面白屏打不开？

按 F12 看 Console。如果是 Identifier 'xxx' has already been declared，说明 client.js 顶层有变量声明——本插件所有变量都在 factory 内，不应出现；若你改过代码，把变量包回 factory 里。

字幕和声音对不上？

CUES 的时间是按视频音轨转写出来的。换视频后要重新对齐。

---

兼容性

• ✅ Windows 10/11 桌面版（标题栏隐身仅 Windows 生效）
• ✅ macOS（无标题栏按钮，其余功能正常）
• ⚠️ Web 版：启动屏会正常显示，但 / 页面需要登录态，client.js 加载时机可能略晚

---

许可

MIT

致谢

• 视觉风格来自《三角洲行动》哈夫克 Relink 开机仪式
• 插件架构参考 dsh-dafeiyu 的 slots 注册写法

---

天空属于哈夫克。