عن المشروع

Gearlynx هو محاكي Atari Lynx عالي الدقة ومتعدد المنصات مكتوب بلغة C++ ويعمل على Windows وmacOS وLinux وBSD وRetroArch. يتضمن خادم MCP (Model Context Protocol) مدمجًا لتصحيح الأخطاء والتطوير بمساعدة الذكاء الاصطناعي. ## الميزات الرئيسية - **محاكاة دقيقة**: يدعم كامل كتالوج Atari Lynx التجاري ومعظم الألعاب المنزلية والعروض التوضيحية، مع إمكانية اختيار المستخدم لمحاكاة Lynx I أو Lynx II. - **دعم ROM**: يتعامل مع ملفات ROM المضغوطة والمنزلية (صيغ lnx وlyx وo وbin وzip). - **حالات الحفظ**: تتضمن معاينة ودعم الإرجاع. - **Run-Ahead**: يقلل من زمن استجابة الإدخال. - **الصوت**: محاكاة دقيقة جدًا مع مرشح تمرير منخفض قابل للتكوين يحاكي عتاد صوت Lynx الأصلي. - **ComLynx متعدد اللاعبين**: يدعم ما يصل إلى ثماني نسخ من المحاكي على نفس الجهاز. - **مسجل VGM**: قدرة تسجيل مدمجة. - **ميزات العتاد**: تبديل البنوك (BANK1 + AUDIN)، وEEPROM، وملفات الحفظ (EEPROM وNVRAM)، وواجهات برمجة تطبيقات خرطوشة GameDrive/ElCheapoSD. - **مصحح أخطاء كامل**: يتضمن مفكك تجميع Run-Ahead في الوقت الفعلي يتعامل مع التعليمات البرمجية ذاتية التعديل، ونقاط توقف لوحدة المعالجة المركزية والذاكرة، والتنقل في التعليمات البرمجية، ورموز التصحيح، والتسميات التلقائية، ومحرر الذاكرة، والبحث في الذاكرة، وعارض سجلات Suzy وMikey، وقنوات الصوت، وUART، والخرطوشة، ومفتش الفيديو. - **خادم MCP**: يتيح تصحيح الأخطاء بمساعدة الذكاء الاصطناعي مع GitHub Copilot وClaude وCodex والأدوات المشابهة، ويكشف أدوات للتحكم في التنفيذ وفحص الذاكرة وحالة العتاد والإرجاع والمزيد. - **الوضع المحمول**: متاح على Windows وLinux وmacOS. - **سلسلة Shader قابلة للبرمجة**: تأثيرات بصرية قابلة للتخصيص. - **دعم وحدات التحكم**: وحدات تحكم ألعاب حديثة عبر gamecontrollerdb.txt. ## دعم المنصات - **مستقل**: Windows وLinux وBSD وmacOS - **Libretro**: Windows وLinux وmacOS وRaspberry Pi وAndroid وiOS وtvOS وwebOS وPlayStation Vita وPlayStation 3 وNintendo 3DS وGameCube وWii وWiiU وSwitch وEmscripten وأنظمة Classic Mini وOpenDingux وRetroFW وQNX. ## التنزيلات تتوفر ملفات ثنائية جاهزة لـ Windows (x64 وARM64) وmacOS (Apple Silicon وIntel وHomebrew) وLinux (Ubuntu PPA وFedora RPM وUbuntu 26.04/24.04 x64/ARM64). كما تتوفر وثائق نواة RetroArch. ## خادم MCP يتضمن Gearlynx خادم Model Context Protocol (MCP) لتصحيح الأخطاء بمساعدة الذكاء الاصطناعي. يدعم نقل STDIO وHTTP (يفضل STDIO) ويوفر أدوات للتحكم في التنفيذ وفحص الذاكرة ونقاط التوقف وفك التجميع وحالة العتاد والإرجاع والمزيد. تعليمات الإعداد موجودة في MCP_README.md. ## إضافة VS Code يتوفر مصحح أخطاء على مستوى المصدر لـ VS Code على BrianPeek/gearlynx-vscode، ويقود Gearlynx عبر بروتوكول مراقبة التصحيح. ## مهارات الوكيل يوفر Gearlynx مهارات الوكيل لمساعدي الذكاء الاصطناعي تغطي تصحيح أخطاء الألعاب وتتبع التعليمات البرمجية وإدارة نقاط التوقف وفحص العتاد والهندسة العكسية وإنشاء الغش والبحث في الذاكرة وتعديل بيانات ROM وترجمة النصوص وترقيع الألعاب. ثبّتها باستخدام `npx skills add drhelius/gearlynx`. ## دقة العتاد يجتاز Gearlynx جميع اختبارات Atari Lynx Hardware Test ROMs. ## تعليمات البناء تتوفر تعليمات بناء مفصلة لـ Windows (Visual Studio) وmacOS (Xcode + Homebrew) وLinux (Ubuntu/Debian/Fedora/Arch) وBSD (FreeBSD/NetBSD/OpenBSD) وLibretro. ## الترخيص GNU General Public License v3.0.