PyMemoryEditor

مكتبة Python خالصة (مبنية على ctypes) تتيح لك فحص وتعديل والبحث في ذاكرة أي عملية قيد التشغيل في بضعة أسطر من Python — سير عمل Cheat Engine على Windows وLinux وmacOS!

---

اقرأ واكتب وافحص ذاكرة أي عملية — مباشرةً من Python.
واجهة برمجية موحّدة واحدة. ثلاث أنظمة تشغيل. لا مُصرِّف C. لا خطوة بناء أصلية.

يعمل على Windows · Linux · macOS — بنسختي 32-bit و64-bit.

عدّل قيمة في لعبة قيد التشغيل · افحص حالة برنامج حيّ · اجمع البيانات مباشرةً من الذاكرة RAM.

---

التثبيت

pip install PyMemoryEditor

لتثبيت تطبيق الواجهة الرسومية المرفق أيضًا (ماسح على غرار Cheat Engine)، استخدم الإضافة app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

لإجراء عمليات فحص أسرع على العمليات الكبيرة، أضف الإضافة speed. فهي تجلب NumPy وتقوم تلقائيًا بتوجيه حلقة مقارنة الفحص الرقمي — أسرع بنحو 10–30× في عمليات الفحص الانتقائي:

pip install "PyMemoryEditor[speed]"

للسماح لمساعد ذكاء اصطناعي بتشغيل المكتبة عبر بروتوكول Model Context Protocol، استخدم الإضافة mcp (انظر أدناه):

pip install "PyMemoryEditor[mcp]"

📖 الدليل الكامل على Read the Docs.

---

شاهدها أثناء العمل

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # Scan the whole process for every address holding the value 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # Read the current value, then write a new one back.
    current = process.read_int(address)
    process.write_int(address, current + 500)

هذا كل شيء — اقرأ أو اكتب أو افحص عملية أخرى في ثلاثة أسطر، بالطريقة نفسها على كل منصة.

---

دع مساعد ذكاء اصطناعي يقوم بذلك (MCP)

توفّر PyMemoryEditor خادم Model Context Protocol، بحيث يمكن لمساعد ذكاء اصطناعي تشغيل الحلقة كاملة بنفسه:

"ابحث عن قيمة الصحة health في لعبتي. إنها 100 الآن."

يقوم بالفحص، ويطلب منك تلقّي ضرر، ثم يحسّن المطابقات، ويسلّمك العنوان.

pip install "PyMemoryEditor[mcp]"
claude mcp add pymemoryeditor -- pymemoryeditor-mcp

أو في أي عميل يقرأ JSON الخاص بـ mcpServers (Claude Desktop، والمحررات، …):

{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "pymemoryeditor-mcp",
      "args": []
    }
  }
}

تغطي أربعة عشر أداة سير العمل الكامل، مع الاحتفاظ بنتائج الفحص على جانب الخادم خلف مقبض handle، بحيث تكلّف عملية فحص أولى بـ 40 000 نتيجة بضعة رموز tokens بدلًا من سياقك بالكامل.

اقرأ دليل MCP لمعرفة المزيد.

---

📖 التوثيق

التوثيق الكامل موجود على pymemoryeditor.readthedocs.io — التثبيت، وسير عمل Cheat Engine، وكل دالة ومعامل، ودليل تطبيق الواجهة الرسومية، وملاحظات المنصات، واستكشاف الأخطاء وإصلاحها.

خريطة سريعة لما يمكنك التوجه إليه:

البدء السريع	افتح عملية، واقرأ، واكتب، ونفّذ أول عملية فحص لك.
البحث في الذاكرة	عمليات فحص القيم، والنطاقات، وتحسين النتائج، وحلقة Cheat Engine.
فحص الأنماط	ابحث عن الكود/البيانات باستخدام بصمات البايتات (AOB) والتعبيرات النمطية regex.
المؤشرات	سلاسل المؤشرات متعددة المستويات وRemotePointer الحيّ.
فحص المؤشرات	ابحث عن المؤشرات الثابتة التي تصمد أمام ASLR.
تطبيق الواجهة الرسومية	الماسح المرفق على غرار Cheat Engine.
خادم MCP	دع مساعد ذكاء اصطناعي يدير حلقة الفحص/التحسين.
مرجع API	كل صنف ودالة ومعامل عام.
ملاحظات المنصات	الأذونات والسلوكيات الخاصة على Windows وLinux وmacOS.
استكشاف الأخطاء وإصلاحها	الأخطاء الشائعة وكيفية إصلاحها.

---

ما الذي يمكنني بناؤه باستخدام هذا؟

• 🎮 أدوات تعديل الألعاب والسبيدرننغ — حالة الاستخدام الكلاسيكية لـ Cheat Engine.
• 🔬 التنقيح والفحص الداخلي — افحص الحالة الحيّة دون إرفاق مُنقّح debugger.
• 📊 أدوات المراقبة — خذ عيّنات من المتغيرات في عملية قيد التشغيل لأغراض القياس عن بُعد telemetry.
• 🔐 أبحاث الأمن والهندسة العكسية — على الأنظمة التي تملكها أو المصرّح لك باختبارها.
• 🎓 التعلّم — التطبيق المرفق أداة تعليمية رائعة لمعرفة كيفية عمل فحص الذاكرة.

[!NOTE] الاستخدام المسؤول. تتواصل PyMemoryEditor مع العمليات الأخرى عبر واجهات API على مستوى نظام التشغيل. لا توجّهها إلا نحو العمليات التي تملكها أو لديك إذن صريح بفحصها.

---

🤝 المساهمة

طلبات السحب pull requests وتقارير الأخطاء وأفكار الميزات مرحّب بها جدًا. اقرأ CONTRIBUTING.md للاطلاع على إعداد التطوير، وتنظيم الاختبارات، والمجموعة الصغيرة من السلوكيات الخاصة بكل منصة التي يجب الانتباه إليها.

إذا ساعدت PyMemoryEditor مشروعك، فيرجى ⭐ المستودع — فهذه أسهل طريقة لدعم العمل ومساعدة الآخرين على اكتشاف المكتبة.

---

الترخيص

صدرت تحت رخصة MIT — مجانية للاستخدام الشخصي والتجاري.