استكشاف الأخطاء وإصلاحها والحصول على المساعدة في Prism

Prism هو مساحة عمل LaTeX تعاونية أصلية للذكاء الاصطناعي، مبنية على نماذج متقدمة، ومصممة لمساعدة الباحثين على التفكير والكتابة والتكرار بوتيرة أسرع. ويعزّز ذكاؤه المضمّن كلاً من سرعة العمل العلمي وعمقه.

يوضح هذا الدليل كيفية استكشاف المشكلات الشائعة وإصلاحها وأماكن العثور على مزيد من المساعدة.

كيفية الوصول إلى Prism

يتوفر Prism على prism.openai.com لجميع المستخدمين الذين لديهم حساب ChatGPT من نوع Free أو Go أو Plus أو Pro، ممن ليسوا ولم يكونوا أعضاءً في مساحة عمل مشتركة من نوع Business أو Enterprise. سنوسّع الوصول إلى Business وEnterprise وEdu في المستقبل القريب.

1. استخدام الذكاء المدمج في Prism

يتضمن Prism مساعدًا مدمجًا داخل المحرر ومدعومًا بنماذج OpenAI المتقدمة. وهو يفهم سياق مستندك ويمكنه المساعدة في إنشاء LaTeX وتشخيص الأخطاء واقتراح الإصلاحات دون مغادرة المحرر. يمكنك الوصول إليه من اللوحة الموجودة أسفل مساحة العمل المشتركة.

1. إنشاء مقتطفات LaTeX: اطلب من Prism إنشاء عناصر LaTeX شائعة، مثل «أنشئ جدولًا 4×4» أو «أضف شكلًا مع تسمية توضيحية». سيعيد Prism صيغة LaTeX جاهزة للاستخدام، ويوفر خياري Keep وUndo حتى تتمكن من إدراجها مباشرة في مشروعك.

2. تشخيص مشكلات التجميع: إذا فشل تجميع مستندك، فصِف المشكلة في اللوحة (على سبيل المثال: «مستندي لا يتم تجميعه»). سيطرح Prism أسئلة توضيحية ويرشدك إلى الأسباب المحتملة، مثل الأوامر المفقودة أو المراجع غير المحلولة.

3. إصلاح الأخطاء داخل السطر: تظهر الأخطاء والتحذيرات كعلامات حمراء أو صفراء في هامش المحرر. يمكنك أن تطلب من Prism إصلاح خطأ محدد، وسيحلل الأسطر ذات الصلة ويشرح الخطأ ويقترح تعديلات موجّهة. يمكنك تطبيق الاقتراح مباشرة ثم إعادة التجميع لتأكيد الإصلاح.

4. التدقيق: اطلب من Prism تدقيق قسم ما وإبراز أي أخطاء أو فجوات منطقية، مع تقديم اقتراحات أيضًا حول كيفية تحسين وضوح القسم. يمكنك الاستفادة من Skills، مثل مراجعة ورقة بحثية، للحصول على ملاحظات تحريرية وواقعية.

5. البحث في الأدبيات: أضف قائمة مراجع إلى ورقتي، بما في ذلك اقتراح أعمال ذات صلة ربما فاتتني.

2. تشخيص أخطاء التجميع

إذا لم يتم تجميع مستند LaTeX الخاص بك، فجرّب الخطوات التالية:

1. تحقق من علامة الخطأ: تبرز العلامات الحمراء والصفراء المكان الذي اكتشف فيه Prism مشكلة. انقر على العلامة لعرض التفاصيل، ثم استخدم المساعد المدمج لتشخيص الخطأ.

2. راجع سجل التجميع: عند فشل التجميع، تعرض لوحة معاينة PDF سجل التجميع. ركّز على رسالة الخطأ الأولى (على سبيل المثال، عدم وجود nd{document})، إذ إن الأخطاء اللاحقة تكون غالبًا آثارًا متسلسلة. شارك هذه الرسالة مع Prism للحصول على إرشادات أدق.

3. تراجع عن التغييرات الأخيرة: إذا ظهر الخطأ بعد تعديل حديث، فتراجع عن هذا التغيير أو علّق عليه مؤقتًا لمعرفة ما إذا كان التجميع سينجح.

