跳到主要內容
maxstudioNews
產品DEV Community (Codex)約 2 分鐘

Codex 在 Harness 階段的運作機制

本文探討 AI 代理 Codex 如何在 Harness 平台中執行其階段,特別是在檔案寫入權限與執行模式方面的挑戰。文章說明了系統如何明確定義沙盒環境,並為「提案」、「更新」、「應用」、「驗證」和「審核」等不同操作選擇適當的模式。此外,文中也詳細介紹了兩種整合 Codex 的轉接器方法。

Codex 在 Harness 階段的運作機制
圖片來源:DEV Community (Codex)

這篇文章最初發表於 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 中。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。