工作区是其他一切的容器——文档、表格、会话、文件和知识库。知识库则是工作区范围内的向量集合：工作区中可被检索的那一半。

ChengOS 里的 RAG 就是五个节点、两条管线。索引管线在文档变化时运行；检索管线在每次提问时运行。二者在运行时除了共享读写的那个知识库之外，别无关联。

有两份 YAML 目录，让你不改工作流也能改变它的行为：

ChengOS 有四个存储，它们的必需程度并不相同：

ChengOS 支持三种部署形态。它们读取同一份 deploy/.env，也都由 chengos.sh 驱动，因此选择的是进程跑在哪里，而不是要学三套不同的系统。

原生部署——脚本里叫「hybrid」——把编译好的 cheng-api 二进制直接跑在宿主机上，不需要容器运行时。当你要最低开销，或者在这台机器上根本没有 root 时，就选它。

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

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

ChengOS 的每种部署模式——原生、Docker 与分布式——读取的都是同一个 deploy/.env 文件。本文是参数字典。具体怎么部署，参见安装 ChengOS 和 Docker 部署。

模型供应商在每套安装中配置一次，之后按节点选用。本文介绍供应商白名单、各供应商实际具备的能力，以及凭证如何挂接。