4. قلّصه إلى مثال أدنى: إذا استمرت المشكلات، فبسّط المستند ليقتصر على المحتوى الأساسي فقط. تساعد إزالة الأقسام غير المرتبطة على عزل مصدر الخطأ.

3. أفضل الممارسات لتجنب المشكلات

1. ابقَ مسجل الدخول: اعمل دائمًا وأنت مسجل الدخول لضمان حفظ تغييراتك وإتاحتها عبر الجلسات.

2. استخدم الحزم المدعومة: يدعم Prism العديد من حزم LaTeX الشائعة الاستخدام. وقد تتسبب الحزم النادرة أو القديمة أو غير المدعومة في أخطاء تجميع غير متوقعة.

3. عدّل بشكل تدريجي: أجرِ تغييرات صغيرة وكرّر التجميع كثيرًا. فهذا يجعل من الأسهل تحديد التعديل الذي تسبب في الخطأ والتعافي بسرعة.

نقل مشاريع LaTeX إلى Prism

يوضح هذا الدليل كيفية نقل مشاريع LaTeX الحالية — سواء من Overleaf أو من جهاز الكمبيوتر المحلي — إلى prism. يضمن استيراد مشاريعك بقاء كل شيء في مكان واحد ويتيح لك مواصلة العمل دون إعادة إنشاء ملفاتك يدويًا.

استيراد المشاريع من Overleaf

لنقل مشروع من Overleaf إلى prism، نزّل أولًا ملفات المشروع من Overleaf ثم ارفعها إلى prism.

تنزيل مشروع واحد

1. افتح لوحة مشاريع Overleaf الخاصة بك.

2. حدّد موقع المشروع الذي تريد نقله.

3. انقر على أيقونة التنزيل في الصف نفسه الذي يظهر فيه اسم المشروع.

4. يقوم Overleaf بتنزيل المشروع بالكامل كـ ملف .zip إلى جهاز الكمبيوتر.

تنزيل عدة مشاريع

1. افتح قائمة مشاريع Overleaf الخاصة بك.

2. حدّد المشاريع باستخدام مربع الاختيار في بداية كل صف.

   

3. لتحديد كل شيء، انقر على مربع الاختيار الأول في القائمة.

4. بعد التحديد، انقر على أيقونة التنزيل في الزاوية العلوية اليمنى من قائمة المشاريع.

   

سيتم تنزيل المشاريع المحددة كملفات .zip.

استيراد المشاريع إلى Prism

يمكن لـ Prism استيراد المشاريع بثلاث طرق: برفع مجلد، أو رفع أرشيف .zip، أو سحب الملفات وإفلاتها في عرض All Projects.


لاستيراد مشروع من قائمة Import:

1. افتح Prism وانتقل إلى Import.

2. انقر على السهم بجوار Import لاختيار نوع الاستيراد.

اختر أحد الخيارات التالية:

1. افتح prism وانتقل إلى خيار Import.

2. انقر على السهم بجوار Import لاختيار نوع الاستيراد.

3. اختر أحد الخيارات التالية:

استيراد ملف .zip: اختر أرشيف المشروع الذي نزّلته من جهاز الكمبيوتر. سيقوم Prism تلقائيًا بفك ضغط المشروع وتحميله.

استيراد مجلد: اختر مجلد المشروع من جهاز الكمبيوتر. سيستورد Prism ملفات .tex وملفات المراجع والصور وموارد المشروع الأخرى.

للاستيراد بالسحب والإفلات: من عرض All Projects، اسحب مجلد مشروع أو ملف .zip وأفلته في Prism. سيُنشئ Prism تلقائيًا مشروعًا جديدًا ويستورد الملفات نيابةً عنك.

بعد انتهاء الرفع، يفتح Prism المشروع الكامل حتى تتمكن من بدء التحرير والتجميع.

أسئلة شائعة أخرى

الحساب والأمان والفوترة

س: أين يمكنني العثور على سياسة الخصوصية لديكم؟
ج: يمكنك العثور على سياسة الخصوصية الخاصة بـ Prism هنا.

س: هل تدرّبون نماذجكم على بياناتي؟
ج: يتمتع المستخدمون بالتحكم الكامل في ما إذا كانت بياناتهم تُستخدم للمساعدة في تحسين نماذجنا، بما يتوافق مع سياسة الخصوصية الخاصة بنا.

