用途:该技能用于在 /home/amwill/Applications/codex-app 目录下,从最新上游 Codex Mac 制品更新 codex-app 的 Linux 移植版,同时保留本地 Linux 补丁并安装刷新后的桌面应用。
主要能力:从 https://persistent.oaistatic.com/codex-app-prod/appcast.xml 获取最新官方上游 Mac 制品并核对版本/构建号;用 --app-asar 或 --dmg 刷新 desktop/recovered/app-asar-extracted;保留 desktop/scripts/assemble-codex-runtime.mjs 中的 Linux 行为补丁,包括隐藏标题栏、原生菜单隐藏、外部浏览器路由、打开目标注册表、宠物/头像悬浮层的稳定性、命中测试与活动气泡尺寸等;将重建运行时安装到 ~/.local/opt/codex-desktop/<version>-<build> 并重指向 current。
使用方式:下载 appcast.xml 取首个 arm64 条目,下载其 enclosure URL(通常为 Codex-darwin-arm64-<version>.zip),确认 Info.plist 版本与 app.asar 哈希;在 desktop 下运行 desktop/scripts/refresh-recovered-from-dmg.mjs --app-asar <path-to-app.asar> --output ./recovered/app-asar-extracted(DMG 用 --dmg ../Codex.dmg);更新 desktop/package.json、package-lock.json 及固定版本元数据的测试;验证补丁保留可运行 node --check desktop/scripts/assemble-codex-runtime.mjs、npm test -- --runInBand tests/linux/recovered-bundle.red.test.ts、npm run test:linux、npm run test:linux:codex-package;用 desktop/scripts/build-codex-linux-runtime.mjs 构建到 desktop/out/Codex-linux-x64-codex-<version>-<build>,复制到 ~/.local/opt/codex-desktop/<version>-<build> 并更新 current;校验桌面入口与 autostart 均通过 /usr/bin/env ELECTRON_OZONE_PLATFORM_HINT=x11 ... --ozone-platform=x11 启动;用 readlink -f ~/.local/opt/codex-desktop/current 及检查 app.asar 元数据与补丁标记验证安装。若用户要求发布,则提交、推送 main、打 v<version> 标签并等待 .github/workflows/linux-release.yml 发布资产。
适用场景:维护该 Linux 移植版、同步上游版本、保留 Linux 专属补丁并发布 Linux 包。
限制:仅可在 /home/amwill/Applications/codex-app 下使用;仓库当前没有 Arch 包发布通道,除非工作流已扩展并验证,否则不要声称已发布;下载的上游制品、desktop/tmp 与 desktop/out 为生成输入/输出,除非仓库策略变更否则不要提交;标签推送后若 GitHub 提示 release not found,应观察工作流,发布由标签驱动的工作流在资产发布后创建。