c24165b8bc
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게 [공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류. 문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인). - Topic_Programming → Domain_Programming (내부 구조 보존) - Topic_Graphic → Domain_Design - Topic_Business → Domain_Product - Topic_General → Domain_General - _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning), Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing) - 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서) - 빈 폴더 정리 (memory/procedures) - 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3.9 KiB
3.9 KiB
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
| 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 | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| server-overview---comfyui | Server Overview - ComfyUI | 10_Wiki/Topics | draft | conceptual | B | 0.8 | 2026-05-20 | 2026-05-20 |
|
|
Server Overview - ComfyUI
🎯 한 줄 통찰 (One-line insight)
ComfyUI 서버는 aiohttp와 asyncio를 기반으로 하며, 클라이언트와 서버 간의 메시지 송수신 및 http 라우트를 통해 워크플로우 데이터를 처리하는 구조를 가집니다.
🧠 핵심 개념 (Core concepts)
- 서버 프레임워크: aiohttp 및 asyncio 기반의 구동 환경.
- 메시지 통신 (Server to Client):
PromptServer인스턴스의send_sync메서드를 통한 소켓 메시지 전달. - 통신 경로 (Client to Server):
api.fetchApi()메서드를 통한 http 라우트 처리. - 데이터 일관성: 큐(Queue) 요청 시 전체 워크플로우(위젯 값 포함)를 제출하며, 요청 이후의 변경 사항은 서버에 반영되지 않음.
🧩 추출된 패턴 (Extracted patterns)
- 양방향 통신 구조: 서버에서 클라이언트로의 소켓 메시지 전송과 클라이언트에서 서버로의 HTTP 요청 처리가 분리되어 존재함.
- 상태 고정성: 클라이언트가 큐에 요청을 제출하는 시점에 워크플로우 데이터가 결정되며, 실행 중 발생하는 수정 사항은 서버에 영향을 미치지 않는 구조적 특성을 보임.
📖 세부 내용 (Details)
ComfyUI 서버 통신 메커니즘
- 서버 구동 환경: Comfy 서버는 aiohttp 프레임워크 위에서 실행되며, 이는 asyncio를 사용합니다.
- 메시지 전달 (Messages):
- Server
\rightarrowClient:server.py에 정의된PromptServer인스턴스의send_sync메서드를 통해 소켓 메시지 형태로 전송됩니다. 이 메시지는api.js에 등록된 소켓 이벤트 리스너에 의해 처리됩니다. - Client
\rightarrowServer:api.js에 정의된api.fetchApi()메서드를 통해 전송되며, 서버에 정의된 http 라우트에 의해 처리됩니다.
- Server
- 워크플로우 제출 및 실행:
- 사용자가 요청을 큐(Queue)에 추가할 때 위젯 값을 포함한 전체 워크플로우를 제출합니다.
- 서버는 큐에 요청을 보낸 이후에 발생하는 변경 사항을 수신하지 않습니다.
- 실행 중 서버의 동작을 수정하려면 별도의 라우트(Routes)가 필요합니다.
Documentation Index 정보
- 전체 문서 인덱스는 다음 경로에서 확인할 수 있습니다:
https://docs.comfy.org/llms.txt
⚖️ 모ikan 및 업데이트 (Contradictions & updates)
본문에서 확인되지 않음.
🛠️ 적용 사례 (Applied in summary)
본문에서 확인되지 않음.
✅ 검증 상태 및 신뢰도
- 상태: draft
- 검증 단계: conceptual
- 출처 신뢰도: B (Primary Source — 웹사이트 본문 직접 추출)
- 중복 검사 결과: 신규 생성 (New discovery)
🔗 관련 문서 링크 (Related document links)
- ComfyUI Server - 서버의 전반적인 구조와 역할을 설명합니다.
- aiohttp - 서버가 구동되는 기반 프레임워크입니다.
- asyncio - 비동기 처리를 위한 핵심 기술 스택입니다.
- PromptServer - 서버 메시지 전송을 담당하는 클래스입니다.
- api.js - 클라이언트 측 통신 로직이 구현된 파일입니다.
📝 변경 이력 (Change history)
- 2026-05-20: Astra /wikify 로 https://docs.comfy.org/development/comfyui-server/comms_overview 본문에서 초안 생성.