# LTXV افزودن راهنمای Latent

گره LTXV Add Latent Guide یک latent از قبل کدگذاری‌شده را به‌عنوان راهنما تثبیت می‌کند، برای زمانی که راهنما از مرحله‌ای پیشین حاصل می‌شود نه از یک تصویر. این گره همان اثر LTXV Add Guide را دارد، اما بدون رفت‌وبرگشت decode/encode و VAE. راهنمایی که از نظر فضایی کوچک‌تر از هدف است (یک IC-LoRA یا مرجع جزئیات‌سازی) روی یک شبکه پراکنده dilate می‌شود، و موقعیت‌های پایانی RoPE آن با همان نسبت گسترش می‌یابند تا کل بوم هدف را پوشش دهد، نه اینکه فقط گوشه بالا-چپ آن را هدف قرار دهد.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `positive` | ورودی شرطی‌سازی مثبت. | CONDITIONING | بله | N/A |
| `negative` | ورودی شرطی‌سازی منفی. | CONDITIONING | بله | N/A |
| `vae` | مدل VAE که برای خواندن فرمول شاخص کاهش مقیاس برای جای‌گذاری فریم استفاده می‌شود. | VAE | بله | N/A |
| `latent` | latent ویدئوی هدف که راهنما روی آن تثبیت می‌شود. | LATENT | بله | N/A |
| `guiding_latent` | latent راهنما. اندازه فضایی آن باید اندازه هدف را در هر دو محور بر همان عدد صحیح تقسیم کند؛ اندازه برابر آن را بدون تغییر تثبیت می‌کند، و اندازه نصف به‌عنوان مرجع IC-LoRA با ضریب x2 در نظر گرفته می‌شود. | LATENT | بله | N/A |
| `latent_idx` | شاخص فریم latent برای شروع راهنما، که بر حسب فریم‌های latent شمرده می‌شود نه فریم‌های پیکسلی. مقادیر منفی راهنما را روی فریم‌هایی پیش از شروع latent قرار می‌دهند، نه با شمارش معکوس از انتهای آن. پیش‌فرض: 0. | INT | بله | -9999 تا 9999 |
| `strength` | حداکثر تا 1.0 محدود شده است. یک راهنمای dilate‌شده موقعیت‌های padding خود را با یک ماسک denoise منفی علامت‌گذاری می‌کند تا مدل آن‌ها را حذف کند؛ بالای 1.0، موقعیت‌های نگه‌داشته‌شده نیز منفی می‌شوند و کل راهنما حذف می‌شود. برای تقویت بیش از 1.0 به‌جای آن از attention_mask استفاده کنید. پیش‌فرض: 1.0. | FLOAT | بله | 0.0 تا 1.0, step 0.01 |
| `attention_mask` | ماسک فضایی اختیاری در فضای پیکسلی. تأثیر شرطی‌سازی را به‌صورت ناحیه‌ای از طریق self-attention کنترل می‌کند و در `strength` ضرب می‌شود. | MASK | خیر | N/A |

### یادداشت‌ها

- هر دو `latent` و `guiding_latent` باید latentهای ویدئویی 5D با شکل (batch, channels, frames, height, width) باشند.
- راهنما باید داخل latent هدف جا شود: تعداد فریم‌های راهنما به‌علاوه `latent_idx` نباید از انتهای latent هدف فراتر برود. مقادیر منفی `latent_idx` مجاز هستند و راهنما را پیش از شروع latent قرار می‌دهند.
- اندازه فضایی راهنما باید اندازه فضایی هدف را در هر دو محور height و width بر یک عدد صحیح تقسیم کند.
- نسبت height و نسبت width باید مقدار یکسانی باشند (نسبت مربعی). نسبت غیرمربعی خطا ایجاد می‌کند، زیرا dilation و جای‌گذاری RoPE برای هر دو محور از یک ضریب کاهش مقیاس واحد استفاده می‌کنند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `positive` | شرطی‌سازی مثبت با راهنمای متصل. | CONDITIONING |
| `negative` | شرطی‌سازی منفی با راهنمای متصل. | CONDITIONING |
| `latent` | خروجی latent با راهنمای اعمال‌شده، شامل `noise_mask` به‌روزرسانی‌شده. | LATENT |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fa.md)

---
**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73`
