中文 | English

ZAFrida UI - PyCharm Frida Plugin

الإصدار الحالي: 0.3.7

التحديثات الرئيسية في 0.3.7

• يمكن لكل مشروع ZAFrida اختيار بيئة Python/Frida بشكل مستقل أو مشاركتها، ويتم استخدام مترجم مشروع PyCharm الحالي افتراضيًا، مع دعم البيئات المحلية مثل venv و Conda و uv و Poetry و Pipenv و Hatch.
• إعادة تصميم واجهة الجلسة (Session UI) وإعدادات المشروع (Project Settings)، مع عرض كامل لمعلومات إصدارات البرنامج المساعد و Python و Frida، وتحسين لوحة السجلات القابلة للسحب والمتكيفة مع الحالة.
• دعم كامل لملفات .js / .ts و Frida 16/17 والتبديل بين بيئات المشاريع المتعددة، بالإضافة إلى عمليات الاتصال الثلاث: USB و Remote و Gadget.
• تعزيز قدرات استعادة الأجهزة وانتظار الجلسات والسجلات التزايدية عبر HTTP API المحلي و CLI و Skill الصيني؛ وإزالة طبقة تكيف MCP المكررة وغير المستقرة.

مقدمة المشروع

أداة رسومية لـ Frida مصممة خصيصًا لـ PyCharm/IntelliJ

ZAFrida UI هو برنامج مساعد رسومي لـ Frida مدمج في PyCharm وسلسلة JetBrains IDEs. يهدف إلى حل مشاكل تعقيد أوامر Frida في سطر الأوامر وسوء إدارة السكربتات، ويوفر واجهة تفاعلية كاملة لإدارة الأجهزة والعمليات والسكربتات والسجلات.

أبرز ما يميزه هو نظام إدارة القوالب "بنمط مربعات الاختيار": يمكن للمستخدمين إدراج مقاطع برمجية ديناميكيًا في السكربت الرئيسي أو تعليقها عبر تحديد/إلغاء تحديد المربعات، مما يتيح تجميع سكربتات Hook "بطريقة البناء المكعبات". كما يتضمن البرنامج المساعد إدارة مشاريع كاملة (zafrida-project.xml) تدعم التبديل السريع بين الأجهزة والبيئات المتعددة.

ZAFrida لا يستبدل Frida، بل يعمل كواجهة UI قوية لـ frida-tools، متكاملًا بسلاسة مع بيئة Python و Frida الحالية لديك.

ويكي مبسط: ZAFrida UI Wiki مبسط (BBS) (هذا هو الويكي الأبسط) دليل استخدام مفصل: ZAFrida UI دليل الاستخدام المفصل Wiki

عرض توضيحي

بدء سريع

1. تثبيت البرنامج المساعد: ابحث عن "ZAFrida" في سوق إضافات IDE أو ثبّته من القرص.
2. تكوين البيئة الافتراضية: يتم استخدام مترجم Python لمشروع PyCharm الحالي افتراضيًا؛ في الإعدادات العامة Settings -> Tools -> ZAFrida يتم الاحتفاظ فقط بالقيم الافتراضية لاسم/مسار الأدوات.
3. إنشاء مشروع: انقر بزر الماوس الأيمن في عرض المشروع -> New Frida Project.
   • إذا كان المشروع يتطلب إصدار Frida مختلفًا، افتح ZAFrida Project Settings، واختر مترجم Python أو دليل البيئة ثم انقر Test.
4. كتابة/اختيار سكربت: في لوحة Run اختر ملف agent.js أو agent.ts الخاص بك.
5. تصحيح Hook:

• الاتصال بالجهاز (USB أو Remote أو Gadget).
• اختيار العملية المستهدفة أو اسم الحزمة.
• انقر Run.

6. استخدام القوالب: انتقل إلى تبويب Templates، وحدد وظائف Hook التي تحتاجها (مثل "SSL Pinning Bypass")، وسيتم حقن الكود تلقائيًا في سكربتك.
7. أتمتة Skills (اختياري): معطلة افتراضيًا. انتقل إلى Settings/Preferences -> ZAFrida -> Skills HTTP API، وحدد Enable Skills لبدء تشغيل API المحلي تلقائيًا (أو يمكنك تشغيله/إيقافه يدويًا Start/Stop)، ومواقع CLI والقوالب:
   • Skill و CLI الرئيسي: skills-template/zafrida-http-control/
   • مشغل التوافق للمسار القديم: skills-cli/zafrida_skill_cli.py

