عن المشروع

agent-device هي أداة مفتوحة المصدر من Callstack تمنح وكلاء البرمجة بالذكاء الاصطناعي حلقة تغذية راجعة مباشرة إلى التطبيقات قيد التشغيل. يتم توزيعها كأداة CLI، وخادم MCP مدمج عبر stdio، وعميل Node.js مكتوب، وكلها تشترك في نفس بيئة التشغيل. تشمل الأهداف المدعومة محاكيات iOS وAndroid وHarmonyOS والمحاكيات والأجهزة الفعلية، بالإضافة إلى tvOS وAndroid TV وAmazon Vega OS TV والويب وmacOS وLinux. تعمل مع وكلاء مثل Claude Code وCodex وCursor وWindsurf وCline وGoose، أو كبيئة تشغيل لوكلاء مبنيين باستخدام AI SDK أو Eve. القدرات الأساسية الموصوفة في ملف README: - فحص حالة التطبيق من خلال لقطات إمكانية الوصول والمراجع والمحددات وأشجار مكونات React Native، بدلاً من الاعتماد على لقطات الشاشة فقط. - التفاعل مع واجهة المستخدم المرئية: النقر والضغط وملء الحقول والتمرير والإيماءات والانتظار وتأكيد الحالة ومعالجة التنبيهات. - تشخيص الأعطال باستخدام لقطات الشاشة والفيديو والسجلات والتتبعات وبيانات الشبكة وعينات الأداء وتفاصيل الانهيار وملفات React. - تكرار سير العمل عن طريق حفظ الخطوات كسيناريوهات .ad للاستخدام المحلي أو في CI، مع إمكانية التصدير إلى YAML صارم من Maestro. التثبيت يتم عبر npm (Node.js 22.12+، أو 24+ لأتمتة الويب)، يليه أمر doctor للتحقق من الإعداد. الجلسات مقيدة بشجرة عمل git الخاصة بالمستدعي، وادعاءات الأجهزة المحلية تمنع الوكلاء المتوازيين من الاستيلاء على محاكيات بعضهم البعض. يمكن فحص ملكية الأجهزة وتحرير المالكين القدامى دون الحاجة إلى خفي. يمكن لنفس الأوامر تشغيل الأجهزة المستضافة على BrowserStack وAWS Device Farm وLimrun. تختلف الخلفيات المنصات: جسر إمكانية وصول محلي وXCTest لنظام iOS، وADB لنظام Android، وHDC وArkUI uitest لنظام HarmonyOS، وVega CLI/VDA لجهاز Vega الافتراضي، ومساعد محلي على macOS، وAT-SPI على Linux. يختلف عمق الدعم، ويقوم أمر capabilities بالإبلاغ عما يدعمه كل هدف. يضع المشروع نفسه كمكمل لـ Appium وDetox وMaestro: تُستخدم هذه الأدوات لكتابة وصيانة مجموعات الاختبار، بينما يسمح agent-device للوكيل بقراءة حالة التطبيق واختيار الأوامر في وقت التشغيل، مع إمكانية تصدير الجلسات إلى تلك الصيغ. وهو مرخص بموجب MIT.