哈夫克开机动画 ShawSheepSussiah/dsh-haavk-boot

dsh-haavk-boot

Listed on dsh-plugin.org

哈夫克 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> 插入空壳 ├─ 挂载 /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> 塞一个隐藏 探针，读它的计算色，通过 IPC 调 setTitleBarOverlay({color, symbolColor})。

本插件做的：
1. 找到那个探针 ，把它的内联色改成 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 的 文案。两边必须条数一致。

改外观

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 注册写法

天空属于哈夫克。