{
  "description": "ComfyUI workflow 格式转换工具：将 ComfyUI UI 导出的 workflow.json 转换为可通过 API 提交的 workflow_api.json",
  "task_spec": "脚本位置：tests/run_comfy/convert_workflow.py\n\n## 功能\n将 ComfyUI 界面导出的 workflow.json（UI格式）转换为 API 可直接提交的 workflow_api.json（API格式）。\n\n## 两种格式的区别\n- UI格式：nodes[] 数组，每个节点含 id/type/pos/size/color/widgets_values/links 等 UI 信息\n- API格式：以 node_id 为 key 的对象，每个节点只含 class_type 和 inputs（参数值或连接引用）\n\n## 用法\n```bash\npython convert_workflow.py workflow.json\npython convert_workflow.py workflow.json -o output_api.json\n```\n\n## 参数\n- workflow（位置参数）：输入的 UI 格式 workflow.json 路径\n- -o / --output：输出路径，默认在原文件名基础上加 _api 后缀\n\n## 转换规则\n1. 跳过纯 UI 节点（Note、MarkdownNote、PrimitiveNode）\n2. 跳过 mode != 0 的禁用节点\n3. 节点连接通过 links[] 映射还原为 [src_node_id, src_slot] 格式\n4. widgets_values 按顺序填入未连线的输入参数，参数名用 widget_0/widget_1/... 占位\n\n## 注意\n- widget_* 占位参数名不准确，建议直接在 ComfyUI 界面使用「Save (API Format)」按钮导出，可获得准确参数名\n- 转换后建议用 check_workflow.py 验证"
}
