- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 LINUX DO 社区： 是
- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出
前言 （点击了解更多详细信息）
这是什么
github.com
GitHub - Wangnov/codex-app-mirror: Mirror official Codex desktop app installers into...
Mirror official Codex desktop app installers into GitHub Releases.
codex-app-mirror，一个镜像官方 Codex App 安装包的项目。
定时从官方来源抓取：
- Windows x64 MSIX（没有 exe ）
- macOS Apple Silicon DMG
- macOS Intel DMG
然后发布到 GitHub Release，同时同步一份到 Cloudflare R2（只保留最新版，我存不起那么多的），方便国内用户下载。
以下为 AI 写的 README 截图：
为啥要做这个
Codex APP 做的越来越好，但是安装体验一直拉完了。对于 Arm Mac 来说，那是亲儿子，没话说。Intel Mac 最近也加了支持，虽然兼容的不是很完整（打开就一堆 UI BUG，但是好歹能用），但是好歹也是有个 dmg 可下载的。
Windows 呢？我那么大一个 Windows 用户群体呢？你竟然告诉我必须得走 Microsoft Store 来下载？？？
且不说有很多人网络环境连不上 Microsoft Store，最气的是就算有时候开了梯子也连不上。
正常情况下，懂点技术的用户往往可以自己解决网络问题，然后走直截了当的方式，比如命令行：
winget download --id 9PLM9XGG6VKS --source msstore --accept-package-agreements
但是如果安装的用户是小白呢（
比如，平时我做线下的分享，有很多朋友也想试试 Codex APP 有没有我说的那么神奇。然后他们就让我帮忙装一下，我脑门的汗就下来了。正好今天在 xhs 碰到了一个想找人帮忙解决 Codex APP 安装问题的，我就顺带想看看，到底有没有一个离线安装包可以解决 Windows 这个烦人的安装。
一番让 GPT Pro搜索之后，找到了一些解决办法，其实就是直接从微软商店里把 .msix 拿出来，然后就可以基本能做到离线安装了。
不过拿这个 .msix 还是有点费劲，网上有一些做这样的工具，但是网页很繁琐古旧，我追根溯源了一下，底层的依赖也很老且很简单。
所以直接让 GPT 大人出手，把这个底层搓出来，然后又搓了一个自动轮询的 Github Action ，把官方的最新版 APP 拉到项目的 Release 里，另外再拉到我的 R2 桶里，让国内用户也都能顺畅安装上。
顺手也镜像了 Mac 的两个 .dmg 。
下载地址
GitHub Release（保存了从我当时开始镜像的全部版本历史）：
GitHub
Release Codex App Mirror 26.513 · Wangnov/codex-app-mirror
Official Codex desktop app installer mirror. Detected versions: Windows x64 MSIX: 26.513.3673.0 (OpenAI.Codex_26.513.3673.0_x64__2p2nqsd0c76g0.Msix) macOS Apple Silicon: 26.513.31313 (build 2867) ...
R2 短链接：
Windows:
https://codexapp.agentsmirror.com/latest/win
Mac Apple Silicon:
https://codexapp.agentsmirror.com/latest/mac-arm64
Mac Intel:
https://codexapp.agentsmirror.com/latest/mac-intel
Checksums:
https://codexapp.agentsmirror.com/latest/checksums
怎么安装 Windows 版
下载 MSIX 后，正常 Windows 直接双击安装即可。
但是，Windows 有各种稀奇古怪的定制版，尤其是企业内部的。如果遇到问题，按如下顺序尝试：
- 你的系统 MSIX / AppX 安装链路还在，可以 PowerShell：
Add-AppxPackage .\Codex-Windows-x64.msix
- 如果你是那种 Store 和 AppX 服务都裁得比较狠的系统，那就不一定能正常安装。这种情况下可以把
.msix改成.zip，解压里面的 app 目录，然后直接跑Codex.exe。
本质上 MSIX 也是包，这样做也没什么太大兼容性问题，只是正常系统还是建议走安装流程。
它安全吗
这个项目不修改包、不重打包、不 patch、不破解。
它只从官方来源把安装包下载下来，然后原样发出来。
Windows 来源是 Microsoft Store ProductId：
9PLM9XGG6VKS
macOS 来源是 OpenAI Codex App 的官方静态下载地址：
https://persistent.oaistatic.com/codex-app-prod/Codex.dmg
https://persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg
Release 里会带 SHA256SUMS.txt 和 release-manifest.json，可以自己核对。
咋做到的
这个项目本身逻辑不复杂，主要是把几个下载链路自动化了一下。
macOS 比较简单，对两个官方 DMG 地址做 HEAD，读：
ETag
Last-Modified
Content-Length
如果有变化，就下载新的 DMG。
Windows 稍微麻烦一点。它不是直接保存第三方网站给的链接，而是自己走 Microsoft Store metadata：
- 通过 DisplayCatalog 查 ProductId
9PLM9XGG6VKS - 拿到
WuCategoryId - 再请求 FE3 metadata
- 从返回的 package metadata 里筛 Windows Desktop x64 对应的 MSIX
- 下载微软 CDN 返回的临时包 URL
其实这个实现有一个现成的开源依赖： StoreLib，但是它太老了，就直接让 Codex 自己搓了一个纯 .NET 的解析器，没有依赖第三方 Store helper 包。
自动更新
GitHub Actions 每 15 分钟轮询一次。
每次先轻量 probe，不下载大文件：
- Windows：比对当前 MSIX moniker / digest 等稳定字段
- macOS：比对 DMG 的 ETag / Last-Modified / Content-Length
- 和最新 Release 里的
release-manifest.json对比
如果没变化，就直接结束，不发重复 Release。
如果发现任意平台有新版本，就下载 Windows + 两个 Mac 包，生成 Checksums，然后发新的 GitHub Release，并同步到 R2。
说完了
最近由于 Codex APP 的一些花式玩法，比如今天看到佬友发布的 原生 codex app 同时支持中转与远端控制 ，也是更加看到了对于历史版本镜像的需求。恰好我这里有，就不偷懒今天把这一弹发出来。
有问题欢迎直接丢 issue，如有帮到也感谢佬友能不吝 Star。
后面还有一些 Codex 周边小工具，整理完继续发。
Codex 实用小工具系列目录
第一弹：【开源】切 provider 避免丢会话：Codex-Threadripper（Codex实用小工具系列第一弹）
第二弹：【开源】逆向 Codex APP ASR 搓了一个语音转写小工具，支持 Whisper 格式（Codex 实用小工具第二弹）
第三弹：【开源】做了一个 Codex App 安装包镜像，解决 Microsoft Store 不好下载的问题（Codex 实用小工具第三弹）
5 个帖子 - 3 位参与者