📖 OPERATOR X — راهنمای جامع

نسخه ۱.۰ — همه‌ی قابلیت‌ها، دستورات و راه‌اندازی، در یک سند.

نسخه: ۱.۰ — ربات مدیریت گروه و کانال تلگرام

---

---

۱) OPERATOR X چیست؟

OPERATOR X یک ربات همه‌کاره برای مدیریت گروه‌ها و کانال‌های تلگرام است. کارش فقط حذف لینک نیست؛ یک مجموعه‌ی کامل از ابزارهای مدیریت، امنیت، سرگرمی و بهره‌وری است.

OPERATOR X در یک نگاه:

نکته‌ی مهم: همه‌چیز از طریق دکمه‌های شیشه‌ای و پنل دکمه‌ای کنترل می‌شود. لازم نیست دستوری حفظ کنی.

---

۲) شروع سریع در ۳ دقیقه

گام ۱ — افزودن ربات به گروه

روی نام ربات بزن و Add to Group را انتخاب کن، یا لینک ربات را در گروه بفرست و روی Add بزن.

گام ۲ — ادمین کردن ربات (الزامی)

بدون ادمین بودن، ربات نمی‌تواند پیام پاک کند. پس:

1. وارد گروه شو → Manage Group → Administrators
2. Add Admin → ربات را انتخاب کن
3. این دسترسی‌ها را روشن کن:

• ✅ Delete Messages
• ✅ Ban Users
• ✅ Invite Users
• ✅ Restrict Members
• ✅ Pin Messages
• ✅ Manage Voice Chats

هر دسترسی برای چه کاری لازم است:

گام ۳ — باز کردن پنل

در گروه بنویس:

پنل

پنل مدیریت برایت باز می‌شود. تمام تنظیمات از همین‌جا انجام می‌شود.

💡 در گروه‌های فارسی می‌توانی به‌جای پنل بنویسی settings یا /panel.

گام ۴ — روشن کردن چند چیز ضروری

پیشنهاد می‌کنیم همین اول این‌ها را روشن کنی:

گام ۵ — چند چیز که ارزش امتحان دارند

پنل                → پنل مدیریت
/toolbox           → جعبه‌ابزار (ماشین‌حساب، رمزساز، ...)
/dice              → بازی سریع
/vote سؤال | گزینه۱ | گزینه۲
کارت               → پروفایل و سطح من
وضعیت سرور         → منابع سرور

---

۳) پنل مدیریت گروه

با دستور پنل این منو باز می‌شود:

🔐 قفل‌ها (x/59)  |  👮 اعضا
👋 خوشامد          |  📜 قوانین
🛡 ضداِسپم          |  🚪 جوین اجباری
🧩 کپچا            |  📝 قواعد سفارشی
⛔ لیست بن         |  🧹 پاک‌سازی
📊 آمار گروه       |  ⚙️ تنظیمات
🧠 ابزارهای پیشرفته |  🖥 وضعیت سرور
💎 پلن             |  وضعیت: 🟢 فعال
🗑 حذف گروه از ربات

هر دکمه چه کار می‌کند:

• 🔐 قفل‌ها — قلب OPERATOR X. ۵۹ قفل در ۶ دسته. عدد داخل پرانتز نشان می‌دهد

چند قفل روشن است.

• 👮 اعضا — مدیران، کاربران ویژه، برترین‌ها، فعال‌ترین‌ها، لیست اخطارها و

جستجوی کاربر.

• 👋 خوشامد — پیام خوش‌آمدگویی خودکار با متن، عکس، دکمه و متغیر پویا.
• 📜 قوانین — متنی که با دستور قوانین برای اعضا نمایش داده می‌شود.
• 🛡 ضداِسپم — موتور امتیازی تشخیص اسپم، سقف فلود، سقف اخطار و پله‌های سکوت.
• 🚪 جوین اجباری — اجبار به عضویت در کانال‌های دیگر پیش از ارسال پیام.
• 🧩 کپچا — تأیید انسان‌بودن هنگام ورود عضو (دکمه‌ای / ریاضی / سؤالی).
• 📝 قواعد سفارشی — قاعده‌ی خودت بساز: keyword، regex یا domain.
• ⛔ لیست بن — لیست کاربران بن‌شده.
• 🧹 پاک‌سازی — حذف انبوه پیام، پاک‌سازی بن و اخطارها.
• 📊 آمار گروه — تخلفات پرتکرار و فعال‌ترین اعضا.
• ⚙️ تنظیمات — حذف پیام‌های سرویس، حالت سکوت کامل، زبان، بازنشانی.
• 🧠 ابزارهای پیشرفته — ضدحمله، کمپین، بن سراسری، قرعه‌کشی، سطح‌بندی،

