AI 程式設計教程中文版
官方教程中文版版本與遷移

檢視版本更新脈絡

用 Codex changelog 核驗版本、模型、入口、整合和安全能力的當前狀態,而不是複製靜態更新表。

Codex changelog 適合用來確認功能何時上線、哪些入口受影響、CLI / App 行為是否變化,以及模型、MCP、skills、plugins、GitHub / Slack / Linear 等能力的演進邊界。

本頁不復制完整更新表。Changelog 是高波動資訊,靜態搬運很快會過期。

任何“最新版”“當前模型”“某功能是否可用”的判斷,都必須回到官方 changelog、當前客戶端和對應官方文件核驗。不要用舊教程裡的版本表做最終依據。

Changelog 適合解決什麼問題

flowchart TB
    Question["你要確認的問題"]
    Version["版本行為<br/>CLI / App / IDE"]
    Model["模型可用性"]
    Feature["功能上線和成熟度"]
    Integration["GitHub / Slack / Linear / MCP"]
    Security["sandbox / approval / governance"]
    Official["官方 changelog + 對應文件"]

    Question --> Version
    Question --> Model
    Question --> Feature
    Question --> Integration
    Question --> Security
    Version --> Official
    Model --> Official
    Feature --> Official
    Integration --> Official
    Security --> Official

常見用途:

  • 判斷某個 CLI 行為是否來自版本更新。
  • 判斷 App、IDE、Cloud 的某個入口是否支援某功能。
  • 核驗模型上線、下線、預設值或入口差異。
  • 查詢 security、sandbox、approval、MCP、skills、plugins 的變更背景。
  • 為教程更新提供事實來源。

不要把 changelog 當入門教程。它是事實核驗入口。

怎麼讀

第一步:先確定問題屬於哪一類。

  • CLI 命令或 TUI 行為。
  • App 桌面功能。
  • IDE extension。
  • Cloud / Web。
  • 模型和推理。
  • 整合和自動化。
  • 安全、治理、許可權。

第二步:在 changelog 中按型別或關鍵詞篩選。

第三步:找到更新項後,不要停在 changelog 摘要,繼續開啟對應正式文件。

第四步:在本機或當前入口驗證。

例如 CLI 行為,應同時看:

codex --version
codex --help
codex <subcommand> --help

如果是 App 或 IDE 功能,應檢查當前客戶端版本和設定頁。

不要複製靜態版本表

教程中不建議長期儲存:

  • 每月 changelog 表。
  • 每個 CLI release 的完整安裝命令。
  • 舊模型切換命令。
  • 入口上線日期。
  • 臨時灰度說明。
  • 短期活動、計劃、額度變化。

這些資訊應該連結官方頁面,而不是成為教程正文的穩定內容。

更好的寫法是:

  • 說明如何查。
  • 說明怎麼判斷是否影響自己。
  • 說明如何在當前客戶端驗證。
  • 給出官方入口。

版本核驗流程

flowchart LR
    Need["需要確認某功能"] --> Changelog["查官方 Changelog"]
    Changelog --> Docs["開啟對應正式文件"]
    Docs --> Local["檢查當前客戶端或配置"]
    Local --> Decision["形成結論"]

示例:

我要确认某个 CLI 参数是否存在。
1. 查 changelog 看是否有相关变更。
2. 查 CLI features 或 command line options。
3. 本机运行 codex --help 或子命令 --help。
4. 只在三者一致时写进教程。

寫教程時如何引用 changelog

推薦寫法:

这类能力更新较快,具体可用性以官方 changelog 和当前客户端为准。
如果你需要确认某个入口是否支持该功能,先查 changelog,再查对应产品页。

不推薦寫法:

某年某月某日之后,所有用户都应该使用 X。

除非這是官方長期穩定政策,否則不要把時間點寫成永久判斷。

與本站文件的關係

Changelog 用來核驗事實,本站文件用來解釋怎麼用。

優先順序:

  1. 官方 changelog:確認變化發生過。
  2. 官方產品文件:確認當前正式行為。
  3. 當前客戶端:確認你賬號和環境可用。
  4. 本站教程:解釋如何理解和落地。

如果四者衝突,以官方當前文件和當前客戶端為準,再更新本站教程。

更新本站教程的檢查清單

當 changelog 出現相關變化時,檢查:

  • 是否影響模型選擇頁。
  • 是否影響 pricing / usage 頁。
  • 是否影響 CLI 引數或 slash commands。
  • 是否影響 sandbox、approval、security。
  • 是否影響 MCP、skills、hooks、plugins。
  • 是否影響 App、IDE、Cloud 的入口說明。
  • 是否需要更新工作流和審計規則。

Changelog 的價值不是讓讀者背版本,而是讓教程維護者知道哪些事實需要重新核驗。

團隊維護建議

商業團隊可以把 changelog 審查放進月度文件維護,而不是每次看到新功能就立刻改教程。先判斷變化是否影響當前教學路徑,再決定更新哪一頁。隻影響少數高階使用者的實驗能力,可以先記錄在維護清單;影響安裝、許可權、預設模型、計費、安全邊界或主要入口的變化,才應該優先更新正文。

每次更新教程時,保留判斷過程比複製更新條目更有價值。維護者應寫清楚變化影響哪個入口、是否已經在當前客戶端驗證、是否需要改截圖、是否會改變推薦工作流。這樣下一次再看 changelog 時,不會重複判斷同一個問題。

本頁目錄