本文说明如何从 OpenCodex FixMemory 2.7.43-memoryfix.4 回到上游 OpenCodex 2.7.43,或暂时退出 OpenCodex 代理并恢复原生 Codex。
- 保存当前 Codex 任务。
- 完全退出 Codex Desktop。
- 等待后台 Codex app-server 退出。
- 保留安装器生成的本地备份。
回滚器检测到 Codex Desktop 或 app-server 仍在运行时,会在修改前拒绝执行。不要为了省几秒钟强制覆盖正在运行的全局命令和配置。
双击发布包根目录的:
回滚-OpenCodex官方版.cmd
回滚器会:
- 检查当前进程和运行环境。
- 通过 npm 安装明确固定的上游 OpenCodex 2.7.43,而不是 latest。
- 恢复安装前备份的本地配置。
- 重新启动并执行健康检查。
因此一键回滚需要可以访问 npm registry。发布 ZIP 只携带经过清理和校验的修复包,不二次分发旧候选包或上游 TGZ。
回滚成功后运行:
ocx --version
ocx health --json
ocx status版本应恢复为 2.7.43,而不是 2.7.43-memoryfix.4。
PowerShell.exe -NoProfile -ExecutionPolicy Bypass -File ".\installer\Rollback-OpenCodex-Official.ps1"根目录 CMD 是普通用户更稳妥的入口;直接调用 PowerShell 脚本主要用于自动化和排错。
仅在一键回滚器无法工作时使用。
从 npm 恢复固定版本:
ocx stop
npm install -g @bitkyc08/opencodex@2.7.43
ocx start
ocx health --json不要安装不带版本号的 latest 作为“回滚”。latest 可能已经指向结构不同的新版本,无法复现安装前状态。
如果目标不是回到上游 OpenCodex,而是暂时退出代理:
ocx stop上游 OpenCodex 的 stop 流程会停止代理,并恢复 Codex 的原生接入状态。
如果代理已经停止但仍需要恢复:
ocx restore然后重新打开 Codex,确认原生模型和任务可用。
一键安装在修改前会创建本地备份。备份属于用户私有运行数据,不会上传到 GitHub Release,也不应附在 issue 中。
回滚前不要手动删除:
- 安装器创建的备份。
- Codex 原始命令入口备份。
- OpenCodex 的本地配置。
- Responses 连续性状态。
如果自动回滚失败,请保留这些文件,只报告脱敏后的错误代码和文件是否存在,不要公开配置内容。
确认:
- ocx --version 为 2.7.43。
- ocx health --json 退出码为 0。
- 配置界面可以打开。
- 原有提供商配置仍可见。
- 一条真实 Codex 请求可以正常完成。
确认:
- OpenCodex 代理已经停止。
- Codex 不再指向本地代理。
- 原生 Codex 可以启动。
- 原有任务列表和任务内容仍可见。
完全退出 Codex Desktop,等待后台进程结束后重试。这是安全保护,不是安装器故障。
关闭并重新打开终端,再运行:
where.exe ocx
ocx --version检查 PATH 中是否存在另一份更早的全局 npm 命令入口。不要直接删除未知路径,先用 npm prefix -g 确认当前全局安装位置。
运行只读诊断:
ocx doctor
ocx status如果端口被其他程序占用,先确认进程身份。不要用批量结束进程的方式回滚。
回滚只恢复程序版本,不能修复供应商停机、额度、Key、模型下线或错误 URL。先区分程序版本、代理健康和供应商响应。
- 不要删除整个用户配置目录。
- 不要覆盖或公开备份。
- 不要把包含密钥的配置粘贴到 issue。
- 不要用无版本号的软件包覆盖现场。
- 不要看到 HTTP 200 就认定流已经恢复完整。
如需报告安全问题,请参见 SECURITY.md。