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

5.2 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

Draft-07 Specification

🎯 한 줄 통찰 (One-line insight)

Draft-07 Specification은 ComfyUI Workflow JSON v1.0의 구조적 무결성을 정의하는 공식 표준으로, 노드 속성과 링크 연결성을 규제하여 워크플로의 이식성과 실행 가능성을 보장한다 [1, 2].

🧠 핵심 개념 (Core concepts)

JSON Schema v1.0: Draft-07 사양을 따르는 최신 ComfyUI 워크플로 표준으로, 실행 엔진이 인식하기 위한 기술적 제약 조건을 정의한다 [1, 2].
Mandatory Node Properties: 노드 객체가 포함해야 하는 필수 속성(id, type, pos, size, order, mode)을 통해 그래프의 구조를 명시한다 [1].
Slot Connectivity Indexing: 링크 및 슬롯의 원본/대상 ID와 인덱스를 지정하여 데이터 흐름의 정확성을 확보한다 [3].
Serialization Validation: 워크플로가 직렬화될 때 이 사양을 준수해야만 ComfyUI 백엔드에서 유효한 프롬프트로 처리될 수 있다 [1, 4].

🧩 추출된 패턴 (Extracted patterns)

Bifurcation Compliance: 시각적 메타데이터를 포함하는 Frontend 포맷(workflow.json)과 실행 최적화된 Backend 포맷(workflow_api.json) 모두가 동일한 Draft-07 기반의 핵심 논리 구조를 공유한다 [5, 6].
Dependency Inversion Traversal: 엔진이 출력 노드에서 시작하여 사양에 정의된 링크를 역추적(backward traversal)하여 필요한 노드만 실행하는 구조적 패턴을 보인다 [7].
Metadata Redundancy: PNG 파일의 메타데이터 청크(tEXt/zTXt)에 두 가지 포맷을 동시에 저장하여 표준 준수와 사용자 편의성을 동시에 유지한다 [8].

📖 세부 내용 (Details)

ComfyUI 워크플로의 구조적 무결성은 Draft-07 사양을 따르는 공식 JSON Schema v1.0에 의해 검증된다 [1, 2]. 이 사양은 워크플로가 단순한 시각적 도표를 넘어 실행 가능한 프로그램으로서 작동하기 위한 기술적 제약 사항을 명시한다.

1. 노드 객체의 필수 속성 규격 [1]:

id: 그래프 탐색을 위한 고유 식별자 (Integer 또는 String).
type: 노드 레지스트리의 클래스 이름과 매핑되는 필수 문자열.
pos / size: UI 렌더링을 위한 캔버스 좌표 및 크기 정보.
order: 엔진이 참조하는 권장 실행 또는 렌더링 순서.
mode: 노드의 활성화, 바이패스(Bypass) 등의 운영 상태.

2. 링크 및 슬롯 연결 사양 [3]: 연결성은 노드 내부의 inputs 및 outputs 배열을 통해 정의된다. inputs 속성의 link 프로퍼티는 들어오는 와이어의 고유 ID를 식별하며, outputs의 links 배열은 하나의 출력이 여러 노드로 전달될 수 있음을 나타낸다. 특히 VAE Loader와 같이 다중 출력 슬롯을 가진 노드의 경우, 정확한 슬롯 인덱싱이 사양 준수의 핵심이다 [3].

3. 유효성 검사 및 실행 [4]: 워크플로 JSON이 생성되면 ComfyUI의 validate_prompt 함수는 이 사양을 기준으로 데이터 구조를 검증한다. 검증을 통과한 JSON은 DynamicPrompt로 구성되어 ExecutionList로 변환되며, 이 과정에서 사양에 어긋나는 연결이나 속성이 발견되면 실행이 거부된다 [4].

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

버전 업데이트: 이전의 0.4 버전 사양에서 최신 1.0(Draft-07 기반)으로 표준이 업데이트되었으며, 이는 공식 문서에서 권장되는 최신 규격이다 [2, 9].
포맷 간 차이: API 포맷은 효율성을 위해 UI 관련 메타데이터를 삭제하지만, 핵심적인 노드 클래스 매핑과 입력 구조는 여전히 Draft-07의 논리적 범주 내에 있다 [5, 6].

🛠️ 적용 사례 (Applied in summary)

ComfyUI Workflow v1.0: Draft-07 사양을 공식적으로 채택한 최신 워크플로 직렬화 규격 [1, 2].
WorkflowExecutor.execute(): 독립 실행 스크립트에서 validate_prompt를 호출하여 워크플로 JSON이 사양을 준수하는지 검증하는 로직이 적용됨 [4].
comfyui-workflow-to-api-converter-endpoint: 비 API 포맷을 API 포맷으로 변환할 때 ComfyUI의 노드 레지스트리와 사양을 참조하여 유효한 JSON을 생성함 [10, 11].

✅ 검증 상태 및 신뢰도

상태: draft
검증 단계: conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
출처 신뢰도: B (Official Documentation / Primary Source via NotebookLM)
중복 검사 결과: 신규 생성 (New discovery)

📝 변경 이력 (Change history)

2026-05-20: Initial draft generated via Datacollector_MAC P-Reinforce engine.

5.2 KiB Raw Blame History