koriweb
a3f63e56e2
- 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>
75 lines
4.0 KiB
Markdown
75 lines
4.0 KiB
Markdown
---
|
|
id: subgraph-blueprints---comfyui
|
|
title: "Subgraph blueprints - ComfyUI"
|
|
category: "10_Wiki/Topics"
|
|
status: "draft"
|
|
verification_status: "conceptual"
|
|
canonical_id: ""
|
|
aliases: []
|
|
duplicate_of: ""
|
|
source_trust_level: "B"
|
|
confidence_score: 0.8
|
|
created_at: 2026-05-20
|
|
updated_at: 2026-05-20
|
|
review_reason: ""
|
|
merge_rypt_history: []
|
|
tags: ["web", "wikify"]
|
|
raw_sources: ["https://docs.comfy.org/custom-nodes/subgraph_blueprints"]
|
|
applied_in: []
|
|
github_commit: ""
|
|
---
|
|
|
|
# [[Subgraph blueprints - ComfyUI]]
|
|
|
|
## 🎯 한 줄 통찰 (One-line insight)
|
|
[[ComfyUI]]에서 커스텀 노드 개발자가 재사용 가능한 서브그래프 컴포넌트를 글로벌 블루프린트로 제공하여 사용자가 워크플로우에 즉시 추가할 수 있게 하는 기능입니다.
|
|
|
|
## 🧠 핵심 개념 (Core concepts)
|
|
- **Global Subgraph Blueprints**: 커스텀 노드와 연관된 재사용 가능한 [[subgraph]] 컴포ned를 전역 블루프린트로 가용화하는 기능입니다.
|
|
- **Automated Scanning**: [[ComfyUI]]는 모든 커스텀 노드 디렉토리를 스캔하여 [[subgraph]] 파일을 자동으로 찾아냅니다.
|
|
- **API Delivery**: 스캔된 서브그래프 파일은 `/global_subgraphs` API 엔드포인트를 통해 서비스됩니다.
|
|
|
|
## 🧩 추출된 패턴 (Extracted patterns)
|
|
- **개발자 워크플로우**: 커스텀 노드 디렉토리 내 `subgraphs/` 폴더 생성 $\rightarrow$ `.json` 파일 배치 $\rightarrow$ [[ComfyUI]] 자동 스캔 및 API 제공.
|
|
- **서브그래프 생성 절차**: [[ComfyUI]]에서 서브그래프 구축 $\rightarrow$ 노드 선택 및 변환 $\rightarrow$ JSON으로 내보내기 $\rightarrow$ `subgraphs/` 폴더에 저장.
|
|
|
|
## 📖 세부 내용 (Details)
|
|
### 🛠️ 구현 방법 (Implementation)
|
|
노드 개발자는 다음과 같은 방식으로 블루프린트를 배포할 수 있습니다:
|
|
1. 커스텀 노드 디렉토리 내에 `subgraphs/` 폴더를 생성합니다.
|
|
2. 해당 폴더 안에 `.json` 형식의 서브그래프 파일을 배치합니다.
|
|
|
|
### 📂 파일 구조 예시 (Example Structure)
|
|
`ComfyUI-MyCustomNodeModule/subgraphs/` 경로 내에 다음과 같은 파일이 포함될 수 있습니다:
|
|
- `My_upscale_subgraph.json`
|
|
- `My_effects_subgraph.json`
|
|
위와 같이 구성된 경우, [[ComfyUI]]의 서브그래프 브라우저에서 해당 블루프린트들을 확인할 수 있습니다.
|
|
|
|
### 📝 JSON 파일 생성 프로세스 (Creation Process)
|
|
서브그래프 JSON 파일은 워크플로우 JSON 파일과 동일한 형식을 사용하며, 가장 쉬운 생성 단계는 다음과 같습니다:
|
|
1. [[ComfyUI]] 내에서 서브그래프를 구축합니다.
|
|
2. 포함할 노드들을 선택합니다.
|
|
3. 해당 노드들을 서브그래프로 변환합니다.
|
|
4. 서브그래프를 JSON으로 내보내기(Export) 합니다.
|
|
5. 생성된 JSON 파일을 `subgraphs/` 폴더에 저장합니다.
|
|
|
|
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
|
|
본문에서 확인되지 않음.
|
|
|
|
## 🛠️ 적용 사례 (Applied in summary)
|
|
- **커스텀 노드 배포**: `ComfyUI-MyCustomNodeModule`과 같은 커스텀 노드 모듈에서 사용자가 워크플로우에 즉시 추가할 수 있는 사전 구축된 노드 그룹(pre-built node groups)을 제공하는 사례로 활용됩니다.
|
|
|
|
## ✅ 검증 상태 및 신뢰도
|
|
- **상태:** draft
|
|
- **검증 단계:** conceptual
|
|
- **출처 신뢰도:** B (Primary Source — 웹사이트 본문 직접 추출)
|
|
- **중복 검사 결과:** 신규 생성 (New discovery)
|
|
|
|
## 🔗 관련 문서 링크 (Related document links)
|
|
- [[subgraph]]: 사용자가 서브그래프와 상호작용하는 방식에 대한 기본 개념입니다.
|
|
- [[ComfyUI]] API Reference: `/global_subgraphs` 엔드포인트와 관련된 기술적 명세입니다.
|
|
- [[Custom Nodes]]: 커스텀 노드 개발 및 배포를 위한 가이드라인입니다.
|
|
- [[Workflow JSON]]: 서브그래프 파일의 기반이 되는 데이터 형식입니다.
|
|
|
|
## 📝 변경 이력 (Change history)
|
|
- 2026-05-20: Astra /wikify 로 https://docs.comfy.org/custom-nodes/subgraph_blueprints 본문에서 초안 생성. |