فهرست کامل قابلیت‌ها و دستورات ربات MtrxAnti
============================================

نکته:
- دستورات فارسی در گروه بدون اسلش قابل استفاده هستند.
- دستورات انگلیسی با اسلش قابل استفاده هستند.
- مواردی که کنارشان «ادمین» نوشته شده فقط برای ادمین‌های گروه یا مالک ربات هستند.
- برای دستورات هدف‌دار، معمولاً باید روی پیام کاربر ریپلای کنید.


راهنمای جامع عملکرد ربات
========================

معرفی کلی
---------
MtrxAnti یک ربات مدیریت، امنیت و سرگرمی برای گروه‌های تلگرام است. ربات پیام‌ها، اعضا، دستورات و دکمه‌های اینلاین را از طریق وب‌هوک دریافت می‌کند و بر اساس تنظیمات گروه و سطح دسترسی کاربر پاسخ می‌دهد. اطلاعات کاربران، اخطارها، سکوت‌ها، بن‌ها، VIP، کوین‌ها، بازی‌ها و تنظیمات در دیتابیس ذخیره می‌شوند و رویدادهای مهم مدیریتی در کانال لاگ ثبت می‌گردند.

نحوه استفاده از دستورات
-----------------------
کاربر می‌تواند در گروه از فرمان فارسی یا نسخهٔ اسلش استفاده کند. برای مدیریت یک عضو، بهترین روش این است که روی پیام همان عضو ریپلای شود و سپس دستور ارسال گردد؛ به این شکل ربات هدف دستور را دقیق تشخیص می‌دهد. در دستورهایی که علت می‌پذیرند، متن بعد از نام دستور به‌عنوان دلیل ذخیره و در پیام نتیجه یا لاگ نمایش داده می‌شود.

سطح دسترسی‌ها
-------------
۱. کاربر عادی:
- مشاهده راهنما، قوانین، پروفایل، رتبه، موجودی، فروشگاه، بازی‌ها و لیگ.
- ارسال گزارش تخلف با ریپلای روی پیام دیگران.
- رأی دادن در پیش‌بینی‌ها و انجام عملیات مجاز مربوط به حساب خود.

۲. ادمین گروه:
- اجرای دستورات مدیریتی مانند سکوت، بن، اخطار، قفل محتوا، فیلتر، پنل و آمار.
- مدیریت VIP، پاسخ‌های خودکار، زمان‌بندی، دامنه‌ها و یوزرنیم‌های مجاز.
- بررسی گزارش‌های کاربران از طریق دکمهٔ اینلاین.

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

جریان گزارش تخلف
----------------
کاربر عادی باید روی پیام موردنظر ریپلای کند و «گزارش» یا «/report» را بفرستد. ربات ابتدا بررسی می‌کند که پیام ریپلای‌شده وجود داشته باشد و گزارش‌دهنده خودش یا یکی از ادمین‌های گروه نباشد. سپس پیام دستور گزارش حذف می‌شود تا گفت‌وگو شلوغ نشود و گزارش در کانال لاگ ثبت می‌گردد.

در خود گروه، ربات یک پیام ریپلای‌شده روی پیام اصلی می‌فرستد و اعلام می‌کند که گزارش ثبت شده است. این پیام شامل نام گزارش‌دهنده، علت گزارش، لینک مستقیم پیام و دکمهٔ «تایید و شروع بررسی» است. ادمین‌ها با تگ نامرئی مطلع می‌شوند، اما متن گزارش برای اعضای گروه قابل مشاهده باقی می‌ماند. وقتی یکی از ادمین‌ها دکمهٔ تأیید را بزند، ربات دوباره سطح دسترسی او را بررسی می‌کند و پیام گزارش را به وضعیت «در حال بررسی توسط...» تغییر می‌دهد.

هم‌زمان یک نسخهٔ مدیریتی گزارش در کانال لاگ ارسال می‌شود و در صورت امکان پیام متخلف نیز برای بررسی دقیق‌تر فوروارد می‌گردد. کانال لاگ محل ثبت رویدادهای مدیریتی و بررسی‌های داخلی است و با پیام تأیید داخل گروه تفاوت دارد.

سیستم اخطار و مجازات
--------------------
ادمین می‌تواند برای کاربر اخطار ثبت کند و دلیل آن را مشخص نماید. تعداد اخطارها در پروفایل کاربر و کارت اطلاعات نمایش داده می‌شود. طبق تنظیمات، با افزایش تعداد اخطارها ممکن است سکوت خودکار با مدت‌های متفاوت اعمال شود. ادمین می‌تواند یک اخطار را کم کند یا همهٔ اخطارها را پاک نماید.

