ValueError: PidNet requires lq_latent — attach via PiDConditioning
快速结论：该报错在使用 ComfyUI 的 PiD — Latent Upscale & Decode 工作流时触发。优先排查是否已正确连接 PiDConditioning 节点，并确认 ComfyUI 版本是否已更新至 0.24.0 或更高。
问题场景
用户在 ComfyUI 中运行 PiD（Parallel-in-Diffusion）模型的 Latent Upscale & Decode 工作流时，在 KSampler 阶段报错。用户尝试使用 “Manual Context Windows” 节点手动配置上下文窗口，但问题仍然存在。
报错原文
ValueError: PidNet requires lq_latent — attach via PiDConditioning原因分析
根据 Issue 讨论，此错误表明 PidNet 模型期望接收 lq_latent 条件输入，但工作流中未正确通过 PiDConditioning 节点提供该输入。可能原因包括：
PiDConditioning节点未正确连接到lq_latent输入。- 使用的 ComfyUI 版本较旧，已通过后续修复解决（用户升级至
0.24.0后问题消失）。 - 工作流配置错误，例如缺少必要的条件节点或连接关系。
环境排查
- ComfyUI 版本（建议升级至
0.24.0或最新版）。 - 确认工作流中已包含并正确连接
PiDConditioning节点（该节点用于提供lq_latent条件）。 - 检查是否使用了 “Manual Context Windows” 节点，如果是，确认其参数（如 context length/overlap、dimension index）是否正确设置。
- 尝试不使用 “Manual Context Windows” 节点，使用默认上下文窗口测试。
解决步骤
- 确认
PiDConditioning节点已正确连接： 在 ComfyUI 工作流中，确保PiDConditioning节点的输出已连接到PidNet的lq_latent输入。如果未找到该节点，手动添加并连接（参考 Issue 中的截图示例）。 - 更新 ComfyUI： 将 ComfyUI 升级至
0.24.0或最新版本。根据 Issue 讨论，此问题可能在更新后已自动修复。 - 移除 “Manual Context Windows” 节点（可优先尝试）： 如果工作流中使用了该节点，先移除并测试默认上下文窗口是否正常工作。Issue 中有用户反馈移除后问题解决。
- 检查依赖版本： 确保所有相关节点和依赖库（如 PiD 相关插件）均为最新版本。如果使用 StabilityMatrix 等管理工具，检查其内部 ComfyUI 更新机制。
- 重新导入工作流： 如果问题仍然存在，尝试从 Issue 附件（如
02-pid_flux1_upscale-debug.json）重新导入工作流，并检查所有节点连接是否正确。
验证方法
重启 ComfyUI 后重新运行工作流。如果 KSampler 正常输出图像，且无 ValueError 报错，则问题已解决。检查输出图像是否清晰无方块（确保与 Issue 中描述的 “blocky / fuzzy” 问题对比）。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
