dsh-boot-sequence
DSH 的启动界面：黑底白字的数据流 + 终端安全启动序列。
打开 DSH 时先来一段约 4 秒的「安全启动」过场：白色字符雨铺满整屏，左边一台终端逐行打印自检日志，进度条一路解压到 100%，最后 ACCESS GRANTED 一闪，整屏淡出，进入正常界面。
- 纯前端、零依赖、零模型调用、不发任何网络请求
- 任意点击 / 按键即可跳过；默认每个会话只播一次，刷新不重复轰炸
- 字体无关：LOGO 用 SVG 点阵画，不依赖任何机器上的等宽字体
- 同一份代码可以脱离 DSH 在浏览器里直接预览（
preview.html）
安装
插件放在 ~/.dsh/local-plugins/，并在 profile 里登记。仓库自带脚本，一条命令搞定（会先备份 profile 的 package.json）：
node tools/install.mjs # 安装到 desktop profile
node tools/install.mjs --dry-run # 只看会改什么
node tools/install.mjs --uninstall
装完重启 DSH 生效。
手动安装等价于三步：
- 把本目录复制到
~/.dsh/local-plugins/dsh-boot-sequence
~/.dsh/profiles/desktop/package.json 里加依赖
"dsh-boot-sequence": "link:C:/Users/<你>/.dsh/local-plugins/dsh-boot-sequence"，
并在 dsh.profile.bundles 数组末尾加 "dsh-boot-sequence"- 在
~/.dsh/profiles/desktop/node_modules/ 下建一个指向第 1 步目录的链接
交互
| 操作 | 效果 |
|---|
| 点击 / 任意键 | 跳过：立刻满进度 + ACCESS GRANTED，0.3 秒后淡出 |
Ctrl + Alt + B | 重播（不受「每会话一次」限制） |
控制台 dshBootSequence.replay() | 同上 |
配置
在 DSH 页面的控制台里改 window.DSH_BOOT，下次播放生效：
window.DSH_BOOT = {
duration: 3000, // 进度条跑满的时长（ms）
grantedHold: 780, // ACCESS GRANTED 停留（ms）
fadeOut: 520, // 淡出时长（ms）
oncePerSession: true, // 每个会话只播一次（sessionStorage 记账）
rain: true, // 数据流
hex: true, // 右侧十六进制流
spectrum: true, // 底部频谱条
safeTop: null, // 顶部安全区（px）。留空则自动测量桌面端标题栏高度
};
右上角是桌面端的窗口按钮（最小化 / 最大化 / 关闭），所以那里什么都不放：
SESSION 0x… / 时钟 和硬件信息都收在右下角，顶部只留左角一行 DSH // SECURE BOOT。
Tauri 桌面端会读标题栏高度（--dbs-top）让顶部元素避开，浏览器里为 0，布局不受影响。
只想在开发时看一次：打开 preview.html，或在 URL 后加 ?hold=boot / ?hold=granted 把画面冻结在对应阶段。
想模拟桌面端标题栏：加 ?safeTop=32，预览页会画一条假的标题栏和三个窗口按钮。
结构
package.json # dsh.bundle.patch + dsh.client（web）
cordis.patch.yml # 往配置树里插一行 bundle
lib/index.js # 宿主半侧：故意为空（纯客户端插件）
lib/client.js # 浏览器半侧：整屏动画引擎
preview.html # 脱离 DSH 的预览壳（迷你模块加载器 + 迷你 React）
tools/install.mjs # 安装 / 卸载
tools/shot.mjs # 用本机 Chrome + CDP 拍时间轴截图
它是怎么挂上去的
浏览器半侧导出标准的 Cordis 三件套 name / inject / apply，在 apply 里往官方的全屏叠加槽注册自己：
ctx.slots.inject('shell.overlay', function* () {
yield ctx.slots.register(
{ name: 'shell.overlay', id: 'boot-sequence', order: 9000 },
() => h(BootOverlay, {})
);
});
用 generator + yield 的叠加式注册，不会顶掉桌宠等其它插件在同一槽位里的条目。
为什么动画不写在 React 里
lib/client.js 里的引擎是纯 DOM + Canvas：React 组件只负责在挂载时启动、卸载时清理。好处是同一份引擎代码可以在 preview.html 里用几十行迷你运行时跑起来——预览看到的就是 DSH 里跑的，不存在「预览版和正式版不一致」。
几个实现细节：
- 字符雨：每列按整格下落，每帧用
rgba(0,0,0,.055) 盖一层做拖尾衰减；少数列标成 hot，带辉光
- LOGO：5×7 点阵 → SVG
<rect>，一行里连续的格合并成一个矩形，避免缩放时的接缝
- 终端日志：一行一行打字，光标跟着走；
[FAIL] 那一行是故意的，下一行会 recovered
- 可读性：数据流上盖一层左深右浅的渐变，左边终端区始终压得住
卸载
node tools/install.mjs --uninstall
再把 ~/.dsh/local-plugins/dsh-boot-sequence 删掉即可。
License
MIT
