ربات «کمکیـــار» یک دستیار مدیریت گروه تلگرام است که برای سادهسازی وظایف مدیریتی مانند خوشآمدگویی، فیلترینگ کلمات، مدیریت اعضا، و گزارشدهی طراحی شده است.
- خوشآمدگویی سفارشی برای اعضای جدید
- فیلتر کلمات و پاسخهای خودکار
- مدیریت اخطارها و مجازاتها (میوت، کیک، بن)
- ایجاد لینک دعوت با پرمیشنها و محدودیت دلخواه
- سیستم گزارشدهی به ادمینها
- تنظیمات گروهی ذخیرهشده در SQLite
نیازمندیها را از requirements.txt نصب کنید:
pip install -r requirements.txtسپس متغیر محیطی TOKEN را در فایل .env یا متغیرهای محیطی سیستم قرار دهید (مثال در .env.example).
و OWNER_ID در فایل .env را با آیدی عددی خودتان در تلگرام جایگزین کنید
- ربات را به گروه اضافه کنید.
- در گروه دستور
فعال شورا ارسال کنید تا ربات فعال شود. - برای دیدن راهنما در پیوی ربات دستور
راهنمایا/helpرا ارسال کنید.
برای اجرای محلی:
python src/main.pyفعال شو— فعالسازی ربات در گروهراهنما— دریافت راهنمای کامل به صورت خصوصیلینک— ساخت لینک دعوت اختصاصیفیلترها— نمایش فیلترهای ثبتشده- ریپلای روی پیام +
فیلتر <پاسخ>— اضافه کردن فیلتر جدید - ریپلای روی پیام +
گزارش— گزارش پیام به ادمینها سقف اخطار <عدد>— تنظیم سقف اخطارهاقوانین— نمایش قوانین گروه
توضیحات بیشتر و لیست کامل دستورات در پنل راهنما داخل ربات موجود است.
تنظیمات گروه در یک فایل SQLite (groups.db) ذخیره میشود. توابع و جدولهای پایه مانند groups, tags, punishments, group_settings, reports, aliases, و warnings جهت مدیریت دادهها تعبیه شدهاند.
برای دسترسی دستی به دیتابیس میتوانید از یک کلاینت SQLite استفاده کنید یا از طریق دستورهای داخلی نوشته شده در سورس بهره ببرید.
- سورس باز است؛ هرگونه PR یا issue در گیتهاب خوشآمد گفته میشود.
- در صورت نیاز میتوانم کمک کنم تا مستندات بیشتری اضافه کنیم، تست بنویسیم یا ترجمه انگلیسی تهیه کنیم.
این پروژه با مجوز متنباز منتشر شده — جزئیات مجوز را در فایل LICENSE ببینید.
همچنین، رعایت بند های ذکر شده در فایل NOTICE نیز مورد انتظار است