hangoutsbot

مقدمة

Hangupsbot عبارة عن روبوت دردشة مصمم للعمل مع Google Hangouts.

يرجى الاطلاع على:

• تعليمات التثبيت
• أداة تعقب الأخطاء والمشاكل وطلبات الميزات
• ويكي لكل شيء آخر

روابط المستودع

• منظمة جيثب
• مشروع الترجمة
• مكتبة Hangups المرجعية

سمات

• الإشارات : إذا ذكرك شخص ما في غرفة ما، يمكنك الحصول على جلسة Hangout خاصة من الروبوت تحتوي على تفاصيل حول الإشارة، بما في ذلك السياق والغرفة والشخص الذي ذكرك.
• المزامنة : المزامنة عبارة عن محادثتين جماعيتين على Hangout يتم إعادة توجيه رسائلهما إلى بعضهما البعض، مما يسمح بالتفاعل السلس بين الغرفتين. يُستخدم بشكل أساسي للتغلب على حد الدردشة البالغ 150 عضوًا، ولكن يمكن استخدامه أيضًا لربط الفرق معًا بشكل مؤقت للتفاعل.
• Syncouts عبر الدردشة : نصف فريقك يستخدم Slack؟ لا مشكلة! يمكنك ربطهم في نفس الغرفة للتواصل. الدعم لعملاء الدردشة الآخرين قريبا.
• تكامل Hubot : يتيح لك Hangupsbot الاتصال بـ Hubot، مما يوفر لك الوصول على الفور إلى مئات من أدوات الدردشة والمكونات الإضافية المطورة.
• المكونات الإضافية والمغاسل : يحتوي الروبوت على تعليمات لتطوير المكونات الإضافية والمغاسل الخاصة بك، مما يسمح للروبوت بالتفاعل مع الخدمات الخارجية مثل موقع الويب الخاص بشركتك، والنصوص البرمجية لـ Google وغير ذلك الكثير.
• هوس المكونات الإضافية : الألعاب، ودعم الأسماء المستعارة، والكلمات الرئيسية المشتركة، وواجهة برمجة التطبيقات القابلة للتخصيص - والقائمة تطول !

تشغيل البوت

ملحوظة: أول تشغيل؟ راجع تعليمات التثبيت

للتنفيذ: python3 hangupsbot.py

 usage: hangupsbot [-h] [-d] [--log LOG] [--cookies COOKIES] [--memory MEMORY] [--config CONFIG] [--version]

optional arguments:
-h, --help         show this help message and exit
-d, --debug        log detailed debugging messages (default: False)
--log LOG          log file path (default:
                   ~/.local/share/hangupsbot/hangupsbot.log)
--cookies COOKIES  cookie storage path (default:
                   ~/.local/share/hangupsbot/cookies.json)
--memory MEMORY    memory storage path (default:
                   ~/.local/share/hangupsbot/memory.json)
--config CONFIG    config storage path (default:
                   ~/.local/share/hangupsbot/config.json)
--version          show program's version number and exit

تكوين بوت للمسؤولين

يمكن تحديد توجيهات التكوين في config.json .

يرجى ملاحظة أن ملف config.json المرفق مع المستودع ليس من المفترض أن يتم تعديله/تغييره. إنه الملف المرجعي الذي يستخدمه الروبوت لإنشاء ملف التكوين الفعلي الموجود في مكان آخر في النظام. لمعرفة مكان وجود الملف الفعلي، يرجى مراجعة قسم التكوين الإضافي في تعليمات التثبيت.

يتم تحديد معظم توجيهات التكوين عالميًا

• يتم دائمًا تحديد التوجيهات العامة في "جذر" الملف config.json .
• لتحديد توجيه لكل محادثة، يجب تعريف خيار التكوين نفسه على أنه config.conversations[<conversation-id>].<configuration option> .
• تتجاوز التوجيهات لكل محادثة الإعدادات العامة، إذا تم تعيين كليهما.
• تم إهمال التوجيهات التي تم تكوينها يدويًا لكل محادثة.

الإضافات

يتيح لك مفتاح plugins في config.json تحديد قائمة المكونات الإضافية التي سيتم تحميلها بواسطة الروبوت عند بدء التشغيل. إذا تم ترك هذا الخيار كـ null ، فسيتم تحميل جميع المكونات الإضافية المتاحة.

