قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

اعتبارًا من 10 أكتوبر 2026، يُدرج موقع PyPI الإصدار 2.13.1 من مكتبة Simple-Matrix-Bot-Lib، الصادر في 29 مارس 2026. تتطلب هذه الحزمة Python 3.9 أو أحدث، ولكن دعم Python 3.9 قد انتهى؛ لذا يُنصح باستخدام إصدار Python مدعوم ومتوافق مع الحزمة. لا تزال وثائق المشروع المُستضافة تُشير إلى الإصدار 2.11.0 وتُحذّر من عدم تحديثها، لذلك يتبع هذا الدليل مثال PyPI الحالي لواجهة برمجة تطبيقات البوت، ويستخدم الدليل القديم فقط لملاحظات التكوين المُوضّحة بوضوح. يُرجى مراجعة إصدار الحزمة وبياناتها الوصفية على PyPI ، والاطلاع على حالة توثيق المشروع .

أسرع إعداد موثوق به هو مستخدم مخصص لبرنامج Matrix، وبيئة افتراضية بلغة Python، وبرنامج روبوت صغير يستجيب !echoفي غرفة اختبار. هذا المثال لغرفة غير مشفرة؛ أما الغرف المشفرة فتتطلب إعدادات إضافية.

ما الذي تحتاجه قبل تثبيت المكتبة؟

أنشئ حسابًا عاديًا على الخادم الرئيسي لتشغيل البوت، أو اطلب إنشاء حساب جديد. اختر له اسم مستخدم مميزًا، مثل echo_bot"اسم المستخدم"؛ فهو لا يحتاج إلى صلاحيات مدير الخادم. قد يكون التسجيل معطلاً أو مقيدًا من قِبل الخادم، لذا اتبع سياسة إنشاء الحسابات الخاصة به. ادعُ الحساب فقط إلى غرفة اختبار خاصة حيث يُسمح له بإرسال الرسائل.

استخدم بايثون 3.11 أو أي إصدار آخر مدعوم حاليًا من بايثون. مع أن بيانات الحزمة لا تزال تسمح باستخدام بايثون 3.9، إلا أن موقع Python.org يُشير إلى انتهاء دعم هذا الإصدار في 31 أكتوبر 2025، لذا فإن الحد الأدنى للإصدار المطلوب ليس توصية جيدة للنشر. راجع إشعار دعم بايثون 3.9 على موقع Python.org .

كيف يتم تثبيت مكتبة Simple-Matrix-Bot-Lib؟

نفّذ هذه الأوامر من مجلد مشروع جديد. تحافظ البيئة الافتراضية على حزم هذا البوت منفصلة عن مشاريع بايثون الأخرى. يضمن تثبيت الإصدار إمكانية إعادة إنتاج المثال باستخدام أحدث إصدار تم التحقق منه لهذه المقالة؛ عند الترقية، تحقق من إصدار PyPI الحالي وملاحظات التوافق الخاصة به.

python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"

في Windows PowerShell، فعّل البيئة باستخدام الأمر .venv\Scripts\Activate.ps1بدلاً من sourceالأمر السابق. ثم أنشئ ملفًا باسم bot.py. توثّق صفحة مشروع PyPI اسم الحزمة وأمر التثبيت، ويستخدم مثالها المنشور Creds، و Bot، و ، و ، و MessageMatch. راجع مثال الاستخدام الحالي على PyPI .

أوامر الطرفية لإنشاء بيئة افتراضية لـ Python، وتفعيلها، وتثبيت simplematrixbotlib الإصدار 2.13.1
يعرض الطرفية البيئة المعزولة وأوامر تثبيت الحزم المثبتة لمشروع الروبوت.

كيف يتم ربط حساب البوت وإضافة أمر إليه؟

احفظ ما يلي باسم bot.py. سيطلب منك إدخال كلمة مرور البوت عند بدء التشغيل، لذا لن تُكتب كلمة المرور في ملف المصدر. لنشر الخدمة تلقائيًا، اقرأ السر من مدير الأسرار في نظام التشغيل أو من متغير بيئة محمي بدلًا من تضمينه مباشرةً في الكود. تعامل مع أي جلسة أو رمز وصول مخزن بواسطة المكتبة كبيانات اعتماد: احتفظ به خاصًا وخارج نظام التحكم في الإصدارات.

import getpass
import simplematrixbotlib as botlib

