Skip to main content
每個指令解析一份 JSON 文件,而不是去刮取記錄行。 --output json 之下,每個會結束的指令都會在 stdout 上剛好回一個 schema-1 信封。長時間執行的指令則以 生命週期影格 的形式串流出同樣的結構。

信封結構

error 物件:

成功與失敗範例

給人看的文案去哪了

EXTENSION_OUTPUT 環境變數是機器模式的開關。當它是 jsonndjson 時,影格獨佔 stdout,給人看的文案讓路:
  • 資訊性輸出與警告會安靜下來,或在串流需要時改走 stderr。
  • 錯誤文案永遠不會被抑制。它一律寫到 stderr,所以啟動失敗仍然看得見,而 stdout 保持可解析。
把 stdout 接給你的解析器,把 stderr 留給人。兩者永不混在一起。

公開的契約產物

extension-develop 套件透過 ./contract/* export,把契約當成可匯入的檔案一併發佈: 請用這份 schema 驗證你的消費端,並把測試釘在 golden 固件上。錯誤碼只會新增,永遠不會被改名或移除。

後續步驟