PyMemoryEditor

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

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

يعمل على 🪟 ويندوز · 🐧 لينكس · 🍎 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]"

📖 الدليل الكامل في Read the Docs.

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

from PyMemoryEditor import OpenProcess

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

    # افحص العملية بأكملها بحثًا عن كل عنوان يحمل القيمة 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # اقرأ القيمة الحالية، ثم اكتب قيمة جديدة.
    current = process.read_int(address)
    process.write_int(address, current + 500)

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

📖 التوثيق

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

خريطة سريعة لأين تذهب:

ماذا يمكنني أن أبني بهذا؟

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

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

🤝 المساهمة

طلبات السحب (Pull Requests)، تقارير الأخطاء وأفكار الميزات مرحّب بها جدًا. اقرأ CONTRIBUTING.md لإعداد بيئة التطوير، هيكل الاختبارات والمجموعة الصغيرة من الخصائص الخاصة بالمنصات التي يجب الانتباه لها.

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

الترخيص

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