Skip to main content
從穩定的檔案與 frame 讀取狀態，而不是去解析終端機裡的文字。 Extension.js 為指令稿、CI 工作與 AI agent 發布了一小組機器契約。每個契約都有固定的結構，後續版本只會擴充它，絕不會破壞它。

​
該讀哪個契約

​
各個契約之間的關係

一個工作階段會寫出 dist/extension-js/<browser>/ready.json，並往 events.ndjson 與 logs.ndjson 追加內容。這三者帶有相同的 runId，所以你可以把它們關聯起來。 會結束的指令在 --output json 之下，會在 stdout 上回答一個 schema-1 結果信封。長時間執行的指令則把同樣結構的信封，以換行分隔的生命週期 frame 形式串流輸出。 每一次失敗都帶著一個來自同一張共用表的穩定 E_* 錯誤碼。控制橋是 logs --follow 與各個 act 指令底下的 WebSocket 層。

​
下一步

  • 從 ready.json 開始，它是每一條自動化流程最先讀取的契約。
  • 用 驅動 CLI 讓助理跑完整個迴圈。