Skip to content

Latest commit

 

History

History
154 lines (98 loc) · 4.12 KB

File metadata and controls

154 lines (98 loc) · 4.12 KB

回滚说明

本文说明如何从 OpenCodex FixMemory 2.7.43-memoryfix.4 回到上游 OpenCodex 2.7.43,或暂时退出 OpenCodex 代理并恢复原生 Codex。

回滚前

  1. 保存当前 Codex 任务。
  2. 完全退出 Codex Desktop。
  3. 等待后台 Codex app-server 退出。
  4. 保留安装器生成的本地备份。

回滚器检测到 Codex Desktop 或 app-server 仍在运行时,会在修改前拒绝执行。不要为了省几秒钟强制覆盖正在运行的全局命令和配置。

推荐:一键恢复上游 OpenCodex 2.7.43

双击发布包根目录的:

回滚-OpenCodex官方版.cmd

回滚器会:

  1. 检查当前进程和运行环境。
  2. 通过 npm 安装明确固定的上游 OpenCodex 2.7.43,而不是 latest。
  3. 恢复安装前备份的本地配置。
  4. 重新启动并执行健康检查。

因此一键回滚需要可以访问 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,恢复原生 Codex

如果目标不是回到上游 OpenCodex,而是暂时退出代理:

ocx stop

上游 OpenCodex 的 stop 流程会停止代理,并恢复 Codex 的原生接入状态。

如果代理已经停止但仍需要恢复:

ocx restore

然后重新打开 Codex,确认原生模型和任务可用。

配置和备份

一键安装在修改前会创建本地备份。备份属于用户私有运行数据,不会上传到 GitHub Release,也不应附在 issue 中。

回滚前不要手动删除:

  • 安装器创建的备份。
  • Codex 原始命令入口备份。
  • OpenCodex 的本地配置。
  • Responses 连续性状态。

如果自动回滚失败,请保留这些文件,只报告脱敏后的错误代码和文件是否存在,不要公开配置内容。

回滚验收

回到上游 OpenCodex

确认:

  • ocx --version 为 2.7.43。
  • ocx health --json 退出码为 0。
  • 配置界面可以打开。
  • 原有提供商配置仍可见。
  • 一条真实 Codex 请求可以正常完成。

回到原生 Codex

确认:

  • OpenCodex 代理已经停止。
  • Codex 不再指向本地代理。
  • 原生 Codex 可以启动。
  • 原有任务列表和任务内容仍可见。

常见问题

回滚器提示 Codex 正在运行

完全退出 Codex Desktop,等待后台进程结束后重试。这是安全保护,不是安装器故障。

回滚后仍显示 memoryfix.4

关闭并重新打开终端,再运行:

where.exe ocx
ocx --version

检查 PATH 中是否存在另一份更早的全局 npm 命令入口。不要直接删除未知路径,先用 npm prefix -g 确认当前全局安装位置。

健康检查失败

运行只读诊断:

ocx doctor
ocx status

如果端口被其他程序占用,先确认进程身份。不要用批量结束进程的方式回滚。

回滚后提供商仍然失败

回滚只恢复程序版本,不能修复供应商停机、额度、Key、模型下线或错误 URL。先区分程序版本、代理健康和供应商响应。

发生异常时不要做什么

  • 不要删除整个用户配置目录。
  • 不要覆盖或公开备份。
  • 不要把包含密钥的配置粘贴到 issue。
  • 不要用无版本号的软件包覆盖现场。
  • 不要看到 HTTP 200 就认定流已经恢复完整。

如需报告安全问题,请参见 SECURITY.md