س: هل تستخدمون «عدم الاحتفاظ بالبيانات» (ZDR)؟ ما عمليات التسجيل/الاحتفاظ التي تتم؟
ج: لا يستخدم Prism حاليًا خيار واجهة برمجة التطبيقات «عدم الاحتفاظ بالبيانات» (ZDR)، ويحتفظ بالسجلات لفترة بعد الطلبات لتحسين المنتج.


س: هل تقدمون وضع خصوصية لا يتم فيه تخزين أي نص أو مراجعته بواسطة البشر، و/أو إقامة بيانات داخل الاتحاد الأوروبي فقط؟
ج: هذه ميزات مطلوبة؛ وهي مدرجة في خارطة الطريق/قائمة الأعمال المتراكمة، لكن لا يوجد جدول زمني ملتزم به بعد.

المشاركة والتعاون

س: لماذا لا يمكنني مشاركة رابط «يمكن لأي شخص التعديل»؟ (القائمة المنسدلة تسمح فقط بخيار «يمكن لأي شخص العرض».)
ج: هذا مقصود حاليًا. لا تتوفر بعد مشاركة الروابط التي تتيح «التحرير لأي شخص»؛ ويجب إضافة المحررين كمتعاونين (بحساب Prism).

س: المتعاونون لا يتلقون رسائل الدعوة عبر البريد الإلكتروني — كيف يمكنهم الوصول إلى المشروع؟
ج: اطلب منهم التحقق من مجلد الرسائل غير المرغوب فيها/البريد العشوائي، وأن يسجلوا الدخول باستخدام عنوان البريد الإلكتروني الذي تمت دعوته؛ ويُفترض أن يظهر لهم المشروع المشترك بعد أول تسجيل دخول.

استيراد المشروع وتصديره

س: توقّف رفع/استيراد ZIP عند عبارة «جارٍ استيراد مشروعك». ماذا أفعل؟
ج: أعد محاولة الرفع. إذا ظل عالقًا بعد إعادة المحاولة، فشارك ملف ZIP مع الدعم حتى يمكن تصحيح مسار الاستيراد.

س: كيف أصدّر/أنزّل مشروعي كملف ZIP؟
ج: انقر على اسم المشروع، ثم اختر Export لتنزيل نسخة مضغوطة من المشروع. قد يستغرق إنشاء اتصال الخلفية بضع ثوانٍ قبل أن تتمكن من التصدير.

الاعتمادية والانقطاعات والاتصال

س: اختفت مشاريعي بعد التحديث. هل فُقدت؟
ج: حدّث مرة أخرى وأعد التحقق من قائمة المشاريع، ومن المفترض أن تعود بياناتك للظهور.

س: اختفت مشاريعي بعد تحديث الصفحة. هل فُقدت؟
ج: يمكن أن يحدث هذا أثناء انقطاع لدى أحد المزوّدين. حاول مرة أخرى؛ ومن المفترض أن تعود مشروعاتك للظهور. إذا لم تعد، يمكن للدعم المساعدة في استعادتها.

س: يبدو الموقع غير متصل / يقول التطبيق إنه لا يمكنه الاتصال بالخلفية. ماذا أفعل؟
ج: حاول مرة أخرى/أعد التحميل. إذا استمرت المشكلة، فأرسل إلى الدعم تفاصيل ما تراه (وإن أمكن، رابط المشروع) حتى يمكن التحقيق في الأمر.

سلامة البيانات والاسترداد والنسخ الاحتياطية وسجل الإصدارات

س: تجمّد مستندي، ثم اختفى المحتوى وانتقلت مواضع ربط التعليقات. هل يمكنني استعادته؟
ج: ابدأ بتنزيل نسخة احتياطية بصيغة .zip. يتضمن Prism أيضًا سجل الإصدارات، وقد يتيح لك استعادة إصدار أقدم. قد لا يكون من الممكن دائمًا استعادة مواضع ربط التعليقات، ولا تُصدَّر التعليقات حاليًا ضمن النسخ الاحتياطية. إذا تغيّر التنسيق، فجرّب منسّق التعليمات البرمجية لإصلاحه.

س: أعدت فتح مشروع فعادت الملفات/المحتوى إلى حالة سابقة أو اختفت — ماذا حدث؟
ج: كانت هناك فترة كان فيها حفظ المشروع يعتمد على مزوّد خارجي لم يتمكن من مواكبة ارتفاع الاستخدام. نُقل الحفظ إلى نظام داخلي لتقليل أخطاء الاتصال ومنع تكرار ذلك، كما أُضيفت وسائل حماية إضافية.

