Skip to main content
每条命令解析一份 JSON 文档,而不是去刮取日志行。 --output json 下,每个会终止的命令都会在 stdout 上恰好回一个 schema-1 信封。长时间运行的命令则以 生命周期帧 的形式流式输出同样的结构。

信封结构

error 对象:

成功与失败示例

人类可读文案去哪了

EXTENSION_OUTPUT 环境变量是机器模式的开关。当它是 jsonndjson 时,帧独占 stdout,人类可读文案让路:
  • 信息性输出和警告会静默,或者在流式场景需要时改走 stderr。
  • 错误文案永远不会被抑制。它总是写到 stderr,这样启动失败依然可见,而 stdout 保持可解析。
把 stdout 接给你的解析器,把 stderr 留给人看。两者永不混流。

公开的契约产物

extension-develop 包通过 ./contract/* 导出,把契约作为可导入的文件一起发布: 请用这份 schema 校验你的消费方,并把测试固定到 golden 固件上。错误码只会新增,永远不会被改名或删除。

下一步