docs(interface): add an Autogrow Inputs page to the Interface Guide

docs.json

@@ -135,6 +135,7 @@
                   "interface/features/subgraph",
                   "interface/features/partial-execution",
                   "interface/features/node-docs",
+                  "interface/features/autogrow-inputs",
                   {
                     "group": "ComfyUI Settings",
                     "icon": "gear",
@@ -3988,6 +3989,7 @@
                   "zh/interface/features/subgraph",
                   "zh/interface/features/partial-execution",
                   "zh/interface/features/node-docs",
+                  "zh/interface/features/autogrow-inputs",
                   {
                     "group": "ComfyUI 设置",
                     "icon": "gear",
@@ -7860,6 +7862,7 @@
                   "ja/interface/features/subgraph",
                   "ja/interface/features/partial-execution",
                   "ja/interface/features/node-docs",
+                  "ja/interface/features/autogrow-inputs",
                   {
                     "group": "ComfyUI Settings",
                     "icon": "gear",
@@ -11745,6 +11748,7 @@
                   "ko/interface/features/subgraph",
                   "ko/interface/features/partial-execution",
                   "ko/interface/features/node-docs",
+                  "ko/interface/features/autogrow-inputs",
                   {
                     "group": "ComfyUI 설정",
                     "icon": "gear",

interface/features/autogrow-inputs.mdx

@@ -0,0 +1,43 @@
+---
+title: "Autogrow Inputs - Dynamic Node Inputs in ComfyUI"
+description: "Autogrow inputs add a new slot to a node when you fill the last one, so a single node can take as many images, masks or latents as you need."
+sidebarTitle: "Autogrow Inputs"
+icon: "plus"
+---
+
+![Batch Images node with one image connected and one free input below it](/images/interface/features/autogrow/autogrow-1.png)
+
+Some nodes in ComfyUI have **autogrow inputs**, also called **dynamic inputs**. These nodes do not show a fixed list of slots. They add another input as soon as you connect the last free one, so a single node can batch two images or twenty without any extra setup.
+
+## How autogrow inputs work
+
+1. **Connect the last free input.** In the example on this page, an image source is linked to `image0` on the **Batch Images** node, while `image1` is still free.
+2. **Watch the node grow.** As soon as you fill the last free input, the node appends a new empty input below it. In the picture below, the new `image2` input appears after `image1` is connected.
+3. **Repeat as needed.** Every time you fill the last input, the node grows again, until it reaches the maximum number of inputs that node allows.
+
+![Batch Images node with two connected inputs and a newly added free input highlighted](/images/interface/features/autogrow/autogrow-2.png)
+
+Two more details worth knowing:
+
+- **Order matters.** The inputs are passed to the node in the order they appear, so `image0` comes before `image1` and so on. Keep that in mind when the result depends on the sequence, for example when you batch images that run through a video model.
+- **The free input is a placeholder.** It is only part of the node's data once you connect something to it. A node that allows zero inputs still runs when every slot is empty.
+
+## Nodes that use autogrow inputs
+
+| Node | Input that grows | Maximum inputs |
+|---|---|---|
+| **Batch Images** | `image` | 50 |
+| **Batch Masks** | `mask` | 50 |
+| **Batch Latents** | `latent` | 50 |
+| **And** / **Or** | `value` | 10 |
+| **Nano Banana 2** and other partner nodes that take reference images | `image_1`, `image_2`, and so on | up to 14 images |
+
+Each node decides its own limits. Hover the input in ComfyUI to read its tooltip when you are not sure how many values it accepts.
+
+<Tip>
+Autogrow is part of the ComfyUI V3 node schema. If you write custom nodes, see [Dynamic Inputs](/custom-nodes/v3_migration#dynamic-inputs) for the `Autogrow` template API.
+</Tip>
+
+<Card title="Batch Images node" icon="book-open" href="/built-in-nodes/BatchImagesNode">
+  Combine several images into one batch, with as many inputs as you need.
+</Card>

ja/interface/features/autogrow-inputs.mdx

@@ -0,0 +1,45 @@
+---
+title: "自動拡張入力 - ComfyUI の動的ノード入力"
+description: "自動拡張入力（動的入力）は、最後の入力を接続すると新しいスロットを自動で追加します。1 つのノードで必要なだけ画像やマスク、Latent をまとめられます。"
+sidebarTitle: "自動拡張入力"
+icon: "plus"
+translationSourceHash: 2b0c8011
+translationFrom: interface/features/autogrow-inputs.mdx
+---
+
+![画像を 1 つ接続し、下に空き入力が 1 つある Batch Images ノード](/images/interface/features/autogrow/autogrow-1.png)
+
+ComfyUI には**自動拡張入力**（autogrow inputs、動的入力とも呼ばれます）を持つノードがあります。こうしたノードは入力スロットを固定で表示しません。最後の空き入力を接続すると、次の入力が自動的に追加されます。そのため 1 つのノードで、2 枚でも 20 枚でも画像をまとめて扱えます。
+
+## 自動拡張入力の仕組み
+
+1. **最後の空き入力を接続する。** このページの例では、**Batch Images** ノードの `image0` に画像を接続し、`image1` は空きのままです。
+2. **ノードが自動で伸びる。** 最後の空き入力を埋めると、その下に新しい空の入力が追加されます。下の図では `image1` を接続したあとに `image2` が現れています。
+3. **必要なだけ繰り返す。** 最後の入力を埋めるたびにノードは再び伸び、そのノードが許可する最大入力数まで増えていきます。
+
+![2 つの入力を接続し、新しく追加された空き入力がハイライトされた Batch Images ノード](/images/interface/features/autogrow/autogrow-2.png)
+
+知っておくと役立つ点が 2 つあります。
+
+- **順序に意味があります。** 入力は表示されている順にノードへ渡されるため、`image0` が `image1` より先になります。順番が結果に影響する場合（例: 動画モデルにまとめて渡す画像）は注意してください。
+- **空き入力はプレースホルダーです。** 何か接続して初めてノードのデータの一部になります。0 個の入力も許可するノードは、すべてのスロットが空でも実行できます。
+
+## 自動拡張入力を使うノード
+
+| ノード | 伸びる入力 | 最大入力数 |
+|---|---|---|
+| **Batch Images** | `image` | 50 |
+| **Batch Masks** | `mask` | 50 |
+| **Batch Latents** | `latent` | 50 |
+| **And** / **Or** | `value` | 10 |
+| **Nano Banana 2** など参照画像を取るパートナーノード | `image_1`、`image_2` など | 最大 14 枚 |
+
+上限はノードごとに決まっています。いくつ受け取れるか分からないときは、ComfyUI 上で入力にマウスを重ねてツールチップを確認してください。
+
+<Tip>
+自動拡張は ComfyUI の V3 ノードスキーマの一部です。カスタムノードを書く場合は、[動的入力](/ja/custom-nodes/v3_migration#動的入力)の `Autogrow` テンプレート API を参照してください。
+</Tip>
+
+<Card title="Batch Images ノード" icon="book-open" href="/ja/built-in-nodes/BatchImagesNode">
+  複数の画像を 1 つのバッチにまとめます。入力は必要なだけ追加できます。
+</Card>

ko/interface/features/autogrow-inputs.mdx

@@ -0,0 +1,45 @@
+---
+title: "자동 확장 입력 - ComfyUI의 동적 노드 입력"
+description: "자동 확장 입력(동적 입력)은 마지막 입력을 연결하면 슬롯을 자동으로 추가합니다. 노드 하나로 필요한 만큼 이미지, 마스크, Latent를 모을 수 있습니다."
+sidebarTitle: "자동 확장 입력"
+icon: "plus"
+translationSourceHash: 2b0c8011
+translationFrom: interface/features/autogrow-inputs.mdx
+---
+
+![이미지 하나를 연결하고 아래에 빈 입력이 하나 있는 Batch Images 노드](/images/interface/features/autogrow/autogrow-1.png)
+
+ComfyUI에는 **자동 확장 입력**(autogrow inputs, 동적 입력)을 가진 노드가 있습니다. 이런 노드는 입력 슬롯을 고정으로 보여주지 않습니다. 마지막 빈 입력을 연결하면 다음 입력이 자동으로 추가됩니다. 그래서 노드 하나로 이미지 두 장이든 스무 장이든 묶어서 처리할 수 있습니다.
+
+## 자동 확장 입력의 동작 방식
+
+1. **마지막 빈 입력을 연결합니다.** 이 페이지의 예시에서는 **Batch Images** 노드의 `image0`에 이미지를 연결했고, `image1`은 비어 있습니다.
+2. **노드가 늘어납니다.** 마지막 빈 입력을 채우면 그 아래에 새 빈 입력이 추가됩니다. 아래 그림에서는 `image1`을 연결한 뒤 `image2`가 나타났습니다.
+3. **필요한 만큼 반복합니다.** 마지막 입력을 채울 때마다 노드가 다시 늘어나며, 해당 노드가 허용하는 최대 입력 수까지 증가합니다.
+
+![입력 두 개를 연결하고 새로 추가된 빈 입력이 강조된 Batch Images 노드](/images/interface/features/autogrow/autogrow-2.png)
+
+알아두면 좋은 두 가지가 있습니다.
+
+- **순서가 중요합니다.** 입력은 화면에 보이는 순서대로 노드에 전달되므로 `image0`이 `image1`보다 먼저 옵니다. 순서가 결과에 영향을 주는 경우(예: 이미지를 한꺼번에 동영상 모델로 보낼 때)에는 특히 주의하세요.
+- **빈 입력은 자리 표시자입니다.** 무언가 연결해야 노드 데이터의 일부가 됩니다. 입력 0개를 허용하는 노드는 모든 슬롯이 비어 있어도 실행됩니다.
+
+## 자동 확장 입력을 사용하는 노드
+
+| 노드 | 늘어나는 입력 | 최대 입력 수 |
+|---|---|---|
+| **Batch Images** | `image` | 50 |
+| **Batch Masks** | `mask` | 50 |
+| **Batch Latents** | `latent` | 50 |
+| **And** / **Or** | `value` | 10 |
+| **Nano Banana 2** 등 참조 이미지를 받는 파트너 노드 | `image_1`, `image_2` 등 | 최대 14장 |
+
+상한은 노드마다 다릅니다. 몇 개까지 받는지 확실하지 않다면 ComfyUI에서 입력 위에 마우스를 올려 툴팁을 확인하세요.
+
+<Tip>
+자동 확장은 ComfyUI V3 노드 스키마의 일부입니다. 커스텀 노드를 만든다면 [동적 입력](/ko/custom-nodes/v3_migration#동적-입력)의 `Autogrow` 템플릿 API를 참고하세요.
+</Tip>
+
+<Card title="Batch Images 노드" icon="book-open" href="/ko/built-in-nodes/BatchImagesNode">
+  여러 이미지를 하나의 배치로 묶습니다. 입력은 필요한 만큼 추가할 수 있습니다.
+</Card>

zh/interface/features/autogrow-inputs.mdx

@@ -0,0 +1,45 @@
+---
+title: "自动增长输入 - ComfyUI 的动态节点输入"
+description: "自动增长输入（动态输入）会在你连上最后一个输入后自动新增一个插槽，让一个节点就能接收任意数量的图像、蒙版或潜空间。"
+sidebarTitle: "自动增长输入"
+icon: "plus"
+translationSourceHash: 2b0c8011
+translationFrom: interface/features/autogrow-inputs.mdx
+---
+
+![Batch Images 节点已连接一张图像，下方还有一个空闲输入](/images/interface/features/autogrow/autogrow-1.png)
+
+ComfyUI 中有些节点带有**自动增长输入**（autogrow inputs），也叫**动态输入**。这类节点不会固定显示一组输入插槽：当你把最后一个空闲输入连上之后，它会自动再增加一个输入，所以一个节点就能批处理两张或二十张图像，不需要额外设置。
+
+## 自动增长输入的工作方式
+
+1. **连上最后一个空闲输入。** 以本页的 **Batch Images** 节点为例，把图像连到 `image0`，此时 `image1` 仍为空闲状态。
+2. **节点随之增长。** 一旦最后一个空闲输入被连上，节点就会在下方自动新增一个空输入。下图里 `image1` 连上后，新的 `image2` 输入出现了。
+3. **按需重复。** 每当最后一个输入被占满，节点就会继续增长，直到达到该节点允许的最大输入数。
+
+![Batch Images 节点已连接两个输入，并高亮显示新出现的空闲输入](/images/interface/features/autogrow/autogrow-2.png)
+
+还有两点需要注意：
+
+- **顺序有意义。** 输入会按显示顺序传给节点，`image0` 排在 `image1` 之前，依此类推。当结果与顺序有关时（例如这些图像要一起送进视频模型）要特别留意。
+- **空闲输入只是占位。** 只有真正连上内容后，它才属于节点数据的一部分；允许 0 个输入的节点即使所有插槽都空着也能运行。
+
+## 使用自动增长输入的节点
+
+| 节点 | 会增长的输入 | 最大输入数 |
+|---|---|---|
+| **Batch Images** | `image` | 50 |
+| **Batch Masks** | `mask` | 50 |
+| **Batch Latents** | `latent` | 50 |
+| **And** / **Or** | `value` | 10 |
+| **Nano Banana 2** 等需要参考图的合作节点 | `image_1`、`image_2` 等 | 最多 14 张图 |
+
+每个节点自己决定上限。不确定某个输入能接多少值时，在 ComfyUI 里把鼠标悬停在输入上查看提示。
+
+<Tip>
+自动增长属于 ComfyUI V3 节点 schema。如果你在编写自定义节点，请参考[动态输入](/zh/custom-nodes/v3_migration#动态输入)中的 `Autogrow` 模板 API。
+</Tip>
+
+<Card title="Batch Images 节点" icon="book-open" href="/zh/built-in-nodes/BatchImagesNode">
+  把多张图像合并成一个批次，输入数量按需增加。
+</Card>