npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@shawsheepsussiah/dsh-haavk-boot

v0.2.7

Published

HAAVK Relink boot splash for DeepSeek Harness (DSH): fullscreen boot video, 6 timed captions, particle layer, native titlebar hiding, and a settings tab. 哈夫克 Relink 节点启动固件:全屏开机视频 + 逐句字幕 + 粒子层 + 标题栏隐身 + 设置面板。

Readme

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> 插入空壳 <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 注册写法

天空属于哈夫克。