ARTEMIS Banner

دع مساعدي الذكاء الاصطناعي ومجموعات الاختبار تستخدم الهواتف الحقيقية مثل الإنسان.

English • 中文文档 • عرض سير العمل • البدء السريع • MCP لبيئات التطوير المتكاملة • الاختبارات المعيارية • مجتمع Discord

Artemis in Action
عرض حي: إعداد مسارات القيادة وحساب إجمالي المدد الزمنية في Google Maps، ثم فتح YouTube لتشغيل أغنية لـ Coldplay.

أبرز الميزات

أتمتة عبر التطبيقات: ينفّذ سير عمل الاختبار والمهام اليومية على Android انطلاقًا من تعليمات باللغة الطبيعية.
استهداف متعدد الوسائط: يستخدم مؤشرات العناصر عند توفرها، مع بدائل للتحديد بالإحداثيات وبصريًا للواجهات المخصصة.
تشخيص من بيئة التطوير: يتيح تكامل Model Context Protocol (MCP) لـ Antigravity وClaude Code وWindsurf تشغيل أجهزة الاختبار وجمع مخرجات Logcat ولقطات الشاشة.
تنفيذ فوري: حلقة تفاعلية للمراقبة والتنفيذ مع ملخصات غير متزامنة للسجل، عادةً 3–5 ثوانٍ لكل خطوة.
استكشاف احترافي: يتحقق من الأهداف قبل كل إجراء ويعيد الإجراءات المحظورة إلى المشغّل للتعافي. يدعم اختبارات الاستكشاف والاستقرار طويلة الأمد.
نتائج AndroidWorld: إنجاز أكثر من 99% من المهام في معيار AndroidWorld من Google Research (أكثر من 100 مهمة متعددة الخطوات).

Antigravity × ARTEMIS: سير عمل اختبار ذاتي

يستخدم Antigravity أداة ARTEMIS عبر MCP لتحويل طلب الاختبار إلى خطة وتنفيذ على الجهاز وتقرير تشخيصي:

1. إدخال الطلب (إرسال المهمة) _{صِف سيناريو الاختبار والمقاييس المستهدفة في Antigravity}	2. توليد خطة الاختبار _{يصوغ خطة اختبار وهيكلية خطوة بخطوة للمراجعة}
3. تنفيذ الاختبار الذاتي _{يشغّل جهازًا حقيقيًا ويتنقل في الواجهة ويحلل الأداء}	4. التقرير النهائي _{يقدّم نتائج تدقيق منظمة وجداول مقاييس ومجموعات بيانات خام}

البدء السريع

تأكد من توصيل جهاز Android (مع تفعيل USB Debugging) أو محاكي. سيقوم سكربت التشغيل بنقرة واحدة تلقائيًا بما يلي:

تثبيت سلاسل أدوات النظام: اكتشاف وتثبيت تلقائي لاعتماديات ADB وscrcpy وFFmpeg وPython (uv).
تركيب خادم MCP العام وقواعد وكيل الذكاء الاصطناعي: المطالبة بتثبيت إعدادات MCP العامة تلقائيًا وعقلية اختبار Artemis للأجهزة المحمولة (rules.md) في بيئات التطوير بالذكاء الاصطناعي لديك (Antigravity، Cursor، Claude Code، Codex، Windsurf، VS Code، Cline/Roo، OpenClaw).

macOS وLinux

# 1. Clone repo & navigate to directory
git clone https://github.com/google/artemis.git && cd artemis

# 2. One-click launch
./start.sh

Windows PowerShell

# 1. Clone repo & navigate to directory
git clone https://github.com/google/artemis.git
cd artemis

# 2. One-click launch
.\start.bat

لا يبحث PowerShell عن الدليل الحالي بحثًا عن سكربتات قابلة للتنفيذ افتراضيًا، لذا استخدم .\start.bat دون شرطة مائلة لاحقة \. في موجه الأوامر (CMD)، استخدم start.bat بدلاً من ذلك.

نصيحة: يفتح http://localhost:8000 في متصفحك الافتراضي مع معالج اتصال الجهاز، وعرض الشاشة المباشر، وساندبوكس الأوامر، وإعادة تشغيل التنفيذ. يمكنك أيضًا التشغيل مباشرة من سطر الأوامر: uv run artemis run "Open Settings, find Battery and tell me current level" --profile flash.

إعداد MCP لـ Codex / Antigravity / Claude Code / Windsurf (انقر للتوسيع)

يتضمن ARTEMIS خادم بروتوكول سياق النموذج (MCP) أصليًا. اربط هاتفك الحقيقي مباشرةً ببيئات التطوير المتكاملة للذكاء الاصطناعي:

1. التثبيت التلقائي بنقرة واحدة (موصى به)

سيؤدي تشغيل ./start.sh (macOS/Linux) أو .\start.bat (Windows PowerShell) إلى مطالبتك بتكوين قواعد MCP والاختبار العامة لبيئات التطوير المتكاملة المكتشفة (أو يمكنك التثبيت/التحديث لاحقًا يدويًا في أي وقت باستخدام الأوامر أدناه):

# Auto-install MCP server & global rules for Antigravity / Jetski:
uv run artemis mcp --install antigravity

# Or install for all supported AI IDEs (including Codex):
uv run artemis mcp --install all

نصيحة: يمكنك أيضًا تكوين MCP تفاعليًا أثناء الإعداد الأولي عبر uv run artemis init. نصيحة احترافية: إذا كنت تريد استخدام أمر artemis عالميًا دون uv run في أي دليل، فشغّل uv tool install -e . مرة واحدة في جذر المشروع.

2. التكوين اليدوي (اختياري)

إذا كنت تفضل التكوين يدويًا، فشغّل uv run artemis mcp --generate-config <client> (على سبيل المثال، codex أو antigravity) لإخراج مقتطف TOML أو JSON المناسب. استبدل /path/to/artemis بمسار المستودع الفعلي لديك ووجّه command إلى ملف Python التنفيذي في .venv الخاص بك:

Codex (~/.codex/config.toml):

[mcp_servers.artemis]
command = "/path/to/artemis/.venv/bin/python"
args = ["-m", "mcp_server"]
cwd = "/path/to/artemis"

[mcp_servers.artemis.env]
PYTHONUNBUFFERED = "1"
PYTHONPATH = "/path/to/artemis"

artemis

الأكثر شعبية