رفع اشکال و دریافت کمک در Prism

Prism یک فضای کاری مشارکتی LaTeX با ماهیت هوش مصنوعی است که بر پایه مدل‌های پیشرو ساخته شده است—و برای کمک به پژوهشگران طراحی شده تا سریع‌تر فکر کنند، بنویسند و تکرار کنند. هوشمندی تعبیه‌شده آن هم سرعت و هم عمق کار علمی را تقویت می‌کند.

این راهنما توضیح می‌دهد چگونه مشکلات رایج را رفع اشکال کنید و کجا کمک بیشتری پیدا کنید.

نحوه دسترسی به Prism

Prism در prism.openai.com برای همه کاربرانی در دسترس است که حساب Free، Go، Plus یا Pro در ChatGPT دارند و عضو فضای کاری Business یا Enterprise نیستند و قبلاً هم نبوده‌اند. در آینده نزدیک، دسترسی را به Business، Enterprise و Edu گسترش خواهیم داد.

1. استفاده از هوشمندی داخلی Prism

Prism شامل یک دستیار بومیِ ویرایشگر است که با مدل‌های پیشروی OpenAI کار می‌کند. این دستیار بافت سند شما را درک می‌کند و می‌تواند بدون ترک ویرایشگر به تولید LaTeX، عیب‌یابی خطاها و پیشنهاد اصلاحات کمک کند. می‌توانید از پنل پایین فضای کاری به آن دسترسی پیدا کنید.

1. تولید قطعه‌های LaTeX: از Prism بخواهید عناصر رایج LaTeX را ایجاد کند، مثل «یک جدول ۴×۴ بساز» یا «یک شکل با عنوان اضافه کن». Prism، LaTeX آماده‌استفاده را برمی‌گرداند و گزینه‌های Keep و Undo را ارائه می‌دهد تا بتوانید آن را مستقیماً در پروژه خود وارد کنید.

2. عیب‌یابی مشکلات کامپایل: اگر سند شما کامپایل نمی‌شود، مشکل را در پنل توضیح دهید (برای مثال، «سند من کامپایل نمی‌شود»). Prism سؤال‌های روشن‌کننده می‌پرسد و شما را در بررسی علت‌های محتمل، مانند فرمان‌های مفقود یا ارجاع‌های حل‌نشده، راهنمایی می‌کند.

3. رفع خطاها درجا: خطاها و هشدارها به‌صورت نشانگرهای قرمز یا زرد در حاشیه ویرایشگر ظاهر می‌شوند. می‌توانید از Prism بخواهید یک خطای مشخص را رفع کند، و آن خطوط مرتبط را تحلیل می‌کند، توضیح می‌دهد چه چیزی اشتباه است، و ویرایش‌های هدفمند پیشنهاد می‌دهد. می‌توانید پیشنهاد را مستقیماً اعمال کنید و برای تأیید اصلاح، دوباره کامپایل بگیرید.

4. نمونه‌خوانی: از Prism بخواهید بخشی را نمونه‌خوانی کند و هر خطا یا خلأ منطقی را مشخص کند، و همچنین برای بهبود شفافیت آن بخش پیشنهاد بدهد. می‌توانید از Skills، مانند Paper Review، برای بازخورد ویرایشی و factual استفاده کنید.

5. جست‌وجوی ادبیات: برای مقاله من یک کتاب‌نامه اضافه کن، از جمله پیشنهاد کارهای مرتبطی که ممکن است از قلم انداخته باشم.

2. عیب‌یابی خطاهای کامپایل

اگر سند LaTeX شما کامپایل نمی‌شود، مراحل زیر را امتحان کنید:

1. نشانگر خطا را بررسی کنید: نشانگرهای قرمز و زرد محل تشخیص مشکل توسط Prism را برجسته می‌کنند. برای دیدن جزئیات روی نشانگر کلیک کنید، سپس از دستیار داخلی برای عیب‌یابی خطا استفاده کنید.

