استكشاف الأخطاء

المشاكل الشائعة وحلولها.

macOS: “لا يمكن فتح التطبيق”

إذا حظر macOS تطبيق Moraya عند التشغيل لأول مرة:

1. انتقل إلى إعدادات النظام > الخصوصية والأمان
2. مرّر للأسفل للعثور على رسالة حظر Moraya
3. انقر على “فتح على أي حال”

macOS: أيقونة Dock تبدو عامة في وضع التطوير

عند تشغيل pnpm tauri dev، تظهر أيقونة Dock كأيقونة تطبيق عامة. هذا متوقع — لا يوجد حزمة .app في وضع التطوير. شغّل pnpm tauri build لرؤية الأيقونة الصحيحة.

الذكاء الاصطناعي: مفتاح API لا يعمل

• تحقق من صحة مفتاح API وأنه لم تنتهِ صلاحيته
• تأكد من اختيار المزوّد الصحيح في الإعدادات > الذكاء الاصطناعي
• بالنسبة لـ Ollama، تأكد من أن خادم Ollama يعمل محلياً (ollama serve)

المحرر: الرياضيات لا تُعرَض

تأكد من استخدام الصياغة الصحيحة: $ مفرد للمضمّنة، و$$ مزدوج للكتلية. قد لا يدعم KaTeX جميع حزم LaTeX — تحقق من قائمة دوال KaTeX المدعومة.

أداء الملفات الكبيرة

بالنسبة لملفات Markdown الكبيرة جداً (>1MB)، فكّر في استخدام وضع المصدر (Cmd+/) لأداء أفضل، حيث أن عرض WYSIWYG للمستندات الكبيرة قد يكون أبطأ.

الإبلاغ عن المشاكل

إذا واجهت خطأ، يرجى الإبلاغ عنه في GitHub Issues مع ذكر:

• نظام التشغيل وإصداره
• إصدار Moraya (من Help > About)
• خطوات إعادة إنتاج المشكلة
• السلوك المتوقع مقابل السلوك الفعلي