Skip to main content
从稳定的文件和帧里读取状态,而不是去解析终端里的文字。 Extension.js 为脚本、CI 任务和 AI agent 发布了一小组机器契约。每个契约都有固定的结构,后续版本只会扩展它,绝不会破坏它。

该读哪个契约

各个契约之间的关系

一个会话会写出 dist/extension-js/<browser>/ready.json,并向 events.ndjsonlogs.ndjson 追加内容。这三者带有相同的 runId,所以你可以把它们关联起来。 会终止的命令在 --output json 下会在 stdout 上回答一个 schema-1 结果信封。长时间运行的命令则把同样结构的信封作为以换行分隔的生命周期帧流式输出。 每一次失败都带有一个来自同一张共享表的稳定 E_* 错误码。控制桥是 logs --follow 与各个 act 命令底层的 WebSocket 层。

下一步

  • ready.json 开始,它是每条自动化流程最先读取的契约。
  • 驱动 CLI 让助手跑完整个循环。