# Часто задаваемые вопросы и устранение неполадок

Быстрые ответы о начале работы, проектах, компиляции, ассистентах и резервных копиях.

## Начало работы

### Нужен ли мне аккаунт?

Нет. Скачайте Oleafly, откройте его и пишите. Необязательные службы, такие как облачный провайдер ИИ, GitHub или Dropbox, используют собственные аккаунты.

### Поддерживает ли Oleafly LaTeX, Typst и Markdown?

Да. Выберите движок при создании проекта. У каждого движка свои возможности редактирования и экспорта. [Краткое руководство](/docs/getting-started/) проведёт вас через создание вашего первого PDF.

### Могу ли я перенести существующую статью или резюме?

Да. Импортируйте исходный код проекта, ZIP-архив или репозиторий Git. В Oleafly есть также пути конвертации для DOCX и текстовых PDF. Прочитайте раздел [Перенос существующего проекта](/docs/import-project/), чтобы выбрать подходящий путь.

### Могу ли я работать автономно?

Вы можете писать, упорядочивать файлы, использовать локальную проверку текста и запускать скачанную локальную модель ИИ без подключения к облаку. Tectonic может компилировать с кэшированными пакетами. Новые пакеты, удалённые библиографии, облачные модели, GitHub и загрузки требуют подключения. Подготовьте проект с успешной компиляцией, прежде чем начать работать с ним автономно.

### Где находятся мои файлы?

Ваши проекты — это обычные папки в вашей локальной библиотеке. Вы можете копировать их, создавать резервные копии или открывать их в другом инструменте. В разделе [Где хранятся ваши данные](/docs/where-your-data-lives/) описаны файлы проекта, настройки приложения и контрольные точки.

### Подходит ли Oleafly для диссертации или резюме?

Да. Начните с [процесса работы над диссертацией](/docs/workflows/thesis/) или [процесса работы над резюме](/docs/workflows/resume/). В обоих используются те же инструменты редактирования, предпросмотра, библиографии и экспорта, что и для научной статьи.

## Установка

### Операционная система блокирует установщик

