Усунення несправностей і отримання допомоги в Prism

Prism — це спільний AI-native робочий простір для 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, наприклад «Create a 4×4 table» або «Add a figure with a caption». Prism поверне готовий до використання LaTeX і надасть опції Keep та Undo, щоб ви могли вставити його безпосередньо у свій проєкт.

2. Діагностика проблем із компіляцією: Якщо ваш документ не компілюється, опишіть проблему на панелі (наприклад, «My document isn’t compiling»). Prism поставить уточнювальні запитання та проведе вас через імовірні причини, як-от відсутні команди або нерозв’язані посилання.

3. Виправлення помилок у рядку: Помилки та попередження з’являються як червоні або жовті маркери на полях редактора. Ви можете попросити Prism виправити конкретну помилку, і він проаналізує відповідні рядки, пояснить, що не так, і запропонує цільові зміни. Ви можете застосувати пропозицію безпосередньо й повторно скомпілювати документ, щоб підтвердити виправлення.

4. Вичитування: Попросіть Prism вичитати розділ і виділити будь-які помилки або прогалини в логіці, а також запропонувати, як покращити ясність розділу. Ви можете використовувати Skills, наприклад Paper Review, для редакторського та фактологічного зворотного зв’язку.

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) і зберігає журнали протягом певного періоду після запитів, щоб покращувати продукт.


Запитання: Чи пропонуєте ви режим конфіденційності, у якому текст не зберігається й не перевіряється людьми, та/або вимоги до локалізації даних лише в ЄС?
Відповідь: Це запитувані функції; вони є в планах/беклозі, але наразі немає узгодженого графіка.

Поширення та співпраця

Q: Чому я не можу поділитися посиланням «будь-хто може редагувати»? (У спадному списку доступно лише «будь-хто може переглядати».)
A: Наразі це зроблено навмисно. Спільний доступ за посиланням із режимом «редагувати може будь-хто» поки не підтримується; редакторів потрібно додавати як співавторів (з обліковим записом Prism).

Q: Співавтори не отримують електронні листи із запрошенням — як їм отримати доступ до проєкту?
A: Попросіть їх перевірити папку спаму/небажаної пошти та увійти, використовуючи запрошену адресу електронної пошти; спільний проєкт має з’явитися після першого входу.

Імпорт і експорт проєктів

Q: Завантаження/імпорт ZIP завис на «importing your project». Що робити?
A: Повторіть завантаження. Якщо після повторної спроби воно все ще зависає, поділіться ZIP-файлом із службою підтримки, щоб можна було налагодити шлях імпорту.

Q: Як експортувати/завантажити мій проєкт як ZIP?
A: Натисніть назву проєкту, а потім виберіть Export, щоб завантажити стиснуту копію проєкту. Може знадобитися кілька секунд, щоб установилося з’єднання з бекендом і експорт став доступним.

Надійність, збої та з’єднання

Q: Мої проєкти зникли після оновлення. Вони втрачені?
A: Оновіть ще раз і повторно перевірте список проєктів — ваші дані мають з’явитися знову.

Q: Мої проєкти зникли після оновлення сторінки. Вони втрачені?
A: Це може статися під час збою в постачальника. Спробуйте ще раз; ваші проєкти мають з’явитися знову. Якщо цього не станеться, служба підтримки допоможе їх відновити.

Q: Схоже, сайт не працює / програма каже, що не може під’єднатися до бекенду. Що робити?
A: Спробуйте ще раз/перезавантажте. Якщо проблема не зникає, надішліть у службу підтримки подробиці того, що ви бачите (і, якщо можливо, посилання на проєкт), щоб це можна було дослідити.

Цілісність даних, відновлення, резервні копії та історія версій

