从眼前的问题开始查。

这是一条历史维护状态记录，不是今天的新版本公告。IPAdapter Plus 作者在 README 中于 2025 年 4 月 14 日说明将项目置于 maintenance-only 模式，需要在使用和推荐旧教程时保留这个背景。

这是一篇带日期的历史更新解读：2026 年 8 月 3 日，Comfy 官方发布 MiniMax H3 Day-0 原生支持公告。文章核对的是这次事件及其对教程的影响，不把它称为今天刚刚发生的新闻。

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

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

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

下载完成但解压报 CRC、Data Error 或无法识别压缩包时，不要继续启动残缺的 Python。先验证压缩包，再排查解压工具、分卷、磁盘和路径。

翻译节点可能在导入 Python 包时失败，也可能已能导入但没有所需语言模型。先确认节点实际调用的是 Argos Translate，不要因为名称相似安装别的翻译库。

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

本指南用于在更新前建立恢复条件。能够 git checkout 旧代码，不等于 Python 依赖、前端、节点和配置也恢复到了旧状态；真正可回退需要记录整个环境的关键组成。

通过 API 构造 inputs 时，列表值被当作节点连接，但不符合连接结构。特别是业务参数本身为数组时，不能假设任何 JSON 列表都会被当作普通值原样传入。

任务没有立即报错，却输出黑图、无效像素或明显异常颜色。先判断实际保存文件是否异常，再区分输入、采样、解码和显示问题；黑色预览与黑色成品不能混为同一现象。

混合节点的异常可能发生在导入，也可能发生在图像数组运算。包名、输入通道、数组类型和透明度参数需要分别核对，不能用“强制转成四通道”覆盖所有情况。

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

适用于升级后某个节点导入失败，或提示某模块缺少过去使用的名称、属性。它与 No module named 不同：模块可能已经存在，只是调用的接口或导入关系不再满足要求。

CLIPTextEncode 等节点收到空的 CLIP 输入。需要检查编码器是否真的加载成功、连线是否正确，以及当前模型是否采用分体加载，而不是只看节点框上有没有一根线。

参考图工作流缺少视觉编码器，或加载后在图像嵌入阶段出现维度不匹配。先确认需要的是 CLIP Vision，而不是 CLIPTextEncode 对应的文本编码器。

以 v0.37.0 的 Qwen 2.1 节点为样本，区分核心发行版本、节点类名和画布显示名；不冒充完整核心节点导出。

先区分官方 Comfy Cloud、自管远程 GPU 或 Docker，以及受托管的 Colab 笔记本，再决定模型存储、端口访问和持久化方式。

先认识 ComfyUI 的节点画布、工作流图、模型与节点面板、执行队列和输出。不同版本的标签与布局可能变化；本指南依据当前官方界面文档，不代表本站实机测试。

在 Apple 芯片 Mac 上选择官方 Desktop 或独立的手动 Python 环境；先确认设备后端，不要照搬 CUDA 修复命令。

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

记录包标识、仓库、观察到的 1.7.9 版本和声明依赖；节点说明与视频报错相互关联，不把功能名当技术类名。

分别排查 ControlNet 与底模兼容性、控制图预处理和条件链路；节点连线类型错误应单独诊断。

将轮廓、姿态或深度信息加入生成流程时，首先应确认控制图是什么、ControlNet 需要什么，以及控制条件是否进入实际采样链路。此文不把所有控制模型归成一个万能节点。