Dragon Codex Boot
给 Windows 版 Codex 桌面客户端播放自定义启动动画，并把动画结尾自然交接到真实、可操作的软件窗口。
社区独立项目，与 OpenAI 无隶属关系。 源码使用 MIT 许可证。仓库与默认程序包包含一段完整的 1080p 龙娘启动动画，解压即可播放，也支持换成自己的 MP4。视频许可说明见 随附媒体说明。
它做什么
- 居中播放启动视频，默认窗口为 1920 × 1080 物理像素。
- 同时打开已安装的 Codex 客户端；如果客户端已开，衔接到现有窗口。
- 客户端尚未出现时，在可配置的动画节点暂停等待。
- 把真实客户端客户区对齐到播放窗口，以 Windows DWM 实时缩略图填入动画里的屏幕。
- 随着动画屏幕扩大，真实界面逐渐显现；视频结束后撤掉播放窗口，把操作交还给客户端。
支持 Esc 跳过、自定义音量、衔接时段、屏幕矩形关键帧，以及首次运行时自动替换启动快捷方式。DWM 连接失败时使用淡出交接。
默认配置来自一段约 14 秒、16:9 的动画：11.3 秒等待节点，12.7–13.65 秒交接。这些时间和屏幕坐标必须按自己的视频修改，不是适用于所有视频的通用模板。
环境
- Windows 10/11 x64，.NET Framework 4.8。
- 已安装 Windows 版 Codex 桌面客户端。
- 本地 MP4，建议 H.264 视频与 AAC 音频、16:9。
- 播放依赖 Windows 自带媒体能力。Windows N 等缺少媒体组件的系统可能无法播放。
播放不需要 Node、Python、NuGet、API key、视频生成服务或管理员权限。修改其他用户或公共目录中的快捷方式可能需要管理员权限；失败会记录到报告，程序不会自行弹出提权请求。
下载版：解压后直接运行
从仓库的 Releases 下载 DragonCodexBoot-版本-win-x64-with-video.zip，解压到一个长期保留的位置，然后双击 DragonCodexBoot.exe。
程序包已经包含 media/startup.mp4 与匹配这段动画的配置。已安装 Codex 且客户端标识与示例一致时，即可播放动画并接入客户端；标识不一致时参考 配置说明 更新 AppLaunch。
默认自动替换启动入口
首次运行会自动替换指向配置中官方客户端的 .lnk 快捷方式。 下载文件本身不会改变电脑。
- 先检查桌面、开始菜单程序目录、公共桌面、公共开始菜单，以及任务栏/快速启动的快捷方式目录。
- 默认继续查找所有本地固定磁盘上的可访问快捷方式，后台运行，最多扫描 5 分钟。跳过 Windows、回收站、链接目录、运行时/缓存目录和启动器自身目录。
- 用实际目标、精确的 AppsFolder 应用 ID 或已安装应用包的可执行文件匹配；同名的其他程序、网页链接不改。
- 已有快捷方式的名称和图标保留，目标改为动画启动器。当前用户桌面和开始菜单缺少对应入口时，补建一个使用已安装客户端名称和本机图标的入口。
- 每个改动先备份原始文件、记录 SHA-256，再替换并复核。扫描结果在
.integration/report.json；下次启动不会重复扫描。
解压目录必须长期保留，替换后的快捷方式会指向该目录。删除或搬走程序前，先双击 Restore-Original-Entrypoints.cmd 恢复。 它只恢复仍与安装记录相符的快捷方式；后来被你修改或删除的入口会保留。恢复后再次播放动画不会自动重新替换。
新增了快捷方式，或希望重试权限不足的公共目录时，双击 Rescan-Entrypoints.cmd。必要时右键这个文件选择以管理员身份运行。
覆盖范围：可识别且可写的启动快捷方式。 MSIX 注册的“所有应用”/搜索结果、原有开始菜单固定项、直接运行官方 exe、协议链接及第三方程序内部调用不由 .lnk 替换统一控制。任务栏可能缓存旧启动信息，需要取消固定后重新固定修改过的入口。程序报告分别显示这些限制，不能把文件替换成功当成“全机所有入口已接管”。
如果不希望修改任何入口，在首次启动前把 launcher.json 中的 AutoReplaceEntrypoints 改为 false。详见 入口替换和恢复。
换成自己的动画
-
在该目录打开 PowerShell，将自己的视频导入：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Import-Animation.ps1 -VideoPath "D:\Animations\startup.mp4"
-
用文本编辑器打开同目录的
launcher.json，按视频修改等待节点、过渡时间和屏幕位置。详见 配置说明。 -
双击
DragonCodexBoot.exe。它播放动画，然后进入真实 Codex。
导入脚本复制视频到 media/startup.mp4，验证副本哈希，已有视频和配置会保留备份。它只导入文件，不分析、重新生成或自动修改分镜。
固定到开始菜单
首次运行已经创建或替换可识别的开始菜单快捷方式。对于 Windows 原先固定的官方应用，取消原固定项，再固定下载目录中的 DragonCodexBoot.exe 或已修改的快捷方式。
如果希望额外创建一个社区名称的独立入口，可使用原有脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-start-menu.ps1
随后在资源管理器中右键 DragonCodexBoot.exe，选择 固定到“开始”。
只恢复这个额外的社区名称入口：先在开始菜单取消其固定，再执行：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-start-menu.ps1 -Action Restore
这段兼容脚本只管理 Dragon Codex Boot.lnk。恢复首次运行的批量替换请使用 Restore-Original-Entrypoints.cmd。
从源码构建
克隆或下载源码，在仓库根目录运行：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\test.ps1
输出位于 build/DragonCodexBoot/。首次构建复制配置模板；再次构建保留已有的 launcher.json。
导入自己的视频：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Import-Animation.ps1 -VideoPath "D:\Animations\startup.mp4"
制作包含随附演示视频的可分发程序包：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\package.ps1
包和 SHA-256 文件写入 dist/。默认使用公开配置模板与仓库中的 media/startup.mp4，不会自动把后来导入到本机 build 目录的个人视频打包进去。可加 -WithoutMedia 生成不含视频的程序包。
自定义名称与图标
-
显示名：修改配置中的
DisplayName。 -
图标：构建时可传入自己有权使用的
.ico：powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build.ps1 -IconPath "D:\MyAssets\my-icon.ico"
公开默认名是 Dragon Codex Boot。官方图标不包含在仓库或默认发布包中；本机私人版本可继续使用自己的名称和图标设置。
当前实现的限制
- 为 16:9 视频设计；实际显示器小于配置的物理窗口尺寸时可能超出屏幕，应降低
PlayerWidth/PlayerHeight。 - 找到“可见、可响应且稳定”的客户端窗口是一种启发式检查，无法证明所有后台任务已加载完。
MatchClientToPlayer: true会恢复并移动、调整真实客户端窗口，结束后保留该位置和尺寸。- 动画里的生成式界面和真实界面可能不同；最好让最后屏幕的比例、配色、结构接近真实软件。
- DWM 缩略图在过渡阶段只显示实时画面，交接完成后才能操作真实客户端。
- 默认入口替换受权限、扫描范围和时间预算限制。开始菜单/任务栏的固定缓存不等同于目录里的
.lnk。 - 不改写官方应用包，不安装持续监听服务，也不设置开机自启。
项目结构
src/ C# WPF 启动器与 DPI 清单
config/launcher.example.json 公开配置模板
scripts/ 构建、导入、测试、快捷方式和打包
tests/ 配置、几何定位及隔离快捷方式恢复测试
docs/ 配置、发布与手动验收
.github/workflows/ Windows 构建及程序包检查
日志在启动器目录的 logs/launcher.log，记录步骤和错误；不保存聊天正文或画面，没有网络遥测。手动验收说明真实窗口检查的范围。
参与改进请阅读 贡献说明。软件许可见 LICENSE，媒体和第三方名称说明见 THIRD_PARTY_NOTICES.md。