Устранение неполадок и получение помощи в 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 откроет проект целиком, и вы сможете начать редактирование и компиляцию.

Другие FAQ

Учётная запись, безопасность и оплата

Q: Где я могу найти вашу политику конфиденциальности?
A: Политику конфиденциальности Prism можно найти здесь.

Q: Вы обучаете модели на моих данных?
A: Пользователи полностью контролируют, используются ли их данные для улучшения наших моделей, в соответствии с нашей политикой конфиденциальности.

Q: Используете ли вы «нулевое хранение данных (ZDR)»? Какое логирование/хранение происходит?
A: Prism в настоящее время не использует опцию API «нулевое хранение данных (ZDR)» и сохраняет журналы в течение некоторого времени после запросов для улучшения продукта.


Q: Предлагаете ли вы режим конфиденциальности, при котором текст не хранится и не проверяется людьми, и/или резидентность данных только в ЕС?
A: Это запрашиваемые функции; они есть в дорожной карте/бэклоге, но утверждённых сроков пока нет.

Общий доступ и совместная работа

Q: Почему я не могу поделиться ссылкой «любой может редактировать»? (В выпадающем списке доступно только «любой может просматривать».)
A: Сейчас это сделано намеренно. Общий доступ по ссылке с правом «редактировать может любой» пока не поддерживается; редакторов нужно добавлять как соавторов (с учётной записью Prism).

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

Импорт и экспорт проектов

Q: Загрузка/импорт ZIP зависает на «importing your project». Что делать?
A: Повторите загрузку. Если после повторной попытки она всё ещё зависает, передайте ZIP-файл в Support, чтобы можно было отладить путь импорта.

Q: Как экспортировать/скачать проект как ZIP?
A: Нажмите на имя проекта, затем выберите Export, чтобы скачать сжатую копию проекта. Прежде чем экспорт станет доступен, подключение к серверной части может устанавливаться несколько секунд.

Надёжность, сбои и подключение

Q: Мои проекты исчезли после обновления. Они потеряны?
A: Обновите ещё раз и снова проверьте список проектов — ваши данные должны появиться снова.

Q: Мои проекты исчезли после обновления страницы. Они потеряны?
A: Это может произойти во время сбоя у провайдера. Попробуйте снова; ваши проекты должны появиться снова. Если этого не произойдёт, поддержка сможет помочь их восстановить.

Q: Похоже, сайт недоступен / приложение говорит, что не может подключиться к серверной части. Что делать?
A: Попробуйте снова/обновите страницу. Если проблема сохраняется, отправьте в поддержку подробности того, что вы видите (и, если возможно, ссылку на проект), чтобы это можно было исследовать.

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

Q: Мой документ завис, затем часть содержимого исчезла, а якоря комментариев сместились. Можно ли его восстановить?
A: Для начала скачайте резервную копию .zip. В Prism также есть история версий, которая может позволить вам восстановить более раннюю версию. Позиции якорей комментариев не всегда можно восстановить, а сами комментарии сейчас не экспортируются в резервные копии. Если форматирование изменилось, попробуйте форматтер кода, чтобы исправить его.

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

Q: Можно ли восстановить позиции комментариев, и входят ли комментарии в резервные копии проекта?
A: Позиции комментариев может быть невозможно восстановить постфактум. Для восстановления при будущих инцидентах теперь создаются периодические резервные копии (например, примерно каждые 10 минут), но комментарии сейчас не экспортируются в ZIP-резервные копии.

Интеграции

Zotero

Q: Почему я не могу импортировать групповые библиотеки Zotero в Prism?
A: Групповые библиотеки Zotero пока не поддерживаются; индивидуальные библиотеки работают, но групповые библиотеки сейчас не поддерживаются.

Q: Моя интеграция с Zotero зависла (например, после смены учётных записей или API-ключей). Как это исправить?
A: Support потребуется ваш числовой ID 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: При использовании сред listing пометьте frame в Beamer как [fragile]; это часто устраняет такие ошибки.

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

Интерфейс продукта и запросы функций

Q: Есть ли в Prism светлая тема?
A: Да. Prism поддерживает три настройки внешнего вида: System, Light и Dark. Вы можете выбрать тему, которая подходит вам лучше всего.