GhostKey — أداة رفع الصلاحيات بنقرة واحدة لـ CVE-2026-98260

GhostKey هي أداة أندرويد لتصعيد الصلاحيات (privilege escalation) بنقرة واحدة، موجهة إلى أجهزة البحث الأمني المصرّح به / الأجهزة الشخصية. وهي مبنية على Shizuku + NDK Native، وتقوم بتجميع الـ Native exploit المطلوب لتصعيد الصلاحيات وجداول إزاحات النواة (kernel offsets) وقدرة تحليل صور OTA boot داخل ملف APK مستقل، بحيث يمكن للمستخدم تشغيلها بنقرة على الهاتف، دون الحاجة إلى حاسوب أو سطر أوامر.

⚠️ الأمان والمسؤولية القانونية هذا المستودع مخصص فقط للبحث الأمني في البيئات المصرّح بها والاختبار القانوني للأجهزة التي أملكها شخصيًا. بدون إذن صريح من مالك الجهاز، قد يُعد تنفيذ رفع الصلاحيات أو الحصول على root أو تجاوز قيود النظام على أجهزة الآخرين مخالفًا للقوانين واللوائح المحلية وشروط خدمة المنصات. استخدام هذه الأداة يعني أنك تفهم وتتحمل بنفسك جميع المخاطر القانونية الناتجة عن ذلك. المؤلف غير مسؤول عن أي إساءة استخدام. الملفات المترجمة من هذا المستودع قد تُعيد تشغيل الجهاز أثناء مرحلة الحقن

---

الميزات

• ROOT بنقرة واحدة: يكتمل مسار رفع الصلاحيات بنقرة واحدة على الهاتف، دون الحاجة إلى توصيل حاسوب أو أوامر adb.
• التكامل مع Shizuku: الحصول على سياق adb shell عبر Shizuku كمدخل لرفع الصلاحيات.
• APK خالص + NDK Native: يُترجم الكود المصدري C الخاص بالـ exploit مع الـ APK عبر NDK/CMake إلى libcve98260.so.
• جدول إزاحات النواة المدمج: يُوزَّع مع الـ APK عدة ملفات تعريف (profile) لإصدارات النواة، وتُطابَق بدقة حسب uname -r؛ وعند عدم وجود تطابق يُوجَّه المستخدم لاستيراد boot.img المقابل ليُحلَّل تلقائيًا.
• تحليل صورة boot الخاصة بـ OTA: يتضمن BootImageParser / ImgToProfile / KallsymsExtractor، ويدعم استنتاج رموز النواة وإزاحاتها من صورة boot.
• التكامل مع KernelSU: يتولى KsuResolver / KsudStage التكامل مع KernelSU.
• تصنيف سجلات التشغيل: تُعرض كل عملية رفع صلاحيات مجمَّعة حسب runId، ويقدّم تشخيص الفشل (FailureDiagnoser) إرشادات مخصصة لأكواد exit (مثل فشل حل KASLR exit=2).
• لوحة الطرفية: عرض مباشر لسجلات تنفيذ exploit وحالات المراحل.

---

حزمة التقنيات وبيئة البناء

العنصر	الإصدار
compileSdk / targetSdk	35
minSdk	31
Kotlin	1.9+ (هدف JVM 17)
NDK / CMake	CMake 3.22.1، ANDROID_STL=none
Shizuku	13.1.5
Jetpack Compose	BOM 2024.10.00 (Material3)
ABI الهدف	arm64-v8a (64 بت فقط)
تسمية المخرجات	GhostKey-<الإصدار>-arm64-v8a-release.apk

الإصدار الحالي: 1.1.5 (versionCode 17، اسم الحزمة com.GhostKey.app).

---

البناء

يستخدم هذا المستودع بناء release (مع تفعيل minify + shrinkResources، وحجم الناتج حوالي 5.8 ميغابايت). لا تستخدم assembleDebug — إذ يختلف مفتاح debug القديم عن مفتاح release، ويتطلب التثبيت فوق نسخة موجودة إلغاء التثبيت أولاً.

1. تجهيز كلمة مرور التوقيع

مفتاح التوقيع موجود في app/keystore/release.keystore (تم تجاهله بواسطة .gitignore، ولن يدخل إلى المستودع). تُحقن كلمة المرور بإحدى الطريقتين التاليتين، ولا تُكتب مرة أخرى في الكود المصدري:

