hermes-decomp

مفكك بلغة Rust لـ بايت كود هيرميس (.hbc)، محرك JS خلف React Native. يدعم HBC 40 إلى 99.

التثبيت

ملفات ثنائية مبنية مسبقًا (لينكس / ماك / ويندوز) من الإصدارات أو الإجراءات:

تحتوي الأرشيفات على 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"

ما يفعله

الخيارات الكاملة والأمثلة ← 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

الموارد

• Hermes Engine · React Native

الترخيص

MIT. انظر LICENSE.