Jared

روابط التحميل

يرجى مراجعة صفحة الإصدار للحصول على تنزيل مُحدث مُجمَّع مسبقًا.

ما هو جاريد؟

روبوت iMessage قوي وقابل للتوسعة بسهولة. يجعل من الممكن إضافة ميزات روبوت الدردشة إلى أي محادثة iMessage. يتضمن بعض الأوامر الأساسية المضمنة. يمكن إضافة عمليات تكامل واجهة برمجة التطبيقات والألعاب والرموز التعبيرية المخصصة وغير ذلك الكثير باستخدام خطافات الويب أو REST API أو عن طريق تثبيت المكونات الإضافية.

أي طلبات سحب ومشكلات GitHub الجديدة موضع تقدير كبير! إذا كنت ترغب في تطوير مكون إضافي لـ Jared، راجع قسم المكون الإضافي أدناه. أنا متاح دائمًا على تويتر إذا كان لديك أي أفكار/اقتراحات.

تثبيت

يجب أن يقوم جاريد بتشغيل جهاز يعمل بنظام macOS مع تسجيل دخول بحساب رسائل نشط. وقد تم اختباره فقط على الإصدار 10.14 Mojave والإصدارات الأحدث. قد يعمل على الإصدارات القديمة من نظام التشغيل macOS ولكن هذا غير مضمون لأنه قد تكون هناك تغييرات في مخطط قاعدة بيانات الرسائل. إذا كنت لا تريد أن يقوم جاريد بالنشر باسمك، فمن المستحسن أن تقوم بإنشاء معرف Apple جديد وحساب مستخدم على جهاز Mac الخاص بك، وتشغيله في الخلفية تحت هذا المستخدم. بهذه الطريقة لا يستخدم معرف Apple الرئيسي الخاص بك.

1. قم بتنزيل Jared.app وانقله إلى مجلد التطبيقات.

راجع قسم التنزيل في الأعلى.

2. قم بتشغيل Jared.app، واسمح لـ Jared "بالوصول الكامل إلى القرص" في تفضيلات النظام.

يعد هذا مطلوبًا بسبب أذونات macOS التي تحد من الوصول إلى قاعدة بيانات الرسائل.

3. منح الوصول لأتمتة الرسائل

إذا كنت تستخدم نظام التشغيل macOS Catalina أو إصدارًا أحدث، فستحتاج إلى السماح لـ Jared بالوصول لأتمتة تطبيق الرسائل. هذا يسمح لجاريد بإرسال الرسائل.

4. (اختياري) السماح بالوصول إلى جهات الاتصال

يمكنك اختياريًا السماح لـ Jared بالوصول إلى جهات الاتصال الخاصة بك حتى يتمكن من توفير أسماء جهات الاتصال وتحديثها. يتم استخدام جهات الاتصال لتعيين/استرجاع الأسماء فقط.

5. (اختياري) ابدأ تشغيل خادم REST API

إذا كنت ترغب في استخدام REST API، فستحتاج إلى تمكينها. إذا كان لديك جدار حماية ممكّنًا على جهاز Mac الخاص بك، فسترى مربع حوار يطالبك بالسماح لـ Jared بالوصول إلى المنفذ الذي يرتبط به.

المدمج في الأوامر

كمرجع، إليك قائمة بالأوامر المضمنة في جاريد. نظرًا لأنه يمكن إضافة الوظائف باستخدام المكونات الإضافية، تظل الوظائف المضمنة خفيفة.

• /help : يسرد كافة الأوامر. /help,[command name] سيعطيك معلومات حول مسار محدد.
• /reload : إعادة تحميل المكونات الإضافية
• /enable : تمكين جاريد
• /disable : تعطيل جاريد
• /ping : تحقق من توفر برنامج الدردشة الآلي
• /version : احصل على نسخة جاريد قيد التشغيل
• /send : إرسال رسالة بشكل متكرر
• /schedule : جدولة الرسائل
• /name : غيّر ما يناديك به جاريد
• /whoami : احصل على اسمك
• /barf : يُرجع تمثيل json لرسالتك، يُستخدم لتصحيح الأخطاء
• Thank you Jared : شكرا جاريد

إعدادات

يوجد ملف التكوين في ~/Library/Application Support/Jared/config.json والذي يسمح لك بما يلي:

• تكوين خطافات الويب
• قم بتعيين منفذ REST API
• تعطيل طرق محددة

راجع config-sample.json للحصول على مثال.

ملحقات

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

الإضافات

يمكن إضافة مسارات إضافية عبر المكونات الإضافية المعيارية، المكتوبة بلغة Swift الأصلية. يتم تحميل المكونات الإضافية ديناميكيًا من المجلد ~/Library/Application Support/Jared/Plugins . لتثبيت وحدة، اسحبها هناك ثم أرسل /reload إلى Jared، أو انقر فوق Reload Plugins في واجهة المستخدم.

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

خطافات الويب

يدعم جاريد خطافات الويب لإرسال معلومات الخادم الخاص بك حول الرسائل الواردة والصادرة. يمكن لخادمك الاستجابة لهذه الطلبات لإرسال الرسائل، أو استخدام REST API لإرسال الرسائل في أي وقت. لتكوين خطافات الويب، قم بإضافتها إلى config.json المذكور أعلاه. لمزيد من المعلومات حول واجهة برمجة تطبيقات webhooks، راجع وثائق webhook.

واجهة برمجة تطبيقات REST

يحتوي جاريد على خادم ويب مزود بواجهة برمجة تطبيقات REST التي يمكن تمكينها. يتيح لك ذلك تقديم طلبات HTTP لإرسال رسائل إلى أي مستلم. لمزيد من المعلومات، راجع وثائق REST API.

كيف يعمل جاريد

يقرأ جاريد من قاعدة بيانات الرسائل على فترات زمنية محددة ويستعلم عن الرسائل الجديدة. فهو يوفر إطار توجيه للتعامل مع الرسائل، ويستخدم AppleScript لإرسال الرسائل الصادرة. كما أنها متعددة الخيوط حتى تتمكن من التعامل مع طلبات متعددة في وقت واحد. يسمح جاريد بالتوسع عبر ملفات البرنامج المساعد .bundle وخطافات الويب وواجهة برمجة تطبيقات REST. يسمح هذا بإضافة الأوامر دون تعديل قاعدة كود جاريد الرئيسية.

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