# مدیریت حرفه‌ای گروه و کانال روبیکا و تلگرام — روی ویندوز ۷

## دو ابزار دسکتاپ، یک محیط اجرا

اگر گروه یا کانال دارید و کارهایتان را دستی انجام می‌دهید، حتماً این‌ها را دیده‌اید:

لیست اعضا را باید دستی مرور کنید، اعضای فعال را نمی‌دانید چه‌کسی بوده، ورودی‌های

تازه را از دست می‌دهید و خوش‌آمد گفتن به هر نفر یک کار وقت‌گیر است.

این بسته، دو ابزار دسکتاپ است که همین کارها را خودکار می‌کند:

| | ابزار روبیکا | ابزار تلگرام |

|---|---|---|

| نام پروژه | `rubika_win7` | `telegram_win7` |

| نسخهٔ فعلی | ۱.۱.۸ | ۱.۰.۸ |

| موتور اتصال | `rubpy` | `Telethon 1.45` |

| ورود | با حساب خودتان | با `api_id` / `api_hash` خودتان |

| محیط اجرا | ویندوز ۷ + پایتون ۳.۸ | ویندوز ۷ + پایتون ۳.۸ |

| نصب | **کاملاً آفلاین** از پوشهٔ `wheels/` با `install.bat` | همان |

هر دو ابزار از یک رابط کاربری سادهٔ پنجره‌ای استفاده می‌کنند؛ نیازی به خط فرمان

یا دانش فنی نیست. کافی است یک‌بار نصب کنید، وارد شوید و کار کنید.

---

## قابلیت‌ها

### ۱. ورود و استخراج مشخصات

ورود امن با حساب خودتان، خواندن پروفایل و کشیدن لیست کامل گروه‌ها و کانال‌هایی

که در آن‌ها عضو یا مدیر هستید.

### ۲. اسکن کامل اعضا + خروجی CSV

لیست اعضای گروه/کانال خوانده می‌شود (با سقف حدوداً ۱۰٬۰۰۰ عضو و مدیریت هوشمند

قطع‌شدن‌ها)، فیلتر **«آنلاین اخیر»** روی آن اعمال می‌شود و خروجی گرفتن از نتیجه

یک کلیک است.

### ۳. رصد اعضای فعال (Watch)

یک حلقهٔ رصد که وضعیتش را در فایل `CSV` نگه می‌دارد. اگر اینترنت قطع شود،

ابزار **صبر می‌کند و خودش ادامه می‌دهد** — وضعیت صفر نمی‌شود و تاریخچه از دست نمی‌رود.

### ۴. تشخیص ورودی‌های جدید

اعضای تازه‌وارد با **نام کاربری** شناسایی می‌شوند، نه با حدس. برای گروه‌ها از

خودِ رویداد پیام استفاده می‌شود.

### ۵. پروب اختلاف لیست اعضا (Member Snapshot Diff)

راه‌دوم برای جاهایی که رویداد «ورود عضو» به دست ابزار نمی‌رسد — **خصوصاً کانال‌ها**.

ابزار از لیست اعضا عکس می‌گیرد و آن را روی دیسک کش می‌کند

(`data/cache/msnap_.json`)، سپس عکس جدید را با قبلی مقایسه می‌کند:

- فقط **افزوده‌ها** را گزارش می‌کند؛ خروج‌ها اسپم نمی‌سازند

- فاصلهٔ زمانی امن دارد (روبیکا ۹۰ ثانیه، تلگرام ۶۰ ثانیه)

- نامِ افراد از همان لیست اعضا خوانده می‌شود

### ۶. پاک‌سازی خودکار پیام‌های ورود/خروج

پیام‌های سیستمی «عضو جدید اضافه شد» / «عضو خارج شد» خودکار حذف می‌شوند تا گروه

دست‌نخورده بماند. یک تیک دارد: **«فقط مدیر گروه/کانال»** — یعنی ابزار فقط جایی

