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

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

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

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

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

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

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

Docker 模式把每个 ChengOS 服务都作为容器运行在 Docker Compose 之下。它是推荐的生产部署方式：版本被固定到确切的镜像标签，数据存储默认绑定在回环地址上，更新与回滚替换的是整个镜像，而...

更新是仅升级、经过校验且可恢复的。在新版本通过校验之前不会发生任何不可逆的操作，在新版本被证明健康之前也不会把它记录为已安装。

本文是一张地图：有哪些进程、后端由哪些 crate 组成，以及这些进程可以被编排成哪些部署形态。