Skip to content

Latest commit

 

History

History
260 lines (183 loc) · 13.4 KB

File metadata and controls

260 lines (183 loc) · 13.4 KB

🌀 GoRi 무선 엔진 - 사용 설명서

만든 사람: GoRi (고리) (khd57788@gmail.com) 라이선스: 무료 사용 - 개인, 단체 및 법인 모두 무료로 사용 가능합니다. "라이선스 및 이용 약관 하단 참조"


필 독 GoRi 엔진은 현재 윈도우 전용입니다.

저는 대한민국의 시골 무지렁이 아저씨입니다. 코드 및 코딩 하나도 모르며, 영어도 전혀 몰라요;; 유튜브 콘텐츠 제작을 위해서 ComfyUI를 사용하던 중 영어와 복잡한 설정 그리고 거미줄 같은 선 때문에 너무 힘들었어요;; 너무 답답하고 힘들어서 선 이라도 없애보자 하고 직접 만들었어요. 제 파트너는 무료 Gemini와 OpenCode 에이전트입니다. (파트너에게 깊은 감사드립니다.) OpenCode에서 무료로 제공하는 Bic pickle, MiniMax M2.5 Free, Nemotron 3 Super Free 모델 엔진을 사용했어요. GoRi 엔진은 베타버전이며 오직 저의 pc 환경에서만 테스트를 해서 오류나 버그가 있을 수 있어요. 사용하시는 분 들의 너그러운 양해 부탁드려요.

PS. 참고로 만드는데 엄청 어려웠어요. ㅜ,.ㅜ;; 혹시 저의 노고에 커피값이라도 지원을 해 주실 분, 저의 GoRi 프로젝트를 지원해 계속 이어가길 바라시는 분은 후원을 해 주세요. (강요는 아니에요...)