فید خبری، بازگردانی، هوش مصنوعی، بازی، پیام دوره‌ای، امنیت.

• 🖥 وضعیت سرور — منابع سرور و وضعیت حالت صرفه‌جویی.
• 💎 پلن — وضعیت اشتراک. (درگاه پرداخت هنوز وصل نیست؛ همه‌ی قابلیت‌ها

الان رایگان باز است.)

---

۴) ۵۹ قفل هوشمند

قفل‌ها در ۶ دسته دسته‌بندی شده‌اند. برای هر قفل می‌توانی اقدام را هم انتخاب کنی که چه اتفاقی برای ناقض بیفتد.

اقدام‌های ممکن

🗑 فقط حذف  |  ⚠️ اخطار  |  🔇 سکوت  |  👢 اخراج  |  ⛔ بن

دسته‌ی ۱ — 🔗 محتوا و متن (۱۱ قفل)

دسته‌ی ۲ — 🖼 مدیا (۱۲ قفل)

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

دسته‌ی ۳ — 👥 قوانین عضویت (۶ قفل)

پیام ورود/خروج عضو، پیام عضو جدید، ورود ربات، فرستنده‌ی کانالی، پیام ناشناس و درخواست جوین.

دسته‌ی ۴ — 💬 رفتار پیام (۹ قفل)

دسته‌ی ۵ — 🔤 زبان و حروف (۱۴ قفل)

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

مثال کاربردی: اگر می‌خواهی اعضا فقط فارسی بنویسند، قفل انگلیسی و عربی را روشن کن. اگر می‌خواهی ایموجی‌بازی را ببندی، قفل ایموجی-فقط را روشن کن.

دسته‌ی ۶ — ✨ موارد دیگر (۷ قفل)

فحش، تبلیغ، اپلیکیشن، تاپیک، گیفت، وب‌اپ و دستکاری (tamper).

میان‌برها

در هر دسته دو دکمه‌ی سریع داری:

⚡️ همه روشن     🌙 همه خاموش

و در خود لیست قفل‌ها، با یک ضربه روی هر قفل، ✅ و ❌ عوض می‌شود.

---

۵) ضداِسپم و کپچا

🛡 ضداِسپم

از پنل → 🛡 ضداِسپم:

موتور ضداِسپم برخلاف ربات‌های ساده، به هر پیام امتیاز می‌دهد. مثلاً لینک + فوروارد + فلود + کاربر تازه = امتیاز بالا = اسپم قطعی.

🧩 کپچا

از پنل → 🧩 کپچا، یکی از سه حالت را انتخاب کن:

🔘 دکمه‌ای   →  «من ربات نیستم» را بزن
🧮 ریاضی     →  مثلاً ۳ + ۵ = ?
❓ سؤالی     →  یک سؤال ساده‌ی فارسی

اگر عضو در مهلت تعیین‌شده تأیید نکند، اقدام انتخابی انجام می‌شود.

---

۶) خوشامد و خداحافظی

از پنل → 👋 خوشامد:

متغیرهای پویا

این‌ها را داخل متن بگذار و OPERATOR X خودش پر می‌کند:

{FIRST_NAME}   نام کوچک عضو
{LAST_NAME}    فامیل
{USERNAME}     یوزرنیم
{MENTION}      منشن عضو
{CHAT_NAME}    نام گروه
{MEMBER_COUNT} تعداد اعضا
{DATE}         تاریخ
{TIME}         ساعت

مثال متن خوشامد:

سلام {MENTION} 👋
به {CHAT_NAME} خوش آمدی!
تو عضو شماره‌ی {MEMBER_COUNT} هستی.
لطفاً قوانین را بخوان.

---

۷) جوین اجباری و قوانین

🚪 جوین اجباری

