RPG Maker JS Analyzer

الغرض والاستخدام: تستهدف الأداة مطوري الألعاب الذين يستخدمون RPG Maker MV/MZ مع JavaScript؛ تحل مشاكل التوافق بين الإصدارات وتكامل الإضافات وجودة الكود. حالات الاستخدام تشمل تدقيق الهجرة، فحص توافق الإضافات، وبناء scaffolding للإضافات الجديدة. القيمة الأساسية هي الكشف المبكر عن المشاكل، وقوالب الإضافات الموحدة، وتقصير دورات التصحيح.
المنطق الأساسي والميزات: تقوم الأداة بإجراء تحليل ثابت لكود JavaScript وبيانات المشروع لاكتشاف واجهات برمجة التطبيقات المنسوخة، فروق MV/MZ، والصراعات مع إضافات الطرف الثالث. المتطلبات: مُحلل AST، خريطة Delta بين إصدارات المحرك، تقييم توافق، ومولّد Scaffold. ميزات اختيارية/متقدمة تشمل بيئة تقييم sandbox، تقارير قابلة للتصدير، توصيات تحويل الكود وقوالب كود جاهزة لـ MV/MZ.
المدخلات والمخرجات: المدخلات — project_version، target_version، source_code (سلسلة أو ملف)، plugin_list (مصفوفة سلاسل)، analysis_mode (enum: compatibility, scaffolding, metrics). المخرجات — compatibility_report (JSON)، issues (مصوفة كحقول: id, severity, description, location)، generated_scaffold (قطعة كود)، وصفحة الملخص summary_score (0–100). التحقق: الإصدارات يجب أن تكون MV أو MZ؛ الكود المصدر لا يمكن أن يكون فارغًا.
الخوارزميات والحسابات: محلل AST يحلل أشجار بناء الجملة لاستخدام API وتوافقه. جدول Delta يربط تغييرات MV→MZ لواجهات API الأساسية وروابط الإضافات. التقييم = max(0, 100 - مجموع أوزان Issues). توليد Scaffold باستخدام محرك قوالب مع بيانات رأس ونقاط دخول للإضافة. النتائج قابلة لإعادة الإنتاج مع نفس المدخلات.
الأخطاء وحالات الحافة: المدخلات الناقصة تسبب أخطاء مخطط؛ الإصدارات غير المعروفة تستخدم Delta افتراضي.Projects كبيرة قد تستغرق وقتًا أطول؛ يتم عرض انتهاء المهلة كنتيجة جزئية. يتم كبح الاعتماديات الدائرية للإضافات.
الصناعة/الإقليم والتوطين: يتوافق مع تقاليد RPG Maker MV/MZ، رؤوس الإضافات وهوية دون الاعتماد على التوطين. يدعم ميزات ECMAScript الموجودة في MV/MZ؛ التوطين يترك لمصادر المستخدم.
الافتراضات والاستثناءات: يفترض أن المدخلات هي مصادر JavaScript داخل مشاريع RPG Maker؛ لا تطبيق تشغيل في الوقت الفعلي ولا أتمتة هجرة كاملة؛ يستثني-assets غير-JS وتفاصيل UI/UX.