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 啟動動畫」桌面捷徑。重複安裝會更新已標記的程式目錄,不會清除個人圖片和文字。建立 skill 或安裝檔案本身不要求關閉、重新啟動 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。