Wangnov/Codex-App-Manager

它是什么

Codex App Manager 是一款跨平台桌面程序，用于处理官方 OpenAI Codex 桌面应用的安装、更新和卸载。你只需运行此管理器，它就会负责处理 Codex 应用本身——你无需单独下载 Codex。该管理器不会构建或修改 Codex；它仅管理围绕 Codex 的安装和更新体验。

它能做什么

• 安装 Codex — 检测你的电脑上是否已安装 Codex 并规划正确的安装流程。
• 更新 Codex — 在 macOS 上，它仅下载版本之间的差异（“差分”包），逐字节验证签名，替换旧版本，并在出现问题时自动回滚。在 Windows 上，它获取 MSIX 或便携版构建，暂存更新，并在之后运行健康检查。
• 卸载 Codex — 干净地移除它。
• 启动 Codex — 一键启动。
• 自我更新 — 管理器通过其自身的镜像系统（见下文）保持自身更新。
• Codex 主题化 — 它是 awesome-codex-skins 库的官方运行时。用户可以立即（试用）或持久地将皮肤应用到正在运行的 Codex 上。皮肤通过 Chrome DevTools Protocol (CDP) 注入，不会修改任何应用文件，因此应用的签名保持有效。

平台

• macOS: Apple Silicon (arm64) 和 Intel (x64)
• Windows: x64 和 ARM64

安装

• macOS (推荐): brew install --cask wangnov/tap/codex-app-manager
• 直接下载: 从 GitHub Releases，或从在中国大陆无需 VPN 即可工作的镜像链接 (codexapp.agentsmirror.com) 下载。

如何在中国保持可访问性

管理器和 Codex 下载共享一个短链接 (codexapp.agentsmirror.com)。Cloudflare Worker 会自动路由流量：全球用户从 Cloudflare R2 获取文件，而中国大陆用户会被重定向到 IHEP S3（中国科学院高能物理研究所）的预签名 URL。由于更新签名是对安装程序字节（而非 URL）进行签名，因此字节完全相同的镜像副本依然有效。

自我更新顺序

1. 其自身的镜像 (codexapp.agentsmirror.com/manager/latest.json)
2. GitHub 回退 (github.com/Wangnov/Codex-App-Manager/releases/latest/download/latest.json)

因此，它完全可以在不依赖 GitHub 的情况下进行自我更新。

签名状态

• macOS: 已进行 Developer ID 签名 + Apple 公证 → Gatekeeper 不会阻止首次启动。
• Windows: 安装程序暂未进行 Authenticode 签名（SmartScreen 可能会发出警告）；自我更新包带有 Tauri 更新程序签名，仅验证下载的字节，不验证 Windows 发布者信任。README 中提到计划使用付费的云端 HSM 证书，但目前尚未到位，当前下载内容不得描述为已签名。

技术栈

• 前端: React 19, TypeScript, Vite, GSAP (动画)
• Shell: Tauri v2 (无边框弹出窗口)
• 后端: Rust 命令层，包含两个独立的引擎 crate: codex-mac-engine (Sparkle) 和 codex-win-engine (MSIX/便携版)

它不做什么

• 不会修改或重新打包 Codex 安装程序。
• 不会绕过 OpenAI/Microsoft 的授权或本地安装策略。
• 不会伪造或重新计算 Sparkle 签名 — 官方签名被逐字复制。
• 不是官方 OpenAI 或 Microsoft Store 分发的替代品。

语言支持

11 种语言，根据系统区域设置自动选择（包括从右向左书写的阿拉伯语）。

许可证

MIT。该项目与 OpenAI 或 Microsoft 没有任何关联或背书关系。