Q: Мій документ завис, потім вміст зник, а прив’язки коментарів змістилися. Чи можу я його відновити?
A: Спочатку завантажте резервну копію .zip. Prism також містить історію версій, яка може дати змогу відновити попередню версію. Позиції прив’язок коментарів не завжди можна відновити, а коментарі наразі не експортуються в резервні копії. Якщо форматування змінилося, спробуйте форматувач коду, щоб його виправити.

Q: Я знову відкрив(ла) проєкт, а файли/вміст повернулися до попереднього стану або зникли — що сталося?
A: Був період, коли збереження проєктів залежало від зовнішнього постачальника, який не міг упоратися зі сплеском використання. Збереження перенесли на внутрішню систему, щоб зменшити помилки з’єднання й запобігти повторенню, а також додали додаткові запобіжники.

Q: Чи можна відновити позиції коментарів і чи входять коментарі до резервних копій проєкту?
A: Позиції коментарів може бути неможливо відновити постфактум. Тепер є періодичні резервні копії (наприклад, приблизно кожні 10 хвилин) для відновлення в майбутніх інцидентах, але коментарі наразі не експортуються в резервні ZIP-копії.

Інтеграції

Zotero

Запитання: Чому я не можу імпортувати групові бібліотеки Zotero у Prism?
Відповідь: Групові бібліотеки Zotero ще не підтримуються; індивідуальні бібліотеки працюють, але групові бібліотеки наразі не підтримуються.

Запитання: Моя інтеграція Zotero зависла (наприклад, після зміни облікових записів або ключів API). Як це виправити?
Відповідь: Службі підтримки знадобиться ваш числовий ідентифікатор Zotero (не ім’я користувача), щоб від’єднати інтеграцію від попереднього/анонімного користувача, після чого ви зможете повторно прив’язати її до свого облікового запису. Приклад, як це зробити: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

Q: Чи можу я клонувати проєкт Prism через Git (GitHub/GitLab) або тримати його синхронізованим із Git-платформою мого інституту?
A: Інтеграція з Git поки недоступна, але це високопріоритетний майбутній проєкт розробки.

Збирання LaTeX і усунення несправностей

Q: Як примусово виконати чисте перебудування (очистити артефакти Aux/toc/bbl)?
A: Перезавантажте сторінку. Оновлення сторінки примусово запускає нове чисте збирання.

Q: Фігури/зображення не завантажуються в Prism, але той самий LaTeX працює в інших місцях.
A: Використовуйте шляхи, відносні до .tex-файлу, який виконує імпорт. Якщо .tex-файл у вкладеній папці, а зображення — у корені проєкту, додайте на початку шляху ../.

Q: Компіляція дуже повільна або ніколи не завершується. Як визначити причину?
A: Закоментуйте розділи (а потім менші частини в цих розділах), доки компіляція не пройде, а потім звузьте пошук до точного рядка, що спричиняє проблему. Також перегляньте попередження та помилки в журналах, починаючи з першої.

Q: Я отримую попередження «Underfull/Overfull \hbox» у згенерованому .bbl. Це помилка компіляції?
A: Ні, це попередження верстки, а не фатальні помилки компіляції. Якщо PDF-вивід виглядає прийнятно, це попередження зазвичай можна ігнорувати.

Q: Чому в Beamer середовища lstlisting/listings дають помилку всередині frame (наприклад, «Extra }, or forgotten \endgroup»)?
A: Позначте frame у Beamer як [fragile], коли використовуєте середовища listing; це часто усуває такі помилки.

Q: Мої посилання \cite показуються як «[?]», хоча .bib існує й команди бібліографії присутні. Яка конфігурація працює?
Один із успішних обхідних способів — переконатися, що бібліографію правильно включено з головного документа; для робочих процесів у стилі BibTeX додайте \bibliographystyle{plain} і \bibliography{refs} (де refs.bib — це ваш файл).

Інтерфейс продукту та запити на функції

Q: Чи є в Prism світла тема?
A: Так. Prism підтримує три налаштування вигляду: System, Light і Dark. Ви можете вибрати тему, яка найкраще вам підходить.