ddc — مُفكِّك DEX → Java بلغة Rust

English | 简体中文

يقوم ddc بفكِّ تجميع بايت كود DEX الخاص بأندرويد وإعادته إلى Java قابلة للقراءة — على مستوى التطبيقات الواقعية، وقابل للاستعلام كقاعدة بيانات، ومُتحقَّق منه بـ javac: كل ملف من الملفات الـ 909,689 التي يُخرجها عبر سبعة تطبيقات APK واقعية يُحلَّل بنجاح دون أخطاء.

أبرز الميزات

• سريع — تطبيق APK بحجم 226 ميغابايت / 20 dex (weibo، 98 ألف صنف) يُفكَّك تجميعه بالكامل في ~13 ثانية بجودة عالية، وتطبيق بحجم 62 ميغابايت (Telegram) في ~4.5 ثانية؛ الأصناف الشاذة تعمل على خيوط مراقَبة محدودة بمهلة زمنية بدلاً من تعليق التشغيل.
• يُترجَم — الناتج الكامل لجميع تطبيقات APK السبعة المرجعية (reqable، Telegram، WhatsApp، weibo، weixin، qq، lark — 0.91 مليون ملف) يجتاز javac بـ صفر أخطاء نحوية؛ كل صنف من زوج أسماء متغايرة الحالة (X/Cua مقابل X/cua) يُحفظ كملف مستقل بدلاً من أن يطمسه الأخير بصمت.
• فك تجميع تدريجي — 15 أمرًا فرعيًا للاستعلام (strings، الإحالات المتبادلة، التسلسلات الهرمية، manifest، الموارد، فك تجميع لكل دالة) تُجيب في أجزاء من الثانية: استعلم عن البيانات الوصفية أولاً، وفكِّ التجميع عند الطلب، وتجاوز التشغيل الكامل تمامًا.
• DEX 035–041، مكتمل — تطبيقات APK متعددة dex، وحاويات XAPK/APKS/APKM، وinvoke-custom؛ تُطوى lambdas ودمج السلاسل النصية مرة أخرى إلى Java حقيقية ((a) -> …، Cls::name، a + b).
• ناتج مقروء — أسماء محلية بأسلوب jadx (str، getName() → name، سلاسل معاملات Kotlin Intrinsics) بدلاً من v12؛ تُعرض قيم IntDef الحرفية كثوابتها مباشرةً (setVisibility(8) → View.GONE؛ جدول نطاق android-37 مدمج، و--symbols يتجاوزه)؛ تُحذف ضوضاء فحوصات null الخاصة بـ Kotlin وتُضمَّن جسور access$NNN الاصطناعية في مواضع استدعائها.
• ناتج قابل لإعادة الإنتاج — بلا طوابع زمنية؛ تشغيلان يُقارنان بنظافة.
• ناتج بمظهر بشري، افتراضيًا (cure): يمر كل ملف عبر تمريرة على مستوى المصدر تحافظ على الدلالة، تُضمِّن سلاسل نسخ السجلات، وتطوي إسنادات if/else إلى تعبيرات ثلاثية، وتستعيد for-each، وتُسقط المخازن الميتة ومخلفات المترجم — −15% من أسطر الناتج على مجموعات بيانات واقعية مع نتائج بوابة javac مطابقة. التمريرة دقيقة، لذا تكلّف وقتًا: weibo (110 آلاف ملف) يستغرق 21 ثانية محسَّنًا مقابل 10 ثوانٍ مع --fast (تخطي التبسيط، مع الحفاظ على التنسيق).
• HTTP REST + MCP، مدمجان (xyz-rust): يكشف ddc serve كل استعلام كمسار REST (GET مع معاملات استعلام أو POST مع جسم JSON) بالإضافة إلى GET /openapi.json ونقطة نهاية MCP قابلة للبث عند /mcp — وجِّه عميل MCP إلى http://addr/mcp؛ ddc http مخصص لـ REST فقط (بلا /mcp)؛ ddc mcp stdio|http يشغّل الأوامر نفسها كأدوات MCP مع مخططات إدخال وإخراج. أوامر الاستعلام تقبل --format auto|text|table|markdown|md|json|jsonl (auto: جدول على طرفية، والصيغة النصية المستقرة عند التوجيه عبر أنبوب).
• واجهة سطر أوامر ثنائية اللغة — تُترجم الرسائل تلقائيًا (DDC_LANG=zh|en يفرض اللغة؛ مع الرجوع إلى الإنجليزية).
• مبني على jdc-core، النواة المحايدة تجاه الآلة المشتركة مع jcdc.

