LiblibAI工作流导入失败因文件未通过底层校验：需确保UTF-8无BOM编码、JSON/YAML语法正确、扩展名与内容一致；根对象必须严格符合Schema v2.4的version、nodes、edges三项顶层键；含非原生节点须替换为CLIPTextEncode等原生type。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
LiblibAI导入工作流后界面无响应、节点不显示、边缘连线消失或根本未触发任何加载提示，说明文件未通过平台底层校验器的首轮解析，而非网络延迟或UI卡顿——系统在读取文件头或结构层时已静默终止流程。
检查文件编码与语法是否被底层拒绝
第一步：用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()调试语句，平台会立即拒绝加载，不报错也不提示。
验证是否符合Schema v2.4强制结构
打开LiblibAI开发者文档中最新版《Workflow Schema v2.4》页面，确认你的文件根对象包含且仅包含以下三项顶层键：【version】（字符串，值必须为"2.4"）、【nodes】（非空数组）、【edges】（数组，可为空但不能缺失）。任意一项缺失、拼写错误（如写成"node"或"edge"）、或嵌套层级错位（如nodes藏在data.nodes里），都会导致加载失败且无日志反馈。
方法一：用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、Custom Crop等非原生节点，上传到LiblibAI后必然失败——这些节点未预装，平台无法识别其type字段（如"ImpactWildcardProcessor"或"WAS_Text_To_Image"），会在解析阶段直接丢弃整个文件。
必须手动编辑JSON，将所有非标准节点替换为LiblibAI原生支持的等效节点：
① 查找所有"type": "ImpactWildcardProcessor" → 替换为"type": "CLIPTextEncode"
② 查找所有"type": "WAS_Text_To_Image" → 替换为"type": "KSampler"
③ 删除所有含"custom_"前缀的字段（如"custom_width"）、以及未在v2.4 Schema中定义的扩展属性
这一步操作起来很简单，直接用VS Code的批量替换（Ctrl+H）即可完成。但跳过它，哪怕其他全部合规，工作流也绝不会加载。
