Ваши файлы и данные
Узнайте, что хранится при проекте и как создавать резервные копии исходника, истории и данных приложения.
Ваша рукопись — это папка с обычными файлами исходника. Эти файлы можно открыть другим редактором, скопировать в резервную копию или забрать из Oleafly.
Файлы проекта
Заголовок раздела «Файлы проекта»Проекты из библиотеки обычно живут в ~/.oleafly/projects/. Проект может содержать основной документ LaTeX, Typst или Markdown, библиографию, рисунки и исследовательские материалы.
project.json хранит сведения о проекте и его настройки, включая основной документ, движок и закреплённую версию Typst. Каталог .git содержит историю Git. Проект, созданный или импортированный в Oleafly, обычно начинается с одного коммита своих файлов с названием «Создать проект» (см. Git и контроль версий). Каталог .oleafly/build/ содержит сгенерированные результаты сборки и может быть воссоздан компиляцией.
Проект Typst может хранить копии пакетов, которые он импортирует, в папке typst-packages, поэтому он компилируется офлайн и на других компьютерах. Typst также использует шрифты из папки fonts проекта. Обе папки путешествуют вместе с проектом.
Папка, открытая на месте, остаётся там, где она есть. Oleafly хранит сборки, настройки, контрольные точки и чаты такой папки в собственной папке данных, поэтому в вашу ничего не добавляется.
Данные, хранящиеся вне проекта
Заголовок раздела «Данные, хранящиеся вне проекта»Настройки приложения, зашифрованные учётные данные поставщиков, записи чатов и использования, скачанные инструменты вроде дополнительных версий Typst и сохранённые контрольные точки относятся к локальному хранилищу приложения. Там же лежат копии проекта, которые Oleafly делает перед каждой репликой ассистента или агента и которые позволяют отменить изменения файлов, сделанные той репликой. Копия вашей библиотеки Zotero, которую читает поиск по @, тоже живёт там, а не в проекте. Копирование папки рукописи не копирует все эти данные приложения.
Связанные папки остаются в своих исходных местах. Архив исходников не включает их содержимое лишь потому, что вы их связали.
Где живут заметки
Заголовок раздела «Где живут заметки»Заметки — это файлы Markdown на вашем компьютере. Каждая личная заметка — это папка в папке проектов, рядом с проектами вашей библиотеки. Заметка проекта — это файл .md в папке notes проекта, поэтому она путешествует вместе с проектом. Папку в Windows, macOS и Linux и то, что лежит в папке заметки, см. в разделе Где хранятся заметки.
Где находится TinyTeX
Заголовок раздела «Где находится TinyTeX»Когда вы устанавливаете TinyTeX из Настройки → Движки → LaTeX, Oleafly помещает его в ~/.oleafly/tinytex. Исключение составляет Windows, когда в имени вашей пользовательской папки есть буквы с диакритикой или не латинские буквы, например корейское или китайское имя, потому что TeX Live не может работать из такой папки. Тогда TinyTeX попадает в папку с именем Oleafly- плюс короткий код внутри ProgramData, обычно это C:\ProgramData. Права администратора не нужны. Если Oleafly не может подготовить и эту папку, он сообщает об этом. Вы можете продолжать компилировать с Tectonic или самостоятельно установить TeX Live в C:\texlive.
В строке TinyTeX в разделе Управление дистрибутивами TeX показана папка; наведите курсор на размытый путь, чтобы прочитать его. Удаляйте TinyTeX из этой строки, а не вручную стирайте папку.
Создавайте резервные копии
Заголовок раздела «Создавайте резервные копии»| Что вы хотите сохранить | Как сохранить |
|---|---|
| Исходник рукописи и материалы проекта | Скопируйте папку проекта или экспортируйте ZIP с исходником |
| Коммиты Git | Сделайте резервную копию репозитория или отправьте изменения в настроенный удалённый репозиторий |
| Сохранённые контрольные точки | Экспортируйте зашифрованный архив истории из панели «Версии» |
| Настройки приложения и локальные записи | Включите каталог данных Oleafly в обычную резервную копию компьютера |
| Связанные данные и ссылки | Делайте резервные копии их исходных папок |
| Проекты и настройки библиотеки вне этого компьютера | Включите облачную синхронизацию, чтобы хранить копию в вашем Dropbox |
ZIP с исходником не включает кэши сборки и Git. Используйте синхронизацию с GitHub для удалённого репозитория и архивы контрольных точек для истории контрольных точек.
Переезд на другой компьютер
Заголовок раздела «Переезд на другой компьютер»Установите Oleafly и скопируйте или клонируйте проект рукописи. На той машине заново подключите связанные папки и поставщиков моделей. Проект несёт с собой выбор компилятора и метаданные; дополнительные инструменты или пакеты может понадобиться установить. Проект Typst с закреплённой версией, которой на этом компьютере нет, предложит скачать её перед компиляцией.
Пути на экране
Заголовок раздела «Пути на экране»Пути внутри вашей домашней папки отображаются как ~/… в настройках, истории версий, сведениях о движке и агенте и в чате. В настройках пути файлов и папок также остаются размытыми, пока вы не наведёте на них указатель или не доберётесь до них клавишей Tab, поэтому скриншот не показывает, где живут ваши файлы.
Сетевой доступ
Заголовок раздела «Сетевой доступ»Письмо и локальная вычитка происходят на вашей машине. Размещённый ИИ получает контекст, переданный выбранному поставщику. Инструменты, читающие изображения и отсканированные PDF, используют локальную модель Ollama, если только вы не выберете для них облачную модель или Mathpix; тогда файл уходит в этот сервис. Цитаты Zotero обращаются к приложению Zotero на вашем компьютере или к zotero.org, когда вы подключаете учётную запись. Поиск цитат, импорт из Zotero, инструменты alphaXiv, синхронизация с GitHub, загрузка пакетов и версий Typst, другие загрузки и проверки обновлений обращаются к соответствующим службам. Совместная работа отправляет каждый общий проект на тот сервер совместной работы, на котором он опубликован. Облачная синхронизация отправляет ваши проекты библиотеки и настройки в ваш собственный Dropbox. Когда вы открываете Настройки → Справка и о программе, приложение запрашивает общедоступные числа: количество звёзд и форков проекта на GitHub и сколько участников сообщества Discord сейчас в сети. Эти запросы не несут ни учётных данных, ни сведений о проекте или использовании, а офлайн-режим пропускает запрос к Discord. И Tectonic, и Typst поддерживают компиляцию из кэша через офлайн-режим.