Files

T

koriweb a3f63e56e2 Add ComfyUI wikified docs and youtube extracts; tidy raw→Topics

- 10_Wiki/Comfyui/: ComfyUI docs generated via /wikify
- 00_Raw/_youtube/: /youtube extraction outputs
- Move some 00_Raw originals into 10_Wiki/Topics_meeting; remove empty canvases and stray files

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-20 18:41:10 +09:00

4.9 KiB

Raw Blame History

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit

title

Workflow JSON - ComfyUI

🎯 한 줄 통찰 (One-line insight)

ComfyUI의 워크플로우를 정의하기 위해 JSON Schema를 사용하여 구조화된 데이터를 생성하고 관리하는 규격서입니다.

🧠 핵심 개념 (Core concepts)

JSON Schema 기반 정의: Workflow JSON은 JSON Schema를 사용하여 정의되며, 변경 사항은 rfcs repo에서 논의됩니다.
ComfyWorkflow v1.0 구조: 워크플로우의 핵심 요소로 version, state, nodes를 필수적으로 포함합니다.
노드 및 연결 구조: nodes, links, reroutes 등 노드의 위치, 크기, 입력/출력 핀(pins) 및 연결 상태를 정의하는 복잡한 객체 모델을 가집니다.
상태 관리 (State): 마지막으로 사용된 그룹 ID, 노드 ID, 링크 ID 등을 포함하여 워크플로우의 연속성을 유지합니다.

🧩 추출된 패턴 (Extracted patterns)

계층적 데이터 구조: nodes 내부에 inputs, outputs, properties, widgets_values와 같은 하위 객체를 두어 노드의 동작을 세부적으로 정의하는 패턴을 보입니다.
좌표 및 경계 정의: groups의 bounding이나 nodes의 pos, size를 수치 배열 또는 객체 형태로 정의하여 UI 상의 위치를 결정합니다.
관계형 연결 (Linking): links 객체를 통해 origin_id와 target_id 사이의 관계를 명시적으로 정의합니다.

📖 세부 내용 (Details)

1. Workflow JSON v1.0 주요 구성 요소

Version: 워크플로우 버전은 상수로 1을 가집니다.
Config: links_ontop 또는 align_to_grid와 같은 설정 값을 포함할 수 있습니다.
State: lastGroupid, lastNodeId, lastLinkId, lastRerouteId를 통해 워크플로우의 마지막 상태를 저장합니다.

2. Nodes (노드) 상세 규격

필수 속성: id, type, pos, size, flags, order, mode, properties가 반드시 포함되어야 합니다.
입력 및 출력: inputs와 outputs는 각각 이름, 타입, 슬롯 인덱스 정보를 포함하며, 노드 간의 데이터 흐름을 제어합니다.
기타 속성: widgets_values, color, bgcolor 등을 통해 시각적 요소와 사용자 입력값을 관리합니다.

3. Links & Reroutes (연결 및 리라우트)

Links: id, origin_id, target_id, type 등을 포함하며 노드 간의 연결을 정의합니다.
Reroutes: id, pos, linkIds를 통해 연결 경로를 재지정하는 역할을 합니다.

4. 기타 데이터 구조

Groups: title, bounding, color, font_size, locked 속성을 가진 그룹 정보를 포함합니다.
Models: name, url, hash, directory 등을 통해 모델 데이터를 관리할 수 있습니다.

⚖️ 모동 및 업데이트 (Contradictions & updates)

최신 버전 정보: 현재 최신 버전은 Version 1.0 (Latest)로 명시되어 있습니다.
이전 버전 존재: Older versions에 대한 언급이 있으나, 구체적인 하위 버전의 상세 스키마는 본문에서 확인되지 않음 (단, 0.4 버전 관련 언급 있음).

🛠️ 적용 사례 (Applied in summary)

JSON Schema 검증: ComfyUI 워크플로우 파일이 규격에 맞게 작성되었는지 검증하는 도구로 활용될 수 있습니다.
워크플로우 저장 및 공유: 노드, 링크, 그룹 정보를 JSON 형태로 직렬화하여 다른 사용자에게 전달하거나 재사용할 수 있습니다.

✅ 검증 상태 및 신뢰도

상태: draft
검증 단계: conceptual
출처 신뢰도: B (Primary Source — 웹사이트 본문 직접 추출)
중복 검사 결과: 신규 생성 (New discovery)

JSON Schema: 워크플로우 데이터의 구조를 정의하고 검증하는 표준 규격입니다.
ComfyUI Server: 워크플로가 실행되는 백엔드 환경과 관련된 개념입니다.
Node Definitions: 워크플로우 내 개별 노드의 동작과 속성을 정의하는 기초 정보입니다.
[[rfcs repo]: 스키마 변경 사항이 논의되는 공식적인 저장소입니다.

📝 변경 이력 (Change history)

2026-05-20: Astra /wikify 로 https://docs.comfy.org/specs/workflow_json 본문에서 초안 생성.

4.9 KiB Raw Blame History