-자발적 후원- 해외: PayPal - (khd57788@gmail.com) 국내: 농협 351-0899-4216-13 (이 # 자)


GoRi가 뭔가요?

GoRi는 ComfyUI를 위한 무선 신호 시스템이에요.
노드들을 선으로 연결하는 대신, 각 입력출력채널 이름을 붙여요.
같은 채널 이름을 가진 노드들은 서로 자동으로 통신해요 — 선이 필요 없어요!

마치 무전기랑 똑같아요. 두 사람이 채널 1번에 맞추면, 서로 멀리 떨어져 있어도 대화할 수 있죠.


필 독 GoRi 엔진은 현재 윈도 전용입니다.

💡 설치 팁 (Installation Tip) ComfyUI Manager의 Install via Git URL 방식을 통한 설치를 강력히 권장합니다. 이 방식으로 설치하셔야 향후 컴피 매니저의 'Update' 및 'Update All' 기능을 통해 클릭 한 번으로 편리하게 자동 업데이트를 받으실 수 있습니다!

💡 Installation Tip We highly recommend installing via the Install via Git URL option in ComfyUI Manager. This ensures you can easily get future updates with a single click using the manager's 'Update' or 'Update All' features!

1. 시작하기

-압축을 풀고 ComfyUI-GoRi-Wireless 폴더를 ComfyUI / custom_nodes 폴더에 넣어 주세요. -GoRi 엔진은 ComfyUI 시작과 동시에 당신이 사용하는 모든 노드에 자동으로 GoRi 엔진이 탑재가 돼요. (예외 노드도 있어요.) -ComfyUI 사용을 하다가 Manager에서 새로운 노드를 깔고 새로고침이 되면, 자동으로 GoRi 엔진이 탑재가 돼요.(혹시 안 되면 f5나 Ctrl+f5를 눌러 새로고침 하세요)

1.1 엔진 켜기

"Graph" 버튼 옆에 있는 햄버거 메뉴 버튼 (☰) 을 클릭하세요. 작은 창이 나타나요.
첫 번째 스위치에 "Engine Active" 또는 "Engine Paused" 라고 써 있어요.

  • 초록 불 + "Engine Active" = 엔진이 작동 중이에요.
  • 빨간 불 + "Engine Paused" = 엔진이 쉬고 있어요 (무선 신호가 흐르지 않아요).

스위치를 클릭해서 켜고 끌 수 있어요.

1.2 인덱스 배지 스위치

두 번째 스위치에는 "Index Box Active" / "Index Box Hidden" 이라고 써 있어요.

  • ON: 모든 노드 오른쪽 위에 GR-001, GR-002 같은 꼬리표가 보여요.
  • OFF: 꼬리표가 숨겨져요.

1.3 픽커 크기 조절

햄버거 메뉴 팝업 아래쪽에 "Picker Size" 슬라이더가 있어요.

  • 슬라이더로 채널 선택 드롭박스의 크기를 1.0배 ~ 3.0배로 조절할 수 있어요.
  • 설정은 브라우저에 자동으로 저장돼요.

2. 무선 통신 연결은 어떻게 작동하나요?

2.1 스위치 점 (동그라미)

각 노드의 입력과 출력 옆에는 작은 동그라미가 있어요.

  • 색이 찬 동그라미 = 활성화되었어요 (무선 신호를 보내거나 받고 있어요).
  • 동그라미가 없으면 = 비활성화되었어요 (무선 신호를 안 보내요).

동그라미 사용법:

동작 결과
동그라미를 왼쪽 클릭 무선을 켜거나 꺼요
채널명 텍스트오른쪽 클릭 채널 이름을 바꿔요 (입력창이 뜸)
채널 선택 드롭박스오른쪽 클릭 채널 이름을 바꿔요 (입력창이 뜸)

💡 동그라미(스위치 점) 자체를 우클릭해도 아무 일도 일어나지 않아요.
채널명을 바꾸려면 채널명 텍스트 또는 드롭박스를 우클릭하세요.

2.2 채널 이름

활성화된 동그라미 옆에 채널 이름이 있어요 (예: CH_001, my-channel 등).

원칙은 간단해요:

출력과 입력의 채널 이름이 같으면, 서로 연결된 거예요. 선이 없어도 돼요!

2.3 스코프 (채널 구역)

채널은 스코프(Scope) 라는 공간 안에 있어요.
스코프는 캔버스에서 이름이 GORI로 시작하는 그룹이에요 (예: GORI:BASE, GORI:FX).

  • GORI 그룹 안에 있는 노드들은 같은 그룹 안에 있는 노드들하고만 통신할 수 있어요.
  • GORI 그룹 밖에 있는 노드들은 GLOBAL 스코프를 사용해요. 다른 GLOBAL 노드들이랑만 통신해요.

덕분에 다른 그룹에서는 같은 채널 이름을 다시 써도 돼요. 서로 방해하지 않아요!

2.4 방송 (브로드캐스트)

송신자(출력)의 채널명을 좌클릭하면 채널 선택 드롭박스가 열려요. 드롭박스에서 현재 채널(초록색)을 한 번 더 클릭하면 방송 모드가 시작돼요.

  • 방송 중인 채널이 연결 가능한 수신자(입력)들이 보라색으로 15초간 표시돼요.
  • 15초가 지나면 자동으로 방송이 종료되고 보라색이 사라져요.

수신자가 방송 채널에 연결하기:

  • 수신 노드(입력)에서 픽커를 열면 보라색 채널들이 보여요.
  • 보라색 채널을 클릭하면 무선 연결이 되고, 그 채널은 해당 노드의 모든 픽커에서 사라져요.
  • 다른 노드의 픽커에서는 계속 보라색으로 보여요 (방송 유지).
  • 연결된 채널은 초록색으로 표시되고, 다시 픽커를 열면 채널 목록 맨 위에 초록색으로 나타나요.

💡 노드에 입력 포트가 여러 개 있을 때(예: 이미지1, 이미지2, 이미지3), 하나의 포트가 보라색 채널에 연결되면 같은 노드의 다른 포트 픽커에서도 그 채널이 사라져요. 그래야 중복 연결을 막을 수 있거든요.


2.5 동적 슬롯 노드 지원

TextEncodeQwenImageEditPlus 같은 특수 노드는 슬롯(입력/출력 포트)이 매번 새로 만들어져요. GoRi 엔진은 이런 노드에서도 채널 정보를 노드 자체에 추가로 저장해서, 슬롯이 새로 생겨도 채널 이름과 연결 상태가 사라지지 않고 유지돼요.

🎯 연결 후 픽커를 닫았다 다시 열어도 채널이 초록색으로 잘 표시됩니다!


3. 모든 키보드 단축키

언제? 무엇을 하나요?
Esc 항상 GoRi 팝업 창을 닫아요. 그리고 모든 노드 선택을 해제해요 (파란색 하이라이트가 사라져요).
G 엔진 켜졌을 때 유령 신호 청소. 노드를 선택한 상태면 그 노드들의 GoRi 데이터를 초기화해요. 아무것도 선택 안 했으면 짝이 없는 "유령" 무선 데이터를 제거해요.
S 엔진 켜졌을 때 Scan & Re-index (스캔 & 재정렬). 모든 노드에 새로운 번호를 붙여요 (GR-001, GR-002, …). 위에서 아래로, 왼쪽에서 오른쪽 순서예요. 활성화된 채널들도 같은 순서로 CH_001, CH_002, …로 이름을 바꿔요.
Shift + S 엔진 켜졌을 때 Super Assembler (슈퍼 조립기). 모든 유선 연결무선 연결로 바꾸고, 실제 선을 없애요. (GetNode, SetNode, Everywhere 노드들은 건드리지 않아요.)
Ctrl + B 아무 때나 노드를 우회(bypass) 하면, 그 노드가 보내던 채널을 듣고 있던 입력들을 자동으로 꺼요.
Ctrl + M 아무 때나 위랑 같지만, 음소거(mute) 용이에요.
Alt + 드래그 캔버스에서 다중 복제. 여러 노드를 선택한 상태에서 Alt를 누르고 하나를 드래그하면, 선택된 모든 노드가 함께 복제되어 움직여요!

4. 자동 동작들

4.1 감시 루프 (Guard Loop)

항상 돌고 있는 숨겨진 "파수꾼"이에요. 이 일을 해요:

  • 새 노드 감지 붙여넣기 할 때 새 GoRi 노드를 찾아서 채널 이름이 기존 것과 충돌하지 않도록 고쳐줘요.
  • 꺼진 노드의 수신기 차단 어떤 노드가 비활성화(disabled/paused)되면, 그 노드의 채널을 듣고 있던 입력들도 자동으로 꺼져요. 다시 켜면 입력들도 자동으로 복구돼요.

4.2 복사 / 붙여넣기 처리

노드를 붙여넣을 때:

  • 노드 1개만 붙여넣기: 모든 무선 데이터가 지워져요 (채널은 지워지지 않아요), (완전 새것처럼 시작).
  • 여러 노드를 한꺼번에 붙여넣기: 붙여넣은 블록 안의 모든 채널 이름이 새로운 고유 이름으로 바뀌어서 원래 노드들과 충돌하지 않아요.

4.3 복제 처리

노드를 복제(Ctrl+C / Ctrl+V)하면, GoRi가 채널 이름을 정리하는 동안 복제본의 인덱스 배지와 스위치 점이 일시적으로 숨겨져요.

4.4 똑똑한 연결 (시그널 엔진)

프롬프트를 실행할 때 GoRi가 모든 활성 출력과 입력을 살펴봐요:

  1. 모든 송신자(채널 이름이 있는 출력)를 모아요.
  2. 만약 두 개 이상의 송신자가 같은 채널을 쓰면, 그 채널은 아무도 못 받아요 (안전 장치예요).
  3. 각 활성 입력에 대해, 스코프 + 채널이 맞는 송신자를 찾아요.
  4. 똑똑한 타입 매칭: 가능하면 데이터 타입이 같은 출력을 연결해줘요 (IMAGE → IMAGE, MODEL → MODEL 등).

5. 저장되는 설정

브라우저에 자동으로 저장돼요 (localStorage):

  • 엔진 켜짐/꺼짐 상태
  • 인덱스 배지 켜짐/꺼짐 상태
  • 픽커 크기 (1.0x ~ 3.0x)
  • 팝업 창 크기와 위치

6. 설정 (고급)

6.1 제외된 노드들

이 노드들은 GoRi 기능이 차단돼요:

  • GetNode, SetNode
  • Reroute, ReroutePrimitive
  • 이름에 "Everywhere"가 들어간 모든 노드 (Anything Everywhere, Seed Everywhere 등)
  • 고리 엔진이 탑재가 안된 노드는 무선 연결이 불가능해요.

이 노드들은 계속 원래 유선 연결을 사용해요.


7. 시각 요소들

인덱스 배지

각 노드 오른쪽 위에 있는 작은 꼬리표: GR-001. 노드의 순서 번호를 보여줘요.

스위치 점

모든 작은 동그라미. 색이 차 있음 = 활성, 동그라미 없음 = 비활성.

채널 라벨

각 동그라미 옆에 이탤릭체로 표시된 채널 이름.

베지어 곡선 (무선 신호선)

-연결의 흐름을 직관적으로 볼 때는 보고싶은 노드에 마우스를 올려 보세요. -노드를 클릭하면, 같은 채널을 쓰는 다른 노드들 사이에 곡선이 나타나요. 이것은 노드 선택 해제를 하기 전까지 사라지지 않아요, 보이지 않는 무선 연결을 눈으로 보여주는 거예요!

색상 구분

각 데이터 타입마다 색깔이 달라요:

  • MODEL = 보라색
  • CLIP = 노란색
  • VAE = 빨간색
  • IMAGE = 초록색
  • LATENT = 주황색
  • CONDITIONING = 금색
  • MASK = 파란색
  • CONTROL_NET = 청록색

8. 꿀팁

  • 스코프(GORI: 그룹)를 사용해서 워크플로의 다른 부분을 나눠보세요.
  • 새 노드를 추가한 후 S를 누르면 깔끔하게 재정리돼요.
  • Shift+S를 한 번 누르면 모든 선을 무선으로 바꿔줘요. 그 다음부터는 선이 필요 없어요!
  • 뭔가 이상하게 작동하면 G를 눌러서 유령 신호를 청소해보세요.

[라이선스 및 이용 약관]

/* * =============================================================

  • 프로젝트: GoRi Switch Engine v1.0
  • 개발자: GoRi (고리)
  • 버전: 1.0 (빌드 2026.05.18)
    • [라이선스 및 이용 약관]
    1. 무료 사용: 개인, 단체 및 법인 모두 무료로 사용 가능합니다.
    1. 재배포 금지: 본 엔진을 다른 플랫폼에 무단 복제하거나
  • 재배포하는 행위를 엄격히 금지합니다.
    1. 표절 및 도용 금지: 소스 코드를 탈취하거나 엔진의 이름을 바꿔서
  • 배포하는 모든 시도를 엄격히 금지합니다.
    1. 출처 표기: 워크플로우 공유 시 "Powered by GoRi Engine"이라는
  • 문구를 포함할 것을 권장합니다.
    • [법적 고지]
  • 본 소프트웨어는 GoRi에 의해 개발되었습니다. 무단 복제, 수정 및
  • 특히 상업적 패키징/판매는 지적 재산권 법에 따라 법적 조치의
  • 대상이 될 수 있습니다.
  • (보안: 'GoRi-2026.04.15 k' 워터마크가 소스 내에 숨겨져 있음)
  • ============================================================= */