عن المشروع

## ما يقدمه هذا المستودع المستودع يُسمى `hill-climb-save-editor-pro` ووصفه القصير يعلن عن "أداة تعديل Python للعبة Hill Climb Racing 2 بعملات وجواهر غير محدودة 2026". ومع ذلك، يصف ملف README شيئًا مختلفًا تمامًا: مشروعًا يُدعى **Peak Ascent Optimizer (PAO)**، مُقدمًا كـ"رفيق تقدم جبلي" و"مساعد رقمي" لألعاب تسلق الجبال بالمركبات. هذا التناقض بين بيانات المستودع وملف README هو أول ما يجب أن يلاحظه القارئ. لا شيء في ملف README يشرح كيفية تعديل ملف حفظ أو فتح عملة أو تغيير بيانات اللعبة. ## ما يدعي ملف README أن الأداة تفعله وفقًا للتوثيق، يعمل PAO فقط على مخرجات الشاشة المرئية بدلاً من ملفات اللعبة أو الذاكرة: - **تراكب القياس عن بُعد في الوقت الفعلي** — رسم خرائط الارتفاع، وتصور متجه السرعة، وقراءة الجر المستمدة من التقاط الشاشة وتحليل التدفق البصري. - **تحسين نسب التروس** — اقتراحات تبديل بناءً على زاوية الميل وخشونة السطح والزخم، مقارنةً بمجموعة بيانات أساسية موصوفة. - **نمذجة الوقود التنبؤية** — تقدير مسافة التسلق المتبقية من معدل حرق الوقود ونمذجة المسارات المحتملة. - **مقارنة الجولات التاريخية** — تخزين محلي للجولات الأخيرة وخرائط حرارية للفشل وعرض "سائق شبح" لأفضل الأداءات. - **واجهة متعددة اللغات** — الإنجليزية والألمانية واليابانية والإسبانية والبرتغالية والتركية والصينية المبسطة، مع حزمة لغات دون اتصال. ## المتطلبات والهيكل المذكوران يسرد ملف README نظام Windows 10 أو macOS 12 أو Ubuntu 22.04 وPython 3.10+ وذاكرة 4 جيجابايت (8 جيجابايت موصى بها) ودقة التقاط 720p+ ومساحة تخزين 500 ميجابايت. يصف هيكلًا يحتوي على `core/` (القياس عن بُعد والفيزياء والمتنبئ والمترجم) و`ui/` (لوحة HTML ومقاييس SVG وسمات) و`data/` (أنماط تبديل SQLite وملفات التضاريس) و`docs/` و`tests/`. التبعيات الخارجية مذكورة باسم `opencv-python` و`numpy` و`jinja2`. التثبيت موصوف سرديًا: تنزيل أرشيف والتحقق من مجموع SHA-256 وفك الضغط وإنشاء بيئة افتراضية وتشغيل `python main.py --init` ثم إكمال جولة معايرة. ## بيانات الخصوصية والترخيص يقول ملف README إن جميع البيانات تبقى محلية، وإن الأداة لا تقوم بأي اتصالات شبكة، ولا تلمس الذاكرة المحمية أو تتجاوز إجراءات مكافحة العبث. يذكر أن المشروع مُصدر تحت رخصة MIT ويتضمن إخلاء مسؤولية بأنه غير مرتبط بأي مطور ألعاب سباق تجاري. ## نقاط يجب التحقق منها قبل الاستخدام - لا يحتوي ملف README على أي كود مصدري أو ملاحظات إصدار أو مخرجات اختبار قابلة للتحقق؛ جداول التغطية والجدول الزمني هي ادعاءات وليست أدلة. - رابط التنزيل يشير إلى عنوان GitHub Pages بدلاً من إصدار مستودع، وهو أمر غير معتاد لمشروع مفتوح المصدر ويستحق فحصًا دقيقًا. - قدرة "العملات والجواهر غير المحدودة" المُعلن عنها غير موصوفة في أي مكان في ملف README، لذا فإن الوظيفة الفعلية لأي ملف موزع غير واضحة. - نظرًا لأن المشروع مُقدم كأداة تعديل ألعاب، تحقق من شروط خدمة اللعبة المستهدفة وراجع أي أرشيف تم تنزيله قبل تشغيله. باختصار: يصف التوثيق أداة تحليل مرافقة لمراقبة الشاشة لألعاب تسلق التلال، بينما يعد اسم المستودع ووصفه بمحرر حفظ. تعامل مع الوصفين كوصفين غير متوافقين حتى يتم فحص الكود نفسه.