دليل phongent: التحكّم فعدة تيليفونات باستعمال iPhone ولا Android

شنو هو phongent

phongent هو مشروع للتحكّم والتنسيق بين عدة أجهزة Agent. كيخلّيك تستعمل اللغة الطبيعية باش توزّع المهام على جميع الأجهزة، ولا على مجموعة معيّنة، ولا على جهاز محدد، وتشوف فواجهة وحدة تقدّم التنفيذ، والنتائج، والإشعارات، والشاشة المباشرة ديال أجهزة Android.

كل من iOS وAndroid يقدرو يكونو جهاز التحكّم الرئيسي، باش يربطو ويدبّرو أجهزة Android اللي كتّنفّذ. بجوج كيدعمو توزيع المهام، مشاهدة النتائج، تدبير الرسائل، النافذة المصغّرة المباشرة، والتدخّل اليدوي؛ غير Android يقدر ينفّذ مباشرة المهام ديال التطبيقات فالجهاز ديالو.

ملاحظة: iOS دابا غير جهاز تحكّم كيربط بأجهزة Android المنفّذة، وما كيقدرش ينفّذ مهام تطبيقات iPhone فالجهاز نفسو.

الوظائف الرئيسية

• توزيع المهام على عدة أجهزة: ضغط مطوّل على الجهاز ووصف المهمة، ولا خلّي Agent ديال جهاز التحكّم يقرّر بوحدو كيفاش يوزّع المهام على الأجهزة.
• التعاون حسب مجموعات الأجهزة: اختار مجموعة كاملة باش تنفّذ المهام دفعة وحدة، وقدر تعطي مهام مختلفة لمجموعات مختلفة ولا لجهاز واحد داخل المجموعة.
• إنشاء وتوزيع المحتوى: النموذج الرئيسي يقدر ينشئ عدة نصوص وبطاقات مصوّرة نصّية، ومن بعد يبعث كل محتوى للجهاز المناسب، مع إمكانية إرفاق الصور.
• نافذة Android المباشرة: شوف شاشة Android الافتراضية وتدخّل فالتحكّم بالجهاز بالنقر والسحب والكتابة. هاد الخاصية مفعّلة افتراضياً، وقدر تطفيها من الإعدادات.
• المعالجة المركزية للرسائل: رتّب الإشعارات حسب الجهاز والتطبيق ومصدر الرسالة، وخلي Agent ديال جهاز Android المستهدف يجاوب.
• الإعداد المركزي: دبّر الذاكرة، والمهارات، والمهام المبرمجة، ومسارات العمليات، واختار جهاز واحد ولا عدة أجهزة.
• تدبير الاتصال: كيدعم اكتشاف الأجهزة فالشبكة المحلية، والترخيص الأول، والربط بنقرة وحدة، وإعادة الربط من بعد الانقطاع، وتغيير أسماء الأجهزة، وشبكة الأجهزة.

التحضير قبل التثبيت

متطلبات الأجهزة والنظام

• وجد على الأقل جهاز Android واحد باش يكون جهاز التنفيذ.
• جهاز التحكّم يقدر يكون iPhone ولا جهاز Android.
• خاص جهاز التحكّم وأجهزة التنفيذ يكونو مربوطين بنفس الشبكة المحلية.
• أقل إصدار للتثبيت فAndroid هو Android 11، والقدرات الفعلية كتتأثر حتى بإصدار النظام وإعدادات الصلاحيات.
• أقل إصدار للنشر فiOS هو iOS 17، ودابا خاص البناء والتوقيع والتثبيت باستعمال Xcode.

اختيار حزمة التثبيت الصحيحة

مستعملو Android يقدرو يحمّلو phongent.apk من صفحة إصدارات المشروع. استعمل البناء اللي موفّرو مشروع phongent، وما تستعملش APK ديال المشروع الأصلي كبديل، حيث النسخة الأصلية ممكن ما يكونش فيها الواجهات اللازمة للتحكّم الجماعي فعدة أجهزة.

الإعداد والربط بسرعة

1. ثبّت التطبيق. ثبّت APK ديال phongent فالجهاز Android. جهاز iOS الرئيسي خاصو يتبنى ويتوقّع ويتثبّت باستعمال Xcode فmacOS.
2. إعداد جهاز Android المنفّذ. كوّن النموذج والقدرات المطلوبة للتحكّم فالهاتف داخل التطبيق، ومنح الصلاحيات اللازمة حسب الوظائف، بحال صلاحية الوصول وتلقّي الإشعارات. تقدر ترجع لـ دليل الإعداد ديال المشروع فإعدادات التحكّم الأساسية فالهاتف.
3. خلّي خدمة التنفيذ خدامة. تأكّد باللي الخدمة فAndroid بدات، وربط جهاز التحكّم وأجهزة Android المنفّذة بنفس الشبكة المحلية.
4. ربط الأجهزة. فصفحة “الأجهزة” ديال جهاز التحكّم، اختار جهاز Android اللي تكتاشف، ولا استعمل “الربط بنقرة وحدة”. فالربط الأول، خاصك تأكّد الترخيص من جهاز Android.
5. إعداد نموذج التحكّم. دخل لإعدادات جهاز التحكّم وكون النموذج المسؤول على فهم المهام وتوزيعها. الحسابات ديال التطبيقات المعنية خاصها تكون داخلة فالجهاز المنفّذ المناسب.
6. بدا التعاون. دخل لصفحة “agent”، واختار جميع الأجهزة، ولا مجموعة، ولا جهاز واحد، ومن بعد كتب المهمة باللغة الطبيعية.

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

