LiblibAI工作流导入失败主因是文件未通过底层校验，需依次检查：UTF-8无BOM编码、JSON/YAML语法合规、扩展名与内容一致、符合Schema v2.4必填字段（version/nodes/edges）、避免使用非原生自定义节点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
LiblibAI工作流导入失败时，系统通常不提示具体原因，只显示“加载失败”或卡在解析阶段——这说明文件未通过平台底层校验器，而非网络或账号问题。
检查文件格式与编码是否合规
第一步：用VS Code打开你准备上传的.json或.yaml文件，右下角查看当前编码。若显示“UTF-8 with BOM”，必须点击该区域→选择“Save with Encoding”→再选“UTF-8”重新保存。【Windows记事本另存为“UTF-8”默认仍带BOM，会导致首行字段名前出现乱码字符，直接触发解析中断】
第二步：复制全部内容，粘贴到 JSONLint（JSON）或 YAML Checker（YAML）中校验。JSON报错常见于单引号代替双引号、末尾多逗号、注释残留；YAML则多因缩进混用空格与Tab、冒号后缺空格。
第三步：确认文件扩展名与内容真实一致。例如，文件名为workflow.json，但实际内容是Python字典格式或带console.log()调试语句，平台会拒绝加载。
验证结构是否符合LiblibAI Schema规范
方法一：比对官方必填字段清单
打开LiblibAI开发者文档中最新版《Workflow Schema v2.4》页面，确认你的文件根对象包含且仅包含以下三项顶层键：【version】（字符串，值必须为"2.4"）、【nodes】（非空数组）、【edges】（数组，可为空但不能缺失）。任意一项缺失或拼写错误（如写成"node"或"edge"），都会导致加载失败。
方法二：用curl命令绕过前端直接测试
在终端执行以下命令（替换YOUR_API_KEY和实际文件路径）：
curl -X POST https://api.liblib.ai/v1/workflows/import \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d @./workflow.json
若返回HTTP 400且body含"missing field: version"或"invalid nodes structure"，说明结构问题确凿；若返回504，则是网关超时，与文件本身无关。
排查节点与插件兼容性冲突
ComfyUI导出的工作流若含Impact Pack、WAS Suite等自定义节点，上传到LiblibAI后必然失败——这些节点未预装，平台无法识别其type字段（如"ImpactWildcardProcessor"）。
必须手动编辑JSON，将所有非标准节点替换为LiblibAI原生支持的等效节点。例如：把"type": "KSampler"保留，但把"type": "ImpactControlNetLoader"整段删除，并在对应edges中切断与其相连的连线。
注意：不要尝试保留ControlNet相关节点却不启用ControlNet插件。LiblibAI会在加载时校验插件启用状态，发现声明了controlnet节点但未开启插件开关，会静默丢弃整个workflow。
