Comfy-Org · comfyui-wiki · May 13, 2026 · May 12, 2026 · May 13, 2026
diff --git a/.cursorrules b/.cursorrules
@@ -64,6 +64,7 @@ Data types should be represented using plain text, not styled text.
 - Japanese (ja)
 - Korean (ko)
 - Russian (ru)
+- Persian/Farsi (fa), when aligning with ComfyUI frontend locale `fa`
 
 ### Translation Principles
 - Only translate when explicitly requested by the user
@@ -141,4 +142,5 @@ When users provide language files and request translation to corresponding langu
 | ja.md    | 入力     | 出力     |
 | ko.md    | 입력     | 출력     |
 | zh.md    | 输入     | 输出     |
-| ru.md    | Входы    | Выходы   |
+| ru.md    | Входы    | Выходы   |
+| fa.md    | ورودی‌ها | خروجی‌ها |
diff --git a/comfyui_embedded_docs/docs/APG/ar.md b/comfyui_embedded_docs/docs/APG/ar.md
@@ -1,18 +1,25 @@
-> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ar.md)
+> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ar.md)
 
-تُعد عقدة APG (الإرشاد الإسقاطي التكيّفي) أسلوبًا لتعديل عملية أخذ العينات من خلال ضبط طريقة تطبيق الإرشاد أثناء الانتشار. تقوم هذه العقدة بفصل متجه الإرشاد إلى مكونات متوازية وعمودية بالنسبة للمخرجات الشرطية، مما يتيح تحكمًا أفضل في توليد الصور. توفر العقدة معاملات لتحجيم الإرشاد، وتطبيع مقداره، وتطبيق زخم حركي لتحقيق انتقالات أكثر سلاسة بين خطوات الانتشار.
+# ترجمة وثيقة عقدة APG (التوجيه الإسقاطي التكيفي)
+
+## نظرة عامة
+
+تقوم عقدة APG (التوجيه الإسقاطي التكيفي) بتعديل عملية أخذ العينات عن طريق ضبط كيفية تطبيق التوجيه أثناء الانتشار. تقوم بفصل متجه التوجيه إلى مكونات متوازية ومتعامدة بالنسبة للمخرجات المشروطة، مما يتيح توليد صور أكثر تحكمًا. توفر العقدة معاملات لقياس التوجيه، وتطبيع حجمه، وتطبيق الزخم لتحقيق انتقالات أكثر سلاسة بين خطوات الانتشار.
 
 ## المدخلات
 
-| المعامل | نوع البيانات | نوع الإدخال | الافتراضي | النطاق | الوصف |
-|-----------|-----------|------------|---------|-------|-------------|
-| `model` | MODEL | مطلوب | - | - | نموذج الانتشار المراد تطبيق الإرشاد الإسقاطي التكيّفي عليه |
-| `eta` | FLOAT | مطلوب | 1.0 | -10.0 إلى 10.0 | يتحكم في مقياس متجه الإرشاد الموازي. السلوك الافتراضي لـ CFG يكون عند القيمة 1. |
-| `norm_threshold` | FLOAT | مطلوب | 5.0 | 0.0 إلى 50.0 | يقوم بتطبيع متجه الإرشاد إلى هذه القيمة، ويتعطل التطبيع عند القيمة 0. |
-| `momentum` | FLOAT | مطلوب | 0.0 | -5.0 إلى 1.0 | يتحكم في المتوسط المتحرك للإرشاد أثناء عملية الانتشار، ويتعطل عند القيمة 0. |
+| المعامل | نوع البيانات | إلزامي | النطاق | الوصف |
+|---------|--------------|--------|--------|-------|
+| `model` | MODEL | نعم | - | نموذج الانتشار المراد تطبيق التوجيه الإسقاطي التكيفي عليه |
+| `eta` | FLOAT | نعم | -10.0 إلى 10.0 | يتحكم في مقياس متجه التوجيه الموازي. سلوك CFG الافتراضي عند القيمة 1 (الافتراضي: 1.0). |
+| `norm_threshold` | FLOAT | نعم | 0.0 إلى 50.0 | تطبيع متجه التوجيه إلى هذه القيمة، يتم تعطيل التطبيع عند القيمة 0 (الافتراضي: 5.0). |
+| `momentum` | FLOAT | نعم | -5.0 إلى 1.0 | يتحكم في المتوسط المتحرك للتوجيه أثناء الانتشار، يتم تعطيله عند القيمة 0 (الافتراضي: 0.0). |
 
 ## المخرجات
 
 | اسم المخرج | نوع البيانات | الوصف |