لتحديد المكونات الإضافية المراد تحميلها، تأكد أولاً من وجود ملفات .py الصحيحة داخل دليل hangupsbot/plugin/ ، ثم قم بتعديل مفتاح plugins في config.json ليعكس المكونات الإضافية/الملفات التي تريد تحميلها، على سبيل المثال plugins: ["mentions", "default", "chance", "syncrooms"]

قد تتطلب بعض المكونات الإضافية تكوينًا إضافيًا. config.json هو موفر التكوين للروبوت ومكوناته الإضافية.

بعض الإضافات المثيرة للاهتمام:

• يذكر البرنامج المساعد
  • تنبيه المستخدمين عند ذكر أسمائهم في الدردشة
• الاشتراك في البرنامج المساعد
  • تنبيه المستخدمين عند قول الكلمات الرئيسية التي اشتركوا فيها في الدردشة
• syncout / syncrooms الإضافات
  • ترحيل رسائل الدردشة بين محادثات مجموعة Hangout المختلفة (المزامنة)
  • التكوين عبر أوامر الروبوت (syncrooms_config)
  • الترجمة الآلية عبر ترجمة Google للرسائل المرسلة (syncrooms_autotranslate)

يحتوي موقع wiki على قائمة أكثر شمولاً من المكونات الإضافية ...

التفاعل مع البوت

هناك نوعان عامان من التفاعلات مع الروبوت:

• تبدأ أوامر /bot بـ /bot على سبيل المثال /bot dosomething
  • بعض أوامر الروبوت تكون للمسؤول فقط
• التفاعلات المخصصة (يختلف الاستخدام وإمكانية الوصول حسب البرنامج المساعد)

يدعم الروبوت الأساسي بعض الأوامر الأساسية حتى بدون تحميل أي مكونات إضافية. فيما يلي قائمة جزئية:

/bot help

• يسرد الروبوت جميع الأوامر المدعومة في رسالة خاصة مع المستخدم

/bot ping

• يرد الروبوت pong .

/bot version

• يرد الروبوت برقم إصدار إطار العمل

تتوفر قائمة كاملة بالأوامر التي يدعمها الإطار الأساسي على صفحة Wiki الخاصة بالأوامر الأساسية .

يحتوي موقع wiki أيضًا على قائمة بالمكونات الإضافية التي توضح بالتفصيل المكونات الإضافية المتاحة مع قوائم الأوامر والاستخدام.

تحديث

• انتقل إلى دليل الروبوت (على سبيل المثال cd ~/hangupsbot )
• قم بالتغيير إلى أحدث فرع ثابت باستخدام git checkout master
• git pull لسحب أحدث إصدار من Hangupsbot
• pip3 install -r requirements.txt --upgrade
• أعد تشغيل البوت

تصحيح الأخطاء

• قم بتشغيل الروبوت باستخدام المعلمة -d ، على سبيل المثال python3 hangupsbot.py -d - يؤدي هذا إلى خفض مستوى السجل إلى INFO للحصول على ملف سجل أكثر تفصيلاً وإفادة.
• tail ملف السجل، والذي من المحتمل أن يكون موجودًا في /<user>/.local/share/hangupsbot/hangupsbot.log - يختلف الموقع حسب التوزيعة!
• يكون إخراج وحدة التحكم (STDOUT) محدودًا إلى حد ما مهما كان مستوى السجل، لذا اعتمد على إخراج ملف السجل بدلاً من ذلك.

نصائح لاستكشاف الأخطاء وإصلاحها

البرنامج لا يعمل:

• تحديث hangupsbot و hangups
• قم بتشغيل hangups للتحقق مما إذا كانت مكتبة عمليات قطع الاتصال الأصلية تعمل أم لا
  • إذا كانت هناك أخطاء، فاحذف ملف تعريف الارتباط الموجود على ``~/.local/share/hangupsbot/cookies.json` وحاول مرة أخرى
  • قم بتسجيل الدخول إلى حسابك في Google من عنوان الخادم.

البوت لا يستجيب للرسائل:

• تأكد من أن الدردشات لا تنتقل إلى قسم "الدعوات" في Hangouts.

تمديد

يرجى الاطلاع على https://github.com/hangoutsbot/hangoutsbot/wiki/Authoring-Bot-Extensions

الاعتمادات / التاريخ

تم اشتقاق Hangoutsbot من روبوت mogunsamang، والذي يعد بحد ذاته فرعًا من برنامج Hangupsbot الخاص بـ xmikos

في 20 يونيو 2015، تم فصل هذه الشوكة وجعلها مستقلة على GitHub

في 03/07/2015، تم تحويل الشوكة إلى منظمة جيثب