来源与致谢

本站是什么

非官方社区教程。 内容分两层，来源完全不同：

层	内容	来源
官方文档	133 篇	learn.chatgpt.com 官方中文原文镜像
教程与案例	快速上手 / 进阶 / 实战案例 / 参考	我们自己写的，事实依据来自官方文档与开源仓库

产品功能以官方最新说明为准。每一篇镜像页面顶部都有回官方原文的链接。

简体和繁体分别是怎么来的

这件事值得说清楚，因为两层的处理方式不一样：

官方文档区 —— OpenAI 自己同时维护 zh-Hans 与 zh-Hant 两套中文文档。 本站的简体版抓 /zh-Hans/docs/<slug>.md，繁体版抓 /zh-Hant/docs/<slug>.md， 两边都是官方人工译文，没有经过任何机器翻译，繁体也不是从简体转换过去的。

极少数页面官方只有英文（比如键盘快捷键、设置项参考），这类会回退到英文原文， 并在页面顶部标出来。

教程与案例 —— 简体是原稿，繁体由 OpenCC 转换。 但 OpenCC 的默认转换和官方 zh-Hant 的用词有不少出入， 所以我们逐条比对官方译文做了修正表：

（下表的词条一律用行内代码包起来，这样它在本站的繁体版里也不会被转换掉， 简繁两版看到的是同一张对照表。）

简体	OpenCC 默认	官方 zh-Hant（本站采用）
权限	許可權	權限
扩展	擴充套件	擴充功能
审批	審批	核准
会话	會話	工作階段
工作空间	工作空間	工作區
访问	訪問	存取
命令	命令	指令
插件	外掛	外掛程式
连接器	聯結器	連接器
代码仓库	程式碼倉庫	程式碼庫
图像	影像	圖像

完整对照表在 scripts/i18n-terms.mjs， 每条后面都注明了该词在官方繁体文档里的出现次数作为依据。

镜像的边界

有 12 篇官方页面没有收录，分两类：

分区落地页（官方的 Codex CLI 首页、功能总览、配置总览这类）。 这些页面的正文是由卡片组件渲染的，在 Markdown 孪生页里被压成了一堆没有层级的文案， 代码块和结构全丢了。原样镜像只会误导读者，所以跳过—— 本站用自己写的分区索引页代替。

正文不在 Markdown 里的页面，比如官方术语表：词条由前端组件渲染， .md 里只有一句导语。这类我们自己重写了一份，见术语表。

另外截图不下载到本地，直接指向官方 CDN 的绝对地址： 一是不转载他们的图，二是官方换图之后这边跟着变，不会留下一张过期截图。

主要参考

• Codex 官方文档 —— 全部事实的第一来源
• openai/codex —— CLI 本体、安装脚本、默认审查器策略
• openai/codex-action —— GitHub Action 与其安全指南
• llms.txt —— 官方给出的全站文档索引，本站的镜像清单据此生成

站点是怎么搭的

VitePress + OpenCC。 两个脚本：

npm run fetch    # 抓官方 zh-Hans / zh-Hant 文档，生成镜像与侧边栏清单
npm run i18n     # 把原创层的简体转成繁体（不碰镜像）
npm run dev      # 本地预览

npm run fetch 会把抓取结果缓存在 .cache/，改归一化逻辑重跑时不必再打网络； 要强制刷新用 npm run fetch -- --refresh。

参与

发现内容有错、和官方对不上、或者想补一个案例，欢迎提 issue 或 PR： github.com/neohoy/codexbook。

改内容时注意两件事：

• docs/docs/ 和 docs/zh-TW/docs/ 不要手改——那是 npm run fetch 的产物，下次抓取会覆盖。
• docs/zh-TW/ 下除 docs/ 外的内容也不要手改——那是 npm run i18n 从简体生成的。 要改繁体用词，改 scripts/i18n-terms.mjs 的修正表。

免责

本站与 OpenAI 无隶属关系。「官方文档」区的文字著作权归 OpenAI 所有， 本站仅作镜像并标注来源。教程部分是社区内容，可能有错、可能过时， 拿去用之前请用官方文档核对一遍。