finalrun-agent

finalrun.app  •  الوثائق  •  المدونة  •  قائمة انتظار الأجهزة السحابية  •  انضم إلى مجتمع Slack

تابعنا على

finalrun-agent هو واجهة سطر أوامر مدفوعة بالذكاء الاصطناعي تختبر تطبيقات Android وiOS باستخدام اللغة الطبيعية. تكتب اختبارًا باللغة الإنجليزية البسيطة في YAML، ثم تقوم FinalRun بتشغيل تطبيقك على محاكٍ أو محاكٍ، وتستخدم نموذج ذكاء اصطناعي (Gemini أو GPT أو Claude) لرؤية الشاشة وتنفيذ كل خطوة — نقر، سحب، كتابة — وتنتج تقرير نجاح/فشل مع فيديو وسجلات الجهاز.

عرض توضيحي

التثبيت

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.ps1 | iex

يتطلب الاختبار المحلي لنظام iOS استخدام macOS (xcodebuild). على Windows، استخدم finalrun cloud لنظام iOS — Android يعمل محليًا. توجد إشارات CI، وتجاوزات متغيرات البيئة، وقائمة القطع الأثرية في أحدث ملاحظات الإصدار.

كتابة وتشغيل أول اختبار لك باستخدام وكلاء الذكاء الاصطناعي

يحتوي FinalRun على مهارات تسمح لوكيل البرمجة بالذكاء الاصطناعي الخاص بك بإنشاء الاختبارات، والتحقق من مساحات العمل، وتشغيل الاختبارات — كل ذلك من الدردشة.

إنشاء الاختبارات

مهارة /finalrun-generate-test تقرأ كود مصدر تطبيقك، وتستنتج هوية التطبيق، وتولد مواصفات اختبار كاملة مع الإعداد والخطوات والحالة المتوقعة — مرتبة حسب مجلد الميزة.

مثال:

/finalrun-generate-test قم بإنشاء اختبارات لميزة المصادقة — تغطية تسجيل الدخول ببيانات اعتماد صحيحة، تسجيل الدخول بكلمة مرور خاطئة، وتسجيل الخروج

سوف يقوم الوكيل بما يلي:

1. قراءة كود المصدر الخاص بك لفهم واجهة المستخدم واستنتاج اسم الحزمة / معرف الحزمة الخاص بالتطبيق
2. إعداد .finalrun/config.yaml وربطات البيئة في .finalrun/env/
3. اقتراح خطة اختبار بمسارات الملفات واستراتيجية التنظيف للموافقة
4. إنشاء مواصفات YAML ضمن .finalrun/tests/auth/ ومجموعة ضمن .finalrun/suites/
5. تشغيل finalrun check للتحقق من كل شيء

تشغيل الاختبارات

مهارة /finalrun-generate-test تقوم بالتحقق وتشغيل الاختبار بمجرد إنشائها.

مثال:

/finalrun-use-cli قم بتشغيل اختبارات المصادقة على Android

تصحيح أخطاء الاختبارات الفاشلة وإصلاحها

مهارة /finalrun-test-and-fix تدير حلقة إنشاء → تشغيل → تشخيص → إصلاح بالكامل. تقوم بإنشاء الاختبارات عبر finalrun-generate-test، وتشغيلها عبر finalrun-use-cli، وقراءة نواتج CLI (result.json، actions/، لقطات الشاشة، device.log) عند الفشل، وتصنيف ما إذا كان الخلل في كود التطبيق أو الاختبار، وتطبيق الإصلاح الأضيق، وإعادة التشغيل حتى يصبح التشغيل ناجحًا.

مثال:

/finalrun-test-and-fix تحقق من ميزة الدفع وأصلحها من البداية إلى النهاية على Android

كيفية تشغيل FinalRun تلقائيًا لإنشاء الاختبارات واختبارها بعد الانتهاء من تطوير الميزة

أضف هذا المحتوى إلى ملف AGENTS.md الخاص بك لتشغيل FinalRun تلقائيًا، حتى لا تضطر إلى طلب إنشاء وتشغيل الاختبارات من وكيلك بشكل صريح في كل مرة. سيسمح هذا أيضًا لوكيلك بإصلاح المشكلات في حالة وجود أي خطأ أثناء التطوير.

مفاتيح API (BYOK — أحضر مفتاحك الخاص)

يستخدم FinalRun مفتاح API الخاص بموفر الذكاء الاصطناعي لديك لتشغيل الاختبارات.

echo "GOOGLE_API_KEY=your-key-here" > .env

تستهلك عمليات تشغيل الاختبار رموز API من الموفر الذي قمت بتكوينه — يتم تطبيق الفوترة القياسية لواجهة API.

تشغيل الاختبارات يدويًا باستخدام CLI

finalrun test smoke.yaml --platform android --model google/gemini-3-flash-preview

finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview

الوثائق

الوثائق الكاملة: docs.finalrun.app

• التشغيل التلقائي لاختبارات FinalRun (وكلاء الذكاء الاصطناعي) — عندما يجب على وكلاء البرمجة إنشاء الاختبارات والتحقق منها وتشغيلها بعد العمل على واجهة المستخدم
• اختبارات YAML — تنسيق الاختبار، الحقول، المجموعات، وبدائل البيئة
• مرجع CLI — جميع الأوامر والإشارات وأدوات إعداد التقارير
• التكوين — تكوين مساحة العمل، هوية التطبيق، علامة --app، والتجاوزات لكل بيئة
• البيئة والأسرار — ترتيب تحميل dotenv، مفاتيح الموفرين، ومتطلبات النظام الأساسي
• استكشاف الأخطاء وإصلاحها — الأخطاء الشائعة والإصلاحات

التطوير

راجع CONTRIBUTING.md لهيكل المستودع المتعدد، وأوامر البناء، وإرشادات المساهمة.

• CODE_OF_CONDUCT.md
• SECURITY.md
• CHANGELOG.md
• LICENSE