از پنل → 🚪 جوین اجباری. آیدی کانال‌ها را وارد کن (هر خط یکی). OPERATOR X چک می‌کند آیا عضو آن‌ها هست یا نه، و نتیجه را کَش می‌کند تا از سهمیه‌ی تلگرام هدر نرود.

نحوه‌ی وارد کردن:

@MyChannel
@AnotherChannel

۸) ابزارهای پیشرفته

از پنل → 🧠 ابزارهای پیشرفته:

🚨 ضدحمله      |  🕵️ کمپین‌ها
🌐 بن سراسری   |  🎁 قرعه‌کشی
🏅 سطح و پروفایل |  📰 فید خبری
♻️ بازگردانی   |  🖥 وضعیت سرور
🤖 هوش مصنوعی  |  🎮 بازی و سرگرمی
🔁 پیام دوره‌ای |  🛡 امنیت گروه

🚨 ضدحمله (Anti-Raid)

موج ورود اعضای جدید را می‌شناسد.

یعنی اگر ۱۰ نفر در یک دقیقه عضو شوند، OPERATOR X گروه را قفل می‌کند و نیم ساعت بعد خودش بازش می‌کند.

🕵️ کشف کمپین تبلیغاتی

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

🌐 بن سراسری (فدراسیون)

یک بار بن = بن در همه‌ی گروه‌های OPERATOR X.

روی پیام کاربر ریپلای کن و بنویس:
بن سراسری دلیل تبلیغ

برای رفع (فقط مالک):
رفع بن سراسری

🏅 سطح، دستاورد و اعتبار

هر پیام تجربه (XP) می‌دهد. ضدفارم گذاشته شده تا کسی با اسپم سطح نگیرد.

۱۲ دستاورد قابل باز کردن: اولین پیام، ۱۰ پیام، ۱۰۰ پیام، ۱۰۰۰ پیام، سطح ۵، سطح ۱۰، سطح ۲۵، دعوت ۱ نفر، دعوت ۱۰ نفر، جایزه‌ی ۷ روز پیاپی، جایزه‌ی ۳۰ روز پیاپی، و ۱۰ اعتبار.

🎁 قرعه‌کشی

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

📰 فید خبری خودکار

یک آدرس RSS بده؛ خبرهای تازه خودکار و بی‌تکرار در گروه منتشر می‌شوند. پارسر داخلی است و به سرویس بیرونی وابسته نیست.

♻️ بازگردانی اقدام (Undo)

اشتباهاً کسی را بن کردی؟ بنویس:

برگردان

وضعیت قبلی برمی‌گردد.

🖥 پایش سلامت سرور

ربات CPU/RAM/دیسک را می‌خواند. اگر سرور تحت فشار باشد، خودکار حالت صرفه‌جویی می‌گیرد و کارهای سنگین را عقب می‌اندازد تا سرویس‌های دیگر آسیب نبینند.

---

۹) هوش مصنوعی

⚠️ پیش‌فرض کاملاً خاموش است. تا خودت روشن نکنی، هیچ درخواستی به هیچ سرویسی فرستاده نمی‌شود و هیچ هزینه‌ای ایجاد نمی‌شود.

فعال‌سازی در گروه

از پنل → 🧠 ابزارهای پیشرفته → 🤖 هوش مصنوعی → وضعیت را 🟢 روشن کن.

سه راه صدا زدن ربات

1. کلمه‌ی فراخوانی — مثلاً هوشی سلام، حالا چطوری؟
2. ریپلای روی پیام ربات — روی پیام OPERATOR X ریپلای کن
3. منشن ربات — @YourBot سلام

تنظیمات موجود

حافظه

OPERATOR X چند پیام آخر هر کاربر را یادش می‌ماند، پس می‌توانی ادامه‌ی گفتگو را بپرسی. حافظه خودکار هرس می‌شود تا دیتابیس بزرگ نشود.

🔐 نکات امنیتی کلیدها

• هیچ کلیدی داخل کد نیست. فقط از فایل .env روی سرور خوانده می‌شود.
• کلید هرگز در لاگ، دیتابیس یا پیام چاپ نمی‌شود.
• می‌توانی به‌جای سرویس‌های گران، یک مدل محلی روی همان سرور وصل کنی

(Ollama / vLLM) که هزینه‌ی API ندارد.

• سقف روزانه‌ی سراسری و کاربری جلوی هزینه‌ی غیرمنتظره را می‌گیرد.