سکوت، بن و رفع محدودیت، هم در گروه اعمال می‌شوند و هم در دیتابیس ثبت می‌گردند. برای هر رویداد، کاربر هدف، ادمین اجراکننده، علت، مدت و زمان پایان قابل ثبت است. برخی محدودیت‌ها برای کاربران VIP به مالک ربات وابسته هستند.

سیستم امنیت و فیلتر
-------------------
ربات پیام‌ها را برای لینک‌های غیرمجاز، یوزرنیم و کانال، کلمات فیلترشده، فایل‌های مشکوک، محتوای قفل‌شده و ارسال رگباری بررسی می‌کند. در صورت فعال بودن تنظیم مربوط، پیام متخلف حذف می‌شود و ممکن است اخطار یا محدودیت خودکار اعمال گردد.

فیلتر فایل علاوه بر نوع MIME، پسوندهای پرخطر مانند exe، apk، bat، sh، php، py، zip و rar را بررسی می‌کند. سیستم Fingerprint نیز برای شناسایی تکرار فایل‌های مشکوک و اسپم استفاده می‌شود. ضدفلود تعداد پیام‌های کاربر را در یک بازهٔ کوتاه می‌سنجد تا ارسال رگباری کنترل شود.

قفل‌های رسانه‌ای و متنی مستقل هستند؛ بنابراین ادمین می‌تواند فقط عکس، ویدیو، GIF، ویس، آهنگ، فوروارد، استیکر یا زبان خاصی را محدود کند. دامنه‌ها، کانال‌ها و یوزرنیم‌های مورد اعتماد از فهرست مجاز مستثنا می‌شوند.

ورود اعضا و احراز هویت
----------------------
هنگام ورود عضو جدید، ربات می‌تواند پیام خوش‌آمدگویی ارسال کند، پیام‌های سرویس ورود و خروج را حذف نماید و عضو را برای حل کپچا یا پذیرش قوانین منتظر نگه دارد. ربات‌های اضافه‌شده توسط کاربران غیرمجاز نیز بر اساس تنظیمات ضدربات مدیریت می‌شوند. وضعیت تأیید عضو در پروفایل و لاگ قابل مشاهده است.

اقتصاد، VIP و بازی‌ها
---------------------
ماتریکس کوین واحد اقتصادی داخلی ربات است. کاربران می‌توانند موجودی و رتبهٔ خود را ببینند، کوین انتقال دهند، در بازی دوز و تاس شرکت کنند و در جدول فعالیت یا لیگ رتبه بگیرند. ادمین‌ها یا مدیران مجاز می‌توانند طبق دسترسی خود کوین اعطا یا کسر کنند.

اشتراک VIP از طریق فروشگاه قابل تهیه و توسط ادمین قابل مدیریت است. وضعیت VIP روی پروفایل کاربر نمایش داده می‌شود و در بعضی عملیات مدیریتی مانند سکوت، محدودیت ویژه دارد.

بانک و پیش‌بینی
---------------
بانک ماتریکس برای ساخت حساب، انتخاب نوع حساب، مدیریت کارت، واریز، برداشت، انتقال، وام، سپرده و مشاهدهٔ گردش حساب استفاده می‌شود. بعضی مراحل حساس مانند اطلاعات کارت، CVV2، رمز دوم و تأیید انتقال در پی‌وی ربات انجام می‌شوند.

ماژول پیش‌بینی به ادمین اجازه می‌دهد یک پیش‌بینی با چند گزینه بسازد. کاربران رأی خود را ثبت می‌کنند و پس از پایان یا لغو پیش‌بینی، نتیجه و وضعیت کوین‌ها بر اساس تنظیمات سیستم مدیریت می‌شود.

پنل‌ها، دکمه‌ها و لاگ‌ها
-----------------------
پنل مدیریت برای دسترسی سریع به قفل‌ها، فیلترها، آمار، بانک، کوین، بازی و تنظیمات گروه استفاده می‌شود. پنل کاربر نیز پروفایل، فروشگاه، موجودی و راهنما را در قالب دکمه‌های اینلاین ارائه می‌کند.

