从眼前的问题开始查。

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

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

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

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

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

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

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

适用于明确准备使用 NVIDIA GPU，但当前 Python 检测不到可用 CUDA 设备。False 只是当前进程无法使用 CUDA 的结果，应从构建、设备可见性与驱动逐层排查。

任务在 GPU 上分配内存失败。先定位失败发生在模型加载、采样、VAE 解码还是其他节点，再决定降低哪个负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。

下载模型、解压依赖或保存图片视频时出现磁盘空间错误。即使目标输出盘还有空间，下载缓存、系统临时目录、容器可写层或另一个挂载点仍可能已满。

按失败阶段整理下载记录，保留具体文件身份和原始发布入口，不默认更换不明镜像或关闭证书校验。

先核对进程可见的设备和实际后端，不把 GPU 0 标签当成物理显卡身份，也不默认显存相加。

浏览器可以打开模型页面，但命令行、节点或下载脚本得到未授权或拒绝访问。这里首先检查资源访问资格与凭据身份，不应直接关闭 TLS 校验或寻找绕过受限仓库的方法。

选择 Windows、Apple 芯片 macOS 或 Linux 的官方桌面安装包，创建 ComfyUI 实例，并区分启动器与模型、输出文件所在目录。

Windows 提示不认识应用、阻止启动或隔离文件时，先识别是哪种防护在起作用。文件名看起来熟悉，不能证明下载物没有被替换。

这份指南用于规划一个可识别、可回退的手动安装环境。重点不是给所有机器同一条 pip 命令，而是先确定设备后端、受支持 Python 与独立工作目录。Desktop 和 Portable 用户不应直接照搬手动环境命令。

上游输出的接口类型与下游输入声明不同，服务端拒绝执行。例如 IMAGE、LATENT、MODEL 和 CONDITIONING 在工作流里承担不同角色，不能仅因界面允许拖动就视为可互换。

在 Mac 上加载某个 FP8 模型或执行节点时，出现转换到 MPS 不支持的 dtype 提示。需要确定是权重加载、解量化还是运算阶段受限，而不能据文件名认定所有量化模型都不支持。

Apple Silicon 上的任务触发 MPS 内存上限。Mac 使用统一内存，浏览器、其他应用、模型和中间张量会共同影响可用空间，不能把机器总内存全部视为可分配给当前生成任务。

转换失败与超出当前节点范围要分开检查；先核对请求实际提交的值，不要直接改节点定义或统一截断数字。

结合退出状态、节点注册和当前工作流判断影响，不按日志颜色决定是否升级整个环境。

Portable 包含自己的 Python 与 ComfyUI 目录。最容易出错的操作，是把依赖安装到系统 Python，却期待嵌入式 Python 可以自动使用。此文按进程和路径解释如何避免两套环境混用。

请求包含若干加载和计算节点，但服务端没有找到本次要执行的有效输出节点。单纯在画布上生成 latent 或连接一些中间节点，并不必然构成完整执行目标。

用环境信息、单次变更和相同输入记录排查过程，区分安装记录、依赖检查和真实运行。