---

۱۰) بازی و سرگرمی

از پنل → 🎮 بازی و سرگرمی یا مستقیم با دستور:

امتیاز همه‌ی بازی‌ها ذخیره می‌شود و در /gametop دیده می‌شود.

مسابقه (/quiz) از یک بانک سؤال فارسی استفاده می‌کند و غلط املایی جزئی را می‌بخشد — پس تهرون هم به‌عنوان تهران قبول می‌شود.

---

۱۱) سیستم تیکت

عضو در گروه می‌نویسد:

/ticket سلام، نمی‌توانم وارد حسابم شوم

OPERATOR X تیکت را می‌گیرد و به پیوی مالک می‌فرستد. مالک همان‌جا روی ✍️ پاسخ می‌زند، جواب را می‌نویسد، و ربات پاسخ را به عضو می‌رساند.

دکمه‌های پنل تیکت

✍️ پاسخ   |   📜 تاریخچه
🔒 بستن

دستورها

---

۱۲) نظرسنجی و یادآور

📊 نظرسنجی

/vote کدام گزینه بهتر است؟ | گزینه اول | گزینه دوم | گزینه سوم

• نمودار میله‌ای زنده
• رأی ناشناس یا علنی
• رأی چندگانه
• تغییر رأی (روی گزینه‌ی دیگر بزن)
• لغو رأی (روی همان گزینه‌ی قبلی بزن)
• بستن خودکار در زمان تعیین‌شده

⏰ یادآور

/remind 30m جلسه دارم

واحدها: s ثانیه، m دقیقه، h ساعت، d روز. سررسید که شد، OPERATOR X در گروه تگت می‌کند.

---

۱۳) امنیت و گزارش

از پنل → 🧠 ابزارهای پیشرفته → 🛡 امنیت گروه.

هشدار امنیتی فوری

OPERATOR X این رویدادها را فوری به پیوی تو می‌فرستد:

افزودن ادمین      |  حذف ادمین
سلب دسترسی ربات   |  اخراج ربات
تغییر تنظیمات     |  حذف انبوه
ورود مشکوک

هر هشدار یک شدت دارد:

ℹ️ اطلاع   |   ⚠️ هشدار   |   🚨 بحرانی

گزارش روزانه

هر روز ساعت ۹ صبح یک خلاصه از همه‌ی گروه‌هایت در پیوی‌ات می‌آید: تعداد اعضا، ورود و خروج، تخلفات و مجموع کل.

پیام دوره‌ای

از پنل → 🔁 پیام دوره‌ای: متنی بنویس و بازه‌ی زمانی بده (مثلاً هر ۱۸۰ دقیقه). OPERATOR X قوانین یا هر پیام دیگری را خودکار در گروه می‌فرستد.

---

۱۴) جعبه‌ابزار

ابزارهای کاربردی که کاملاً روی همان سرور اجرا می‌شوند — بدون هیچ کلید، هیچ سرویس بیرونی و هیچ هزینه‌ای.

ماشین‌حساب امن است: از eval استفاده نمی‌کند؛ ورودی با ast پارس می‌شود و فقط عملیات ریاضی مجاز عبور می‌کنند. پس تزریق کد ممکن نیست.

مثال‌های ماشین‌حساب:

/calc (2+3)*4          →  20
/calc sqrt(16)+2**3    →  12
/calc 10/4             →  2.5
/calc ۱۲×۳             →  36

تبدیل واحد:

/تبدیل 10 km mi        →  6.21371 mi
/تبدیل 1 kg g          →  1000 g
/تبدیل 100 cm m        →  1 m

---

۱۵) فهرست کامل دستورات

مدیریت (ریپلای + دستور)

عمومی

پیشرفته

هوش مصنوعی، بازی و ابزار

---

۱۶) پلن‌ها

✅ همه‌ی ۵۹ قفل در حال حاضر روی پلن رایگان فعال‌اند. هیچ قابلیتی پشت دیوار پرداخت نیست.

بخش پلن‌ها در پنل (💎) وجود دارد و ساختار آن آماده است، ولی درگاه پرداخت هنوز وصل نشده. اگر روی دکمه‌ی خرید بزنی، این پیام را می‌بینی:

درگاه پرداخت در نسخه‌ی بعدی وصل می‌شود ✨