دکمه‌های اینلاین برای عملیات حساس، مانند لغو سکوت، آن‌بن، پاکسازی اخطار، مشاهدهٔ پیام گزارش‌شده و تأیید گزارش استفاده می‌شوند. قبل از اجرای عملیات حساس، شناسهٔ کاربر کلیک‌کننده و سطح دسترسی او بررسی می‌شود. نتیجهٔ بسیاری از عملیات با ادیت همان پیام اینلاین نمایش داده می‌شود.

پشتیبانی ذخیره‌سازی و تنظیمات
-----------------------------
ربات در حالت اصلی برای اتصال به MySQL پیکربندی شده است و در طراحی پروژه امکان استفاده از SQLite یا فایل JSON به‌عنوان مسیر جایگزین وجود دارد. تنظیمات امنیتی، زمان‌ها، سقف اخطار، محدودیت فلود، انواع فایل مجاز و پسوندهای مسدود از فایل پیکربندی خوانده می‌شوند.

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


۱) دستورات عمومی و راهنما
-------------------------
راهنما
/help
نمایش راهنمای دستورات ربات.

قوانین
/rules
نمایش قوانین گروه.

/start
شروع کار با ربات در پی‌وی.

کامیونیتی ما | کامیونیتی | کانال‌ها
/community
/channels
نمایش کانال‌ها و کامیونیتی‌های مرتبط.


۲) مدیریت کاربران و نظارت گروه (ادمین)
---------------------------------------
سکوت [دقیقه] [علت]
/mute [دقیقه] [علت]
ساکت کردن کاربر برای مدت مشخص یا به‌صورت دائمی.

لغو سکوت | حذف سکوت
/unmute
لغو سکوت کاربر.

بن [دقیقه] [علت] | اخراج
/ban [دقیقه] [علت]
محروم کردن کاربر از گروه برای مدت مشخص یا دائمی.

لغو بن | حذف بن
/unban
لغو محرومیت و بازگرداندن دسترسی کاربر.

اخطار [علت]
/warn [علت]
ثبت اخطار برای کاربر. بر اساس تعداد اخطارها ممکن است سکوت خودکار اعمال شود.

لغو اخطار | حذف اخطار
/unwarn
کسر یک اخطار از کاربر.

پاکسازی اخطار
/clearwarn
حذف تمام اخطارهای کاربر.

اطلاعات کاربر با ریپلای
/info
نمایش کارت اطلاعات، وضعیت VIP، ادمین بودن، احراز هویت، اخطارها، سکوت و بن.

پنل | پنل مدیریت
/panel
باز کردن پنل مدیریت گروه.

آمار مدیریتی
/stats
نمایش آمار کاربران، سکوت‌ها، بن‌ها، VIPها، اخطارها، فیلترها و وضعیت قفل‌ها.

پین کردن پیام با ریپلای
/pin
سنجاق کردن پیام انتخاب‌شده.

آن‌پین کردن پیام با ریپلای
/unpin
برداشتن سنجاق پیام.

گزارش با ریپلای
/report
گزارش پیام متخلف توسط کاربر عادی؛ گزارش در گروه ثبت می‌شود، ادمین‌ها به‌صورت نامرئی تگ می‌شوند و دکمه مشاهده پیام و تأیید بررسی دارند.

گزارش [علت] با ریپلای
گزارش تخلف با ذکر علت.


۳) فیلتر و قفل محتوای گروه (ادمین)
----------------------------------
فیلتر [کلمه]
افزودن کلمه به فیلتر اختصاصی گروه.

حذف فیلتر [کلمه]
حذف کلمه از فیلتر اختصاصی.

قفل استیکر
/locksticker
جلوگیری از ارسال استیکر.

بازکردن استیکر | باز کردن استیکر | حذف قفل استیکر
رفع قفل استیکر.

مسدود پک [نام پک]
مسدودسازی یک پک استیکر.

حذف مسدود پک [نام پک] | بازکردن پک [نام پک] | آنبن پک [نام پک] | رفع مسدودیت پک [نام پک]
رفع مسدودی پک استیکر.

لیست پک‌های مسدود
/blockedpacks
نمایش پک‌های مسدودشده.

قفل فایل
جلوگیری از ارسال فایل‌های ممنوع و فایل‌های مشکوک.

بازکردن فایل | باز کردن فایل | حذف قفل فایل
رفع قفل فایل.

قفل فوروارد
جلوگیری از ارسال پیام‌های فورواردی.

بازکردن فوروارد | باز کردن فوروارد | حذف قفل فوروارد
رفع قفل فوروارد.

