> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# LoopProgress - ComfyUI Built-in Node Documentation

> LoopProgress는 루프의 진행 상황을 ComfyUI 서버 인터페이스에 보고하는 개발 전용 보조 노드입니다. 각 실행 시 "Iteration X / Y" 텍스트를 클라이언트로 전송하고 현재 반복 위치를 변경 없이 반환하므로, 데이터 흐름을 변경하지 않고 루프 내부에 인라인으로 배치할 수 있습니다.

LoopProgress는 루프의 진행 상황을 ComfyUI 서버 인터페이스에 보고하는 개발 전용 보조 노드입니다. 각 실행 시 "Iteration X / Y" 텍스트를 클라이언트로 전송하고 현재 반복 위치를 변경 없이 반환하므로, 데이터 흐름을 변경하지 않고 루프 내부에 인라인으로 배치할 수 있습니다.

## 입력

| 매개변수       | 설명                                                                                      | 데이터 타입 | 필수 | 범위 |
| ---------- | --------------------------------------------------------------------------------------- | ------ | -- | -- |
| `start_id` | 진행 메시지가 속한 프롬프트/루프 인스턴스의 식별자입니다. 제공된 목록의 첫 번째 항목은 진행 텍스트를 올바른 실행 중인 실행으로 라우팅하는 데 사용됩니다. | STRING | 예  | -  |
| `position` | 현재 반복 위치(인덱스)입니다. 제공된 목록의 첫 번째 항목은 진행 메시지에 사용되며 출력으로도 반환됩니다.                            | INT    | 예  | -  |
| `total`    | 전체 반복 횟수입니다. `position`과 함께 사용되어 "Iteration X / Y" 진행 메시지를 구성합니다.                       | INT    | 예  | -  |

참고: 이 노드는 목록 입력(`is_input_list=True`)으로 선언되어 모든 입력을 허용하므로, 연결된 각 값은 목록으로 처리되며 첫 번째 요소만 읽습니다. 이 노드는 항상 실행되며(입력 지문이 고정됨), 따라서 루프를 통과할 때마다 다시 실행됩니다.

## 출력

| 출력 이름      | 설명                                     | 데이터 타입 |
| ---------- | -------------------------------------- | ------ |
| `position` | `position` 입력에서 변경 없이 전달된 현재 반복 위치입니다. | INT    |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoopProgress/ko.md)

***

**Source fingerprint (SHA-256):** `505ba814b93533679516b4f4239f5eee0dbac125d7ea16746c6cdbb7a68f803d`