-|-------------|-----------|-------------|
-| `model` | MODEL | يُرجع النموذج المعدل بعد تطبيق الإرشاد الإسقاطي التكيّفي على عملية أخذ العينات الخاصة به |
+|------------|--------------|--------|
+| `model` | MODEL | إرجاع النموذج المعدل مع تطبيق التوجيه الإسقاطي التكيفي على عملية أخذ العينات الخاصة به |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
diff --git a/comfyui_embedded_docs/docs/APG/en.md b/comfyui_embedded_docs/docs/APG/en.md
@@ -4,15 +4,18 @@ The APG (Adaptive Projected Guidance) node modifies the sampling process by adju
 
 ## Inputs
 
-| Parameter | Data Type | Input Type | Default | Range | Description |
-|-----------|-----------|------------|---------|-------|-------------|
-| `model` | MODEL | Required | - | - | The diffusion model to apply adaptive projected guidance to |
-| `eta` | FLOAT | Required | 1.0 | -10.0 to 10.0 | Controls the scale of the parallel guidance vector. Default CFG behavior at a setting of 1. |
-| `norm_threshold` | FLOAT | Required | 5.0 | 0.0 to 50.0 | Normalize guidance vector to this value, normalization disable at a setting of 0. |
-| `momentum` | FLOAT | Required | 0.0 | -5.0 to 1.0 | Controls a running average of guidance during diffusion, disabled at a setting of 0. |
+| Parameter | Data Type | Required | Range | Description |
+|-----------|-----------|----------|-------|-------------|
+| `model` | MODEL | Yes | - | The diffusion model to apply adaptive projected guidance to |
+| `eta` | FLOAT | Yes | -10.0 to 10.0 | Controls the scale of the parallel guidance vector. Default CFG behavior at a setting of 1 (default: 1.0). |
+| `norm_threshold` | FLOAT | Yes | 0.0 to 50.0 | Normalize guidance vector to this value, normalization disabled at a setting of 0 (default: 5.0). |
+| `momentum` | FLOAT | Yes | -5.0 to 1.0 | Controls a running average of guidance during diffusion, disabled at a setting of 0 (default: 0.0). |
 
 ## Outputs
 
 | Output Name | Data Type | Description |
 |-------------|-----------|-------------|
 | `model` | MODEL | Returns the modified model with adaptive projected guidance applied to its sampling process |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
diff --git a/comfyui_embedded_docs/docs/APG/es.md b/comfyui_embedded_docs/docs/APG/es.md
@@ -1,18 +1,21 @@
 > Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/es.md)
 
-El nodo APG (Adaptive Projected Guidance) modifica el proceso de muestreo ajustando cómo se aplica la guía durante la difusión. Separa el vector de guía en componentes paralelos y ortogonales en relación con la salida condicional, permitiendo una generación de imágenes más controlada. El nodo proporciona parámetros para escalar la guía, normalizar su magnitud y aplicar momentum para transiciones más suaves entre los pasos de difusión.
+El nodo APG (Adaptive Projected Guidance) modifica el proceso de muestreo ajustando cómo se aplica la guía durante la difusión. Separa el vector de guía en componentes paralelos y ortogonales con respecto a la salida condicional, lo que permite una generación de imágenes más controlada. El nodo proporciona parámetros para escalar la guía, normalizar su magnitud y aplicar momento para transiciones más suaves entre los pasos de difusión.
 
 ## Entradas
 
-| Parámetro | Tipo de Dato | Tipo de Entrada | Por Defecto | Rango | Descripción |
-|-----------|-----------|------------|---------|-------|-------------|
-| `model` | MODEL | Requerido | - | - | El modelo de difusión al que aplicar la guía proyectada adaptativa |
-| `eta` | FLOAT | Requerido | 1.0 | -10.0 a 10.0 | Controla la escala del vector de guía paralelo. El comportamiento CFG por defecto se obtiene con un valor de 1. |
-| `norm_threshold` | FLOAT | Requerido | 5.0 | 0.0 a 50.0 | Normaliza el vector de guía a este valor, la normalización se desactiva con un valor de 0. |
-| `momentum` | FLOAT | Requerido | 0.0 | -5.0 a 1.0 | Controla un promedio móvil de la guía durante la difusión, se desactiva con un valor de 0. |
+| Parámetro | Tipo de Dato | Obligatorio | Rango | Descripción |
+|-----------|--------------|-------------|-------|-------------|
+| `model` | MODEL | Sí | - | El modelo de difusión al que se aplicará la guía proyectada adaptativa |
+| `eta` | FLOAT | Sí | -10.0 a 10.0 | Controla la escala del vector de guía paralelo. Comportamiento CFG predeterminado con un valor de 1 (predeterminado: 1.0). |
+| `norm_threshold` | FLOAT | Sí | 0.0 a 50.0 | Normaliza el vector de guía a este valor; la normalización se desactiva con un valor de 0 (predeterminado: 5.0). |
+| `momentum` | FLOAT | Sí | -5.0 a 1.0 | Controla un promedio móvil de la guía durante la difusión; se desactiva con un valor de 0 (predeterminado: 0.0). |
 
 ## Salidas
 
 | Nombre de Salida | Tipo de Dato | Descripción |