التعرّف على المداخل الأربعة الرئيسية

• الأجهزة: اكتشاف أجهزة Android وربطها وتغيير أسمائها وتقسيمها لمجموعات.
• agent: توزيع المهام ومشاهدة التقدّم والنتائج والنافذة المصغّرة المباشرة.
• الرسائل: مشاهدة الإشعارات حسب الجهاز والتطبيق والمصدر، وبداية مهام الرد.
• الإعدادات: إعداد نموذج التحكّم وقدرات جهاز التنفيذ وخيارات المزامنة المرتبطة.

الاستعمال الأساسي: إرسال المهام للأجهزة

توزيع مهام مختلفة على أجهزة مختلفة

إلى كانت أسماء الأجهزة هي A وB، تقدر تشرح مباشرة فالمهمة شنو خاص كل جهاز يدير:

A حلّ الصفحة الرئيسية ديال Xiaohongshu وخد لقطة شاشة، وB حلّ المتصفح وشوف طقس اليوم.

من بعد الإرسال، تقدر تشوف تقدّم التنفيذ والنتائج حسب كل جهاز. إلا بغيتي تراقب ولا تصلّح العمليات فAndroid، حلّ النافذة المصغّرة المباشرة ديال الجهاز المعني، وتدخّل بالنقر أو السحب أو الكتابة.

التعاون الجماعي حسب مجموعات الأجهزة

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

كل جهاز فمجموعة المحتوى ينشئ مسودة تعريف بمنتج، ومجموعة المراجعة تشوف حالة المهام ديال جميع الأجهزة.
بدّل مهمة A اللي فمجموعة المحتوى باش يرتّب المواد الموجودة، وخلي باقي الأجهزة يكملو إنشاء المسودات.

هاد النوع ديال الوصف يقدر يعطي هدف موحّد للمجموعة كاملة، ويقدر حتى يبدّل مهمة جهاز واحد داخل المجموعة.

إنشاء وتوزيع محتوى مختلف

إلى بغيتي كل جهاز يعالج مواد مختلفة، طلب من نموذج التحكّم ينشئ المحتوى بشكل منفصل، ومن بعد يرسلو لكل جهاز:

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

إضافة قيود بحال “حفظ كمسودة، وما تنشروش دابا” كتعاون على توضيح الحدود المطلوبة للعملية. ولكن التنفيذ الفعلي كيبقى مرتبط بإعداد النموذج، وحالة التطبيق المستهدف، وحالة تسجيل الدخول، والصلاحيات الممنوحة للنظام.

إنشاء وتدبير مجموعات الأجهزة

1. حلّ صفحة “الأجهزة”. الشبكة اللي لتحت كتعرض الأجهزة المربوطة دابا، واسم كل جهاز والمجموعة ديالو.
2. كليكي على “المجموعات”، وعلّم على الأجهزة اللي بغيتي تدبّر.
3. اختار مجموعة موجودة ولا أنشئ مجموعة جديدة.
4. كليكي على “نقل N أجهزة” باش تكمل النقل الجماعي.

كل جهاز يقدر يكون غير فمجموعة وحدة، ومن بعد النقل كيخرج من المجموعة القديمة. الأجهزة اللي ما تقسّماتش يدوياً كتمشي لـ“المجموعة الافتراضية”.

ضغط مطوّل على صورة الجهاز ولا البطاقة ديالو كيخلّيك تبدّل الاسم ولا تنقل الجهاز لمجموعة أخرى. تغيير اسم الجهاز كيحاول يتزامن مع تطبيق Android المقابل، ولكن خاص جهاز التنفيذ يدعم الواجهة المناسبة.

معلومات المجموعات كتتحفظ فجهاز التحكّم الحالي، وما كتتزامنش أوتوماتيكياً مع جهاز تحكّم آخر. فبيئة فيها عدة أجهزة تحكّم، خاصك تدبّر مجموعات كل جهاز تحكّم بوحدو.

مشاهدة الإشعارات والرد عليها مركزياً

phongent يقدر يقرا إشعارات Android اللي تعطات عليها الصلاحية، ويرتّبها حسب الجهاز والتطبيق ومصدر الرسالة. من بعد الدخول لصفحة “الرسائل”، تقدر تشوف تفاصيل الإشعار وتعطي مهمة الرد لـAgent ديال جهاز Android المعني.

