六幕动画如何跑起来:dsh-startup-screen 启动序列 Promise 链实现原理
六幕动画如何跑起来:dsh-startup-screen 启动序列 Promise 链实现原理
冷启动 DeepSeek Harness 时,dsh-startup-screen 插件会先播一段六幕开机动画:黑幕鲸鱼标识 → 过曝洗白 → 暖白档案底板 → 五步访问授权 → 揭幕。这段 dsh-startup-screen 启动动画能一镜到底地"丝滑"跑完,靠的不是任何动画框架,而是浏览器原生的一串 Promise 链。本文带你拆解它的启动序列:wait() 如何把"等待"串成链、"等人点击"如何融入动画、为什么台词没念完绝不推进,以及跳过与揭幕如何瞬间收尾。
一、先看这段开机动画到底在播什么 🎬
整段动画是一段"技术档案"风格的启动过场,画面从纯黑一路亮到暖白,最后色散故障揭幕。完整时间线如下:
| 幕 | 画面 | 推进方式 | 代码位置 |
|---|---|---|---|
| 第一幕 | 黑幕 + DeepSeek 鲸鱼标识 / "深度求索 / DEEPSEEK" | 自动 | run() |
| 过场 | 过曝洗白(黑 → 灰 → 暖白) | 自动 | run() |
| 第二幕 | 暖白"技术档案"底板:品牌块、页脚、进度条 | 自动 | run() |
| 五步序列 | 访问许可 → 身份确认 → 接收需求 → 读取权限 → 核验通过 | 第 1、2 步等人,其余自动 | stepLoop() |
| 终幕 | WELCOME + 色散故障 + 揭幕 | 自动 | finale() |
所谓"六幕",对应屏幕上那圈六格阶段柱与
[ 00 / 06 ] → [ 06 / 06 ]的步进计数:五步授权 + 终幕欢迎,正好数到 6。
每一步都是"中文大字 + 英文等宽副标题 + 底部日志",英文副标题像终端接收数据一样逐字打出。这套脚本就定义在 STEPS:
| # | 中文主字 | 英文副标题 | 需要操作 |
|---|---|---|---|
| 1 | 需要访问许可 | ACCESS PERMISSION REQUIRED |
点按钮 / 按 Enter / 空格 |
| 2 | 身份资料确认 | IDENTITY VERIFICATION |
点按钮 / 按 Enter / 空格 |
| 3 | 接收访问需求 | ACCESS REQUEST RECEIVED |
自动 |
| 4 | 开始读取权限 | PERMISSION READ STARTED |
自动 |
| 5 | 读取完毕 · 核验通过 | READ COMPLETE · VERIFIED |
自动 |
| 6 | 欢迎「身份名称」访问 | WELCOME, NAME |
自动 |
二、整段动画 = 一条 Promise 链 🔗
这是理解全篇的关键:没有 requestAnimationFrame 手写循环、没有动画库、没有状态机,整条时间线就是 Promise.resolve() 后面接一长串 .then()。每"等一会儿、做一个动作"就是一个 .then(),动作做完把控制权交给下一个 .then()。
run() 的骨架简化后是这样:
// lib/splash.js 简化示意
function run() {
return Promise.resolve()
.then(() => wait(820)) // 第一幕:黑幕 + 鲸鱼标识
.then(() => { /* 过曝洗白 */ return wait(760) })
.then(() => { /* 暖白底板 / BOOT */ return wait(700) })
.then(() => stepLoop()) // 五步交互 / 自动序列
.then(() => finale()) // 终幕:色散故障 + 揭幕
.catch(() => finish()) // 任何异常 → 直接揭幕
}
这条链之所以"稳",是因为它只有三种"停顿",全部交给三个小函数去管:定时等待、等人交互、等音频播完。下面逐个拆开。
三、wait():把"等待"变成可串联的一步 ⏱️
动画里所有"停 N 毫秒",都不是 setTimeout 回调里再手动触发下一步,而是把 setTimeout 包成一个 Promise,让 .then() 链自然等它完成:
function wait(base) {
return new Promise(function (resolve) {
if (skipped) return resolve() // 已跳过 → 立即放行
var t = setTimeout(resolve, ms(base)) // ms() 会按"速度"缩放
timers.push(t) // 记下定时器,供 releaseAll() 回收
})
}
两个细节很关键(见 wait / ms):
- 速度缩放:
ms(base)会除以C.speed。设置页把速度调到3×,整段动画就等比变快,不用改任何时间数字。 - 登记定时器:每个
setTimeout的句柄都推进timers数组。这是后面"跳过 / 揭幕瞬间收尾"能成立的伏笔——只要能把这些定时器一次性清掉,链就立刻走到头。
四、waitAction():让"等人点击"融入启动序列 👆
第 1、2 步不是播完就走,而是要等你点按钮或按 Enter / 空格。在纯定时链里做"等人"很别扭,但用 Promise 就顺理成章——一个永远不自己 resolve、只等用户手势才 resolve 的 Promise:
function waitAction() {
return new Promise(function (resolve) {
if (skipped || !C.requireInteraction) return resolve() // 允许跳过 / 关闭确认
ui.btn.addEventListener('click', resolve) // 点按钮
document.addEventListener('keydown', onKey) // Enter / 空格
// 用户不动作,链就停在这一步,直到手势触发 resolve
})
}
于是"等人"这一环被无缝嵌进了 .then() 链里:上一步播完 → 弹出按钮 → 挂在 waitAction() 上等你 → 你一点,链才继续走下一步。想关掉确认?把 requireInteraction 设为 false,这个 Promise 会直接 resolve,五步全部变成自动。
五、音频驱动节奏:台词没念完绝不推进 🎙️
启动动画的"停留时长"不是写死的,而是由实际音频时长决定。voice.line() 播一句台词,返回一个"这一句实际花了多久(ms)"的 Promise:
var spoke = voice.line(step.say, step.zh, step.audio) // Promise:实际播了多久
function holdFor(spoken) {
var target = Math.max(ms(step.hold), (spoken || 0) + ms(240)) // 台词长就多停
return wait(Math.max(0, target - spoken))
}
return spoke.then(holdFor) // 台词真正念完,才推进到下一步
(见 stepLoop 与 holdFor)这里有两个刻意的设计:
max(视觉基准, 实际时长 + 240ms 收尾):台词短不会干等,台词长就老老实实多停一会儿。- 不掐断语音:
speechSynthesis本身是队列,voice.line()不会cancel上一句。所以你点得再快,也不会把刚念到一半的台词硬生生掐断——只有"跳过 / 揭幕"才真正cancel()。
六、releaseAll():跳过与揭幕如何瞬间收尾 🚀
右上角的 SKIP ▸、按 Esc,或走到终幕揭幕,本质都是同一招:把所有"挂起"的 Promise 一次性放行。
function releaseAll() {
for (var i = 0; i < timers.length; i++) clearTimeout(timers[i]) // 清掉所有定时器
var list = waiters.slice()
for (var j = 0; j < list.length; j++) { try { list[j]() } catch (e) {} } // 逐个 resolve
}
requestSkip() 就是三步:置 skipped = true → releaseAll() → finish()。因为 wait() / waitAction() 里都登记了"我完成时的收尾函数"(waiters),releaseAll() 把它们挨个调用,链上所有还没到的 .then() 会瞬间连环 resolve,动画在视觉上"快进"到揭幕。
七、两道保险:绝不把用户留在黑幕里 🛡️
启动界面是把首屏整个盖住的,所以最怕"播到一半卡死 = 永久黑屏"。项目用双保险守住这条线:
- 链尾
.catch:run()末尾接了.catch(() => finish()),时间线里任何一步抛异常,都会直接揭幕、摘掉黑幕(见.catch)。 - 9 秒硬兜底:初始化时挂了一个与动画无关的
setTimeout,9 秒内如果黑幕类名dsu-boot还在,就无条件把黑幕移除、解锁滚动(见 兜底逻辑)。Host 侧lib/index.js还内置了一份同款"兜底脚本",连splash.js都没跑起来时也能放行。
finish()(见 实现)负责收尾:还原桌面端标题栏、停掉语音、按"每次会话 / 每天"写入持久化标记、移除根节点、派发 dsh-startup:done 事件。
八、关键文件与延伸阅读 📁
想继续往下挖,从这几个入口读起即可:
| 文件 | 作用 |
|---|---|
lib/splash.js |
浏览器端运行时:六幕时间线、wait / waitAction / releaseAll 全在这里 |
lib/index.js |
Host 半侧:注入首屏、注册 splash.css / splash.js / 配置路由、写 JSON 配置 |
lib/client.js |
浏览器半侧自举:Host 未注入时由客户端自己把动画挂起来 |
test/smoke-splash.mjs |
冒烟测试:用最小 DOM 桩把整条链跑一遍,断言"不抛异常、必摘黑幕、不掐断语音" |
AUDIO-FIELDS.md |
语音 / 音效槽位与"时长怎么定"的完整清单 |
README.md |
功能、播放序列、三十三项设置 |
package.json |
版本 1.1.2、npm test 跑四套测试共 227 项断言 |
想亲手把整条链跑起来看效果:
npm test会用 DOM 桩把smoke-splash.mjs的六幕初始化完整走一遍——它专门守住"初始化不许抛异常、跑完必须摘掉dsu-boot(否则就是黑屏)"这条底线。
一句话总结:dsh-startup-screen 把"开机动画"拆成了三类可串行的 Promise——定时等待 wait()、交互等待 waitAction()、音频等待 voice.line()——再用 releaseAll() 一键放行、.catch + 9 秒兜底兜住异常。没有框架、没有依赖,仅靠浏览器原生的 Promise,就跑出了一段六幕连贯、可交互、绝不卡黑屏的启动序列。