--output json 下,每个会终止的命令都会在 stdout 上恰好回一个 schema-1 信封。长时间运行的命令则以 生命周期帧 的形式流式输出同样的结构。
信封结构
error 对象:
成功与失败示例
人类可读文案去哪了
EXTENSION_OUTPUT 环境变量是机器模式的开关。当它是 json 或 ndjson 时,帧独占 stdout,人类可读文案让路:
- 信息性输出和警告会静默,或者在流式场景需要时改走 stderr。
- 错误文案永远不会被抑制。它总是写到 stderr,这样启动失败依然可见,而 stdout 保持可解析。
公开的契约产物
extension-develop 包通过 ./contract/* 导出,把契约作为可导入的文件一起发布:
请用这份 schema 校验你的消费方,并把测试固定到 golden 固件上。错误码只会新增,永远不会被改名或删除。

