8. 第 7 模块:自定义节点协议与 WebSocket 通信体系 (07_custom_nodes_and_comms)¶
模块章节目录
8.5. 模块架构概述¶
本模块剖析 ComfyUI 的生态基石与前后端通信底座:动态自定义节点扩展协议与基于 WebSocket 的实时全双工流式通信机制。
ComfyUI 的生态繁荣归功于其简洁而强悍的扩展抽象与异步通信架构:
节点协议标准与注册机制:解析
NODE_CLASS_MAPPINGS、INPUT_TYPES与RETURN_TYPES契约规范,以及插件加载器的动态导入与热重载。V3 API 面向对象节点规范:剖析新一代面向对象节点架构(
_ComfyNodeInternal/io.Combo/V3Data)与严格的 Schema 动态校验。aiohttp 服务端与 REST 路由:深入
server.py异步 HTTP 服务实现,解析提示词提交接口(/prompt)、队列控制与历史状态查询。WebSocket 流式事件总线:解剖基于二进制及 JSON 消息的实时通知协议(
executing/progress/executed),实现毫秒级 UI 状态与图片流式回传。