• الطريقة أ: الإضافة في local.properties (موصى بها، وهذا الملف تم تجاهله)

  CVE98260_STORE_PASSWORD=你的密码
  CVE98260_KEY_PASSWORD=你的密码
  

• الطريقة ب: متغيرات البيئة

  export CVE98260_STORE_PASSWORD=你的密码
  export CVE98260_KEY_PASSWORD=你的密码
  

2. تجميع APK بنمط release

./gradlew assembleRelease

مسار المخرجات: app/build/outputs/apk/release/GhostKey-1.1.5-arm64-v8a-release.apk

---

هيكل الدليل (الوحدات الأساسية)

app/src/main/
├── kotlin/com/GhostKey/app/
│   ├── Cve98260Application.kt        # Application 入口
│   ├── data/                       # 内核 profile 加载/解析/存储
│   │   ├── Profile.kt              # 内核 profile 数据模型
│   │   ├── BuiltinProfileCatalog.kt# 内置偏移表
│   │   ├── ProfileRepository.kt    # 精确 release 匹配（无回退）
│   │   ├── AssetConfigLoader.kt    # assets 配置加载
│   │   ├── LegacyProfileConverter.kt
│   │   ├── ProfileImportManager.kt # 用户导入 boot.img
│   │   ├── RunLogStore.kt         # 运行日志分档存储
│   │   ├── UserProfileStore.kt
│   │   └── ota/                   # BootImageParser / ImgToProfile / KallsymsExtractor
│   ├── device/                    # DeviceBinding / KernelProbe / PrivilegeGate
│   ├── engine/                    # ExploitEngine / FailureDiagnoser
│   ├── ksu/                       # KsuResolver / KsudStage
│   ├── model/                     # KernelProfile / ShizukuStatus / StageTracker ...
│   ├── native/                    # KernelProfileSerializer / NativeContract
│   ├── shizuku/                   # Cve98260UserService / ShizukuPermissionManager
│   ├── ui/                        # Compose 界面（MainScreen / LogViewerScreen / SettingsScreen）
│   └── viewmodel/                 # ExploitViewModel
├── aidl/com/GhostKey/app/shizuku/ # Shizuku 跨进程接口
├── cpp/                           # Native exploit（CMake 构建为 libcve98260.so）
└── assets/ksu/                    # ksud 二进制

سير الاستخدام (نظرة عامة)

1. ثبّت Shizuku وفعّله على الجهاز، ثم امنحه الإذن لهذا التطبيق.
2. ثبّت مدير KernelSU (لاستقبال نتائج رفع الصلاحيات).
3. افتح GhostKey، وسيقوم التطبيق بفحص إصدار النواة ومطابقته مع جدول الإزاحات المدمج؛ وإن لم توجد مطابقة، فاستورد boot.img المُصدَّر من الجهاز لتحليله تلقائيًا.
4. اضغط على رفع الصلاحيات، وراقب سجلات الطرفية وحالة المراحل في الوقت الفعلي؛ وعند الفشل، اتبع التشخيص المتخصص من FailureDiagnoser (معايرة A/B، مطابقة profile، أخذ عينات tracefs، إلخ) لتحديد السبب.
5. رفع الصلاحيات هو root مؤقت، ويزول بعد إعادة تشغيل الجهاز.

---

الأجهزة المدعومة

تغطي ملفات تعريف النواة المدمجة عدة سلاسل نواة 5.15 / 6.1 / 6.6 / 6.12 / 6.18. أمثلة على الطُرز التي تم التحقق منها:

• OPPO Find X8 Ultra (PKJ110) — النواة 6.6.118-android15-...

تكون ملفات تعريف النواة المحددة وفقًا لـ app/src/main/kotlin/com/GhostKey/app/data/BuiltinProfileCatalog.kt وموارد *.profile المختلفة.

---

اصطلاح الإصدارات

• يبقى رقم الإصدار مُدارًا يدويًا بدءًا من 1.1.0، ولا يُرفع تلقائيًا عند إعادة التغليف اليومية؛ ولا يُرفع إلا عند الحاجة الصريحة.
• تُسمّى المخرجات بشكل موحّد GhostKey-<ver>-release.apk ثم تُسلَّم إلى dist/ (هذا المجلد مُستثنى بواسطة .gitignore ولا يُدرج في مستودع الإصدارات).

---

الترخيص

مخصص فقط لأبحاث الأمان المصرّح بها واختبار الأجهزة الشخصية. أي استخدام يتجاوز النطاق المصرّح به لا يشمله الترخيص.