从眼前的问题开始查。

工作流执行成功后，调用方还需要知道哪些节点产生了结果、结果保存在什么位置，以及如何取回。不要把节点 ID、文件名和任务 ID 混成一个字段。

原生 ComfyUI API 拒绝提交工作流。HTTP 400 只说明这次请求不符合要求，具体原因应从 error 与 node_errors 中提取，不能一律当成网络不稳定重试。

本指南面向调用自有或获授权 ComfyUI 实例的开发者。网站提供的 MCP 与 ComfyUI 原生 HTTP API 是两套不同接口；这里讨论后者，不涉及自动登录第三方平台或绕过访问限制。

浏览器或脚本无法连接 ComfyUI。localhost 指的是发起访问的那台设备；本机、容器、Notebook、远程服务器和手机之间的地址含义不同，不能只复制一段固定 URL。

将页面、后端、日志、节点列表和工作流保存请求分别定位，避免用同一套办法处理所有连接错误。

用独立服务、任务标识与结果接口设计集成，区分 Python 入口脚本和稳定 API 契约。

浏览器打不开正常画布、控件消失或白屏，但后端终端可能仍在运行。需要区别静态资源加载失败、前端扩展冲突和后端根本没启动，不能看到白屏就重装所有模型。

更新之后，新教程里的模板或界面仍然不存在。ComfyUI 核心源码、桌面应用、前端包、自定义节点与模板并不是一个不可分割的版本号。

区分远程目录、缓存、过滤条件、节点代码和 Python 导入，保留真实请求与错误记录。

ComfyUI 启动时无法绑定端口，通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例，但不能看到端口占用就立即杀掉所有 Python 进程。

点击运行后任务很快结束，没有在预想目录看到新图片或视频。这可能是缓存命中、没有新的保存操作、输出写到临时目录，或者客户端把某个事件误当作成功。

API 客户端能连接 WebSocket，也成功排队，但一直等待某个事件或没有取回结果。需要核对 client_id、prompt_id、终止事件和历史查询，而不是只以连接保持为成功条件。

先尝试导出独立副本，再区分草稿保存、文件下载和 API 格式，不以清缓存作为第一步。