dsh-haavk-boot: Adding HAAVK Relink Boot Animation to DeepSeek Harness

前言

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,可:

  1. 启用 / 关闭节点
  2. 开关开机启动屏
  3. 开关视觉层(粒子 / HUD)
  4. 开关音频
  5. 开关「热重载后重播」
  6. 一键重播启动屏(会 POST /preview)

配置写入 ~/.dsh/@shawsheepsussiah/dsh-haavk-boot/settings.json。

换视频建议转 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。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye