# Codex 版本更新影响检查清单

核验日期：2026-07-21

## 升级前

- [ ] 记录当前稳定版本和安装来源。
- [ ] 阅读官方 Changelog 与对应 GitHub Release。
- [ ] 标出与当前工作流相关的 CLI、App、权限、配置、MCP、Skill 变化。
- [ ] 保存关键配置的脱敏快照。
- [ ] 选择一个非生产仓库作为回归样本。
- [ ] 记录回滚到旧版本的方法。

## 核心回归

- [ ] 登录与会话恢复。
- [ ] 只读仓库调查。
- [ ] 文件编辑与 diff 审查。
- [ ] shell 命令审批与沙箱边界。
- [ ] `AGENTS.md` 指令加载。
- [ ] 项目级与用户级配置优先级。
- [ ] MCP 连接与权限。
- [ ] Skills / Plugins 加载。
- [ ] Git 工作区与 worktree 行为。
- [ ] 非交互命令或 GitHub Action（如使用）。
- [ ] 浏览器、截图、图片输入（如使用）。

## 结果记录

```md
### 从 / 到版本

### 升级原因

### 通过项

### 失败项

### 配置迁移

### 回滚决定

### 对团队的影响

### 下次复核日期
```

## 判定规则

- 关键认证、权限或生产自动化失败：暂停推广新版本并回滚。
- 仅非关键显示问题：记录 Issue、给出临时方案，再决定是否升级。
- 行为变化但符合官方说明：更新团队手册、模板和培训内容。
- 新功能尚未验证：标记“未验证”，不要写成已经可用于生产。

## 团队发布说明模板

```md
本次 Codex 从 X 升级到 Y。与团队相关的变化是：……
已验证：登录、仓库读取、编辑、测试、权限和关键自动化。
需要注意：……
出现问题时：执行……回滚，并在……记录。
```

## 观察窗口

升级后至少保留一个真实工作周期的观察窗口。记录失败率、审批异常、自动化中断和使用者反馈；没有证据时不要宣称性能提升或完全兼容。对于生产自动化，先小范围运行再扩大覆盖，并保留旧版本镜像、安装命令或锁定文件。

官方来源：

- https://learn.chatgpt.com/docs/codex/changelog
- https://github.com/openai/codex/releases