# Codex Bug Report 模板

核验日期：2026-07-21

## 提交前

- [ ] 已搜索相同平台、版本和错误信息的已有 Issue。
- [ ] 已在最小目录或最小仓库中复现。
- [ ] 已确认问题来自 Codex，而不是项目自身脚本失败。
- [ ] 已删除全部密钥、Cookie、私有代码和个人路径。

## Issue 正文

```md
### Summary
一句话说明实际问题，不写解决方案猜测。

### Codex surface
CLI / App / IDE / Cloud

### Version
精确版本号：

### Environment
- OS：
- Architecture：
- Shell / IDE：
- Network / proxy：

### Steps to reproduce
1.
2.
3.

### Expected behavior

### Actual behavior

### Reproduction frequency
Always / Sometimes / Once

### Minimal reproduction
可公开仓库或最小命令；没有则说明原因。

### Sanitized logs
只粘贴相关片段。

### Regression
- 最近正常版本：
- 首次异常版本：

### Workaround
如果有，说明可重复的临时方案。
```

## 日志脱敏检查

- [ ] 搜索并删除 `Authorization`、`Cookie`、`token`、`secret` 等字段值。
- [ ] 将个人主目录替换为 `<HOME>`，私有仓库替换为 `<PRIVATE_REPO>`。
- [ ] 不上传完整配置文件；只保留与复现相关且已脱敏的键。
- [ ] 截图检查浏览器标签、终端历史、侧栏文件名和通知内容。
- [ ] 最小仓库不包含客户代码、数据集或内部域名。

## 好报告与坏报告的区别

好报告能让维护者在不知道你的业务背景时重现问题，并能区分 Codex 行为、网络环境与仓库脚本错误。坏报告只有“不能用”“很卡”或一张无版本信息的截图。若无法稳定复现，也要写出现频率、最后正常时间和触发前后的操作，不要把推测写成事实。

提交后保留复现环境一段时间，并及时回应维护者补充信息；确认新版本修复后再关闭问题。

官方来源：

- https://learn.chatgpt.com/docs/codex/troubleshooting
- https://github.com/openai/codex/issues