系统装好了、编辑器也能用，但某次运行没有达到预期。本文就是诊断路径。

渠道问题按消息卡在哪一环能干净地区分开，所以请先定位断点，而不是靠猜：

这里只有一个节点会出现在画布上：agent/reactagent。另外三个是它循环内部的阶段 —— 规划、执行、评审 —— 并且刻意对节点面板隐藏。之所以仍然收录，是因为它们的输入输出最能说清一次迭代...

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

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

chat/input 与 chat/output 是对话式工作流的两端：前者接收进来的消息与会话身份， 后者把回复送回同一个会话。chat/historysearch 是读取侧 —— 列出会话、检索消息，或取出某条命中附…

把技能当作可构建、可校验的对象，而不只是拿来运行。tools/skill 执行一个技能。 tools/writeskillpackage 产出技能包，tools/validateskillspec 在有人尝试发布或导入之…

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

编辑器里的对话面板不是硬拼在工作流引擎上的演示控件，而是一等的执行界面：你发一条消息就启动一次工作流运行，而这次运行产生的一切——流式 token、工具调用、智能体迭代、审批请求——都会...

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