# XFESystem 品牌启动动画

本次交付标签为 `0.3.0-dev.4-bootsplash.1`，沿用双版本自研 C# 内核和已有网页加载优化。按用户补充要求保留原有 Desktop / Console 选择菜单，进入加载阶段后只显示黑底、现有蓝色星环 Logo、`XFESystem` 字样和必要时的加载环。

![动画设计预览](boot-animation/XFESystem-BootAnimation.gif)

## 动画节奏

主动画约 2.4 秒：黑底起始，蓝色环形光轨展开，Logo 从中心显现；XFESystem 字样淡入，一道冷色高光扫过后，光轨收束为稳定 Logo。系统首帧提前准备好时仍完整播放主动画，结束后直接进入控制台或桌面。首帧尚未准备好时，保持 Logo 与字样，下方显示两组反向旋转的分段轨道和光点；没有百分比、版本号、阶段编号或提示语。

![实际原生等待画面](boot-animation/Native-Waiting.png)

## 实际接入

`Source/XFESystem.NativeKernel/BootVisual.cs` 是共享的整数绘制器，`BootLogoData.cs` 来自已有图标和 Cascadia Mono 字形。`Tools/BootAnimationPreview` 使用同一绘制器生成设计帧；启动时直接由自研内核的独立调度线程运行，不播放预录视频、不启动浏览器，也不依赖图形桌面或额外动画库。

`BootSplash.cs` 分配临时原生帧缓冲，先完成绘制再复制到实际 framebuffer，避免逐像素清屏时 Logo 和字样闪烁。临时缓冲在首帧交接前释放。图形版通过 `BootFramebufferPresenter`，控制台通过 `ConsoleMemoryFramebuffer` 的首帧回调，在完整像素已准备好时调用 `xfe_runtime_boot_complete`；主动画完成且应用准备好后，内核才移交显存写入权。等待动画由真实就绪状态控制，不伪造进度。

EFI 正常路径不再显示分辨率提示和链式加载错误文字；默认仍按既有显示策略选择分辨率，并保留按需 F2 显示设置。Limine 保留双系统菜单，`terse` 关闭正常内核加载消息；独立镜像使用静默加载。内核诊断条已移除，GC、线程、输入等诊断继续保留在串口日志。覆盖范围为本系统接管后的加载过程；主板或 UEFI 自己在此前显示的画面不由内核控制。

## 验收范围

新增宿主检查覆盖就绪门槛、动画边界、字体区域、通道掩码、显存行距和保护区域，以及完整首帧只交接一次。QEMU 对启动过程逐帧截图，检查中心品牌区域之外全为黑色、Logo 和字样真实出现、实际像素随时间变化，并核对主动画完成、首帧就绪和界面呈现的先后顺序。

快速路径使用真实 Console / Desktop 应用验收。慢速分支另用相同动画源文件的原生内核诊断镜像：故意不启动应用，确认加载环真实持续显示且不提前交接；该诊断不算桌面、控制台或托管运行时验收。另保留无串口启动和原有 Bing、Monaco、Markdown、终端回归。完整结果、哈希和 U 盘记录见 [验证摘要](validation-results/BootAnimation20261015.json)。

仍是 RAM-only、单 BSP、软件渲染实验系统。实体启动与输入、GPU/CUDA、SMP、实际刷新率和长期稳定性没有由本次动画测试取得验收。