-|-------------|-----------|-------------|
-| `model` | MODEL | Devuelve el modelo modificado con la guía proyectada adaptativa aplicada a su proceso de muestreo |
+|------------------|--------------|-------------|
+| `model` | MODEL | Devuelve el modelo modificado con guía proyectada adaptativa aplicada a su proceso de muestreo |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
diff --git a/comfyui_embedded_docs/docs/APG/fa.md b/comfyui_embedded_docs/docs/APG/fa.md
@@ -0,0 +1,22 @@
+> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/fa.md)
+
+### مرور کلی
+گره APG (راهنمایی تصویری تطبیقی) فرآیند نمونه‌برداری را با تنظیم نحوه اعمال راهنمایی در طول انتشار تغییر می‌دهد. این گره بردار راهنمایی را نسبت به خروجی شرطی به دو مؤلفه موازی و عمودی تفکیک می‌کند که امکان تولید تصویر کنترل‌شده‌تری را فراهم می‌آورد. این گره پارامترهایی برای مقیاس‌دهی راهنمایی، نرمال‌سازی اندازه آن و اعمال مومنتوم برای انتقال نرم‌تر بین مراحل انتشار ارائه می‌دهد.
+
+### ورودی‌ها
+
+| پارامتر | نوع داده | الزامی | محدوده | توضیحات |
+|---------|----------|--------|--------|---------|
+| `model` | MODEL | بله | - | مدل انتشار برای اعمال راهنمایی تصویری تطبیقی |
+| `eta` | FLOAT | بله | 10.0- تا 10.0 | مقیاس بردار راهنمایی موازی را کنترل می‌کند. رفتار پیش‌فرض CFG در مقدار 1 (پیش‌فرض: 1.0). |
+| `norm_threshold` | FLOAT | بله | 0.0 تا 50.0 | بردار راهنمایی را به این مقدار نرمال می‌کند، نرمال‌سازی در مقدار 0 غیرفعال می‌شود (پیش‌فرض: 5.0). |
+| `momentum` | FLOAT | بله | 5.0- تا 1.0 | میانگین متحرک راهنمایی در طول انتشار را کنترل می‌کند، در مقدار 0 غیرفعال می‌شود (پیش‌فرض: 0.0). |
+
+### خروجی‌ها
+
+| نام خروجی | نوع داده | توضیحات |
+|-----------|----------|---------|
+| `model` | MODEL | مدل اصلاح‌شده با راهنمایی تصویری تطبیقی اعمال‌شده بر فرآیند نمونه‌برداری آن را برمی‌گرداند |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
diff --git a/comfyui_embedded_docs/docs/APG/fr.md b/comfyui_embedded_docs/docs/APG/fr.md
@@ -1,18 +1,23 @@
 > Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/fr.md)
 
-Le nœud APG (Adaptive Projected Guidance - Guidage Projeté Adaptatif) modifie le processus d'échantillonnage en ajustant la manière dont le guidage est appliqué pendant la diffusion. Il sépare le vecteur de guidage en composantes parallèles et orthogonales par rapport à la sortie conditionnelle, permettant une génération d'image plus contrôlée. Le nœud fournit des paramètres pour mettre à l'échelle le guidage, normaliser son amplitude et appliquer une quantité de mouvement pour des transitions plus fluides entre les étapes de diffusion.
+Voici la traduction en français de la documentation du nœud APG :
+
+Le nœud APG (Guidage Projectif Adaptatif) modifie le processus d'échantillonnage en ajustant la manière dont le guidage est appliqué pendant la diffusion. Il sépare le vecteur de guidage en composantes parallèle et orthogonale par rapport à la sortie conditionnelle, permettant une génération d'image plus contrôlée. Le nœud fournit des paramètres pour mettre à l'échelle le guidage, normaliser sa magnitude et appliquer un momentum pour des transitions plus fluides entre les étapes de diffusion.
 
 ## Entrées
 
