用途:当最终图像或视频能渲染完成但结果不对(如伪影、主体或姿势错误、构图错、偏色、发虚、手部崩坏、风格不对)时,用来定位出错阶段,而不是重掷整个工作流。若运行本身失败(报错、OOM、缺节点、崩溃导致黑图),该技能不适用。
主要能力与用法:核心是 panel_run 配合 to_node_id(“运行到节点”),利用 ComfyUI 的原生部分执行,只渲染目标输出节点及其上游,其他分支跳过,因此每次探测快速且低成本。输出会自动送达,无需轮询。
硬性限制:to_node_id 必须是输出节点,如 SaveImage、PreviewImage、SaveVideo、SaveAudio(在 panel_query_graph 详情中 is_output: true)。裸的 KSampler、VAEDecode、预处理器不是输出节点,不能直接作为目标。要检查非输出位置,需先加预览探针:中间 IMAGE 接 PreviewImage;latent 经 VAEDecode 再接 PreviewImage;mask 经 MaskToImage 再接 PreviewImage;ControlNet 预处理器图通常已是 IMAGE,接 PreviewImage;CONDITIONING 无法直接预览,改看 widget 值或上游文本节点。探针用 panel_add_node 和 panel_connect 搭建,检查完用 panel_remove_node 移除。
调试流程:先读图(panel_graph_outline,必要时 panel_query_graph),记录节点 id、输出节点和每个节点的 mode,路径上处于 bypass/mute 的节点是错误渲染的常见原因,应先用 panel_set_node_mode 修好;然后在可疑链中部(二分)选探测点,取得该处输出,运行到该输出节点,观察此阶段是否已出错;仍正常则探测点下移,已出错则上移,重复直到找到第一个输出异常的阶段,再通过 panel_set_widget、panel_set_node_mode、重接线或换模型修复,并用运行到节点确认后再跑全图。
常见症状对应探测点:整体主体或风格错误,看 conditioning 来源(文本/提示词节点、采样器正向输入的 latent 解码);ControlNet 未生效或结构错误,看预处理器输出图;IPAdapter 参考未生效,看 resize/crop 后的参考图;inpaint/outpaint 溢出,用 MaskToImage 看实际进入采样器的 mask;refiner/放大后变差,比较基础 latent 前后;内容正确仅质量差,问题靠后,先探末端。
注意事项:目标是非输出节点会被拒绝并提示;mode 会影响结果;预览探针标注为 preview,不是保存文件,无 SaveImage 即“未执行保存输出”属正常;每次运行到节点都会排队一个真实小任务,不要叠加探测;嵌套在子图内的输出节点暂不能作为目标,需在根图加探针。使用方式、安装命令和收费信息暂无提供。