CORTEX v1.0.0 - التثبيت والبدء السريع

يُوزَّع Cortex v1.0.0 كتطبيق Windows محمول واحد: cortex.exe. توجد بيئتا التشغيل للأجهزة x64 و x86 في مجلد runtime ويتم اختيارهما تلقائيًا لكل هدف. لا حاجة لتثبيت أي شيء آخر (لا Qt، ولا Visual C++ runtime).

التثبيت

1. نزّل الأرشيف:

   cortex-v1.0.0-windows-portable.zip
   

2. استخرج الأرشيف بالكامل إلى مجلد عادي قابل للكتابة، على سبيل المثال:

   C:\Cortex\
   

3. لا تنقل cortex.exe بمفرده. أبقِ مجلد runtime بجوار الملف التنفيذي.

4. شغّل:

   .\cortex.exe
   

الجلسة الأولى

1. انقر على "Select process" في الشريط العلوي (أو File > Select process...).
2. اختر الهدف وانقر على Attach (أو انقر نقرًا مزدوجًا على الصف).
3. استخدم لوحة "Value scan" في مساحة عمل Memory لفحص قيمة (First scan، ثم Next scan).
4. انقر نقرًا مزدوجًا على نتيجة مفيدة لتحضير مدخل في Addresses.
5. استخدم قائمة السياق الخاصة بعنوان للانتقال إلى Memory viewer أو Disassembler أو RE أو Pointer Maps أو Structures أو إجراءات المنقّح.
6. تعيد أزرار Memory و Debug و RE و Trace و Automation و Runtime في الشريط العلوي ترتيب مساحات العمل لكل مهمة.
7. بدّل مفتاح الشريط العلوي من "Read-only" إلى "Writes allowed" فقط عندما تنوي تنفيذ عملية تغيّر الهدف أو الحالة الدائمة.

أوضاع سطر الأوامر

المساعدة:

   .\cortex.exe --help

الإصدار:

   .\cortex.exe --version

خادم MCP دائم عبر stdio (بدون هدف؛ يتم الارتباط من عميل الذكاء الاصطناعي):

   .\cortex.exe mcp

ربط MCP بـ PID أو بعملية عند بدء التشغيل:

   .\cortex.exe mcp --pid 1234
   .\cortex.exe mcp --process game.exe

كذلك إتاحة أدوات المستوى المنخفض الأولية:

   .\cortex.exe mcp --tools all

أوامر مدمجة أخرى:

   .\cortex.exe probe --pid 1234
   .\cortex.exe diagnose --pid 1234
   .\cortex.exe analyze <directory>
   .\cortex.exe symbolize [options]
   .\cortex.exe inject <target> [dll]

محتويات الأرشيف

cortex.exe تطبيق Cortex (واجهة سطح المكتب وأوضاع CLI/MCP).

runtime\x64\cortex_core.dll بيئة تشغيل الأدوات للأهداف 64-بت.

runtime\x86\cortex_core.dll بيئة تشغيل الأدوات للأهداف 32-بت.

runtime\x86\cortex_runtime_helper.exe مساعد خاص يُستخدم تلقائيًا للأهداف 32-بت.

لا تختار أبدًا بين x64 و x86: يقرأ Cortex معمارية الهدف
ويستخدم بيئة التشغيل المطابقة، بما في ذلك مع
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs التوثيق والسجل والترخيص والأدلة التقنية.

استكشاف الأخطاء وإصلاحها

• إذا لم يبدأ cortex.exe، تحقق من استخراج الأرشيف بالكامل ومن وجود مجلد runtime.
• إذا تعذّر فتح هدف، تحقق من معماريتّه ومن صلاحيات العملية في Windows. استخدم الصلاحيات المرتفعة فقط عندما يتطلبها الهدف.
• إذا رُفضت عملية كتابة أو نقطة توقف أو عملية تحكم، بدّل الشريط العلوي إلى "Writes allowed" أولًا.
• تُحفظ الإعدادات وتخطيط النافذة في %LOCALAPPDATA%\Cortex. للإبقاء عليها بجوار cortex.exe بدلًا من ذلك (ذاكرة USB، بيئة معزولة)، أنشئ ملفًا فارغًا باسم cortex.portable بجوار الملف التنفيذي.
• في وضع MCP، يكون stdout مخصصًا لـ JSON-RPC طوال الجلسة؛ وتذهب التشخيصات إلى stderr.
• راجع docs/getting-started.md و docs/ui-guide.md و docs/ui-walkthrough.md لسير العمل الكامل.

التفويض

استخدم Cortex فقط على البرامج والأنظمة التي تملكها أو المصرّح لك بفحصها. تجاوز مكافحة الغش والوصول غير المصرّح به والتدخل في الخدمات عبر الإنترنت خارج نطاق هذا المشروع.