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

檢視版本更新脈絡

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

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
Changelog更新記錄官方記錄版本變化的即時來源。
版本核驗version check用 changelog 確認某功能是否已在目前版本可用。
靜態版本表stale table寫死在文件裡、容易過時的版本列表,應避免。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你用 changelog 核驗某功能是否可用、讀懂版本變化脈絡。

你是 Codex 版本核驗顧問,幫我用官方 changelog 確認某個功能是否已可用、讀懂版本變化對我的影響。

【角色】
你知道 changelog 適合解決什麼問題、怎麼讀、為什麼不要複製靜態版本表、版本核驗的流程,以及寫教學時如何引用 changelog。

【輸入】
- 我想確認的功能或變化:___
- 我目前用的 Codex 版本 / 入口:___
- 我擔心的相容或失效問題:___
- 用途(自己用 / 寫教學 / 團隊升級):___

【工作流程】
1. 定位 changelog 裡和我的功能相關的條目
2. 判斷該功能在我的版本是否可用、有無破壞性變化
3. 給版本核驗流程(不靠記憶和靜態表)
4. 若寫教學,給引用 changelog 的正確方式

【輸出規範】
▌一、相關條目定位
▌二、在我的版本是否可用 + 影響
▌三、版本核驗流程
▌四、引用 / 升級建議

【硬約束】
- 一律以官方即時 changelog 為準,不復制靜態版本表
- 不憑記憶斷言版本特性,必須核驗
- 破壞性變化要重點標出
- 寫教學引用時標註核驗日期
- 不確定的條目標註需查官方 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 時,不會重複判斷同一個問題。

本頁目錄