دست به کار می‌شود که شما مدیر آن هستید. تعداد کل حذف‌شده‌ها در وضعیت نمایش داده می‌شود.

### ۷. خوش‌آمدگویی چندمقصدی

می‌توانید ترکیبی انتخاب کنید که خوش‌آمد کجا فرستاده شود:

- **پیوی خودِ عضو** (خصوصی)

- **پیوی خود شما** (پیام‌های ذخیره‌شده) — برای اینکه سابقه داشته باشید

- **منشن در گروه**

وضعیت هر عضو دقیق ثبت می‌شود: خوش‌آمد کامل، بخشی (مثلاً پیوی نرسید ولی منشن شد)،

یا ناموفق. اگر مقصد بلاک باشد، ابزار رد می‌شود و **خطای فارسی** نشان می‌دهد؛

خطای شبکه هم دور بعد دوباره تلاش می‌شود.

### ۸. منشن واقعی و قابل کلیک

منشن در گروه واقعی است، نه متن ساده:

- در تلگرام با `MessageEntityMentionName` و **محاسبهٔ دقیق آفست یونی‌کد (UTF-16)**

— این نکته جایی است که اکثر کدهای ساده به‌هم می‌ریزند

- اگر نام کاربری قابل تبدیل نباشد، ابزار خودکار به حالت متن ساده برمی‌گردد

### ۹. افزودن اعضا به گروه/کانال

لیست ورودی از فایل `CSV` خوانده می‌شود، با:

- **سقف روزانه** و **فاصلهٔ زمانی بین هر افزودن** (در پایگاه‌دادهٔ `SQLite`)

- جلوگیری از تکرار از سه مسیر: دیتابیس، کش مقصد و کش «قبلاً انجام‌شده»

- کش لیست مقصد برای سرعت بیشتر

در تلگرام هر دو مسیر پیاده‌شده و تست‌شده است: کانال با `channels.InviteToChannel`

و گروه با `messages.AddChatUser`.

### ۱۰. پشتیبانی کامل از پروکسی (نسخهٔ تلگرام)

برای شرایطی که اتصال مستقیم کار نمی‌کند:

- **خودکار از ویندوز** (خواندن تنظیمات پروکسی از رجیستری)

- **بدون پروکسی**

- **آدرس دستی:** لینک `t.me/proxy` (MTProto مستقیماً، بدون نیاز به بستهٔ اضافه)،

`socks5://` یا `http://`

- دکمهٔ **«تست اتصال»** با پیام خطای دقیق و فارسی

- شماره‌های بین‌المللی هم پذیرفته می‌شوند (نه فقط `+98`)

### ۱۱. ابزارهای کار روزمره

- دکمهٔ **«آخرین لاگ رصد»** که خلاصهٔ آخرین چرخه را در کلیپ‌بورد می‌گذارد

- لاگ چرخه‌ای در `data/logs/*.log` (تعداد پیام، فرستنده، واردشده، حذف‌شده…)

- نوار وضعیت دقیق: هم وضعیت خام، هم وضعیت داخلی

### ۱۲. ساخت فایل EXE داخل خود بسته

یک `build_exe.bat` همراه پکیج هست که با نصب‌کنندهٔ **آفلاین** (`wheels-installer/`)

نسخهٔ اجرایی می‌سازد. یعنی روی کامپیوتری که اینترنت ندارد هم می‌توانید

برنامه را به یک فایل اجرایی تبدیل کنید تا نصب پایتون هم لازم نباشد.

---

## چه چیزی تحویل می‌گیرید؟

- سورس کامل دو پروژه (پایتون)

- پوشهٔ `wheels/` برای نصب کامل آفلاین + `install.bat`

- `build_exe.bat` برای ساخت نسخهٔ اجرایی

- ابزار عیب‌یابی (`diagnose.py`) برای بررسی وضعیت اتصال

- راهنمای فارسی نصب و استفاده

