# Ваши файлы и данные

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

Ваша рукопись — это папка с обычными файлами исходника. Эти файлы можно открыть другим редактором, скопировать в резервную копию или забрать из Oleafly.

## Файлы проекта

Проекты из библиотеки обычно живут в `~/.oleafly/projects/`. Проект может содержать основной документ LaTeX, Typst или Markdown, библиографию, рисунки и исследовательские материалы.

`project.json` хранит сведения о проекте и его настройки, включая основной документ, движок и закреплённую версию Typst. Каталог `.git` содержит историю Git. Проект, созданный или импортированный в Oleafly, обычно начинается с одного коммита своих файлов с названием «Создать проект» (см. [Git и контроль версий](/docs/git-history/#the-first-commit)). Каталог `.oleafly/build/` содержит сгенерированные результаты сборки и может быть воссоздан компиляцией.

Проект Typst может хранить копии пакетов, которые он импортирует, в папке `typst-packages`, поэтому он компилируется офлайн и на других компьютерах. Typst также использует шрифты из папки `fonts` проекта. Обе папки путешествуют вместе с проектом.

Папка, [открытая на месте](/docs/library/#folders-opened-in-place), остаётся там, где она есть. Oleafly хранит сборки, настройки, контрольные точки и чаты такой папки в собственной папке данных, поэтому в вашу ничего не добавляется.

## Данные, хранящиеся вне проекта

Настройки приложения, зашифрованные учётные данные поставщиков, записи чатов и использования, скачанные инструменты вроде дополнительных версий Typst и сохранённые контрольные точки относятся к локальному хранилищу приложения. Там же лежат копии проекта, которые Oleafly делает перед каждой репликой ассистента или агента и которые позволяют отменить изменения файлов, сделанные той репликой. Копия вашей библиотеки Zotero, которую читает поиск по `@`, тоже живёт там, а не в проекте. Копирование папки рукописи не копирует все эти данные приложения.

[Связанные папки](/docs/linked-folders/) остаются в своих исходных местах. Архив исходников не включает их содержимое лишь потому, что вы их связали.

## Где живут заметки

[Заметки](/docs/notes/) — это файлы Markdown на вашем компьютере. Каждая личная заметка — это папка в папке проектов, рядом с проектами вашей библиотеки. Заметка проекта — это файл `.md` в папке `notes` проекта, поэтому она путешествует вместе с проектом. Папку в Windows, macOS и Linux и то, что лежит в папке заметки, см. в разделе [Где хранятся заметки](/docs/notes/#where-notes-are-stored).

## Где находится 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 в обычную резервную копию компьютера |
| Связанные данные и ссылки | Делайте резервные копии их исходных папок |
| Проекты и настройки библиотеки вне этого компьютера | Включите [облачную синхронизацию](/docs/cloud-sync/), чтобы хранить копию в вашем Dropbox |

ZIP с исходником не включает кэши сборки и Git. Используйте [синхронизацию с GitHub](/docs/github-sync/) для удалённого репозитория и [архивы контрольных точек](/docs/checkpoints/) для истории контрольных точек.

## Переезд на другой компьютер

Установите Oleafly и скопируйте или клонируйте проект рукописи. На той машине заново подключите связанные папки и поставщиков моделей. Проект несёт с собой выбор компилятора и метаданные; дополнительные инструменты или пакеты может понадобиться установить. Проект Typst с закреплённой версией, которой на этом компьютере нет, предложит скачать её перед компиляцией.

## Пути на экране

Пути внутри вашей домашней папки отображаются как `~/…` в настройках, истории версий, сведениях о движке и агенте и в чате. В настройках пути файлов и папок также остаются размытыми, пока вы не наведёте на них указатель или не доберётесь до них клавишей Tab, поэтому скриншот не показывает, где живут ваши файлы.

## Сетевой доступ

Письмо и локальная вычитка происходят на вашей машине. Размещённый ИИ получает контекст, переданный выбранному поставщику. Инструменты, читающие изображения и отсканированные PDF, используют локальную модель Ollama, если только вы не выберете для них облачную модель или Mathpix; тогда файл уходит в этот сервис. Цитаты Zotero обращаются к приложению Zotero на вашем компьютере или к zotero.org, когда вы подключаете учётную запись. Поиск цитат, импорт из Zotero, инструменты alphaXiv, синхронизация с GitHub, загрузка пакетов и версий Typst, другие загрузки и проверки обновлений обращаются к соответствующим службам. [Совместная работа](/docs/collaboration/) отправляет каждый общий проект на тот сервер совместной работы, на котором он опубликован. [Облачная синхронизация](/docs/cloud-sync/) отправляет ваши проекты библиотеки и настройки в ваш собственный Dropbox. Когда вы открываете **Настройки → Справка и о программе**, приложение запрашивает общедоступные числа: количество звёзд и форков проекта на GitHub и сколько участников сообщества Discord сейчас в сети. Эти запросы не несут ни учётных данных, ни сведений о проекте или использовании, а офлайн-режим пропускает запрос к Discord. И Tectonic, и Typst поддерживают компиляцию из кэша через офлайн-режим.

[Прочитать о принципах продукта →](/docs/philosophy/)