هر پلنی که در آینده تعریف شود، از این جدول پیروی می‌کند:

تا آن زمان، همه‌ی قفل‌ها برای همه باز است و لازم نیست کاری کنی.

---

۱۷) سؤالات پرتکرار

ربات را اضافه کردم ولی چیزی پاک نمی‌کند. ربات باید ادمین باشد و دسترسی Delete Messages داشته باشد.

پنل برای بقیه‌ی اعضا هم باز می‌شود؟ نه. پنل تنظیمات فقط برای مالک و مدیران باز می‌شود. اعضای عادی در پیوی فقط منوی ساده‌ی کاربری را می‌بینند.

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

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

اگر ربات را از گروه حذف کنم چه می‌شود؟ OPERATOR X این را فوری به تو اطلاع می‌دهد. داده‌های گروه از OPERATOR X حذف نمی‌شود و با افزودن دوباره، برمی‌گردد.

پیام‌های قدیمی را چطور پاک کنم؟ از پنل → 🧹 پاک‌سازی یا دستور حذف 100.

فارسی بنویسم یا انگلیسی؟ هر دو کار می‌کند. همه‌ی دستورها معادل فارسی دارند.

چند نفر می‌توانند مدیر ربات باشند؟ هر تعداد. مدیر ربات با مدیر (ریپلای) اضافه می‌شود.

کاربر ویژه چیست؟ کاربری که از همه‌ی قفل‌ها معاف است — مناسب برای مدیران و اعضای قابل اعتماد.

باید پلن بخرم تا قفل‌ها کار کنند؟ نه. همه‌ی ۵۹ قفل همین حالا و رایگان کار می‌کنند. بخش پلن فقط ساختار آماده برای آینده است و درگاه پرداخت هنوز وصل نشده.

---

۱۸) رفع اشکال

ربات جواب نمی‌دهد

1. در گروه بنویس آیدی — اگر جواب داد، ربات سالم است.
2. اگر جواب نداد، ربات ادمین نیست یا از گروه حذف شده.
3. وضعیت سرور را بزن و منابع را چک کن.

قفل کار نمی‌کند

1. مطمئن شو قفل در پنل ✅ است (نه ❌).
2. مطمئن شو ربات ادمین با دسترسی Delete Messages است.
3. مطمئن شو کاربر مورد نظر ویژه نیست (کاربران ویژه از قفل معاف‌اند).

کپچا نمی‌آید

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

هوش مصنوعی جواب نمی‌دهد

1. در گروه: پنل → ابزارهای پیشرفته → 🤖 هوش مصنوعی → وضعیت باید 🟢 باشد.
2. روی سرور، AI_ENABLED=true باید در .env باشد.
3. سقف روزانه را چک کن: 📈 مصرف هوش مصنوعی.

پیام خوشامد نمی‌آید

1. وضعیت خوشامد باید 🟢 باشد.
2. ربات باید دسترسی Invite Users داشته باشد.
3. با 👁 پیش‌نمایش متن را چک کن.

---

📞 پشتیبانی

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

---

«OPERATOR X ۱.۰» — ساخته‌شده برای اینکه مدیریت گروه دیگر وقت‌گیر نباشد.

---

🖥 نصب و راه‌اندازی روی سرور

راهنمای کامل نصب، بروزرسانی، پشتیبان‌گیری و انتقال به سرور دیگر.

نسخه ۱.۰ — سه روش نصب، از ساده تا حرفه‌ای.

---

پیش‌نیازها

💡 OPERATOR X در حالت long polling کار می‌کند، پس هیچ پورتی باز نمی‌کند، به دامنه و SSL نیازی ندارد، و با پروژه‌های دیگر روی همان سرور تضاد ندارد.

---

روش ۱ — نصب دستی (ساده‌ترین، بدون توکن در آرگومان)

گام ۱: آپلود کد

# آرشیو را آپلود کن
scp -P 22 guardian-1.0.0.tar.gz root@YOUR_IP:/tmp/

# باز کن
mkdir -p /opt/guardian
tar -xzf /tmp/guardian-1.0.0.tar.gz -C /opt/guardian
cd /opt/guardian

گام ۲: ساخت کاربر و محیط

useradd --system --no-create-home --shell /usr/sbin/nologin guardian
python3 -m venv /opt/guardian/.venv
/opt/guardian/.venv/bin/pip install -r requirements.txt