creds = botlib.Creds(
    homeserver="https://matrix.example.org",
    username="echo_bot",
    password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"

@bot.listener.on_message_event
async def echo(room, message):
    match = botlib.MessageMatch(room, message, bot, PREFIX)
    if (match.is_not_from_this_bot()
            and match.prefix()
            and match.command("echo")):
        text = " ".join(match.args())
        reply = text or "Usage: !echo <text>"
        await bot.api.send_text_message(room.room_id, reply)

bot.run()

استبدل عنوان URL الخاص بخادم المنزل (المثال) بعنوان URL الأساسي لخادمك، واستخدم اسم المستخدم وكلمة المرور لحساب البوت. يستقبل المستمع رسائل الغرفة، MessageMatchويتجاهل رسائله الخاصة، ويتعامل فقط مع !echoالأمر المطلوب. تُعيد استدعاءات واجهة برمجة التطبيقات (API) الكلمات المتبقية إلى نفس الغرفة. تتبع هذه الأسماء واستدعاءات الدوال مثال PyPI المنشور للمكتبة. قارن ذلك مع دليل البدء السريع لمكتبة Simple-Matrix-Bot-Lib .

محرر بايثون يعرض عمليات الاستيراد، وموجه getpass، وبيانات اعتماد خادم Matrix الرئيسي وecho_bot، وتهيئة البوت
تستخدم كتلة بيانات الاعتماد حسابًا مخصصًا وتطلب كلمة المرور الخاصة به بدلاً من وضع السر في الملف.
محرر بايثون يعرض مستمع حدث on_message_event، وفحوصات MessageMatch، واستدعاء send_text_message
يتجاهل المعالج رسائل الروبوت نفسه، ويطابق أمر !echo، ويرسل وسائطه مرة أخرى إلى الغرفة.

كيف تقوم بتشغيل البوت والتأكد من أنه يعمل؟

من البيئة الافتراضية المُفعّلة، قم بتشغيل ما يلي:

python bot.py

أدخل كلمة مرور حساب البوت عند المطالبة. في غرفة الاختبار، أرسل رسالة !echo hello. سيرد بوت أساسي يعمل بشكل صحيح hello. إذا لم يرد، فتأكد من انضمام حساب البوت إلى تلك الغرفة، وأن المستخدم لديه إذن لإرسال الرسائل هناك، وأن عنوان URL الخاص بالخادم الرئيسي صحيح، وأن الرسالة تبدأ بالبادئة الصحيحة !. أبقِ العملية قيد التشغيل؛ إغلاق نافذة الأوامر الخاصة بها يوقف هذا النشر البسيط في المقدمة.

غرفة اختبار على غرار فيلم ماتريكس تعرض @you:example.org إرسال !echo hello و @echo_bot:example.org الرد بـ hello
تُظهر محادثة نموذجية في الغرفة الطلب والرد المتوقعين لأمر الصدى؛ إنها مجرد توضيح، وليست نتيجة اختبار مباشر.

لا تعالج هذه العينة رسائل الغرف المشفرة تشفيرًا تامًا. تُعلن المكتبة عن دعمها للتشفير التام، لكن دليلها المُستضاف حاليًا يحمل الإصدار 2.11.0 وقد يكون قديمًا؛ إذ يصف هذا الدليل matrix-nio[e2e]تبعيات إضافية وإعدادًا Config.encryption_enabled. تأكد من خطوات التثبيت والتحقق الدقيقة للإصدار الذي تُثبّته قبل تفعيل التشفير. تُتيح الوثائق القديمة أيضًا إعدادًا join_on_invite؛ ادعُ الروبوت فقط إلى الغرف التي يجب أن يصل إليها، وتحقق من هذا الإعداد إذا كان نظامك يتطلب التحكم في عمليات الانضمام التلقائي إلى الغرف. راجع دليل التشفير التام والتكوين الخاص بالمكتبة .

يكتمل الإعداد عندما يبقى الروبوت مسجلاً دخوله، وعضواً في غرفة الاختبار، ويستجيب !echo helloبـ hello. أما في بيئة الإنتاج، فيُشغّل تحت إدارة العمليات، ويجب حماية كلمة المرور وبيانات الجلسة الخاصة به.

اترك تعليقاً

رفع حد ملفات Systemd في Synapse بدون تخمين

رفع حد ملفات Systemd في Synapse بدون تخمين

قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.

تنظيف رسائل Synapse القديمة والوسائط دون فقدان البيانات

استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.

استعادة مساحة قرص Synapse Media دون الإضرار بالملفات المشتركة

ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

راجع نشاط الجهاز، وقم بتعطيل حسابات Synapse غير النشطة المؤكدة من خلال واجهة برمجة تطبيقات المسؤول، وتعرف على ما الذي تزيله علامة المسح الاختيارية فعليًا.

تقليل الضغط على ذاكرة PostgreSQL في Matrix Synapse

حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.

إغلاق عمليات التسجيل في ماتريكس أو طلب رموز دعوة على سينابس

أوقف إنشاء الحسابات المفتوحة على خادم Synapse المستضاف ذاتيًا، أو اجعل عمليات التسجيل مقتصرة على الدعوات فقط باستخدام رموز تسجيل محدودة الاستخدام.