--output json 之下,每個會結束的指令都會在 stdout 上剛好回一個 schema-1 信封。長時間執行的指令則以 生命週期影格 的形式串流出同樣的結構。
信封結構
error 物件:
成功與失敗範例
給人看的文案去哪了
EXTENSION_OUTPUT 環境變數是機器模式的開關。當它是 json 或 ndjson 時,影格獨佔 stdout,給人看的文案讓路:
- 資訊性輸出與警告會安靜下來,或在串流需要時改走 stderr。
- 錯誤文案永遠不會被抑制。它一律寫到 stderr,所以啟動失敗仍然看得見,而 stdout 保持可解析。
公開的契約產物
extension-develop 套件透過 ./contract/* export,把契約當成可匯入的檔案一併發佈:
請用這份 schema 驗證你的消費端,並把測試釘在 golden 固件上。錯誤碼只會新增,永遠不會被改名或移除。

