Que fait Codex 同窗口启动动画 ?
将随附动画部署到用户电脑，在官方 Codex 主窗口中播放，播放结束后保留为静态壁纸。默认动画包含演唱剪影头像、“欢迎回来”文字、白龙角色背景以及“开始你的下一次创作吧”字幕。头像分辨率为 4096×4096，壁纸为 3840×2160；这些是经过 AI 增强后导出的图片，部分细节经过重建。
安装与日常使用
命令中的 <skill> 指本 SKILL.md 所在目录。请通过当前允许执行脚本的 PowerShell 环境运行（已在本机上使用 PowerShell 7 验证）：
& '<skill>/scripts/manage.ps1' -Action Install
& '<skill>/scripts/manage.ps1' -Action Status
& '<skill>/scripts/manage.ps1' -Action Start
Install 操作会将随附程序复制到 %LOCALAPPDATA%\CodexStartupSameWindow\App，并创建一个使用 GPT 图标的“Codex 启动动画”桌面快捷方式。重复安装会更新已标记的程序目录，但不会清除个人图片和文字。创建技能或安装文件本身不需要关闭或重启 Codex。
如果 Windows PowerShell 5 的系统策略阻止运行 .ps1 脚本，请使用环境中已有的、允许运行的 PowerShell 7；不要为此修改执行策略。如果没有可用的脚本宿主，请交付随附程序和说明，并明确告知安装尚未完成。
Start 操作会调用随附的 CodexSameWindow.exe。如果当前官方应用正常启动但未启用接入，请提示用户保存工作后完全退出，再使用快捷方式启动。不要结束用户的应用进程。
此外，还支持 -Action Settings 打开外观设置、-Action Restore 撤销当前外观，以及 -Action Shortcut 修复快捷方式。接入后可按 Ctrl+Alt+B 打开设置。仅恢复外观不会清空个人设置。
修改头像、图片和文字
根据截图中的位置区分以下字段：
| 用户指向的位置 | 字段 |
|---|---|
| 开场头像正下方的大字 | introTitle |
| 大字下方的小字 | introCaption |
| 后半段角色画面底部的字幕 | artworkSubtitle |
| 聊天壁纸的显示强度，范围 0–75 | wallpaperStrength |
| 开场头像文件 | avatarFile |
| 动画角色图片（会自动生成描线） | artworkFile |
| 聊天壁纸的原始尺寸文件 | wallpaperFile |
仅设置用户要求的字段。将修改内容编写为 UTF-8 编码的 JSON 文件，然后执行：
{"introTitle":"欢迎回来","artworkSubtitle":"开始你的下一次创作吧"}
& '<skill>/scripts/manage.ps1' -Action Set -PatchFile '<绝对路径>/patch.json'
助手需要 Node.js 才能执行 Set 和详细的 Status 操作。如果 PATH 中没有 Node，请使用环境中的依赖定位工具查找，并通过 -NodePath 参数传入。启动、安装、图形设置和恢复功能不依赖 Node。Set -DryRun 只校验输入，不连接应用。
脚本会合并个人设置，立即更新静态背景，并关闭自己打开的临时设置层。下次播放时会显示新图片和字幕；使用 -Replay 可以预览。如果主窗口在后台，预览会跳过，并且不能将跳过报告为已播放。如果设置层已被用户打开，请先让用户保存或关闭，以避免覆盖未保存的操作。
avatarFile 使用原始分辨率，方形图片效果最佳；artworkFile 使用现有的导入器生成 1536×1024 的动画图和匹配的描线；wallpaperFile 保留原始分辨率。更换完整背景时，请同时提供 artworkFile 和 wallpaperFile，以便动画描线和聊天壁纸来自同一张图片。如果用户要求 AI 清晰增强，请在导入前使用可用的图像增强能力，并如实说明重建细节与最终尺寸。
接入边界
仅支持已验证 OpenAI 签名的 Windows 商店包 OpenAI.Codex。启动器通过系统激活接口启用本机 127.0.0.1 上的随机调试端口，校验监听地址、进程归属和主页面。端口随应用进程保留，完全退出后从原始官方图标打开可结束接入。
设置助手仅操作其自有外观层 __aemeathExtension 和 aemeath-startup-images 数据库。不要扩大目标到其他窗口、读取聊天内容，或修改官方安装包、CSP、全局透明度、安全设置或登录状态。如果连接失败，请先检查状态和日志，避免无条件重复注入或中断用户工作。
如需修改默认模板、重新打包、调整时序或排查后台窗口，请阅读 references/maintenance.md。