✨ الميزات

• 🗄️ بلا حالة — مرّر -d/--db <PATH> (ملف ثنائي أو ملف .i64)؛ لا خادم خلفي، ولا تتبع للجلسات.
• 💾 حالة IDB دائمة — ملف IDB هو الحالة: التعليقات والعلامات المرجعية والأسماء والتحليل تبقى عبر العمليات.
• 🧩 تغطية كاملة لـ IDALib — المقاطع، الدوال، CFG، التفكيك، فك الترجمة Hex-Rays، النصوص، الأسماء، المراجع المتقاطعة، نقاط الدخول، البيانات الوصفية، التعليقات، العلامات المرجعية، توقيعات FLIRT.
• ⚡ دفعات ومتوازي — شغّل أوامر كثيرة مع فتح IDB واحد؛ وزّع أمرًا واحدًا على قواعد بيانات كثيرة بالتزامن (يدعم glob).
• 🤖 الوكيل أولًا — مستند JSON واحد على stdout، والأخطاء على stderr؛ مهارات مضمّنة لـ Codex / Claude Code / OpenCode.

🚀 التثبيت

المتطلبات الأساسية: IDA Pro 9.1 (مرخّص، شُغّل مرة واحدة) · IDA 9.1 SDK مفكوك (وقت البناء فقط) · Rust + LLVM/Clang (متطلبات bindgen)

export IDADIR="/Applications/IDA Professional 9.1.app/Contents/MacOS"  # IDA install dir
export IDASDKDIR=/path/to/idasdk91                                     # unpacked SDK (absolute path!)

git clone <this-repo> && cd idalib-cli
cargo install --path .

idalib-cli info    # ✅ verify tool version, IDA version, license

الـ SDK مطلوب في وقت البناء فقط؛ يربط الملف التنفيذي مكتبات IDA المحلية لديك في وقت التشغيل. فحوصات التطوير بدون SDK: cargo test --no-default-features --features stub-idalib.

🎮 الأوامر والاستخدام

كل أمر يحتاج -d/--db <PATH> — ملف IDB (.i64) أو ملف ثنائي (يُنشأ IDB بجانبه عند أول استخدام). تقبل العناوين 0x401000 أو 401000. المخرجات دائمًا مستند JSON واحد؛ تذهب الأخطاء إلى stderr مع رمز خروج غير صفري.

قاعدة البيانات

الاستعلام

التحرير (يُحفظ في IDB)

الدمج

جولات سيناريوهات

🔎 فرز ملف ثنائي غير معروف

idalib-cli -d ./sample meta            # what is it? (filetype/compiler/bitness)
idalib-cli -d ./sample segments        # memory layout
idalib-cli -d ./sample strings         # quick hints
idalib-cli -d ./sample functions -u    # user code only

🔍 التعمق في دالة

idalib-cli -d ./sample function -a 0x401000       # CFG + blocks + xrefs
idalib-cli -d ./sample decompile -a 0x401000      # read the pseudo-code
idalib-cli -d ./sample disasm -a 0x401000 -n 20   # or the raw instructions
idalib-cli -d ./sample xrefs -a 0x401000 --all    # who calls it

📝 تدوين النتائج (تبقى عبر العمليات/الوكلاء)

idalib-cli -d ./sample comments set -a 0x401000 -c "parses config, see 0x402100"
idalib-cli -d ./sample bookmarks add -a 0x401000 -d "entry point"
idalib-cli -d ./sample comments get -a 0x401000    # verify

⚡ تحليل جماعي لعينات كثيرة

# first pass: create IDBs + overview for every sample
idalib-cli parallel -d "./samples/*.bin" -- "batch -- meta functions -u"

# deep pass: decompile one hot function in every IDB
idalib-cli parallel -d "./samples/*.i64" --jobs 8 -- "decompile -a 0x401000"

🔎 البحث وفحص البيانات الخام

idalib-cli -d ./sample find --text "MAGIC"            # string hits
idalib-cli -d ./sample find --imm 0x1337              # immediate-value hits
idalib-cli -d ./sample find --pattern 554889e5        # byte pattern (prologue)
idalib-cli -d ./sample bytes -a 0x401000 -n 32        # hexdump
idalib-cli -d ./sample bytes -a 0x401000 --width qword -n 4
idalib-cli -d ./sample xrefs -a 0x401000 --from       # outgoing refs (calls)
idalib-cli -d ./sample rename -a 0x401000 -n decrypt  # label it
idalib-cli -d ./sample set-type -a 0x401000 -t "int f(const char *, int);"  # set prototype

🤖 فحص مجمّع مناسب للوكلاء (مستند JSON واحد)

idalib-cli -d ./sample batch -- "meta" "segments" "functions -u" "decompile -a 0x401000"

دليل سير عمل الوكيل: skills/idalib-cli/SKILL.md؛ مثال شامل قابل للتشغيل في examples/workflow.sh.

{
  "id": 7,
  "start": "0x401000",
  "end": "0x401080",
  "size": 128,
  "name": "main",
  "blocks": 3,
  "decompiled": true,
  "pseudocode": "int __cdecl main(...) { ... }"
}

⚙️ الإعدادات

ملف اختياري ~/.idapro/idalib-cli/config.toml (المجلد الأساسي: $IDALIB_CLI_HOME):

❓ الأسئلة الشائعة