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.0 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

object_info.json

🎯 한 줄 통찰 (One-line insight)

실행 중인 ComfyUI 인스턴스 내 모든 노드의 입출력 규격과 제약 조건을 정의하는 핵심 스키마 레지스트리 [1, 2].

🧠 핵심 개념 (Core concepts)

스키마 카탈로그 (Schema Catalog): 현재 실행 중인 ComfyUI 인스턴스에 설치된 모든 노드(내장 및 커스텀 노드 포함)의 상세 사양을 담고 있는 청사진이다 [2].
데이터 타입 및 범위 정의: 각 노드가 요구하는 필수/선택적 입력값의 종류, 허용되는 수치 범위(Min/Max), 기본값, 그리고 출력 데이터의 타입을 명시한다 [2, 3].
동적 엔드포인트 정보: 서버 실행 중에 /object_info 경로를 통해 실시간으로 획득할 수 있는 동적 데이터이다 [4].
유효성 검사 기준: 외부 애플리케이션이나 사용자 정의 UI에서 입력 데이터를 검증하거나 워크플로우를 프로그래밍 방식으로 수정할 때 참조하는 기준점이 된다 [4, 5].

🧩 추출된 패턴 (Extracted patterns)

서버 기반 동적 쿼리 패턴: 고정된 파일이 아니라, 현재 서버 환경에 설치된 커스텀 노드 상태를 반영하기 위해 서버 ID 기반의 특정 URL 엔드포인트를 통해 데이터를 추출하는 방식을 취한다 [4].
입력 유효성 선행 검증 패턴: API를 통해 워크플로우를 실행하기 전, 이 JSON의 스키마 정보를 활용하여 파라미터 오버라이드 값이 노드의 수용 범위를 준수하는지 사전에 확인한다 [4, 5].

📖 세부 내용 (Details)

object_info.json은 ComfyUI 서버가 현재 운용 가능한 모든 노드 클래스에 대한 지식 데이터베이스 역할을 수행한다 [2]. 이 파일은 크게 다음과 같은 정보를 포함한다.

노드 입력 사양: 필수(required) 및 선택(optional) 입력 항목을 구분하며, 각 입력 항목의 데이터 타입(예: STRING, INT, IMAGE)과 위젯 값의 범위, 기본값 등을 정의한다 [2, 3]. 이는 내부적으로 노드의 INPUT_TYPES() 함수 정보에서 기인한다 [3].
노드 출력 사양: 해당 노드가 실행 결과로 생성하는 데이터 스트림의 타입을 정의하여 다른 노드와의 연결 가능 여부를 판단하게 한다 [2].
메타데이터 및 보조 정보: 노드에 대한 툴팁이나 개발자용 메타데이터 정보를 포함하여, 외부 도구가 노드의 기능을 이해하고 사용자에게 설명할 수 있도록 돕는다 [2].

이 파일은 특히 서버리스 API 배포 환경에서 중요한 역할을 하며, 개발자는 이를 통해 자신만의 사용자 인터페이스를 구축하거나 워크플로우를 동적으로 생성 및 수정하는 도구를 제작할 수 있다 [1, 4]. 실행 중인 서버에서 직접 데이터를 가져오는 방식이 권장되며, 이는 설치된 커스텀 노드의 변경 사항을 즉각적으로 반영하기 위함이다 [4].

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

소스 데이터 내에서 직접적인 정보 상충은 발견되지 않았으나, object_info.json은 정적인 아카이브 파일이 아니라 실행 환경에 따라 내용이 변하는 동적 레지스트리 성격을 가진다는 점이 명확히 기술되어 있다 [1, 4]. 또한, 커스텀 노드 제작 시 INPUT_TYPES() 정의가 부정확하면 이 JSON의 신뢰성도 저하될 수 있음을 시사한다 [3].

🛠️ 적용 사례 (Applied in summary)

RunComfy 플랫폼: 서버리스 API 배포 시 워크플로우 검증 및 UI 구성을 위한 핵심 파일로 사용된다 [1, 5].
데이터 추출 엔드포인트: 실제 서버 환경에서 https://<server_id>-comfyui.runcomfy.com/object_info 경로를 통해 이 데이터를 획득할 수 있도록 구현되어 있다 [4].
comfy_api_simplified MCP 서버: AI 에이전트가 노드 유형을 나열(list_node_types)하거나 특정 노드의 상세 정보(get_node_type_info)를 조회할 때 이 스키마 정보를 기반으로 툴 기능을 제공한다 [6].

✅ 검증 상태 및 신뢰도

상태: 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.0 KiB Raw Blame History