Codex 中文文档（当前菜单镜像计划）

目标：按 https://developers.openai.com/codex 当前可见的 Codex Docs menu 建立中文镜像，并持续追踪菜单变化。

当前状态（快照：2026-04-07 UTC）

• 当前可见 menu 覆盖：72/72（以 docs/official-nav-snapshot.json 为基准）。
• 目录结构状态：已清理超出当前 menu 的页面，当前 ./docs 与 menu 对齐。
• 英文底稿状态：./docs-en 已按当前 menu 整理完成，可作为中文翻译唯一英文源。
• 内容质量状态：72/72 全部为 L3（内容对齐），详见 docs/progress.md。

目录结构

docs/
├─ index.md
├─ progress.md
├─ official-nav-snapshot.json
├─ getting-started/
├─ using-codex/
├─ configuration/
├─ administration/
├─ automation/
├─ learn/
└─ releases/

docs-en/
├─ index.md
├─ getting-started/
├─ using-codex/
├─ configuration/
├─ administration/
├─ automation/
├─ learn/
└─ releases/

翻译与同步原则

• 以官方英文文档为唯一事实来源。
• 以 docs-en/ 为仓库内唯一英文底稿来源。
• 命令、配置项、模型名保留英文原文。
• 每页底部标注来源与更新时间（UTC）。
• 当前仓库默认只镜像官网当前可见 menu，不再混入额外深链页。

翻译实施

• 分批翻译方案：specs/0002.md
• 批次 0 执行口径：specs/0003.md
• 推荐流程：先同步 docs-en/，再翻译 docs/，最后运行校验脚本并更新 docs/progress.md

镜像质量等级

• L1（骨架）：页面存在，包含来源/时间与“翻译中”标识。
• L2（结构对齐）：章节层级与官方一致。
• L3（内容对齐）：示例、参数、注意事项可直接使用。

自动化检查

• 当前可见 menu 差异对比（优先实时抓取，失败时回退快照）：

  python3 scripts/codex_nav_diff.py

• 仅按本地快照对比：

  python3 scripts/codex_nav_diff.py --use-snapshot-only

• 全站相对链接检查：

  python3 scripts/check_docs_links.py

• 英文底稿、中文输出与菜单快照一致性检查：

  python3 scripts/check_translation_sync.py

声明

本项目为非官方社区中文镜像，不代表 OpenAI 官方立场。若与英文原文冲突，以英文原文为准。