hermes-decomp v0.2.3

مفكك تجميع بلغة Rust لـ Hermes bytecode (.hbc)، محرك JavaScript الذي يعمل خلف React Native. يدعم HBC 40 إلى 99.

التثبيت

ملفات تنفيذية جاهزة (Linux / macOS / Windows) من Releases أو Actions:

تتضمن الأرشيفات hermes-decomp و hermes-mcp. للتحقق: shasum -a 256 -c SHA256SUMS.

hermes-decomp update --check      # or --install / --version v0.1.7

من المصدر (Rust 1.70+):

git clone https://github.com/SymbioticSec/hermes-decomp.git
cd hermes-decomp && cargo build --release
# → target/release/hermes-decomp  target/release/hermes-mcp

البدء السريع

hermes-decomp info app.hbc
hermes-decomp disasm app.hbc --function 5 --info --show-offsets
hermes-decomp decompile app.hbc -o out.js          # progress on stderr
hermes-decomp decompile app.hbc --deep -o out.js   # recover more names, slower
hermes-decomp decompile app.hbc --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"

ما الذي يفعله

الخيارات الكاملة والأمثلة → docs/USAGE.md.

ملاحظات:

• يستخدم decompile للحزمة الكاملة ذاكرة تخزين مؤقت على القرص .hdcache لإعادة التحميل السريع. مرّر --no-cache للفرض.
• أدوات الكتابة تقوم بترقيع bytecode / HASM. وهي لا تعيد ترجمة JavaScript المفكك.
• decompile -o … يطبع مراحل المعالجة على stderr.

MCP والمكتبة

• خادم MCP (hermes-mcp) لمساعدي الذكاء الاصطناعي → docs/MCP.md
  قالب الإعداد: mcp-config.example.json
• حزمة Rust hbc-decomp → docs/LIBRARY.md

cargo build --release -p hbc-decomp-mcp

المساهمة

راجع CONTRIBUTING.md. يُرجى فتح issue قبل PR.

cargo build --release --workspace && cargo test --workspace

الموارد

• Hermes Engine · React Native

الترخيص

MIT. راجع LICENSE.