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

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

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

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