Wangnov / codex-app-mirror

codex-app-mirror 
 把官方 Codex 桌面应用安装包，原样、可校验、国内可达地镜像到 GitHub Release， 
 并为 macOS 提供 Sparkle 增量自动更新源。
 官网 · Official Website · 中文 · English 
 🖥️ 不想手动下载? Codex App Manager 是基于本镜像的桌面客户端——一键安装、增量更新、干净卸载官方 Codex。 
 🖥️ Prefer one click? Codex App Manager — the desktop client built on this mirror — installs, updates and uninstalls official Codex for you.
---
 本项目由 DuckCoding 赞助支持 
 为 Claude Code / Codex / Gemini CLI 提供按量计费的 API 中转服务。 
 Sponsored by DuckCoding — a pay-as-you-go API relay for Claude Code / Codex / Gemini CLI.
---
# 中文
`codex-app-mirror` 是面向 OpenAI Codex 桌面应用的安装包镜像与分发项目，用于在 Microsoft Store 或官方下载不便时提供稳定且可校验的获取渠道。项目仅做镜像，不构建、不修改、不重打包：Stable 通道将官方 Windows MSIX 与 macOS DMG 原样发布到 GitHub Release，并经 CDN 短链分发；Linux 版统一 ChatGPT 桌面应用（包含 Codex）在 Preview 期间只进入独立 GitHub prerelease。macOS 端另提供 Sparkle 增量更新 appcast，由下游 Codex App Manager 客户端消费。
## 能力一览
| 能力 | 说明 |
|---|---|
| 🪟 **Windows MSIX** | 直接镜像 Microsoft Store 包，x64 稳定发布，ARM64 纳入 manifest 与镜像路径 |
| 🍎 **macOS DMG** | Apple Silicon + Intel 双架构，官方原包，零改动 |
| 🐧 **Linux Preview** | Ubuntu / Debian 的 DEB 与 Fedora 的 RPM，x64 + ARM64；仅发布 GitHub prerelease，不进入 CDN/latest |
| 🔄 **增量自动更新** | macOS Sparkle appcast + delta 差量包，pinned EdDSA 签名字节级保真 |
| 🌏 **国内可达** | Cloudflare R2 全球节点 + 中国大陆自动分流到 S3 副镜像，同一条短链全自动选路 |
| ⏱️ **15 分钟探测** | Cloudflare Cron 主调度 + GitHub Actions 6 小时兜底，上游一变就发版 |
| 🔐 **可校验** | 每个 Release 附 `SHA256SUMS.txt` 与 `release-manifest.json` 上游指纹 |
## 下载与安装
打开 最新 GitHub Release，下载你的平台对应文件：
- **Windows x64**：`OpenAI.Codex_..._x64__2p2nqsd0c76g0.Msix`
- **Windows ARM64**：`OpenAI.Codex_..._arm64__2p2nqsd0c76g0.Msix`（当官方下载 URL 已解析时发布）
- **Apple Silicon Mac**：`Codex-mac-arm64.dmg`
- **Intel Mac**：`Codex-mac-x64.dmg`
### Linux Preview
OpenAI 于 2026-08-11 发布了统一 ChatGPT 桌面应用的 Linux Preview，其中包含 ChatGPT、ChatGPT Work 与 Codex。Linux 包不会混入上面的 Stable Latest；请到 GitHub Releases 查找 `codex-app-linux-preview- ` prerelease：
- **Ubuntu 24.04/26.04、Debian 13**：`chatgpt_ _amd64.deb` 或 `chatgpt_ _arm64.deb`
- **Fedora 43/44**：`chatgpt- -1.x86_64.rpm` 或 `chatgpt- -1.aarch64.rpm`
Linux Preview 是显式隔离的第三通道：`stable | beta | linux-preview`。它按需输入精确版本，验证 OpenAI APT/RPM 仓库签名与四个包的 SHA-256 后发布；不会推进 GitHub Latest，不会上传 R2/S3，也不创建任何 `latest/linux*` 短链。官方包安装后会配置 OpenAI 自己的更新仓库，因此后续自动更新默认直接来自 OpenAI。
或直接使用 CDN 短链（推荐，**自动按你的网络选最优节点**——国内走 S3 副镜像，海外走 R2，只保留当前最新版）：
| 平台 | 短链 |
|---|---|
| Windows x64（兼容别名） | |
| Windows x64 | |
| Windows ARM64（当前版本可用时） | |
| Apple Silicon Mac | |
| Intel Mac | |
| 校验和 | |
| Release 指纹 | |
需要**历史版本**时，到 GitHub Releases 按 release/tag 查找；短链只指向最新版。建议同时下载 `SHA256SUMS.txt` 核对文件完整性。`release-manifest.json` 的机器可校验契约见 `docs/manifest-schema.md`（JSON Schema）。
## macOS 自动更新
macOS 版除了手动下载 DMG，还支持 **Sparkle 增量自动更新**。下游的 Codex App Manager 客户端会订阅本镜像的 appcast，自动检查新版并**只下载版本间的 delta 差量包**，而不是每次重拉完整安装包：
- Apple Silicon： 
- Intel： 
镜像**逐字节复制**官方 Sparkle 归档和 OpenAI 的 EdDSA 签名，只改写 `enclosure` 的下载地址指向镜像。由于 EdDSA 签的是归档字节本身，只要镜像与官方字节级一致，**原始签名依然有效**——本镜像不会、也无法伪造签名。如果客户端没有匹配的 delta，会自动回退到完整归档。
## 工作原理
### 探测 → 比对 → 发布
每次运行先做一次轻量探测，只有上游真的变