六幕动画如何跑起来:dsh-startup-screen 启动序列 Promise 链实现原理

原创2026-11-05 11:22:261,910 阅读

六幕动画如何跑起来: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,动画在视觉上"快进"到揭幕。

七、两道保险:绝不把用户留在黑幕里 🛡️

启动界面是把首屏整个盖住的,所以最怕"播到一半卡死 = 永久黑屏"。项目用双保险守住这条线:

  1. 链尾 .catch:run() 末尾接了 .catch(() => finish()),时间线里任何一步抛异常,都会直接揭幕、摘掉黑幕(见 .catch)。
  2. 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,就跑出了一段六幕连贯、可交互、绝不卡黑屏的启动序列。

登录后查看全文
dsh-startup-screen