قفل عکس / بازکردن عکس
قفل یا باز کردن ارسال عکس.

قفل ویدیو / بازکردن ویدیو
قفل یا باز کردن ارسال ویدیو.

قفل گیف / بازکردن گیف
قفل یا باز کردن ارسال GIF.

قفل ویس / بازکردن ویس
قفل یا باز کردن ارسال پیام صوتی.

قفل آهنگ / بازکردن آهنگ
قفل یا باز کردن ارسال فایل صوتی و آهنگ.

قفل چت فارسی / بازکردن چت فارسی
محدودسازی یا آزادسازی پیام‌های فارسی.

قفل چت انگلیسی / بازکردن چت انگلیسی
محدودسازی یا آزادسازی پیام‌های انگلیسی.


۴) تنظیمات حفاظتی خودکار
------------------------
- ضد لینک و تبلیغات؛ با امکان دامنه‌های مجاز.
- ضد یوزرنیم و کانال؛ با امکان یوزرنیم‌های مجاز.
- ضد فلود و ارسال رگباری؛ تعداد پیام مجاز و بازه زمانی قابل تنظیم است.
- ضد فایل و جلوگیری از پسوندهای خطرناک مانند exe، apk، bat، sh، php، py، zip و موارد مشابه.
- شناسایی فایل‌های اسپم با سیستم Fingerprint.
- حذف پیام‌های ورود و خروج اعضا.
- جلوگیری از اضافه شدن ربات‌های مزاحم.
- کپچا و احراز هویت اعضای جدید.
- حالت تهاجمی و گزارش خودکار رفتارهای مشکوک.
- حالت شب و سکوت خودکار شبانه.
- ارسال یادآوری قوانین در بخش نظرات کانال متصل.
- ثبت لاگ اقدامات مدیریتی در کانال گزارش.
- جلوگیری از گزارش پیام خود کاربر یا پیام ادمین‌ها.

تنظیمات روشن/خاموش موجود:
- حذف پیام ورود روشن
- پاسخ کانال روشن
- پاسخ کانال خاموش
- حالت شب روشن
- حالت شب خاموش
- روشن ماتریکس کوین
- خاموش ماتریکس کوین
- غیرفعال ماتریکس کوین
- فعال ماتریکس کوین
- قفل ماتریکس کوین
- بازکردن ماتریکس کوین


۵) پاسخ خودکار و زمان‌بندی (ادمین)
---------------------------------
پاسخ [کلمه] | [متن]
افزودن پاسخ خودکار برای یک کلمه یا عبارت.

حذف پاسخ [کلمه]
حذف پاسخ خودکار.

لیست پاسخ‌ها
نمایش پاسخ‌های خودکار ثبت‌شده.

زمانبندی [تنظیمات]
افزودن پیام زمان‌بندی‌شده.

حذف زمانبندی [شناسه]
حذف پیام زمان‌بندی‌شده.

لیست زمانبندی
نمایش زمان‌بندی‌ها.

همگانی | ارسال همگانی [متن]
/broadcast [متن]
ارسال پیام همگانی برای کاربران ثبت‌شده. مخصوص مدیر ربات.


۶) لینک‌ها و دسترسی‌های مجاز (ادمین)
------------------------------------
مجاز کردن لینک [دامنه]
افزودن دامنه به فهرست لینک‌های مجاز.

حذف لینک مجاز [دامنه]
حذف دامنه از فهرست مجاز.

لیست لینک‌های مجاز
نمایش دامنه‌های مجاز.

مجاز کردن یوزرنیم [@username]
مجاز کردن کانال [@channel]
افزودن یوزرنیم یا کانال به فهرست مجاز.

حذف یوزرنیم مجاز [@username]
حذف کانال مجاز [@channel]
حذف مورد از فهرست مجاز.

لیست یوزرنیم‌های مجاز
لیست کانال‌های مجاز
نمایش یوزرنیم‌ها و کانال‌های مجاز.


۷) پروفایل و امکانات کاربری
---------------------------
حساب من | اطلاعات من | پروفایل | حساب کاربری
/myinfo
/profile
نمایش پروفایل کاربر، رتبه، تعداد پیام‌ها، کوین‌ها، VIP و وضعیت احراز هویت.

زمان ورود | تاریخ ورود
/joindate
/join
نمایش تاریخ ورود کاربر به گروه.

فروشگاه | فروشگاه ماتریکس | خرید اشتراک
/shop
نمایش فروشگاه و پلن‌های VIP.