ساختار پروژهٔ تلگرام (بقیهٔ فایل‌های کد):

```

app/

├── config.py تنظیمات (محل ذخیرهٔ داده در حالت exe و حالت معمولی)

├── database.py پایگاه‌دادهٔ SQLite

├── tg.py موتور بک‌اند

├── main.py نقطهٔ ورود برنامه

├── diagnose.py عیب‌یابی

├── ui_login.py پنجرهٔ ورود

├── ui_main.py پنجرهٔ اصلی

├── ui_members.py اعضا

├── ui_active.py رصد فعال

├── ui_add.py افزودن

├── ui_settings.py تنظیمات

└── ui_profile.py پروفایل

```

---

## نصب و اجرا

۱. پوشه را باز کنید و `install.bat` را اجرا کنید (اینترنت لازم نیست)

۲. برنامه را اجرا کنید

۳. وارد شوید:

- روبیکا: با حساب خودتان

- تلگرام: با `api_id` و `api_hash` خودتان (از `my.telegram.org`)

۴. اگر اتصال برقرار نشد، `diagnose.py` را اجرا کنید یا از بخش پروکسی «تست اتصال» بگیرید

**تولید فایل اجرایی (اختیاری):** `build_exe.bat` را اجرا کنید.

---

## نکته‌های مهم (صادقانه)

- محدودیت خود تلگرام: به هر کانال حدوداً **۲۰۰ نفر** می‌توان افزود؛ بعد از آن

فقط لینک دعوت قابل ارسال است. این محدودیت سمت سرور تلگرام است، نه ابزار.

- برای رصد کانال‌های پخش (broadcast) باید در آن کانال **مدیر** باشید.

- در تلگرام، مبنای زمان‌بندی رصد «شناسهٔ پیام» است؛ اگر عدد غیرمنطقی وارد شود

ابزار خودش حالت «از الان» را انتخاب می‌کند تا انفجار خوش‌آمد رخ ندهد.

- در حالت «seed» (شروع با شمارهٔ منفی) فقط فرستنده‌ها خوانده می‌شوند و خوش‌آمد

انبوه فرستاده نمی‌شود.

- خودِ کاربر هرگز جزو «اعضای واردشده» شمرده نمی‌شود.

- این ابزارها برای **مدیریت گروه‌ها و کانال‌های خودتان** ساخته شده‌اند؛ مسئولیت

رعایت قوانین هر پیام‌رسان و رضایت اعضا بر عهدهٔ استفاده‌کننده است.

---

## تازه‌ترین تغییرات

**نسخهٔ روبیکا ۱.۱.۸**

- خوش‌آمدگویی چندمقصدی ترکیبی و وضعیت دقیق هر عضو

- پروب اختلاف اعضا با کش دیسکی و فاصلهٔ زمانی امن

- پاک‌سازی خودکار پیام‌های سیستمی + فیلتر «فقط مدیر»

**نسخهٔ تلگرام ۱.۰.۸**

- رفع باگ زمان‌دارِ وضعیت رصد: حالا ورودی‌های جدید بلافاصله و بدون ری‌استارت

برنامه دیده می‌شوند

- پر شدن خودکار کش اعضا: پیوی خوش‌آمد به عضو تازهٔ کانال هم بی‌کم‌وکاست می‌رسد

- پروکسی کامل (خودکار / بدون پروکسی / دستی) با تست اتصال

- پشتیبانی از شماره‌های بین‌المللی

---

## قیمت

**۴۵۰٬۰۰۰ تومان** برای بستهٔ کامل دو ابزار — شامل سورس کامل، نصب‌کنندهٔ آفلاین

و اسکریپت ساخت نسخهٔ اجرایی. هر ابزار را جداگانه هم می‌توانید تهیه کنید:

**۲۹۰٬۰۰۰ تومان**.

---

**نیاز دارید؟** ویندوز ۷ (یا بالاتر) — بقیه‌اش داخل بسته هست.