用途:该技能是 comfy 核心能力之上的组合层,教用户用可复用的小片段拼装大型 ComfyUI 工作流,类似代码里的函数复用,避免重复搭建同一组节点(如 IPAdapter 块)。
主要能力:片段以 fragments/ 目录下的 .json 文件存在,含 _fragment 元数据头声明类型化接口(inputs、outputs、params,含默认值)。blueprint 用 YAML 端到端串联片段,组合器生成单个可直接运行的 API 格式工作流 JSON。引用体系支持 $alias.output(前一步输出)、$item.field(foreach 项字段)、$asset.<路径>(项目资产,经推送锁解析)、$var.<名称>(comfy.yaml 中 vars 常量),必须整值引用,不支持插值。若末段片段 terminal 为 true 则由其自行保存,否则自动追加 SaveImage/SaveVideo。
使用方式:命令内置于 comfy CLI,含 comfy workflow compose、decompose、comfy --json workflow fragment ls/show/validate,以及 comfy run --workflow ... --wait。--lib 默认 ./fragments,默认输出为 <blueprint>.compiled.json。decompose 可将已有工作流反投影为片段,避免手工编辑 widgets_values 或按节点 id 检索。编译产物内嵌 _meta(compose/1)溯源信息,foreach 支持 chunk: N 分批输出。所有命令在 comfy --json 下输出 JSON 信封,校验错误时以非零退出并给出结构化错误码(如 fragment_invalid、blueprint_invalid、fragment_lib_not_found)。
适用场景:可能被扩展、复用或迭代的工作流,跨多个工作流重复出现的子区域,节点数接近或超过约 200 行难维护的图,需要多模型提供方串联的流水线。
限制:仅适合弃用型一次性且明确追求速度的工作流,或只需改现有工作流内部数值(应使用 comfy workflow slots / set-slot / vary)。图形少于约 10–15 个节点、不会变化复用时也不建议用片段。前端格式与子图模板需先展平为 API 格式,需 object_info(运行中/云端服务器或离线 object_info.json)。字符串以外的非 STRING 类型不接受字面量。其它细节资料未提供。