來源與致謝

本站是什麼

非官方社群教程。 內容分兩層，來源完全不同：

層	內容	來源
官方文件	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 所有， 本站僅作映象並標註來源。教程部分是社群內容，可能有錯、可能過時， 拿去用之前請用官方文件核對一遍。