快速结论:该报错通常出现在用户希望通过 ComfyUI-Manager 的“通过 Git URL 安装”或节点列表功能安装 ComfyUI-QueueControl 时,发现它没有出现在 custom-node-list.json 中。优先排查该节点是否已被合并进节点清单;如果尚未合并,应改用 Git 克隆方式手动安装。
适用环境:Issue 中只明确提到 ComfyUI Manager 与 ComfyUI 内置 Queue Manager,作者提供的安装类型为 git-clone。操作系统、Python、CUDA、PyTorch、显卡型号均无确认信息。
最快修复方案:暂无确认的一步修复方案。Issue 最终反馈为“I got bad advice. sorry. Moving to a pull request.”,说明作者改为通过提交 PR 将节点加入清单,原生安装入口需等待该 PR 合并后才可能生效。
注意事项:Issue 原文只是一份节点清单条目提交,并不代表该节点已被收录进 custom-node-list.json。PR 合并前,直接依赖 Manager 列表安装仍可能失败;改为手动 Git 克隆属于绕行方案,Issue 中未给出具体命令,请以节点仓库说明为准。
问题场景
用户在 ComfyUI 中使用 ComfyUI-Manager 管理自定义节点,希望添加 ComfyUI-QueueControl。该扩展用于增强 ComfyUI 内置 Queue Manager,支持暂停/恢复队列、调整执行顺序、挂起单条任务,以及将整个队列保存到磁盘并在重启后恢复,还可在意外崩溃时自动保存并恢复当前队列。用户请求将其加入 Manager 的 custom-node-list.json,以便通过节点清单安装。
报错原文
Please add ComfyUI-QueueControl to custom-node-list.json
同时,Issue 正文提供了期望收录的条目信息,关键字段为 install_type: git-clone,仓库地址为 https://github.com/seeker-ktf/ComfyUI-QueueControl。
原因分析
最可能的原因是 ComfyUI-QueueControl 当时尚未被加入 ComfyUI-Manager 维护的 custom-node-list.json,因此 Manager 的节点列表或 Git URL 安装流程无法识别它。Issue 正文实际是一个列表收录请求,而非运行期崩溃。Issue 末尾作者表示“I got bad advice. sorry. Moving to a pull request.”,即此前处理方式不正确,后续应通过 PR 修改节点清单,因此可判断该问题的根因在于节点尚未收录,而不是用户本地环境故障。
环境排查
- 确认 ComfyUI-Manager 是否为 Issue 对应时间点的版本,并尝试刷新或重新拉取节点清单。
- 确认安装方式:Issue 给出的推荐安装类型是
git-clone,不是 pip 包。 - 确认目标节点仓库地址是否为
https://github.com/seeker-ktf/ComfyUI-QueueControl。 - Issue 未提供 Python、CUDA、PyTorch、显卡型号等信息,这些项目无需作为本问题的前置排查重点。
- 如果通过 Manager 列表安装仍不可见,检查是否已有方式能安装该节点。
解决步骤
- 先确认在 ComfyUI-Manager 的节点列表中能否找到
ComfyUI-QueueControl;如果找不到,说明清单尚未包含它。 - 如 Issue 结论所述,由扩展作者向 ComfyUI-Manager 提交 PR,在
custom-node-list.json中新增该节点条目;Issue 中给出的字段包括title、reference、files、install_type、description。 - PR 合并并更新节点清单后,再通过 ComfyUI-Manager 重新搜索或安装该节点。Issue 未记录合并后的具体刷新和安装操作,可优先尝试更新 Manager 后重启复检。
- 如果仍需临时使用,可优先尝试按节点仓库的说明手动 Git 克隆安装;Issue 未提供具体命令,请勿照搬不确定的路径或参数。
验证方法
确认 ComfyUI-Manager 的节点清单中已能检索到 ComfyUI-QueueControl,且其安装来源指向 https://github.com/seeker-ktf/ComfyUI-QueueControl,即可认为收录问题已解决。至于节点在 Queue Manager 中的暂停/恢复、排序、保存恢复等功能是否正常,建议以该节点仓库的说明为准进行验证;Issue 本身未包含这部分验证记录。
参考来源
ltdrdata/ComfyUI-Manager #3546
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