-| Paramètre | Type de données | Type d'entrée | Par défaut | Plage | Description |
-|-----------|-----------|------------|---------|-------|-------------|
-| `model` | MODEL | Requis | - | - | Le modèle de diffusion auquel appliquer le guidage projeté adaptatif |
-| `eta` | FLOAT | Requis | 1.0 | -10.0 à 10.0 | Contrôle l'échelle du vecteur de guidage parallèle. Comportement CFG par défaut avec une valeur de 1. |
-| `norm_threshold` | FLOAT | Requis | 5.0 | 0.0 à 50.0 | Normalise le vecteur de guidage à cette valeur, la normalisation est désactivée avec une valeur de 0. |
-| `momentum` | FLOAT | Requis | 0.0 | -5.0 à 1.0 | Contrôle une moyenne mobile du guidage pendant la diffusion, désactivé avec une valeur de 0. |
+| Paramètre | Type de données | Requis | Plage | Description |
+|-----------|-----------------|--------|-------|-------------|
+| `model` | MODEL | Oui | - | Le modèle de diffusion auquel appliquer le guidage projectif adaptatif |
+| `eta` | FLOAT | Oui | -10.0 à 10.0 | Contrôle l'échelle du vecteur de guidage parallèle. Comportement CFG par défaut à un réglage de 1 (par défaut : 1.0). |
+| `norm_threshold` | FLOAT | Oui | 0.0 à 50.0 | Normalise le vecteur de guidage à cette valeur, la normalisation est désactivée à un réglage de 0 (par défaut : 5.0). |
+| `momentum` | FLOAT | Oui | -5.0 à 1.0 | Contrôle une moyenne mobile du guidage pendant la diffusion, désactivé à un réglage de 0 (par défaut : 0.0). |
 
 ## Sorties
 
 | Nom de la sortie | Type de données | Description |
-|-------------|-----------|-------------|
-| `model` | MODEL | Renvoie le modèle modifié avec le guidage projeté adaptatif appliqué à son processus d'échantillonnage |
+|------------------|-----------------|-------------|
+| `model` | MODEL | Renvoie le modèle modifié avec le guidage projectif adaptatif appliqué à son processus d'échantillonnage |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`
diff --git a/comfyui_embedded_docs/docs/APG/ja.md b/comfyui_embedded_docs/docs/APG/ja.md
@@ -1,18 +1,23 @@
 > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ja.md)
 
-APG（Adaptive Projected Guidance）ノードは、拡散過程でのガイダンスの適用方法を調整することで、サンプリングプロセスを変更します。このノードは、ガイダンスベクトルを条件付き出力に対する平行成分と直交成分に分離し、より制御された画像生成を可能にします。ガイダンスのスケーリング、大きさの正規化、および拡散ステップ間のより滑らかな遷移のためのモーメンタムの適用を制御するパラメータを提供します。
+以下が翻訳結果です。
+
+APG（適応型投影ガイダンス）ノードは、拡散プロセス中のガイダンスの適用方法を調整することで、サンプリングプロセスを変更します。このノードは、条件付き出力に対するガイダンスベクトルを平行成分と直交成分に分離し、より制御された画像生成を可能にします。ガイダンスのスケーリング、その大きさの正規化、および拡散ステップ間のスムーズな遷移のためのモメンタム適用のためのパラメータを提供します。
 
 ## 入力
 
-| パラメータ | データ型 | 入力タイプ | デフォルト | 範囲 | 説明 |
-|-----------|-----------|------------|---------|-------|-------------|
-| `model` | MODEL | 必須 | - | - | 適応投影ガイダンスを適用する拡散モデル |
-| `eta` | FLOAT | 必須 | 1.0 | -10.0 から 10.0 | 平行ガイダンスベクトルのスケールを制御します。設定値1でデフォルトのCFG動作になります。 |
-| `norm_threshold` | FLOAT | 必須 | 5.0 | 0.0 から 50.0 | ガイダンスベクトルをこの値に正規化します。設定値0で正規化は無効になります。 |
-| `momentum` | FLOAT | 必須 | 0.0 | -5.0 から 1.0 | 拡散中のガイダンスの移動平均を制御します。設定値0で無効になります。 |
+| パラメータ | データ型 | 必須 | 範囲 | 説明 |
+|-----------|-----------|----------|-------|-------------|
+| `model` | MODEL | はい | - | 適応型投影ガイダンスを適用する拡散モデル |
+| `eta` | FLOAT | はい | -10.0 ～ 10.0 | 平行ガイダンスベクトルのスケールを制御します。設定値1でデフォルトのCFG動作になります（デフォルト: 1.0）。 |
+| `norm_threshold` | FLOAT | はい | 0.0 ～ 50.0 | ガイダンスベクトルをこの値に正規化します。設定値0で正規化は無効になります（デフォルト: 5.0）。 |
+| `momentum` | FLOAT | はい | -5.0 ～ 1.0 | 拡散中のガイダンスの移動平均を制御します。設定値0で無効になります（デフォルト: 0.0）。 |
 
 ## 出力
 
 | 出力名 | データ型 | 説明 |
 |-------------|-----------|-------------|
-| `model` | MODEL | サンプリングプロセスに適応投影ガイダンスが適用された変更済みモデルを返します |
+| `model` | MODEL | サンプリングプロセスに適応型投影ガイダンスが適用された、変更済みモデルを返します |
+
+---
+**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654`