رمز مجموعة التواصل

الميزات

• إدارة الأجهزة والعمليات
  يدمج frida-ls-devices و frida-ps، مع دعم تحديث قائمة الأجهزة بنقرة واحدة، وعرض العمليات الجارية والتطبيقات قيد التشغيل أو التطبيقات المثبتة.

• اتصال متعدد الأنماط
  دعم كامل لأنماط USB / Remote / Gadget، مع دعم تخصيص Host و Port عن بُعد، دون الحاجة إلى تجميع معاملات سطر أوامر معقدة يدويًا.

• تشغيل سكربت تفاعلي (Run / Attach)

  • دعم إجراءي Run (Spawn افتراضيًا) و Attach، وليس مجرد "تبديل وضع" بسيط.
  • دعم Force Stop لإيقاف التطبيق المستهدف قسريًا.
  • إخراج سجلات وحدة التحكم المدمجة، مع حفظ السجلات تلقائيًا في دليل المشروع zafrida-logs/.

• قائمة النقر بزر الماوس الأيمن في محرر JS / TypeScript (مهم)

  • في منطقة تحرير ملفات Frida .js أو .ts، انقر بزر الماوس الأيمن ويمكنك الاختيار مباشرة:
    • Run Frida Script: تنفيذ الملف الحالي كسكربت رئيسي (Spawn افتراضيًا).
    • Attach Frida Script: حقن الملف الحالي كسكربت إضافي في العملية المستهدفة قيد التشغيل.
  • يتم حفظ الملف الحالي تلقائيًا قبل التنفيذ، ويتم التبديل تلقائيًا إلى مشروع ZAFrida الذي ينتمي إليه السكربت.
  • مناسب لـ PoC سريع، والتحقق من العروض التوضيحية، ووضع Gadget، أو الحقن الفوري في العمليات قيد التشغيل.
  • اختصارات لوحة المفاتيح:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S

حالات الاستخدام

ZAFrida UI مناسب لجميع السيناريوهات التي تستخدم Frida في الهندسة العكسية، خاصة:

• اختبار الاختراق والتحليل العكسي لتطبيقات Android / iOS.
• عمليات التصحيح التي تتطلب التبديل المتكرر بين سكربتات Hook المختلفة.
• المهندسون الذين اعتادوا استخدام IDE (PyCharm/IDEA) للتطوير المختلط بين Python و JavaScript و TypeScript.

التوثيق الفني

• متطلبات البيئة:

  • IntelliJ IDEA أو PyCharm (يُوصى بـ 2024.3+)
  • تثبيت Python3 و frida-tools محليًا (pip install frida-tools)
  • تأكد من وجود frida و frida-ps و frida-ls-devices في PATH النظام أو حدد مساراتها في إعدادات البرنامج المساعد.

• الإبلاغ عن المشكلات: Github Issues

تشغيل المشروع

1. استنساخ الكود المصدري: git clone https://github.com/yilongmd/zafrida-ui.git
2. افتح المشروع باستخدام IntelliJ IDEA.
3. شغّل مهمة Gradle runIde لبدء بيئة التصحيح.

لقطات النظام

الواجهة الرئيسية ولوحة التشغيل (Run Panel)

توفر اختيار الجهاز واختيار السكربت وتكوين وضع التشغيل وإخراج وحدة التحكم.

إدارة القوالب الديناميكية (Template Panel)

اختيار الفئة على اليسار، وتحديد القوالب في المنتصف، ومعاينة الكود في الوقت الفعلي على اليمين. تتحكم مربعات الاختيار مباشرة في تفعيل محتوى السكربت.

واجهة الإعدادات (Settings)

دعم تخصيص مسارات أدوات Frida وعنوان الاتصال عن بُعد وتكوين السجلات.

معالج إنشاء المشروع

إنشاء هيكل مشروع Frida موحد بسرعة.

البنية التقنية

بيئة التطوير

• اللغة: Java 21, Java, نصوص البناء تستخدم Gradle Kotlin DSL
• الإطار: IntelliJ Platform SDK
• أداة البناء: Gradle
• التبعيات: frida frida-tools (بيئة Python)

شكر وتقدير

شكر خاص للخبراء التاليين على دعمهم بقوالب سكربتات Frida JS لهذا المشروع:

• 小佳
• Lane
• 迷人

لمزيد من المساهمين ورسائل الشكر، يرجى الاطلاع على: CONTRIBUTORS.md