這篇文章最初發表於 openspec-ui.dev。首次檔案寫入測試以結束代碼 0 告終,但實際上並未產生任何檔案。代理曾表示工作區是唯讀的,而 OpenSpec Workbench 轉接器卻將程序結束代碼視為該回合的結果。這是在 2026 年 10 月 24 日使用 Codex CLI 0.164.0 時觀察到的行為。
檔案遺失揭露了轉接器預設處理的兩個決策點。Codex 需要明確知道它可以在哪裡寫入,而 Workbench 則需要讀取該回合中發生的事情。在 Harness 設定中,一個階段可以將 codex-cli 指定為其代理,並選擇一個模型和推理工作量。轉接器會從該階段的任務中選擇沙盒。
「提案」、「更新」、「應用」和「驗證」階段使用 workspace-write 模式,而「審核」階段則使用 read-only 模式。驗證階段也可以執行寫入建置產物或快取的檢查,這也是它使用可寫入模式的原因。Workbench 在啟動代理之前會解析工作目錄。如果變更擁有自己的工作樹,則執行會從該處開始。
Codex 隨後會為子程序強制執行其自身的檔案系統沙盒。在測試中,workspace-write 模式允許在工作樹中寫入,拒絕在其父級區域寫入,並允許在系統暫存目錄中寫入。所選模式是 Workbench 檢查的調用一部分。
有兩種轉接器,兩種設定選項的方式。原生轉接器執行 codex exec --json 指令。串流會攜帶回合結果、訊息、指令結束代碼、變更的檔案和權杖使用量。Workbench 可以看到失敗的回合以及產生該結果的程序。
選擇 codex-cli-acp 以使用單獨安裝的 @agentclientprotocol/codex-acp 橋接器。在此,橋接器會在會話開啟時列出可用的會話選項。Workbench 會根據該列表檢查請求的模式、模型和推理工作量,然後在發送提示詞之前設定這些選項。
不支援的模型或工作量會以診斷訊息停止該階段,該訊息會列出橋接器提供的選項。首次即時應用測試使用了橋接器版本 2.2.2,並返回了檔案變更和使用量。這兩條路徑共享相同的階段到沙盒策略。橋接器還可以在階段執行時發送上下文更新。執行記錄的使用量在之後即可取得。
您可以嘗試一下:選擇一個在自己工作樹中的小變更。在該變更的 Harness 設定中將 Codex 分配給「審核」和「應用」階段,然後依序執行這些階段。開啟執行輸出以查看每個階段做了什麼。
安裝 CLI 後,您可以從同一個儲存庫檢查已註冊的轉接器和持久化的執行記錄。使用 openspec-ui-cli show agents 和 openspec-ui-cli show run <runId> 指令。實作決策和即時測試細節記錄在 ADR 0051 和 ADR 0052 中。