التطبيقات المرافقة
ما هي التطبيقات المرافقة؟
التطبيقات المرافقة هي تطبيقات أصلية لـ iOS وAndroid وmacOS تتصل ببوابتك كـ عقد. تكشف العقد إمكانيات الجهاز, الكاميرا والشاشة التفاعلية وتسجيل الشاشة والموقع والصوت وتنفيذ الأوامر, لوكلائك.
فكّر في الأمر هكذا: البوابة هي العقل، والتطبيقات المرافقة هي الأيدي والعيون على أجهزتك.
كيف تعمل العقد
- الاتصال, يتصل التطبيق المرافق ببوابتك عبر WebSocket
- الإقران, تمر الأجهزة الجديدة بعملية الموافقة على الإقران
- تسجيل الإمكانيات, يخبر التطبيق البوابة بما يستطيع فعله (كاميرا وشاشة تفاعلية وموقع وغيرها)
- استدعاء الوكلاء, أثناء المحادثات، يمكن للوكلاء طلب من العقدة التقاط صورة أو تسجيل الشاشة أو عرض شاشة تفاعلية والمزيد
العقد ليست بوابات, لا تشغّل ذكاءً اصطناعياً خاصاً بها. إنها أجهزة طرفية تمتد ما يمكن لوكلائك القيام به.
تطبيق macOS المرافق
يعيش تطبيق macOS في شريط القوائم ويعمل كعقدة مرافقة ومدير للبوابة في آنٍ واحد.
الإمكانيات
- الشاشة التفاعلية, عرض محتوى ويب تفاعلي في نافذة أصلية
- الكاميرا, التقاط صور ومقاطع فيديو (أمامية/خلفية)
- تسجيل الشاشة, تسجيل ملء الشاشة أو لكل تطبيق
- تنفيذ الأوامر, تشغيل أوامر الطرفية على Mac (مقيّد بموافقات التنفيذ)
- الإشعارات, إرسال إشعارات macOS الأصلية مع خيارات الأولوية
- الموقع, GPS عند توفره
الميزات الإضافية
- إدارة البوابة, بدء وإيقاف ومراقبة البوابة
- ملكية الأذونات, إدارة أذونات macOS TCC (الإشعارات وإمكانية الوصول وتسجيل الشاشة والميكروفون والتعرف على الكلام وAppleScript)
- الروابط العميقة, مخطط URL
neotask://لتشغيل الوكلاء بمعاملات - تثبيت CLI, تثبيت أداة سطر الأوامر
neotask
تطبيق iOS
يتصل تطبيق iOS كعقدة ببوابتك، مما يجلب إمكانيات الجوال لوكلائك.
الإمكانيات
- الشاشة التفاعلية, عرض محتوى تفاعلي مبني على SwiftUI
- الكاميرا, صور ومقاطع فيديو (كاميرات أمامية/خلفية)
- تسجيل الصوت, التقاط الميكروفون
- الموقع, GPS مع اختيار الدقة
- الإشعارات, إشعارات iOS الفورية الأصلية
الميزات
- الاكتشاف, يجد بوابتك عبر Bonjour (شبكة محلية) أو Tailscale (VPN) أو الإدخال اليدوي
- الإقران, إقران آمن للجهاز مع الموافقة من البوابة
- الإيقاظ الصوتي, تنشيط كلمة التنبيه للتفاعل بدون يدين
- وضع التحدث, محادثة صوتية مستمرة
- ملحق المشاركة, مشاركة المحتوى من التطبيقات الأخرى مباشرة إلى وكيلك
- A2UI, عرض واجهة المستخدم المدفوعة بالوكيل على شاشة الجهاز التفاعلية
القيود
- تصميم يعطي الأولوية للمقدمة (iOS يوقف اتصالات WebSocket في الخلفية)
- قيود صارمة لأوامر الخلفية
- حالياً في معاينة داخلية
تطبيق Android
يتصل تطبيق Android كعقدة بإمكانيات مشابهة لـ iOS.
الإمكانيات
- الشاشة التفاعلية, عرض واجهة المستخدم المبني على Jetpack Compose
- الكاميرا, صور وفيديو (أمامية/خلفية، مقيّدة بالأذونات)
- تسجيل الشاشة, التقاط شاشة النظام (Android 10+)
- الموقع, GPS مع أوضاع الدقة
- إرسال SMS, على الأجهزة التي تدعم خدمة الهاتفية
- الدردشة والسجل, عرض سجل المحادثة على الجهاز
الميزات
- خدمة المقدمة, الإشعار المستمر يحافظ على الاتصال حياً
- الجلسات المشتركة, نفس الجلسة عبر جميع العقد المتصلة
- Android الحديث, يتطلب Android 12+ (API 31)
مضيف العقدة بدون واجهة
تشغيل عقدة بدون أي واجهة مستخدم, مثالي لخوادم البناء والآلات البعيدة أو صناديق Linux بدون واجهة.
الإمكانيات
- تنفيذ الأوامر, تشغيل أوامر على مضيف العقدة
- قائمة سماح الأوامر, تكوين الأوامر التي يمكن للعقدة تنفيذها
- خدمة مستمرة, التثبيت كخدمة launchd/systemd
حالات الاستخدام
- وكلاء بناء CI/CD, السماح لوكيلك الذكي بتشغيل عمليات البناء على خادم بعيد
- أتمتة المختبر المنزلي, تشغيل أوامر على Raspberry Pi أو خادم منزلي
- تنسيق متعدد الآلات, تنسيق المهام عبر آلات متعددة
إقران الأجهزة
تدفق الإقران
- يقدم التطبيق المرافق هوية جهازه (بصمة + مفتاح عام)
- تصدر البوابة طلب موافقة على الإقران
- توافق على الجهاز من خلال تطبيق سطح المكتب أو لوحة التحكم
- تصدر البوابة رمز الجهاز للاتصالات المستقبلية
نموذج الثقة
- الأجهزة المحلية (loopback) تتم الموافقة عليها تلقائياً للراحة
- الأجهزة غير المحلية تتطلب موافقة صريحة
- تُخزَّن رموز الأجهزة محلياً وتُعاد استخدامها عند إعادة الاتصال
موافقات التنفيذ
بالنسبة للعقد التي يمكنها تشغيل أوامر الأنظمة (macOS ومضيفات بدون واجهة)، تتحكم موافقات التنفيذ في المسموح به:
- وضع قائمة السماح, الأوامر المعتمدة مسبقاً فقط يمكن تنفيذها
- وضع الطلب, الأوامر غير المعروفة تطلب موافقتك
- الوضع الكامل, بدون قيود (استخدم بحذر)
تكوين قوائم السماح لكل عقدة للتحكم الدقيق في ما يمكن لكل جهاز القيام به.