Проверьте, что файл взят из [официальных релизов](https://github.com/Oleafly/Oleafly/releases/latest) и соответствует вашей платформе. Следуйте [руководству по установке](/docs/install/#first-launch) для шагов первого запуска на вашей платформе.

### Какой пакет Linux мне использовать?

Выберите архитектуру, соответствующую вашему компьютеру, и пакет AppImage, пакет Debian или RPM. Требования к системе см. в разделе [Установка в Linux](/docs/install/#linux).

## Компиляция

### Первая компиляция идёт медленно

Tectonic может потребовать скачать пакеты, используемые этим документом, а первая компиляция на компьютере к тому же скачивает набор часто используемых. Они кэшируются для последующих сборок. Пока пакеты ещё скачиваются, компиляция может выйти за обычный пятиминутный лимит. Откройте [Журнал](/docs/compiling/#reading-the-logs), чтобы видеть, что происходит.

### Отсутствует пакет

Если включён офлайн-режим, выберите **Выключить и скомпилировать** в сообщении или отключите его на одну компиляцию, чтобы получить пакет. В системном наборе инструментов TeX используйте **Найти и установить** в ошибке. TeX Live из Debian, Ubuntu или Fedora получает пакеты через `apt` или `dnf`. См. [Движки и пакеты LaTeX](/docs/latex-engines/#recover-from-a-missing-file).

### Я выбрал pdfLaTeX, и Oleafly просит дистрибутив TeX

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX и pLaTeX работают на дистрибутиве TeX, установленном на вашем компьютере. Когда его нет, выбор любого из них перед компиляцией открывает диалог. Выберите **Скачать и использовать TinyTeX**, чтобы установить дистрибутив, или **Вернуться к Tectonic**, чтобы вернуться к встроенному движку. После неудачной компиляции предпросмотр предлагает тот же выбор в виде **Скачать и использовать TinyTeX** и **Использовать Tectonic**. См. [Когда TeX не установлен](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX пишет, что latexmk требует Perl

`latexmk` в MiKTeX работает на Perl, который MiKTeX не включает. Установите Strawberry Perl или TinyTeX из **Настройки → Движки → LaTeX**: у него свой Perl, и он берёт на себя компиляцию вместо MiKTeX. См. [MiKTeX и Perl](/docs/latex-engines/#miktex-and-perl).

### В моём PDF нет текста

В шрифте нет глифов для этих символов. Чаще всего это бывает с корейским, китайским и японским текстом, и TeX пропускает символы, не прерывая компиляцию. Oleafly предупреждает вас и перечисляет их в журнале. В LaTeX вставьте настройку, которую даёт предупреждение для вашего письма. В Typst скачайте набор шрифтов, который предлагает уведомление, или добавьте в папку `fonts` проекта шрифт с нужными символами. В Markdown задайте в заголовке YAML `mainfont` или `CJKmainfont` со шрифтом, в котором они есть. См. [Символы, отсутствующие в PDF](/docs/latex-engines/#characters-missing-from-the-pdf) и [Символы, которые выглядят как квадратики](/docs/typst/#characters-that-show-as-boxes).

### Oleafly остановил мою компиляцию, потому что она шла слишком долго

Компиляция может идти 5 минут. Пока пакеты ещё скачиваются, лимит растягивается до 30 минут. Markdown в PDF получает 15 минут, а Quarto и Calepin — час. Скомпилируйте снова: загрузка продолжится с того места, где остановилась. Для длинных черновиков на Tectonic установите **Режим компиляции** в **Быстрый** в меню компиляции.

### Могут ли новые проекты использовать мою собственную установку TeX?

Да. Откройте **Настройки → Движки → LaTeX** и установите **Движок компиляции по умолчанию** на **latexmk (системный TeX)**. Новые, импортированные и сконвертированные проекты LaTeX затем будут начинаться с него. См. [Задать значение по умолчанию для новых проектов](/docs/engines/#set-a-default-for-new-projects).

### Мой документ использует minted или PythonTeX

Эти пакеты запускают другие программы во время компиляции документа, и Oleafly блокирует это по умолчанию. Им требуется системный LaTeX. Если вы доверяете каждому файлу в проекте, выберите **Разрешить внешние команды** на панели над редактором. См. [Разрешение внешних команд](/docs/latex-engines/#allow-external-commands).

### Компиляция завершилась с предупреждениями

Откройте **Журнал** и сначала проверьте неопределённые цитирования и ссылки. [Предпроверка](/docs/preflight/) помогает найти затронутые места в исходном коде перед экспортом.

### Я не понимаю ошибку сборки

Попросите ассистента прочитать журнал, исправить ошибку и скомпилировать снова. Используйте режим **Спрашивать разрешение**, если хотите просматривать предлагаемые действия по ходу работы. Вы также можете опубликовать журнал в форуме помощи сообщества [Discord](/discord).

### Почему отсутствует формат экспорта?

Доступные форматы зависят от движка и типа документа. Проверьте [таблицу экспорта](/docs/export/#editable-formats).

## ИИ-ассистенты

### Какого ассистента можно использовать?

Подключите провайдера моделей, используйте локальную модель или выберите [CLI-агент](/docs/cli-agents/). В разделе [Настройка ИИ](/docs/ai-setup/) описан каждый путь.

### Нужен ли ИИ для работы в редакторе?

Нет. Написание, компиляция, цитирования, предпросмотры, диаграммы, история проекта и экспорт доступны без ассистента.

### Что может делать ассистент?

Он может работать с файлами проекта, искать источники, изучать PDF, создавать рисунки, запускать инструменты и помогать исправлять сборку. Выберите тариф и политику подтверждения, которые подходят для работы. См. [Чат и инструменты](/docs/ai-chat/).

### Что означает «Проверена» рядом с моделью?

Модель прошла проверку вызова инструментов. Это помогает выбрать модель для действий в проекте; качество её текстов или исследований при этом не оценивается. См. [Настройка ИИ](/docs/ai-setup/).

### Почему расход показывается как «Неизвестно»?

Некоторые провайдеры и CLI-агенты не сообщают данные о расходе. «Неизвестно» означает, что значение недоступно. Прочитайте раздел [Расход и бюджеты](/docs/ai-usage/).

### Могу ли я подключить внешнего ассистента?

Да. Используйте встроенное [подключение CLI-агента](/docs/cli-agents/), включите локальный [MCP-сервер](/docs/mcp/) Oleafly или подключите своего агента к [команде `oleafly`](/docs/cli/), которая работает и при закрытом приложении.

## История и совместная работа

### Как восстановить более раннюю версию?

Откройте [Контрольные точки](/docs/checkpoints/), чтобы сравнить исходный код успешных сборок и восстановить версию. Используйте [Систему контроля версий](/docs/git-history/) для коммитов Git, которыми вы управляете сами.

### Могу ли я работать с соавтором?

Да. Благодаря [совместной работе в реальном времени](/docs/collaboration/) вы и ваши соавторы редактируете один проект одновременно через сервер совместной работы, которым управляет ваша группа. У каждого из вас проект хранится как файлы на собственном компьютере. Вы также можете обмениваться архивами исходного кода или использовать [синхронизацию через GitHub](/docs/github-sync/) для обмена коммитами.

### Могу ли я использовать свои проекты на двух компьютерах?

Да. [Облачная синхронизация](/docs/cloud-sync/) хранит проекты вашей библиотеки и настройки в вашем собственном Dropbox, и каждый подключённый компьютер может их скачать. Чтобы подключить её, откройте **Настройки → Хранение данных → Облачная синхронизация**. Перенести проект между компьютерами можно также с помощью [синхронизации через GitHub](/docs/github-sync/).

### Создаёт ли экспорт исходного кода полную резервную копию?

Он создаёт резервную копию исходного кода проекта. Автоматические контрольные точки, настройки приложения и учётные данные хранятся отдельно. Следуйте [руководству по резервному копированию](/docs/where-your-data-lives/#back-up-your-work), чтобы включить всё необходимое.

## Сообщить о проблеме

Откройте **Настройки → Справка и о программе → Копировать сведения** и приложите эти данные к краткому описанию, шагам для воспроизведения проблемы и соответствующему журналу. Сообщите о ней в [Issues](https://github.com/Oleafly/Oleafly/issues); для вопросов и помощи с процессом работы используйте [сообщество Discord](/discord).
