Отстраняване на проблеми и получаване на помощ в 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, например „Създай таблица 4×4“ или „Добави фигура с надпис“. Prism ще върне готов за използване код на LaTeX и ще предложи опциите „Запазване“ и „Отмяна“, за да можете директно да го вмъкнете в проекта си.

2. Диагностика на проблеми при компилиране: Ако документът ви не се компилира, опишете проблема в панела (например „Документът ми не се компилира“). Prism ще зададе уточняващи въпроси и ще ви преведе през вероятните причини, като липсващи команди или неразрешени препратки.

3. Коригиране на грешки на място: Грешките и предупрежденията се показват като червени или жълти маркери в полето на редактора. Можете да помолите Prism да поправи конкретна грешка. То ще анализира съответните редове, ще обясни проблема и ще предложи целеви редакции. Можете да приложите предложението директно и да компилирате отново, за да потвърдите корекцията.

4. Корекция на текст: Помолете Prism да коригира даден раздел, да открои грешките или пропуските в логиката и да предложи как да подобрите яснотата му. Можете да използвате умения като „Рецензия на научна статия“, за да получите редакционна обратна връзка и проверка на фактите.

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. Изберете проектите чрез полето за отметка в началото на всеки ред.

1. За да изберете всички, щракнете върху първото поле за отметка в списъка.

2. След като ги изберете, щракнете върху иконата за изтегляне в горния десен ъгъл на списъка с проекти.

Избраните проекти ще бъдат изтеглени като .zip файлове.

Импортиране на проекти в Prism

Prism може да импортира проекти по три начина: чрез качване на папка, качване на .zip архив или плъзгане и пускане на файлове в изгледа Всички проекти.


За да импортирате проект от менюто „Импортиране“:

1. Отворете Prism и изберете Импортиране.

2. Щракнете върху стрелката до Импортиране, за да изберете типа на импортирането.

Изберете една от следните възможности:

1. Отворете Prism и отидете до опцията Импортиране.

2. Щракнете върху стрелката до „Импортиране“, за да изберете типа на импортирането.

3. Изберете една от следните възможности:

Импортиране на .zip файл: Изберете изтегления архив на проекта от компютъра си. Prism автоматично ще разархивира и зареди проекта.


Импортиране на папка: Изберете папката на проекта от компютъра си. Prism ще импортира вашите .tex файлове, библиографски файлове, изображения и други ресурси на проекта.


За импортиране чрез плъзгане и пускане: В изгледа Всички проекти плъзнете и пуснете папка на проект или .zip файл в Prism. Prism автоматично ще създаде нов проект и ще импортира файловете вместо вас.

След приключване на качването Prism отваря целия проект, за да можете да започнете да редактирате и компилирате.

Други често задавани въпроси

Акаунт, сигурност и таксуване

В: Къде мога да намеря вашата политика за поверителност? О: Можете да намерите политиката за поверителност на Prism тук.

В: Обучавате ли моделите си с моите данни? О: Потребителите имат пълен контрол дали данните им да се използват за подобряване на нашите модели в съответствие с нашата Политика за поверителност.

В: Използвате ли „нулево задържане на данни“ (ZDR)? Какви данни се регистрират и колко дълго се съхраняват? О: Понастоящем Prism не използва опцията на API за „нулево задържане на данни“ (ZDR) и съхранява регистри за определен период след заявките с цел подобряване на продукта.


В: Предлагате ли поверителен режим, при който не се съхранява текст и няма човешки преглед, и/или местонахождение на данните само в ЕС? О: Тези функции са заявени и са включени в пътната карта/списъка със задачи, но все още няма потвърден срок.

Споделяне и съвместна работа

В: Защо не мога да споделя връзка с настройка „всеки може да редактира“? (Падащото меню позволява само „всеки може да преглежда“.) О: Понастоящем това е предвиденото поведение. Споделянето чрез връзка с разрешение „всеки може да редактира“ още не се поддържа. Редакторите трябва да бъдат добавени като сътрудници и да имат акаунт в Prism.


В: Сътрудниците не получават имейлите с покани — как могат да отворят проекта? О: Помолете ги да проверят папката си за нежелана поща и да влязат с поканения имейл адрес. Споделеният проект би трябвало да се покаже след първото им влизане.

Импортиране и експортиране на проекти

В: Качването/импортирането на ZIP файла ми остава на „Импортиране на проекта“. Какво да направя? О: Опитайте да качите файла отново. Ако процесът отново блокира, споделете ZIP файла с екипа за поддръжка, за да може да се установи проблемът по пътя на импортиране.


В: Как да експортирам/изтегля проекта си като ZIP файл? О: Щракнете върху името на проекта и изберете „Експортиране“, за да изтеглите компресирано копие на проекта. Възможно е установяването на връзка със сървъра да отнеме няколко секунди, преди експортирането да стане достъпно.

Надеждност, прекъсвания и свързаност

В: Проектите ми изчезнаха след опресняване. Загубени ли са? О: Опреснете отново и проверете списъка с проекти. Данните ви би трябвало да се покажат отново.


В: Проектите ми изчезнаха след опресняване на страницата. Загубени ли са? О: Това може да се случи при прекъсване на услугата на доставчик. Опитайте отново — проектите ви би трябвало да се покажат. Ако не се покажат, екипът за поддръжка може да помогне за възстановяването им.


В: Сайтът изглежда недостъпен/приложението съобщава, че не може да се свърже със сървъра. Какво да направя? О: Опитайте отново или презаредете. Ако проблемът продължава, изпратете на екипа за поддръжка подробности за това, което виждате, и ако е възможно — връзка към проекта, за да може случаят да бъде проучен.

Цялост на данните, възстановяване, резервни копия и хронология на версиите

В: Документът ми блокира, след което част от съдържанието изчезна, а маркерите на коментарите се преместиха. Мога ли да го възстановя? О: Първо изтеглете резервно копие във формат .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“)? О: Когато използвате среди за кодови листинги, маркирайте frame в Beamer с [fragile]. Това често отстранява тези грешки.


В: Цитиранията с \cite се показват като „[?]“, въпреки че .bib файлът ми съществува и командите за библиография са налице. Коя конфигурация работи? Успешно заобиколно решение е да се уверите, че библиографията е правилно включена от основния документ. За работни процеси от типа BibTeX включете \bibliographystyle{plain} и \bibliography{refs} (където refs.bib е вашият файл).

Потребителски интерфейс и заявки за функции

В: Prism предлага ли светъл режим? О: Да. Prism поддържа три настройки за облика: Системна, Светла и Тъмна. Можете да изберете най-подходящата за вас тема.