س: هل يمكن استعادة مواضع التعليقات، وهل تُضمَّن التعليقات في النسخ الاحتياطية للمشروع؟
ج: قد لا يكون من الممكن استعادة مواضع التعليقات بعد حدوث المشكلة. توجد الآن نسخ احتياطية دورية (مثلًا كل ~10 دقائق) للاسترداد في الحوادث المستقبلية، لكن التعليقات لا تُصدَّر حاليًا في النسخ الاحتياطية بصيغة ZIP.

عمليات التكامل

Zotero

س: لماذا لا يمكنني استيراد مكتبات مجموعات Zotero إلى Prism؟
ج: مكتبات مجموعات Zotero غير مدعومة بعد؛ تعمل المكتبات الفردية، لكن مكتبات المجموعات غير مدعومة حاليًا.

س: تكامل Zotero لديّ عالق (على سبيل المثال، بعد تغيير الحسابات أو مفاتيح API). كيف يمكن إصلاحه؟
ج: سيحتاج الدعم إلى معرّف Zotero الرقمي الخاص بك (وليس اسم المستخدم) لإلغاء ربط التكامل بالمستخدم السابق/المجهول، وبعد ذلك يمكنك إعادة ربطه بحسابك. مثال على كيفية القيام بذلك: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

س: هل يمكنني استنساخ مشروع Prism عبر Git ‏(GitHub/GitLab) أو إبقاؤه متزامنًا مع منصة Git الخاصة بمؤسستي؟
ج: تكامل Git غير متاح بعد، لكنه مشروع تطوير قادم عالي الأولوية.

بناء LaTeX واستكشاف الأخطاء وإصلاحها

س: كيف أفرض إعادة بناء نظيفة (مسح عناصر Aux/toc/bbl)؟
ج: أعد تحميل الصفحة. يفرض تحديث الصفحة عملية بناء جديدة ونظيفة.

س: الأشكال/الصور لا تُحمَّل في Prism، لكن LaTeX نفسه يعمل في مكان آخر.
ج: استخدم مسارات نسبية إلى ملف .tex الذي يجري منه الاستيراد. إذا كان ملف .tex داخل مجلد فرعي وكانت الصورة في جذر المشروع، فأضف ../ في بداية المسار.

س: التجميع بطيء جدًا أو لا ينتهي أبدًا. كيف أحدد السبب؟
ج: علّق الأقسام (ثم الأجزاء الأصغر داخل تلك الأقسام) حتى ينجح التجميع، ثم ضيّق النطاق حتى تصل إلى السطر المحدد المسبب للمشكلة. راجع أيضًا التحذيرات والأخطاء في السجلات، بدءًا من الأول.

س: أحصل على تحذيرات “Underfull/Overfull \hbox” في ملف .bbl الناتج. هل هذا خطأ تجميع؟
ج: لا، هذه تحذيرات تنضيد وليست أخطاء تجميع قاتلة. إذا كان مخرج PDF يبدو مقبولًا، فيمكن عادةً تجاهل التحذير.

س: في Beamer، لماذا تُحدث بيئات lstlisting/listings أخطاء داخل frame (مثل “Extra }, or forgotten \endgroup”)؟
ج: اجعل إطار Beamer موسومًا بـ [fragile] عند استخدام بيئات listing؛ فكثيرًا ما يحل ذلك هذه الأخطاء.

س: تظهر استشهادات \cite لدي على شكل “[?]” رغم وجود ملف .bib وأوامر المراجع. ما التهيئة التي تعمل؟
أحد الحلول البديلة الناجحة هو التأكد من تضمين قائمة المراجع بشكل صحيح من المستند الرئيسي؛ وبالنسبة لسير العمل بنمط BibTeX، أدرج \bibliographystyle{plain} و\bibliography{refs} (حيث refs.bib هو ملفك).

واجهة المستخدم وطلبات الميزات

س: هل يوفّر Prism الوضع الفاتح؟
ج: نعم. يدعم Prism ثلاثة إعدادات للمظهر: النظام وفاتح وداكن. يمكنك اختيار النسق الأنسب لك.