Comfy-Org · lin-bot23 · Aug 27, 2026
diff --git a/comfyui_embedded_docs/docs/APG/en.md b/comfyui_embedded_docs/docs/APG/en.md
@@ -11,6 +11,8 @@ The APG (Adaptive Projected Guidance) node modifies the sampling process by adju
 | `norm_threshold` | Normalize guidance vector to this value, normalization disabled at a setting of 0 (default: 5.0). | FLOAT | Yes | 0.0 to 50.0 |
 | `momentum` | Controls a running average of guidance during diffusion, disabled at a setting of 0 (default: 0.0). | FLOAT | Yes | -5.0 to 1.0 |
 
+Note: When the noise level (`sigma`) increases during sampling, the momentum running average resets to zero. If the model provides only a single conditioning output (no separate unconditional conditioning), the guidance adjustment is skipped and the conditioning is left unchanged.
+
 ## Outputs
 
 | Output Name | Description | Data Type |
@@ -20,4 +22,4 @@ The APG (Adaptive Projected Guidance) node modifies the sampling process by adju
 > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/en.md)
 
 ---
-**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
+**Source fingerprint (SHA-256):** `df0c76aee28479d49c4e471e54d1d32082adc6921a6a50b506675144a79e018a`
diff --git a/comfyui_embedded_docs/docs/ARVideoI2V/en.md b/comfyui_embedded_docs/docs/ARVideoI2V/en.md
@@ -2,28 +2,30 @@
 
 ## Overview
 
-This node prepares an image-to-video generation setup for AR (Auto-Regressive) video models. It takes a starting image, encodes it into the latent space using a VAE, and stores the encoded image in the model's configuration. This allows the video sampling process to use the image as the first frame, effectively seeding the generation without needing a separate image-to-video model architecture.
+This node prepares an image-to-video generation setup for AR (Auto-Regressive) video models that use Causal Forcing or Self-Forcing. It encodes a starting image into latent space with a VAE and stores it in the model's transformer options, so the video sampling process can seed the KV cache before denoising. It uses the same text-to-video model checkpoint, so no separate image-to-video architecture is needed.
 
 ## Inputs
 
 | Parameter | Description | Data Type | Required | Range |
 | --- | --- | --- | --- | --- |
 | `model` | The AR video model to be used for generation. | MODEL | Yes | - |
 | `vae` | The VAE model used to encode the starting image into latent space. | VAE | Yes | - |
-| `start_image` | The initial image that will serve as the first frame of the generated video. | IMAGE | Yes | - |
+| `start_image` | The initial image that will serve as the first frame of the generated video. Only the first image in the input batch is used, and only its RGB channels are encoded. | IMAGE | Yes | - |
 | `width` | The width of the generated video frames (default: 832). | INT | Yes | 16 to 8192 (step: 16) |
 | `height` | The height of the generated video frames (default: 480). | INT | Yes | 16 to 8192 (step: 16) |
 | `length` | The total number of frames in the generated video (default: 81). | INT | Yes | 1 to 1024 (step: 4) |
 | `batch_size` | The number of video sequences to generate in a single batch (default: 1). | INT | Yes | 1 to 64 |
 
+Note: The start image is resized to the specified `width` and `height` before being encoded. The latent temporal dimension is calculated as `((length - 1) // 4) + 1`, and the latent spatial dimensions are `height / 8` and `width / 8`.
+
 ## Outputs
 
 | Output Name | Description | Data Type |
 | --- | --- | --- |
-| `MODEL` | The cloned model with the encoded start image stored in its configuration for video generation. | MODEL |
-| `LATENT` | An empty latent tensor with the correct dimensions for the video generation process. | LATENT |
+| `MODEL` | The cloned model with the encoded start image stored in its transformer options (`ar_config.initial_latent`), which the sampler uses to seed the KV cache before denoising. | MODEL |
+| `LATENT` | A zero-filled latent tensor with shape `[batch_size, 16, lat_t, height // 8, width // 8]`, where `lat_t = ((length - 1) // 4) + 1`. | LATENT |
 
 > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ARVideoI2V/en.md)
 
 ---
-**Source fingerprint (SHA-256):** `0445b279ba49fa946050cfa70d1e6b13240eaa600b99dfe63f27c3203dc4b61b`
+**Source fingerprint (SHA-256):** `984834951b9d5a22aef51c85a5019fd8ba58cdb2d6fff235371ed29f316896d8`
diff --git a/comfyui_embedded_docs/docs/AddLayer/ar.md b/comfyui_embedded_docs/docs/AddLayer/ar.md
@@ -6,20 +6,20 @@
 
 | المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
 |-----------|-------------|-----------|----------|-------|
