New releaseAug 17, 2026
hermes-decomp v0.2.2
أداة تحليل عكسي قوية تتيح لك هندسة تطبيقات React Native المحمولة عكسيًا عن طريق تحويل ملفاتها المترجمة من Hermes bytecode (.hbc) إلى JavaScript قابل للقراءة.
مفكك بلغة Rust لـ بايت كود هيرميس (.hbc)، محرك JS خلف React Native. يدعم HBC 40 إلى 99.
التثبيت
ملفات ثنائية مبنية مسبقًا (لينكس / ماك / ويندوز) من الإصدارات أو الإجراءات:
| ملحق الملف | المنصة |
|---|---|
linux-x86_64 / linux-arm64 | لينكس |
macos-arm64 / macos-x86_64 | ماك |
windows-x86_64 | ويندوز |
تحتوي الأرشيفات على 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 --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"
ما يفعله
| المجال | الأوامر (أبرزها) |
|---|---|
| قراءة | info, disasm, decompile, tui, extract, modules, deps |
| تحليل | xref, callgraph, graphviz, closures, debug, dump, bin-diff |
| مساعدات الهندسة العكسية | secrets, frida-hooks |
| كتابة (بايت كود فقط) | emit-hasm, asm, asm-check, patch-string, patch-function, inject-stub, create |
الخيارات الكاملة والأمثلة ← docs/USAGE.md.
ملاحظات:
- يستخدم
decompileللحزمة الكاملة ذاكرة تخزين مؤقت على القرص.hdcacheلإعادة التحميل السريع. استخدم--no-cacheللإجبار. - أدوات الكتابة تعدل البايت كود / 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
الموارد
الترخيص
MIT. انظر LICENSE.