موجودی
/balance
نمایش موجودی ماتریکس کوین.

انتقال | انتقال کوین
/transfer
انتقال کوین به کاربر دیگر.


۸) VIP (ادمین)
---------------
ویژه
/vip
افزودن اشتراک ویژه برای کاربر.

حذف ویژه
/unvip
حذف اشتراک ویژه.

لیست ویژه
/viplist
نمایش فهرست کاربران VIP.


۹) ماتریکس کوین و اقتصاد ربات
-----------------------------
ماتریکس کوین | کوین | کوین من | سکه‌های من | سکه
/coins
/coin
نمایش موجودی، رتبه و اطلاعات کوین.

اعطای کوین | افزایش کوین | اعطای سکه | اهدای ماتریکس کوین | اهدای کوین | اهدا
دادن کوین به کاربر. مخصوص ادمین یا مدیر مجاز.

کسر کوین | کاهش کوین | کسر سکه
کم کردن کوین از کاربر. مخصوص ادمین یا مدیر مجاز.

روشن/خاموش ماتریکس کوین
/matrixcoin
فعال یا غیرفعال کردن سیستم کوین در گروه.


۱۰) بازی و رتبه‌بندی
--------------------
دوز
/dooz
شروع بازی دوز و ایجاد چالش با کوین.

تاس
/dice
شروع چالش تاس.

بازی‌های من | بازی های من
/mygames
نمایش آمار بازی‌های کاربر.

برترین‌ها | چت‌ترین‌ها | آمار چت
/top
نمایش برترین کاربران بر اساس فعالیت و تعداد پیام‌ها.

لیگ | جدول لیگ
/league
نمایش جدول لیگ و رتبه‌بندی کاربران.


۱۱) بانک ماتریکس
----------------
- ساخت حساب بانکی و انتخاب نوع حساب.
- مشاهده حساب‌ها و کارت‌های بانکی.
- واریز و برداشت از کیف پول.
- انتقال بانکی بین کاربران.
- دریافت وام هفتگی.
- سپرده قفل‌شده هفتگی.
- نمایش گردش حساب و صورت‌حساب.
- محاسبه سود بر اساس نوع حساب.
- تأیید انتقال در پی‌وی ربات.

دکمه یا بخش بانک
/bank


۱۲) پیش‌بینی ماتریکس
--------------------
- ساخت پیش‌بینی توسط ادمین.
- تعریف گزینه‌های پیش‌بینی.
- رأی دادن کاربران به گزینه‌ها.
- پرداخت یا دریافت کوین بر اساس نتیجه.
- مشاهده پیش‌بینی‌های فعال.
- پایان دادن یا لغو پیش‌بینی توسط ادمین.


۱۳) احراز هویت و ورود اعضا
--------------------------
- پیام خوش‌آمدگویی برای عضو جدید.
- کپچای ورود و دکمه تأیید هویت.
- پذیرش قوانین و فعال‌سازی حساب.
- جلوگیری از فعالیت عضو تا تأیید هویت.
- ثبت وضعیت احراز هویت در پروفایل و لاگ.


۱۴) پنل‌ها و دکمه‌های اینلاین
-----------------------------
- پنل مدیریت گروه با دسته‌بندی قفل‌ها، فیلترها، آمار، بانک، کوین و بازی‌ها.
- پنل کاربری با پروفایل، فروشگاه، موجودی و راهنما.
- دکمه‌های اقدام سریع برای لغو سکوت، آن‌بن، پاکسازی اخطار و مشاهده پروفایل.
- دکمه مشاهده پیام گزارش‌شده در گزارش‌ها.
- تگ نامرئی ادمین‌ها در گزارش گروه.
- دکمه تأیید بررسی گزارش توسط ادمین.
- ادیت شدن وضعیت گزارش بعد از قبول آن توسط یکی از ادمین‌ها.


۱۵) دستورات اسلش موجود
-----------------------
/start
/help
/rules
/community
/channels
/mute
/unmute
/ban
/unban
/warn
/unwarn
/clearwarn
/panel
/info
/stats
/broadcast
/report
/schedule
/schedules
/myinfo
/profile
/joindate
/join
/blockpack
/blocksticker
/unblockpack
/blockedpacks
/mygames
/matrixcoin
/shop
/balance
/transfer
/dooz
/dice
/top
/league
/coins
/coin
/pin
/unpin
/vip
/unvip
/viplist
/bank


پایان فهرست