-| `layers` | مكدس الطبقات المطلوب الإلحاق به. اتركه غير موصول لبدء مكدس جديد. | LAYERS | لا | — |
-| `image` | محتوى الطبقة بحجمه الأصلي. الدفعة تتوسع إلى طبقات متتالية. | IMAGE | نعم | — |
-| `mask` | قناع الشفافية لهذه الطبقة. المناطق المُقنَّعة (القيمة 1) تصبح شفافة، وتُضرب مع أي قناة ألفا تحملها الصورة بالفعل. | MASK | لا | — |
-| `name` | اسم الطبقة المعروض في محرر التركيب. (الافتراضي: "") | STRING | لا | — |
-| `x` | الموضع الأفقي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
-| `y` | الموضع الرأسي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
-| `opacity` | الشفافية الأولية للطبقة. (الافتراضي: 1.0) | FLOAT | لا | من 0.0 إلى 1.0 (الخطوة: 0.01) |
-| `blend_mode` | وضع المزج الأولي، ويُطبَّق على الطبقات السفلية. على الطبقة السفلية فوق الخلفية الشفافة الافتراضية، تُنتج الأوضاع غير الوضع العادي شفافية. (الافتراضي: "normal") | COMBO | لا | خيارات متعددة متاحة |
-| `rotation` | الدوران الأولي بالدرجات، في اتجاه عقارب الساعة. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 1.0) |
-| `width` | العرض الأولي للطبقة. القيمة 0 تُبقي العرض الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
-| `height` | الارتفاع الأولي للطبقة. القيمة 0 تُبقي الارتفاع الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
-| `z_index` | تجاوز ترتيب التراص. تُفرز الطبقات فرزًا مستقرًا حسب z_index؛ والقيم المتساوية تحتفظ بترتيبها في القائمة. (الافتراضي: 0) | INT | لا | من -1000 إلى 1000 |
-| `flip_h` | قلب الطبقة أفقيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
-| `flip_v` | قلب الطبقة رأسيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
+| `طبقات` | مكدس الطبقات المطلوب الإلحاق به. اتركه غير موصول لبدء مكدس جديد. | LAYERS | لا | — |
+| `صورة` | محتوى الطبقة بحجمه الأصلي. الدفعة تتوسع إلى طبقات متتالية. | IMAGE | نعم | — |
+| `قناع` | قناع الشفافية لهذه الطبقة. المناطق المُقنَّعة (القيمة 1) تصبح شفافة، وتُضرب مع أي قناة ألفا تحملها الصورة بالفعل. | MASK | لا | — |
+| `الاسم` | اسم الطبقة المعروض في محرر التركيب. (الافتراضي: "") | STRING | لا | — |
+| `س` | الموضع الأفقي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
+| `ص` | الموضع الرأسي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
+| `الشفافية` | الشفافية الأولية للطبقة. (الافتراضي: 1.0) | FLOAT | لا | من 0.0 إلى 1.0 (الخطوة: 0.01) |
+| `وضع الدمج` | وضع المزج الأولي، ويُطبَّق على الطبقات السفلية. على الطبقة السفلية فوق الخلفية الشفافة الافتراضية، تُنتج الأوضاع غير الوضع العادي شفافية. (الافتراضي: "normal") | COMBO | لا | خيارات متعددة متاحة |
+| `الدوران` | الدوران الأولي بالدرجات، في اتجاه عقارب الساعة. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 1.0) |
+| `العرض` | العرض الأولي للطبقة. القيمة 0 تُبقي العرض الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
+| `الارتفاع` | الارتفاع الأولي للطبقة. القيمة 0 تُبقي الارتفاع الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
+| `مؤشر التكديس` | تجاوز ترتيب التراص. تُفرز الطبقات فرزًا مستقرًا حسب z_index؛ والقيم المتساوية تحتفظ بترتيبها في القائمة. (الافتراضي: 0) | INT | لا | من -1000 إلى 1000 |
+| `عكس أفقي` | قلب الطبقة أفقيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
+| `عكس رأسي` | قلب الطبقة رأسيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
 
 ملاحظات:
 - فقط `image` مطلوب؛ جميع المدخلات الأخرى اختيارية.

diff --git a/comfyui_embedded_docs/docs/AddLayer/es.md b/comfyui_embedded_docs/docs/AddLayer/es.md
@@ -6,20 +6,20 @@ El nodo Add Layer convierte una imagen de entrada en una capa y la coloca en un
 
 | Parámetro | Descripción | Tipo de dato | Requerido | Rango |
 |-----------|-------------|--------------|-----------|-------|
