Codex 提示詞層
Codex 會分層組裝提示詞:它自己的基礎指令、你的專案文件、權限與環境脈絡、 你安裝的技能,以及更多內容。Codex Set → Prompt 會顯示這個層疊結構,告訴你 每一層占用多少空間,並讓你關閉不需要的部分。
清單顯示什麼
Section titled “清單顯示什麼”每一列都會顯示它在組裝順序中的位置、控制它的設定鍵(如果有),以及它實際 傳送內容的大小。
位置編號之間會有空缺。這是刻意安排的:這些數字是真實的組裝索引,其中兩個會在 下方的 過渡通知 中列出。如果把每組都從一開始重新編號,顯示的就會是 Codex 實際並未使用的順序。
| 類型 | 你可以做什麼 |
|---|---|
| 可在此切換 | 一個真正的開關。會在 config.toml 中寫入一個鍵。 |
| 功能開關控制 | 確實存在,但要從功能設定中變更,而不是在此頁面。 |
| 一律啟用 | Codex 中任何地方都沒有關閉開關。 |
| 變更時傳送 | 通知狀態過渡,因此只有內容發生變更時才會出現。 |
| 擴充層 | 無法列出。Codex 不會公開它們。 |
沒有關閉開關的層完全不會顯示開關,而不是顯示一個停用的開關。灰顯控制項會暗示 這項能力存在、只是暫時無法使用,但實際並非如此。
點擊層名稱即可查看它傳送的文字。對話框會從 codex debug prompt-input 讀取內容,
所以顯示的是真實內容,而不是描述。
有時沒有內容可顯示,對話框會說明具體原因:
- 檔案存在但為空。 你的
~/.codex/AGENTS.md是零位元組,因此該層沒有內容可傳送。 對話框會顯示路徑。 - 在我們讀取的這一輪中,它沒有傳送任何內容。 各層只有在發生變更時才會重新傳送, 所以未變更的層不會出現在單次樣本中。
- 它在可讀清單之外傳輸。 基礎提示詞透過另一個欄位傳送,無法在這裡列印。
- 無法讀取提示詞。 此機器上的探測失敗。
讀取內容來自你的全域 Codex 主目錄(~/.codex),而不是儀表板碰巧執行的目錄。
+ Add layer 會附加你自己的指令。自訂層會組合到 developer_instructions 中,
它採用附加方式——Codex 會保留自己的指令,並把你的指令加進去。
自訂層會在它們自身之間編號,因為它們會按該順序合併為一個區段——它們不會 與內建層交錯排列。
可以使用列上的箭頭重新排序,也可以在列內任意位置按 Alt + Up / Alt + Down。
順序就是組合順序。
+ Add layer 提供五個起點:精簡輸出、編輯前規劃、解釋推理、先測試,以及使用韓文 回覆。每一個都會開啟一般編輯器,預先填入內容且可完全編輯——預設只是起點,你儲存的 內容會成為一般的自訂層。
這些預設是我們自己的文字,旨在提煉一種方法,而不是複製任何人的提示詞。每個預設都會 註明來源。
編輯時在各層之間移動
Section titled “編輯時在各層之間移動”編輯器提供上一層/下一層控制項和位置指示器。移動時會保留未儲存的編輯,因此你可以在編輯 途中比較兩層,再返回原處,而不會遺失已輸入的內容。
如果某一層包含無法按原文生效的內容,編輯器會發出警告——例如聲稱自己具有不同身分、 指定註冊表已定義的工具、使用不會被任何機制展開的範本預留位置,或陳述 Codex 稍後才會 產生的環境事實。
這些只是警告,絕不會阻止儲存。如果你確實想覆寫 Codex,也可以這樣做;警告只是讓它成為 一個有意的決定,而不是意外。
在 opencodex 外部寫入的指令
Section titled “在 opencodex 外部寫入的指令”如果 developer_instructions 已經存在,且不是由 opencodex 寫入,面板不會覆寫它。
面板會改為提供將文字匯入為一層的選項:你會先看到現有值,在確認之前不會寫入任何內容。
內容不同步時
Section titled “內容不同步時”如果已儲存的層與 config.toml 中的值不一致,面板會說明情況並提供 Repair,而不會
靜默修復。兩種修復路徑會重寫你寫過的文字,因此這些操作始終需要明確執行。如果某個層檔案
已經遺失,修復功能會先寫入備份,再進行任何修改。
變更何時生效
Section titled “變更何時生效”變更會套用到新啟動的工作階段。已經執行的工作階段會繼續使用啟動時的提示詞設定。
此頁面讀取什麼,又不讀取什麼
Section titled “此頁面讀取什麼,又不讀取什麼”opencodex 只讀取一個設定檔——你的 config.toml。Codex 會從多個層解析設定,因此這裡的值
表示的是你的檔案所寫的內容,不一定是 Codex 最終計算出的值。
此頁面寫入的鍵
Section titled “此頁面寫入的鍵”這些鍵位於 Codex 的 config.toml 中,而不是 opencodex 自身的設定。
| 鍵 | 預設值 | 層 |
|---|---|---|
include_permissions_instructions |
true |
權限 |
include_collaboration_mode_instructions |
true |
協作模式 |
include_environment_context |
true |
環境內容 |
include_apps_instructions |
true |
應用程式 |
skills.include_instructions |
true |
技能 |
developer_instructions |
未設定 | 依序連接的自訂層 |
寫入採用逐行編輯,你的註解與格式會保留;opencodex 無法辨識的鍵會原樣保留,而不會被刪除。
缺少的鍵會以預設值讀取,而不是 false。面板顯示檔案中實際存在的值,並在鍵未設定時說明這一點。

