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

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

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

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…