Codex Router安全升级与回滚指南基于Git的一键更新、一键还原详解【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-routerCodex Router 是面向 Codex 的外部模型路由器External-model router for Codex提供 Kimi OAuth/API 引导登录、DeepSeek 接入、安全迁移与一键回滚能力。本文聚焦它最值得信任的部分基于 Git 的安全升级机制——更新前如何保护你的本地改动、失败时如何自动还原、以及如何用一条命令把版本切回上一个已知良好的状态。为什么升级必须是安全的大多数工具更新失败后你需要手动排查是哪个文件被改坏了。Codex Router 走的是另一条路把升级视为一个 Git 事务。它的更新器src/update.mjs在安装前会做三重校验来源校验origin远程仓库必须是官方认可的 Codex Router 地址拒绝未知来源工作区校验检查是否有对被跟踪文件的本地编辑有则拒绝覆盖并明确列出是哪几个文件分支校验只接受main分支其他开发分支一律拒绝。未跟踪的新文件untracked永远不会阻塞更新——只有你真正改动过仓库里的代码才会触发保护。一键更新步骤update 命令更新流程对 macOS/Linux 与 Windows 完全一致操作macOS / LinuxWindows PowerShell检查是否有新版本./bin/update check./codex-router.ps1 update check执行更新./bin/update./codex-router.ps1 update手动回滚./bin/rollback./codex-router.ps1 rollback一条update命令内部会发生的事详见 docs/INSTALL.md留底先把当前版本提交号保存到refs/codex-router/rollback引用中src/update.mjs拉取获取origin/main并快速前进fast-forward重装重新执行安装。若依赖没有变化只需重启服务而不是完整重装。关键点如果安装失败更新器会自动检出上一个版本并重装——你根本不需要手动干预。这就是一键更新背后真正的安全网。一键还原rollback 的两种场景rollback不是卸载它把受管的源码检出切换回缓存的上一个版本并重新安装docs/INSTALL.md。之后再次运行update会自动切回main继续更新。需要区分两种回滚版本回滚./bin/rollback处理更新失败或你想退回旧版本的情况迁移回滚./bin/migrate rollback专门撤销旧版 Codex 配置的迁移与版本更新无关。更新失败的排障入口在 docs/TROUBLESHOOTING.md更新器通常已自动恢复缓存的旧版本若自动回滚也失败会明确告诉你上一个提交是 xxx你仍可手动执行./bin/rollback找回它。本地文件被改动时怎么办当更新被本地编辑挡住时错误信息会列出被改动的文件并给出两条路保留改动执行git stash把改动存起来更新后随时恢复放弃改动给同一命令加上--force如./bin/update --force——它只丢弃被跟踪文件的编辑绝不删除你的任何未跟踪文件。还有一个贴心的细节如果更新本身成功、但配置环节因你跳过提示/缺少凭证而退出退出码 2更新会保留而不是回滚——因为问题出在配置而非代码盲目回滚反而让修复永远无法生效。这套判断逻辑的完整说明见 docs/INSTALL.md。升级前后检查清单 更新前后各花一分钟能避免 90% 的更新后不对劲# 更新前确认当前健康 ./bin/doctor # 更新后修复可能失效的配置并重启服务 ./bin/doctor --fix # 需要反馈问题时生成不含密钥的诊断包 ./bin/support-bundledoctor --fix会在升级后重建依赖、修复服务定义support-bundle生成的诊断包自动排除凭证、日志内容可放心分享若从旧版本无 caller 能力升级安装器会自动生成访问凭证并收紧配置权限——完成后请完全退出并重新打开 Codex让它加载新地址。总结Codex Router 的升级哲学可以概括为一句话先留底再更新失败自动回手动一键回。Git 提交引用refs/codex-router/rollback就是你的版本保险箱update与rollback两条命令覆盖了升级的所有路径。完整安装与升级文档见 docs/INSTALL.md常见故障排查见 docs/TROUBLESHOOTING.md。【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考