chengflow/openapi.yaml 是 REST API 的 OpenAPI 3.0.3 规范，Makefile 能把它变成 Swagger UI、Redoc、Postman 集合、生成的 SDK、Markdo…

工作流运行通过 WebSocket 流式推送。轮询 GET /executions/:id 告诉你结果；而 socket 告诉你正在发生什么——逐节点进度、逐 token 的模型输出、智能体迭代和审批请求。

ChengOS 有四种凭证类型，各司其职。大多数 401 和 403 的困惑都源于用错了类型，因此在开始排查之前值得先通读下表。

ChengOS 中的一切都与同一个后端服务 cheng-api 通信。编辑器、对话网关和 cheng CLI 都只是本文所述 API 的普通客户端——不存在什么它们专用、而你无法使用的私有接口。

ChengOS 在 MCP 上是双向的：

技能把一项能力打包起来，让智能体能够找到它并正确使用它。工具是一个可调用的函数，而技能是一个具名单元，带有使用说明、输入输出 schema，通常还有参考文档——这相当于「给模型一个按钮」...

把工具节点直接连到智能体上，在一定规模内是可行的。但每个工具都会往模型的上下文里增加一份函数定义，因此十几个工具意味着每一次请求都带着十几份 Schema——既昂贵，也越来越容易让模型搞...

普通工作流在设计阶段就决定了自己的顺序——连线是你画的。而智能体在运行时决定：它推理任务、调用工具、查看结果，然后重复，直到完成或被某个限制终止。agent/reactagent 就是这个节点。

ChengOS 里有三样东西都叫「版本」，把它们混在一起会造成真实的困惑：

数据在节点之间有三种流动方式：连线（主要机制）、节点自身配置里的 ${...} 替换，以及引擎的环境注入。它们之间有严格的优先级顺序，搞清楚这个顺序，几乎能解释所有「我的节点为什么拿到了那...