التثبيت

macOS (Homebrew):

brew install ejfkdev/tap/ddc

Windows (Scoop) — أضف الـ bucket مرة واحدة، ثم ثبّت بالاسم (لا يقوم scoop بحل صيغة user/repo/app المجردة — issue #3):

scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install ddc

# or install straight from the manifest URL, no bucket needed:
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/ddc.json

cargo-binstall (أي منصة — يجلب الملف التنفيذي المُجمَّع مسبقًا من الإصدار بدلًا من الترجمة):

cargo binstall ddc-cli

الملفات الثنائية: كل إصدار يوفر ملفات ثنائية خام (بدون أرشيفات) لـ linux-amd64 وlinux-arm64 وwindows-amd64 وwindows-arm64 وmacos-amd64 وmacos-arm64 — حيث تكون إصدارات غير macOS مضغوطة بـ UPX.

من المصدر (Rust stable):

git clone https://github.com/ejfkdev/ddc && cd ddc
cargo build --release

الاستخدام

ddc app.apk                          # full decompile → app-out/
ddc app.apk -c com.example.Foo       # one class to stdout
ddc app.apk -o - | less              # everything to stdout

ddc info app.apk                      # app context (label via arsc, package,
                                      # version, md5) + per-dex counts
ddc mainactivity app.apk             # entry point: package + launcher
ddc findrefs app.apk string token    # every const-string "token" site
ddc getmethod app.apk Foo.toString   # one method, all overloads
ddc pkg app.apk --app -o own/        # the app's own code only

الخيارات والأمثلة الكاملة: ddc --help (قائمة الأوامر الفرعية مجمّعة حسب سير العمل). المرجع الكامل — دلالات كل خيار، وصيغة إخراج كل أمر فرعي وسلوكه — موجود في docs/cli.md (中文).

الأداء

سبعة تطبيقات APK واقعية، إصدار release، مقاسة بعد فترة تهدئة (Apple Silicon، 6P+12E). مجموعة التحقق المكوّنة من 39 APK (4.08M ملف مفكوك، زمن الجدار لكل APK / ذروة RSS / بوابة تحليل javac) موجودة في docs/validation.md (中文).

فك الترجمة الكامل — 7 تطبيقات APK واقعية

APK	الحجم	فك الترجمة الكامل	ذروة RSS
reqable	34 MB	0.57s	162 MB
Telegram	62 MB	4.50s	786 MB
WhatsApp	139 MB	13.6s (99,483 ملفًا — جميع أزواج الفئات المتغايرة في حالة الأحرف محفوظة)	944 MB
weibo	226 MB	13.5s	1173 MB
weixin	268 MB	32.7s	1401 MB
lark	398 MB	16.1s	2226 MB
qq	374 MB	37.1s	2268 MB

أوامر الاستعلام الفرعية على نفس تطبيقات APK (الخلايا: الوقت / ذروة RSS؛ strings -f <package> --with-locations، وfindrefs على سلسلة الحزمة والدالة onCreate، وhierarchy/disasm/getclass على فئة المشغّل لكل تطبيق):

أوامر الاستعلام الفرعية — 13 أمرًا × 7 تطبيقات APK