FolkPatch

🌏 لغات README: English / 中文 / 日本語

FolkPatch - أداة إدارة Root متخصصة في تحسين الواجهة وتوسيع الوظائف

مبنية على KernelPatch، توفر قدرات Root مستقرة مع تجربة واجهة جديدة ونظام توسيع ثلاثي المستويات APM / KPM / الإضافات. ابدأ سريعًا من خلال وثائقنا الشاملة — التثبيت والاستخدام، إدارة الوحدات، تطوير الإضافات، الإعدادات المخصصة، كل ذلك في مكان واحد.

📚 اقرأ الوثائق الكاملة →

---

✨ مقدمة

🎨 الوظائف الأساسية

• تنفيذ Root مبني على KernelPatch
• Hook لدوال النواة دون الحاجة لإعادة تجميع النواة

📱 المتطلبات المسبقة

• إلزامي: جهاز Android بمعمارية ARM64 وإصدار نواة Linux من 3.18 إلى 6.15

🎨 واجهة المدير وتصميمه

• واجهة مستخدم جديدة وتحسين تجربة التفاعل
• دعم خلفيات مخصصة
• دعم التدويل
• تحسين أداء الرسوم المتحركة وسلاسة التفاعل
• تحسين التفاصيل البصرية والتأثيرات الديناميكية للواجهة
• دعم الإيقاف اليدوي لفحص التحديثات التلقائي، وإعادة السيطرة على ترقية الإصدار إلى المستخدم

📦 نظام الوحدات والتوسيع

يوفر FolkPatch ثلاث طبقات من قدرات التوسيع، تغطي احتياجات التخصيص من النواة إلى وضع المستخدم:

• APM: نظام وحدات شبيه بـ Magisk، يدعم التثبيت الجماعي والنسخ الاحتياطي الكامل
• KPM: نظام وحدات النواة (يدعم inline-hook و syscall-table-hook)، مع دعم التحميل التلقائي
• الإضافات (APD Lua Plugin): توسيع خفيف بنصوص Lua، يقع بين APM و KPM
• عبر المتجر المدمج يمكن تنزيل أشهر APM و KPM والإضافات بنقرة واحدة

🧩 نظام الإضافات (APD Lua Plugin)

الإضافات هي توسيع خفيف في وضع المستخدم ابتكرته FolkPatch، وتقع مكانتها بين APM (وحدات على مستوى النظام) و KPM (وحدات على مستوى النواة): لا تعدّل ملفات النظام، ولا تحقن النواة، بل تعمل فقط بنصوص Lua خلال دورة حياة apd. مقارنة بالوحدات التقليدية، تسري الإضافات فور تثبيتها دون الحاجة لإعادة التشغيل، وعتبة تطويرها أقل.

القدرات المدعومة:

• مفاتيح التشغيل والإيقاف والتفعيل/التعطيل بنقرة واحدة
• إجراءات سريعة (Action) وواجهة إعدادات للمستخدم
• مهام حراسة مجدولة (تنفيذ دوري في الخلفية)
• سجلات تنفيذ دائمة، مع دعم العرض والتصدير والمشاركة

الوثائق الكاملة لصيغة حزمة الإضافات وواجهة API ودورة الحياة وأوامر الإدارة:

• 🇨🇳 الصينية: https://fp.mysqil.com/modules/plugin/
• 🇬🇧 الإنجليزية: https://fp.mysqil.com/en/modules/plugin/

⚡ الخصائص التقنية

• مبنية على KernelPatch

🚀 التنزيل والتثبيت

1. التنزيل: احصل على أحدث حزمة تثبيت من صفحة الإصدارات

2. التثبيت: ثبّت الحزمة على جهاز Android الخاص بك، واتبع الإرشادات داخل التطبيق لإكمال الإعداد

3. ابدأ الاستخدام: اقرأ الوثائق الكاملة للتعرف على إدارة الوحدات وتطوير الإضافات والاستخدامات المتقدمة

🙏 شكر المصادر المفتوحة

يعتمد هذا المشروع على المشاريع مفتوحة المصدر التالية:

• KernelPatch - المكوّن الأساسي
• Magisk - magiskpolicy
• KernelSU - واجهة التطبيق ودعم وحدات شبيه بـ Magisk
• Sukisu-Ultra - مرجع لتصميم بعض الواجهات
• APatch - الفرع الأعلى
• MMRL - مرجع صيغة بيانات مستودع الوحدات ومصدر البيانات
• Shizuku - خدمة Shizuku المدمجة

📄 الترخيص

• يُفتح FolkPatch وفق ترخيص GNU General Public License v3 (GPL-3)، وبصفتك معدّلًا أو موزّعًا، يجب عليك الالتزام بالمعايير التالية:
• إذا عدّلت الكود أو دمجت FolkPatch في مشروعك ووزّعته على طرف ثالث، فيجب أن يكون مشروعك بالكامل مفتوح المصدر وفق ترخيص GPLv3
• عند توزيع الملفات الثنائية، يجب عليك تقديم الكود المصدري الكامل والقابل للقراءة بشكل فعلي أو التعهد بتقديمه
• يُحظر تمامًا فرض رسوم ترخيص على ترخيص البرنامج نفسه، ويمكنك فرض رسوم على التوزيع أو الدعم الفني أو التطوير المخصص
• التوزيع يعني منحك لجميع المستخدمين الحق في استخدام براءات الاختراع الخاصة بك المرتبطة بهذا المشروع
• يُقدَّم هذا البرنامج "كما هو"، دون أي ضمانات، والمؤلف الأصلي غير مسؤول عن أي خسائر ناتجة عن استخدام هذا البرنامج
• أي مخالفة للشروط المذكورة أعلاه تؤدي إلى الإنهاء التلقائي لترخيص GPLv3 الخاص بك، وعندها ستفقد الحق القانوني في توزيع FolkPatch، ويحتفظ المؤلف الأصلي بالحق في ملاحقة المسؤولية القانونية عن انتهاك حقوق النشر (بما في ذلك على سبيل المثال لا الحصر طلب أوامر قضائية لوقف الانتهاك، والتعويض المالي، وإزالة المشاريع المخالفة)

💬 التواصل المجتمعي

نقاش وتواصل FolkPatch

• قناة Telegram: @FolkPatch