گام ۳: تنظیمات

cp .env.example .env
nano .env

حداقل چیزی که باید پر کنی:

BOT_TOKEN=توکن-ربات-از-BotFather
OWNER_IDS=آیدی-عددی-خودت

سپس فایل را امن کن:

chmod 600 .env
chown -R guardian:guardian /opt/guardian

گام ۴: سرویس systemd

cat > /etc/systemd/system/guardian.service <<'EOF'
[Unit]
Description=Guardian Telegram Group/Channel Manager Bot
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=guardian
Group=guardian
WorkingDirectory=/opt/guardian
ExecStart=/opt/guardian/.venv/bin/python run.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now guardian

گام ۵: بررسی

systemctl status guardian
journalctl -u guardian -n 30 --no-pager

باید این پیام را ببینی:

ربات آماده است ✅

---

روش ۲ — نصب خودکار (توصیه‌شده)

OPERATOR X یک نصب‌کننده‌ی تعاملی دارد که توکن را مخفی می‌پرسد و از آرگومان دستور عبور نمی‌دهد (تا در تاریخچه‌ی شل نماند):

cd /opt/guardian
bash deploy/install.sh

و برای ثبت یا تغییر توکن در آینده:

bash deploy/set-tokens.sh

---

روش ۳ — نصب از ویندوز (با اسکریپت PowerShell)

اگر روی ویندوز کار می‌کنی، این اسکریپت همه‌چیز را خودکار انجام می‌دهد — آپلود، نصب، ساخت سرویس و راه‌اندازی:

.\deploy\deploy.ps1 -Server root@YOUR_IP -Port 22

---

بروزرسانی نسخه

نسخه‌ی جدید را روی همان مسیر آپلود کن و فقط این‌ها را اجرا کن:

cd /opt/guardian
# فایل‌های جدید را کپی کن، سپس:
.venv/bin/pip install -r requirements.txt
chown -R guardian:guardian /opt/guardian
systemctl restart guardian

✅ داده‌هایت از دست نمی‌رود. OPERATOR X ستون‌های تازه‌ی دیتابیس را هنگام بالا آمدن خودکار اضافه می‌کند و در لاگ می‌نویسد «افزودن ستون جدید».

---

پشتیبان‌گیری

دیتابیس در حالت WAL است، پس کپی خام با cp می‌تواند فایل خراب بدهد. از ابزار داخلی استفاده کن:

cd /opt/guardian
sudo -u guardian .venv/bin/python tools/backup_db.py data/bot.db --stats

برای گرفتن فایل پشتیبان:

sudo -u guardian .venv/bin/python tools/backup_db.py data/bot.db /tmp/backup.db

---

انتقال به سرور دیگر

اگر سرور سنگین شد و خواستی همه‌چیز را روی سرور تازه ببری:

.\deploy\migrate.ps1 -From root@OLD_IP -FromPort 22 -To root@NEW_IP -CopyEnv

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

---

دستورات مفید

---

عیب‌یابی

سرویس بالا نمی‌آید

journalctl -u guardian -n 40 --no-pager

معمول‌ترین دلیل: BOT_TOKEN در .env خالی یا نامعتبر است.

خطای «readonly database»

chown -R guardian:guardian /opt/guardian/data /opt/guardian/logs
chmod 750 /opt/guardian/data /opt/guardian/logs
systemctl restart guardian

تداخل توکن

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

grep BOT_TOKEN /opt/guardian/.env | cut -d: -f1

تست سلامت قبل از راه‌اندازی

cd /opt/guardian
sudo -u guardian .venv/bin/python -m tools.selfcheck

---

امنیت

OPERATOR X با چند قاعده‌ی سخت طراحی شده:

• هیچ کلیدی داخل کد نیست — همه‌چیز از .env خوانده می‌شود.
• .env باید chmod 600 باشد و تنها برای root قابل خواندن.
• توکن هرگز در لاگ، آرگومان دستور یا دیتابیس نوشته نمی‌شود.
• هوش مصنوعی پیش‌فرض خاموش است؛ تا روشن نکنی هیچ درخواست بیرونی نمی‌رود.

---

«OPERATOR X ۱.۰» — ساخته‌شده برای اینکه مدیریت گروه دیگر وقت‌گیر نباشد.