给 Codex 装龙娘启动器与紫璃桌宠:修好交接黑屏、窗口二次重排和精灵图糊帧
本文目录(4 节)
10 月中旬我给本机的 Codex 桌面端(WindowsApps 包版本 26.1007.2314.0)装了两个第三方美化项目:一个是桌宠资源包 zili-codex-pet(紫璃),另一个是带开场视频与主题注入的启动器 DragonCodexBoot(配合 Codex-Dragon-Atelier 龙娘工坊主题)。
装完文件校验全过,但实际从桌面点开用起来,连着暴露出三个非常破坏体验的毛病:桌面快捷方式直接绕过了启动动画、紫璃桌宠在屏幕上肉眼可见地发糊,最头疼的是开场视频播完了,切过去的 Codex 主窗口还在转圈加载,紧接着又因为窗口最大化闪跳一次。
1. 快捷方式绕过与紫璃 spritesheet.webp 放大发糊
前两个问题定位起来很快:
- 启动动画没触发:安装脚本默认只在开始菜单生成了
Dragon Codex Boot.lnk,而我平时双击的桌面ChatGPT.lnk和任务栏固定图标仍然直接指向C:\Program Files\WindowsApps\OpenAI.Codex_...\app\ChatGPT.exe。把原快捷方式备份到F:\CodexBeautify\backups\repair-20261015-113802后,将桌面ChatGPT.lnk的TargetPath改为F:\CodexBeautify\DragonCodexBoot\DragonCodexBoot.exe,并保留原 Codex 图标。 - 紫璃桌宠发糊:检查
C:\Users\30408\.codex\pets\zili\spritesheet.webp的流信息,原图集是8×11网格,单帧只有192×208(整图1536×2288)。在高分屏缩放下被客户端拉大后边缘发虚。我用ffmpeg在保持透明通道与8×11帧网格不变的前提下,生成了3072×4576(单帧384×416)的 2× 锐化图集替换进去,进设置切一下其他宠物再切回紫璃就清晰了。
2. 为什么动画放完了,Codex 还在加载?
真正花工夫的是启动器与主界面的交接时机。
去读 F:\CodexBeautify\repair\DragonCodexBoot.local.cs 和 Start-Integrated.ps1 的源码,才发现原版启动器的判断非常粗糙:
- 启动器拉起
ChatGPT.exe后,只用 Win32 检查目标进程是否出现顶层窗口且Responding == true,一旦满足就开始把启动视频淡出; - 但 Electron 壳的顶层窗口建好时,里面的 WebView(
app://-/index.html)才刚开始挂载 React 树、加载字体和注入Codex-Dragon-Atelier龙娘主题图片; - 更糟的是,原版启动器在视频淡出结束的那一拍才调用最大化窗口,等于用户刚看到半成品界面,窗口尺寸又猛地跳变重排一次。
3. 用 CDP 9446 端口探针等待 DOM、字体与主题真就绪
要让视频结束时切过去就是已经渲染完备的主界面,不能只看 Win32 窗口句柄,必须直接问渲染进程。
因为 Start-Integrated.ps1 在拉起 Codex 时本就会开本地调试端口 127.0.0.1:9446 来注入龙娘主题,我在 F:\CodexBeautify\DragonCodexBoot\scripts\Wait-ForUi.mjs 里写了一个独立的就绪探针,专门连接 9446 端口并排除 /avatar-overlay 桌宠悬浮窗,只盯主界面:
export const readinessExpression = `(() => {
const visible = element => {
if (!element) return false;
const rect = element.getBoundingClientRect(), style = getComputedStyle(element);
return rect.width > 20 && rect.height > 10 && style.visibility !== 'hidden' && style.display !== 'none';
};
const main = document.querySelector('main[data-app-shell-main-surface]');
const editor = document.querySelector('[data-codex-composer][contenteditable="true"]');
const settings = document.querySelector('[role="dialog"], [data-settings-page]');
const theme = window.__DRAGON_ATELIER__?.status;
const shell = visible(main), composer = visible(editor) && editor.getAttribute('aria-disabled') !== 'true';
const settingsReady = theme?.reason === 'settings' && visible(settings || main);
const fonts = !document.fonts || document.fonts.status === 'loaded';
const ready = document.readyState === 'complete' && shell && (composer || settingsReady) && fonts && theme?.active === true;
return {
ready,
reason: !shell ? 'app-shell' : !(composer || settingsReady) ? 'composer' : !fonts ? 'fonts' : !theme?.active ? 'theme' : 'settling',
layout: [innerWidth, innerHeight, main?.clientWidth || 0, editor?.clientWidth || 0].join(':')
};
})()`;
除了检查主工作区 main[data-app-shell-main-surface]、输入框 [data-codex-composer]、document.fonts.status 和 window.__DRAGON_ATELIER__.status.active,探针还会对 #dragon-atelier-scene .da-dragon 里的背景立绘全部跑一遍 image.decode(),并且要求 layout 连续稳定不抖动后,才通过原子重命名写入 runtime/ready-<token>.json。
4. 移除视频线程轮询与提前窗口定位
同步修改了 DragonCodexBoot.local.cs 并用 Build-Repair.ps1 重新编译了本地 DragonCodexBoot.exe:
- 把进程与文件检查移出 UI 播放线程:避免启动器自己在轮询时卡顿视频帧;
- 提前完成窗口尺寸定位:在后台窗口真正淡入揭幕前就把目标窗口的位置与最大化状态固定好,交接阶段只做纯粹的透明度交叉淡入,不再触发二次 resize;
- 慢启动兜底等待:如果遇上冷启动超过动画时长,启动器会停在视频尾段保持画面,直到收到
ready-<token>.json的ready信号才执行淡出交接。
实测桌面热启动约 2.9s 收到完整就绪信号;用 Test-DelayedHandoff.ps1 模拟冷启动人为延后 17 秒,启动器也能稳稳停在动画尾段等待,揭幕瞬间主界面、输入框和龙娘立绘全部就位,不再有白屏和闪跳。