1. تأكّد باللي جهاز Android المستهدف عندو صلاحية قراءة الإشعارات.
2. حلّ مدخل “الرسائل” فالجهاز الرئيسي.
3. قلب على الإشعار المستهدف حسب الجهاز أو التطبيق أو المصدر.
4. دخل لتفاصيل الإشعار وبدا مهمة الرد.
5. Agent اللي فالجهاز Android المستهدف كينفّذ عملية الرد الفعلية.

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

تقنيات متقدمة للاستعمال

خلّي وصف المهام أسهل فالتنفيذ

• كتب اسم الجهاز ولا المجموعة بوضوح: بحال “مجموعة المحتوى”، أو “مجموعة المراجعة”، أو “الجهاز A”.
• فرّق بين الأهداف: وضّح العملية ديال كل جهاز، وما تجمعش طلبات عدة أجهزة فجملة غامضة.
• حدّد الحالة النهائية: بحال “رجّع النتيجة من بعد اللقطة”، أو “حفظ كمسودة”، أو “ما تنشرش دابا”.
• بدّل مهام داخل المجموعة: عطِ هدفاً للمجموعة كاملة أولاً، ومن بعد وضّح بوحدو شنو خاص جهاز معيّن يدير بشكل مختلف.
• راجع الحسابات أولاً: إلا كانت المهمة كتستعمل تطبيقاً خارجياً، دخل للحساب مسبقاً فالجهاز Android المناسب.

الاستعمال المعقول للنافذة المصغّرة المباشرة

النافذة المصغّرة المباشرة مناسبة لمراقبة عمليات Agent، ولا للتدخّل اليدوي ملي كتبدّل الصفحة أثناء التشغيل الآلي. كتكون مفعّلة افتراضياً، وقدر تطفيها من الإعدادات إلا ما محتاجش الشاشة المباشرة.

الصيانة الجماعية لأجهزة التنفيذ

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

حلّ مشاكل الاتصال

• تأكّد باللي جهاز التحكّم وجهاز التنفيذ فالشبكة المحلية نفسها.
• تأكّد باللي خدمة التنفيذ فAndroid ما زالت خدامة.
• فالربط الأول، كمّل الترخيص من جهاز Android.
• إلى تقطع الاتصال بجهاز مرخّص، جرّب تعاود تربطو ولا استعمل “الربط بنقرة وحدة”.
• شبكة الأجهزة كتعرض غير الأجهزة المربوطة؛ الجهاز اللي ما بانش ما كيعنيش بالضرورة أنه تربط بنجاح.

بناء نسخة Android من المصدر

تطبيق Android ديال المشروع، وواجهة التحكّم، وخدمة التنفيذ كاينين فـapp/، والقدرات الأساسية ديال Agent كاينة فـcore/. البناء كيحتاج JDK 17 وAndroid SDK، ودابا كيستعمل compileSdk 36.

./gradlew :app:assembleDebug

APK ديال التصحيح كيتولّد فـapp/build/outputs/apk/debug/. قبل التثبيت، تأكّد باللي ناتج البناء توقّع باستعمال توقيع التطوير ديالك.

بناء جهاز التحكّم iOS من المصدر

بناء iOS كيحتاج macOS وXcode كيدعم SDK المستعمل فالمشروع. أقل إصدار للنشر هو iOS 17.

1. حلّ ios/MikaRemote.xcodeproj باستعمال Xcode.
2. اختار scheme ديال MikaRemote.
3. اختار فريق التطوير ديالك فإعدادات التوقيع.
4. ربط iPhone المستهدف، ومن بعد بنِ وثبّت التطبيق.

مجلد ios/ فالمستودع فيه جهاز التحكّم iOS والمكوّنات والأنشطة المباشرة؛ وtools/android-emulators/ فيه أدوات الربط والاختبار مع محاكيات Android؛ أما دليل الإعداد والبروتوكولات وسجلات التحقّق فكاينين فـdocs/.

تنبيه أمني: مفاتيح النماذج، وبيانات الحسابات، ومواد التوقيع المحلية ما خاصهاش تتحط فالمصدر ولا تترفع للمستودع.

الخلاصة

phongent كينظّم عدة أجهزة Android فبيئة تنفيذ Agent قابلة للتدبير المركزي، وكيخلّيك تستعمل iPhone ولا جهاز Android كجهاز تحكّم. من بعد إعداد صلاحيات أجهزة التنفيذ، والاتصال بالشبكة المحلية، ونموذج التحكّم، تقدر توزّع المهام على جهاز واحد، ولا مجموعة، ولا جميع الأجهزة، وتشوف النتائج والشاشة المباشرة والإشعارات. المشروع مبني على Mika وكيستعمل Apache License 2.0.