四种集成形态，从「一个组件」到「完全不用框架」。按你想自己掌控多少界面来选。

网关是外部应用与 ChengOS 工作流之间的一层。它的全部职责就是映射：消息来自哪个应用、应该由哪个工作流处理、属于哪个会话。把这个模型理顺，多应用部署才不会变成猜谜。

SDK 是纯 TypeScript，不依赖任何框架。React hooks 和组件建立在它之上，但核心类在任何地方都能用。

网关 SDK（@chengflow/chat）用于把一个由 ChengOS 驱动的对话界面放进网页应用。它分三层，你按需选用：

cheng CLI 不必与 ChengOS 服务器跑在同一台机器上。一旦不在同一台，有一个问题决定了其余一切：工作流读文件时，读的是谁的磁盘？

不带参数运行 cheng，就会在当前目录下开始对话。其余的内容要么是子命令，要么是会话内的斜杠命令。

cheng CLI 是 ChengOS 的终端客户端。它不需要装在服务器上——它跑在你的笔记本上，驱动任何位置的 ChengOS 安装。这正是它的意义：你工作的机器和运行工作流的机器不必是同一台。

ChengOS 里的文档不是一个 Markdown 文件，而是存放在数据库中的块树，带有自己的版本历史，以及一个暂存区——Shadow 会话——让智能体可以提出修改，而在人类确认之前完全不触碰原文档。

表格是 ChengOS 中与文档相对的结构化数据形态：它是 Airtable 意义上的多维表格——有类型的列、有序的记录、可保存的视图——而不是一张由零散单元格组成的电子表格。

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