-| `layers` | Pila de capas a la que se añadirá. Si se deja sin conectar, se inicia una nueva pila. | LAYERS | No | — |
-| `image` | Contenido de la capa en su tamaño nativo. Un lote se expande a capas consecutivas. | IMAGE | Sí | — |
-| `mask` | Máscara de transparencia para esta capa. Las áreas enmascaradas (valor 1) se vuelven transparentes, multiplicándose con cualquier canal alfa que la imagen ya contenga. | MASK | No | — |
-| `name` | Nombre de la capa mostrado en el editor del compositor. (predeterminado: "") | STRING | No | — |
+| `capas` | Pila de capas a la que se añadirá. Si se deja sin conectar, se inicia una nueva pila. | LAYERS | No | — |
+| `imagen` | Contenido de la capa en su tamaño nativo. Un lote se expande a capas consecutivas. | IMAGE | Sí | — |
+| `máscara` | Máscara de transparencia para esta capa. Las áreas enmascaradas (valor 1) se vuelven transparentes, multiplicándose con cualquier canal alfa que la imagen ya contenga. | MASK | No | — |
+| `nombre` | Nombre de la capa mostrado en el editor del compositor. (predeterminado: "") | STRING | No | — |
 | `x` | Posición horizontal inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION |
 | `y` | Posición vertical inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION |
-| `opacity` | Opacidad inicial de la capa. (predeterminado: 1.0) | FLOAT | No | 0.0 a 1.0 (paso 0.01) |
-| `blend_mode` | Modo de fusión inicial, aplicado contra las capas inferiores. En la capa inferior sobre el fondo transparente predeterminado, los modos no normales producen transparencia. (predeterminado: "normal") | COMBO | No | Múltiples opciones disponibles |
-| `rotation` | Rotación inicial en grados, en sentido horario. (predeterminado: 0.0) | FLOAT | No | -360.0 a 360.0 (paso 1.0) |
-| `width` | Ancho de visualización inicial. 0 conserva el ancho nativo de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
-| `height` | Altura de visualización inicial. 0 conserva la altura nativa de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
-| `z_index` | Anulación del orden de apilamiento. Las capas se ordenan de forma estable por z_index; los valores iguales mantienen su orden en la lista. (predeterminado: 0) | INT | No | -1000 a 1000 |
-| `flip_h` | Voltear la capa horizontalmente. (predeterminado: False) | BOOLEAN | No | false / true |
-| `flip_v` | Voltear la capa verticalmente. (predeterminado: False) | BOOLEAN | No | false / true |
+| `opacidad` | Opacidad inicial de la capa. (predeterminado: 1.0) | FLOAT | No | 0.0 a 1.0 (paso 0.01) |
+| `modo de fusión` | Modo de fusión inicial, aplicado contra las capas inferiores. En la capa inferior sobre el fondo transparente predeterminado, los modos no normales producen transparencia. (predeterminado: "normal") | COMBO | No | Múltiples opciones disponibles |
+| `rotación` | Rotación inicial en grados, en sentido horario. (predeterminado: 0.0) | FLOAT | No | -360.0 a 360.0 (paso 1.0) |
+| `ancho` | Ancho de visualización inicial. 0 conserva el ancho nativo de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
+| `alto` | Altura de visualización inicial. 0 conserva la altura nativa de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
+| `índice z` | Anulación del orden de apilamiento. Las capas se ordenan de forma estable por z_index; los valores iguales mantienen su orden en la lista. (predeterminado: 0) | INT | No | -1000 a 1000 |
+| `voltear_h` | Voltear la capa horizontalmente. (predeterminado: False) | BOOLEAN | No | false / true |
+| `voltear_v` | Voltear la capa verticalmente. (predeterminado: False) | BOOLEAN | No | false / true |
 
 Notas:
 - Solo se requiere `image`; todos los demás parámetros son opcionales.

diff --git a/comfyui_embedded_docs/docs/AddLayer/fa.md b/comfyui_embedded_docs/docs/AddLayer/fa.md
@@ -6,20 +6,20 @@
 
 | پارامتر | توضیحات | نوع داده | الزامی | محدوده |
 |-----------|-------------|-----------|----------|-------|
-| `layers` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — |
-| `image` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — |
-| `mask` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — |
-| `name` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — |
+| `لایه‌ها` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — |
+| `تصویر` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — |
+| `ماسک` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — |
+| `نام` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — |
 | `x` | موقعیت افقی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
 | `y` | موقعیت عمودی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
-| `opacity` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) |
-| `blend_mode` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است |
-| `rotation` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) |
-| `width` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
-| `height` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
+| `شفافیت` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) |
+| `حالت ترکیب` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است |
+| `چرخش` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) |
+| `عرض` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
+| `ارتفاع` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
 | `z_index` | بازنویسی ترتیب قرارگیری. لایه‌ها به‌صورت پایدار بر اساس z_index مرتب می‌شوند؛ مقادیر برابر ترتیب فهرست را حفظ می‌کنند. (پیش‌فرض: 0) | INT | خیر | -1000 تا 1000 |
-| `flip_h` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
-| `flip_v` | قرینه‌سازی عمودی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
+| `وارونه افقی` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
+| `وارونه عمودی` | قرینه‌سازی عمودی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
 
 نکات:
 - فقط `image` الزامی است؛ سایر ورودی‌ها اختیاری هستند.