# راهنمای قابلیت‌های جدید XByteHub

این نسخه سه قابلیت جدید را به‌صورت **افزایشی** اضافه می‌کند: دعوت طلایی، نت ملی ویژه و جوین اجباری چندکاناله. داده‌های پیشین کاربران، کانفیگ‌ها، پروکسی‌ها و تنظیمات عادی حفظ شده‌اند.

## شروع سریع

پس از جایگزینی فایل‌ها روی هاست، از پنل ادمین بخش‌های **تنظیمات رفرال**، **تنظیمات نت ملی** و **جوین اجباری** را باز کنید. تنظیمات جدید در نخستین ذخیره‌سازی از پنل، به `data/settings.json` افزوده می‌شوند و نیاز به مهاجرت دستی ندارند.

| بخش | محل تنظیم | نکتهٔ مهم |
|---|---|---|
| دعوت طلایی | پنل ادمین ← `🌟 تنظیمات رفرال` | برای ساخت لینک، `BOT_USERNAME` را در `config.php` وارد کنید یا اجازه دهید ربات در اولین درخواست از `getMe` نام کاربری را دریافت کند. |
| نت ملی ویژه | پنل ادمین ← `🎁 تنظیمات نت ملی` | ابتدا تیرها و موجودی جداگانهٔ کانفیگ/پروکسی را تنظیم کنید. |
| جوین اجباری | پنل ادمین ← `📢 جوین اجباری` | ربات باید در **همهٔ** کانال‌های ثبت‌شده ادمین باشد. |

## مخزن نت ملی

فایل‌های زیر کاملاً از موجودی عادی جدا هستند:

| فایل | محتوا |
|---|---|
| `data/national_net_configs.json` | کانفیگ‌های ویژهٔ نت ملی |
| `data/national_net_proxies.txt` | پروکسی‌های ویژهٔ نت ملی |

برای مدیریت این فایل‌ها از مسیر **تنظیمات نت ملی ← مدیریت مخزن ویژه** استفاده کنید؛ افزودن مستقیم فایل‌ها نیز ممکن است، اما پنل ادمین از اعتبارسنجی و حذف موارد تکراری پشتیبانی می‌کند.

## رفتارهای محافظتی

دعوت فقط زمانی نهایی می‌شود که کاربر کاملاً جدید باشد، از همهٔ کانال‌های اجباری عبور کند و لینک او به یک کاربر موجود اشاره کند. self-referral، لینک جعلی و ثبت تکراری نادیده گرفته می‌شوند.

claim نت ملی، هنگام تأیید نهایی دوباره تعداد دعوت، cooldown و موجودی را بررسی می‌کند. عملیات claim و تغییرات مربوط به referral با قفل فایل انجام می‌شوند تا کلیک هم‌زمان یا پردازش موازی باعث تحویل/شمارش تکراری نشود.

> اگر `BOT_USERNAME` را تنظیم نمی‌کنید، ربات برای ساخت نخستین لینک دعوت به API تلگرام نیاز دارد. برای کاهش این وابستگی، مقدار نام کاربری ربات را بدون `@` در `config.php` ثبت کنید.