跳到內容

Codex 提示詞層

Codex 會分層組裝提示詞:它自己的基礎指令、你的專案文件、權限與環境脈絡、 你安裝的技能,以及更多內容。Codex Set → Prompt 會顯示這個層疊結構,告訴你 每一層占用多少空間,並讓你關閉不需要的部分。

每一列都會顯示它在組裝順序中的位置、控制它的設定鍵(如果有),以及它實際 傳送內容的大小。

位置編號之間會有空缺。這是刻意安排的:這些數字是真實的組裝索引,其中兩個會在 下方的 過渡通知 中列出。如果把每組都從一開始重新編號,顯示的就會是 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 提供五個起點:精簡輸出、編輯前規劃、解釋推理、先測試,以及使用韓文 回覆。每一個都會開啟一般編輯器,預先填入內容且可完全編輯——預設只是起點,你儲存的 內容會成為一般的自訂層。

這些預設是我們自己的文字,旨在提煉一種方法,而不是複製任何人的提示詞。每個預設都會 註明來源。

編輯器提供上一層/下一層控制項和位置指示器。移動時會保留未儲存的編輯,因此你可以在編輯 途中比較兩層,再返回原處,而不會遺失已輸入的內容。

如果某一層包含無法按原文生效的內容,編輯器會發出警告——例如聲稱自己具有不同身分、 指定註冊表已定義的工具、使用不會被任何機制展開的範本預留位置,或陳述 Codex 稍後才會 產生的環境事實。

這些只是警告,絕不會阻止儲存。如果你確實想覆寫 Codex,也可以這樣做;警告只是讓它成為 一個有意的決定,而不是意外。

如果 developer_instructions 已經存在,且不是由 opencodex 寫入,面板不會覆寫它。 面板會改為提供將文字匯入為一層的選項:你會先看到現有值,在確認之前不會寫入任何內容。

如果已儲存的層與 config.toml 中的值不一致,面板會說明情況並提供 Repair,而不會 靜默修復。兩種修復路徑會重寫你寫過的文字,因此這些操作始終需要明確執行。如果某個層檔案 已經遺失,修復功能會先寫入備份,再進行任何修改。

變更會套用到新啟動的工作階段。已經執行的工作階段會繼續使用啟動時的提示詞設定。

此頁面讀取什麼,又不讀取什麼

Section titled “此頁面讀取什麼,又不讀取什麼”

opencodex 只讀取一個設定檔——你的 config.toml。Codex 會從多個層解析設定,因此這裡的值 表示的是你的檔案所寫的內容,不一定是 Codex 最終計算出的值。

這些鍵位於 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。面板顯示檔案中實際存在的值,並在鍵未設定時說明這一點。