2. گزارش کامپایل را مرور کنید: وقتی کامپایل ناموفق است، پنل پیش‌نمایش PDF یک گزارش کامپایل نشان می‌دهد. روی اولین پیام خطا تمرکز کنید (برای مثال، نبودن \end{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 در حال حاضر از گزینه API «عدم ذخیره داده» (ZDR) استفاده نمی‌کند و برای بهبود محصول، پس از درخواست‌ها گزارش‌ها را برای مدتی نگه می‌دارد.


س: آیا حالت حریم خصوصی‌ای ارائه می‌دهید که در آن هیچ متنی ذخیره یا توسط انسان بررسی نشود، و/یا محل اقامت داده فقط در اتحادیه اروپا باشد؟
پ: این‌ها قابلیت‌های درخواستی هستند؛ در نقشه راه/فهرست کارهای آتی قرار دارند، اما هنوز زمان‌بندی قطعی برایشان تعیین نشده است.

اشتراک‌گذاری و همکاری

پرسش: چرا نمی‌توانم یک پیوند «هر کسی می‌تواند ویرایش کند» را به اشتراک بگذارم؟ (فهرست کشویی فقط «هر کسی می‌تواند مشاهده کند» را اجازه می‌دهد.)
پاسخ: این در حال حاضر عمدی است. اشتراک‌گذاری مبتنی بر پیوند به‌صورت «قابل ویرایش برای همه» هنوز پشتیبانی نمی‌شود؛ ویرایشگرها باید به‌عنوان همکار اضافه شوند (با یک حساب Prism).

پرسش: همکاران ایمیل دعوت را دریافت نمی‌کنند—چطور می‌توانند به پروژه دسترسی پیدا کنند؟
پاسخ: از آن‌ها بخواهید پوشه هرزنامه/اسپم خود را بررسی کنند، و با همان نشانی ایمیلی که دعوت شده وارد شوند؛ پروژه مشترک باید پس از اولین ورود برایشان نمایش داده شود.

درون‌ریزی و برون‌بری پروژه

پرسش: بارگذاری/درون‌ریزی ZIP من روی «در حال درون‌ریزی پروژه شما» گیر کرده است. چه کار باید بکنم؟
پاسخ: بارگذاری را دوباره امتحان کنید. اگر پس از تلاش مجدد همچنان گیر کرده است، فایل ZIP را با پشتیبانی به اشتراک بگذارید تا مسیر درون‌ریزی اشکال‌زدایی شود.

پرسش: چگونه پروژه‌ام را به‌صورت ZIP برون‌بری/دانلود کنم؟
پاسخ: روی نام پروژه کلیک کنید، سپس Export را انتخاب کنید تا یک نسخه فشرده از پروژه دانلود شود. ممکن است چند ثانیه طول بکشد تا اتصال backend برقرار شود و امکان برون‌بری فراهم شود.

پایداری، قطعی‌ها و اتصال

پرسش: پروژه‌های من بعد از تازه‌سازی ناپدید شدند. آیا از دست رفته‌اند؟
پاسخ: دوباره تازه‌سازی کنید و فهرست پروژه‌ها را دوباره بررسی کنید، داده‌های شما باید دوباره ظاهر شوند.

پرسش: پروژه‌های من پس از تازه‌سازی صفحه ناپدید شدند. آیا از دست رفته‌اند؟
پاسخ: این می‌تواند هنگام قطعی یکی از ارائه‌دهندگان رخ دهد. دوباره تلاش کنید؛ پروژه‌های شما باید دوباره ظاهر شوند. اگر ظاهر نشدند، پشتیبانی می‌تواند به بازیابی آن‌ها کمک کند.

پرسش: به نظر می‌رسد سایت آفلاین است / برنامه می‌گوید نمی‌تواند به backend متصل شود. چه کار باید بکنم؟
پاسخ: دوباره تلاش کنید/صفحه را دوباره بارگذاری کنید. اگر مشکل ادامه داشت، جزئیات چیزی را که می‌بینید (و در صورت امکان، یک پیوند پروژه) برای پشتیبانی ارسال کنید تا بررسی شود.

یکپارچگی داده، بازیابی، پشتیبان‌گیری و تاریخچه نسخه‌ها

پرسش: سند من متوقف شد، سپس محتوا ناپدید شد و لنگرهای نظرها جابه‌جا شدند. آیا می‌توانم آن را بازیابی کنم؟
پاسخ: ابتدا یک نسخه پشتیبان .zip دانلود کنید. Prism همچنین شامل تاریخچه نسخه‌ها است که ممکن است به شما امکان بازیابی نسخه‌ای قدیمی‌تر را بدهد. ممکن است موقعیت لنگرهای نظر همیشه قابل بازیابی نباشد، و نظرها در حال حاضر در نسخه‌های پشتیبان صادر نمی‌شوند. اگر قالب‌بندی تغییر کرده است، قالب‌بند کد را برای تعمیر آن امتحان کنید.

پرسش: پروژه‌ای را دوباره باز کردم و فایل‌ها/محتوا به حالت قبل برگشته بودند یا ناپدید شده بودند—چه اتفاقی افتاد؟
پاسخ: مدتی وجود داشت که ذخیره‌سازی پروژه به یک ارائه‌دهنده خارجی متکی بود که در زمان اوج استفاده نمی‌توانست همگام شود. برای کاهش خطاهای اتصال و جلوگیری از تکرار این وضعیت، ذخیره‌سازی به یک سیستم داخلی منتقل شد و محافظت‌های بیشتری نیز اضافه شد.

پرسش: آیا موقعیت نظرها قابل بازیابی است، و آیا نظرها در نسخه‌های پشتیبان پروژه قرار می‌گیرند؟
پاسخ: ممکن است موقعیت نظرها پس از وقوع قابل بازیابی نباشد. اکنون برای بازیابی در رخدادهای آینده، پشتیبان‌گیری‌های دوره‌ای (مثلاً هر حدود ۱۰ دقیقه) وجود دارد، اما نظرها در حال حاضر در نسخه‌های پشتیبان ZIP صادر نمی‌شوند.

یکپارچه‌سازی‌ها

Zotero

س: چرا نمی‌توانم کتابخانه‌های گروهی Zotero را به Prism وارد کنم؟
پ: کتابخانه‌های گروهی Zotero هنوز پشتیبانی نمی‌شوند؛ کتابخانه‌های فردی کار می‌کنند، اما کتابخانه‌های گروهی در حال حاضر پشتیبانی نمی‌شوند.

س: ادغام Zotero من گیر کرده است (مثلاً پس از تغییر حساب‌ها یا کلیدهای API). چگونه می‌توان آن را برطرف کرد؟
پ: پشتیبانی به شناسه عددی Zotero شما (نه نام کاربری‌تان) نیاز دارد تا ادغام را از کاربر قبلی/ناشناس جدا کند؛ پس از آن می‌توانید دوباره آن را به حساب خود پیوند دهید. نمونه‌ای از نحوه انجام این کار: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

پرسش: آیا می‌توانم یک پروژه Prism را از طریق Git (GitHub/GitLab) clone کنم یا آن را با پلتفرم Git مؤسسه‌ام همگام نگه دارم؟
پاسخ: یکپارچه‌سازی Git هنوز در دسترس نیست، اما یک پروژه توسعه آتی با اولویت بالا است.

ساخت LaTeX و رفع اشکال

پرسش: چگونه یک بازسازی تمیز اجباری انجام دهم (پاک کردن آرتیفکت‌های Aux/toc/bbl)؟
پاسخ: صفحه را دوباره بارگذاری کنید. تازه‌سازی صفحه یک ساخت تازه و تمیز را اجباری می‌کند.

پرسش: شکل‌ها/تصاویر در Prism بارگذاری نمی‌شوند، اما همان LaTeX در جای دیگری کار می‌کند.
پاسخ: از مسیرهایی استفاده کنید که نسبت به فایل .texای که درون‌ریزی را انجام می‌دهد نسبی باشند. اگر فایل .tex در یک زیرپوشه است و تصویر در ریشه پروژه قرار دارد، ابتدای مسیر ../ را اضافه کنید.

پرسش: کامپایل بسیار کند است یا هیچ‌وقت تمام نمی‌شود. چگونه علت را پیدا کنم؟
پاسخ: بخش‌ها را به حالت نظر درآورید (و سپس بخش‌های کوچک‌تر درون آن‌ها را) تا کامپایل موفق شود، سپس دقیقاً خطی را که باعث مشکل شده محدود کنید. همچنین هشدارها و خطاهای موجود در گزارش‌ها را، از اولین مورد شروع کرده، بررسی کنید.

پرسش: در .bbl تولیدشده هشدارهای «Underfull/Overfull \hbox» دریافت می‌کنم. آیا این یک خطای کامپایل است؟
پاسخ: خیر، این‌ها هشدارهای حروف‌چینی هستند، نه خطاهای致ی کامپایل. اگر خروجی PDF قابل قبول به نظر می‌رسد، معمولاً می‌توان این هشدار را نادیده گرفت.

پرسش: در Beamer، چرا محیط‌های lstlisting/listings داخل یک frame خطا می‌دهند (مثلاً «Extra }, or forgotten \endgroup»)؟
پاسخ: هنگام استفاده از محیط‌های listing، frame مربوط به Beamer را به‌صورت [fragile] علامت‌گذاری کنید؛ این کار اغلب این خطاها را برطرف می‌کند.

پرسش: ارجاع‌های \cite من به‌صورت «[?]» نمایش داده می‌شوند، با اینکه فایل .bib من وجود دارد و فرمان‌های کتاب‌نامه هم حاضر هستند. چه پیکربندی‌ای کار می‌کند؟
یک راه‌حل جایگزین که موفق بوده این است که مطمئن شوید کتاب‌نامه به‌درستی از سند اصلی وارد شده است؛ برای جریان‌های کاری سبک BibTeX، \bibliographystyle{plain} و \bibliography{refs} را وارد کنید (که در آن refs.bib فایل شماست).

رابط کاربری محصول و درخواست‌های قابلیت

پرسش: آیا Prism حالت روشن ارائه می‌دهد؟
پاسخ: بله. Prism از سه تنظیم ظاهری پشتیبانی می‌کند: System، Light و Dark. می‌توانید تمی را انتخاب کنید که برای شما بهترین کارایی را دارد.