SuperAPI AI 工具集

comfy-custom-nodes-validation

编程与开发

查看项目

更新于 10-20 17:54

技能介绍

该工具是 comfy-cli 中用于验证生成的 ComfyUI 自定义节点代码的分层回退方案,核心目标是在节点真正被 ComfyUI 加载前,按阶段排查问题,避免把文件存在误当作加载成功。

主要能力与验证流程:

  1. 静态契约检查与 Python 语法解析,先排除代码结构与语法层面的明显问题。
  2. 在 ComfyUI 自身的 Python 环境中执行导入,检验依赖与运行环境是否匹配。
  3. 重启 ComfyUI,通过 /object_info 检查节点是否被发现与注册。
  4. 执行一个小型工作流,确认节点在实际运行中可用。

检查项包括:注册形式是否正确,节点、输入与输出的 ID 是否唯一且非空,声明的可调用对象是否存在,并报告依赖、文件系统与网络相关行为。

使用要点:修复后必须重启并重新发现节点,不应承诺热重载。使用 --where local 可将本地目录检查固定到本地结果;若命令报告 object_info_stale,表示结果来自缓存,应重启 ComfyUI 后重新运行命令,只有警告消失后目录结果才能作为加载证据。comfy nodes refresh 只重新拉取注解,不更新 /object_info,浏览器刷新也不会改变两者。

适用场景:自定义节点开发完成后的加载前验证、修复后复验、排查节点未被发现或缓存导致的误判。

限制:静态扫描无法证明动态行为不存在,因此不能替代运行时验证;资料未提供该工具的具体命令示例、安装步骤、平台支持与收费信息,暂未提供。