# Облачная синхронизация с Dropbox

Резервное копирование проектов библиотеки и настроек в ваш собственный Dropbox и открытие их на других ваших компьютерах. Что синхронизируется, как обрабатываются конфликты и удаления и что означает каждое сообщение.

Облачная синхронизация хранит копию проектов вашей библиотеки и ваших настроек в вашем собственном Dropbox. Подключите тот же Dropbox на другом компьютере, скачайте там свои проекты, и оба компьютера будут поддерживать их в актуальном состоянии.

Откройте **Настройки → Хранение данных → Облачная синхронизация**, чтобы настроить её.

## Перед началом

- Вам нужен аккаунт Dropbox. В бесплатном аккаунте Dropbox Basic доступно 2 ГБ.
- Облачная синхронизация работает на macOS, Windows и Linux.
- Oleafly синхронизирует данные, только пока он открыт, в том числе когда он свёрнут или его окно скрыто. Пока Oleafly закрыт, ничего не синхронизируется.
- Oleafly взаимодействует с Dropbox напрямую. Промежуточного сервера Oleafly нет.

## Подключение Dropbox

1. Откройте **Настройки → Хранение данных → Облачная синхронизация** и выберите **Подключить Dropbox**.
2. В браузере открывается страница входа и подтверждения Dropbox. Войдите на ней и разрешите Oleafly доступ.
3. Oleafly завершает подключение, и после этого браузер сообщает «Вы подключены». Если после подтверждения что-то пойдёт не так, браузер сообщит, что вход не завершён, а Oleafly покажет, что произошло.

Вы входите на собственной странице Dropbox, поэтому Oleafly никогда не видит ваш пароль от Dropbox.

### Если браузер не может вернуться в Oleafly

После подтверждения Dropbox отправляет ваш браузер на локальный адрес вашего компьютера (127.0.0.1), и Oleafly забирает данные входа оттуда. Если это не срабатывает, выберите **Не получается войти? Вставьте код**. Dropbox покажет код. Скопируйте его и вставьте в Oleafly.

### К чему у Oleafly есть доступ

- Oleafly может открыть только собственную папку приложения в вашем Dropbox, `Apps/Oleafly`. Какие-либо другие ваши файлы в Dropbox он увидеть не может.
- Он запрашивает у Dropbox четыре разрешения и никаких других. `account_info.read` показывает ваш адрес электронной почты и сколько места вы занимаете. `files.metadata.read`, `files.content.read` и `files.content.write` позволяют ему просматривать, читать и записывать файлы в собственной папке.
- Вход выполняется по OAuth с PKCE.
- На macOS и Windows маркер входа хранится в связке ключей операционной системы. На Linux или когда связка ключей недоступна, он хранится в зашифрованном файле в папке данных Oleafly.
- Маркер никогда не синхронизируется. Каждый компьютер подключается самостоятельно.

### Карточка «Облачная синхронизация»

После подключения карточка показывает:

- Адрес электронной почты аккаунта Dropbox.
- Кольцо, которое показывает, насколько заполнен ваш Dropbox. По мере заполнения Dropbox оно меняется с зелёного на жёлтый, оранжевый и красный, а от 80% становится красным.
- **Синхронизация на этом компьютере** — переключатель, который включает или выключает синхронизацию здесь.
- **Синхронизировать автоматически** — переключатель, который позволяет Oleafly синхронизироваться самостоятельно.
- Имя этого компьютера. Нажмите его, чтобы переименовать компьютер.
- Список **Проекты**.
- **Дополнительно**, где есть **Отключить**.

## Что синхронизируется

### Проекты

Каждый проект вашей библиотеки синхронизируется вместе со своими файлами, включая папку, в которой компилируется основной документ. Oleafly не включает в синхронизацию:

- результаты сборки, например файлы `.aux` и `.log` и скомпилированный основной PDF. Файл сборки, который вы отслеживаете в Git, например журнал результатов, по-прежнему сохраняется в вашем Dropbox;
- папки Python `__pycache__`;
- папку `.git`;
- рабочие папки самого Oleafly;
- временные файлы редакторов;
- системные файлы, например `.DS_Store`.

Ещё несколько вещей тоже не синхронизируются, и строка проекта перечисляет их как пропущенные с указанием причины: символические ссылки, папки `node_modules` и `.venv`, файлы размером больше 16 ГБ и файлы с [именами, которые не работают на любом компьютере](#renames-and-file-names).

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

История Git и [контрольные точки](/docs/checkpoints/) не синхронизируются.

### Сведения о проекте

Файл `project.json` каждого проекта тоже синхронизируется, поэтому его имя, основной документ, движок, цвет обложки и другие сведения следуют за ним. Несколько сведений принадлежат одному компьютеру и остаются на нём:

- пути экспорта;
- скрыт ли проект;
- спецификация пакетов TeX;
- политика создания контрольных точек;
- от какого проекта он был ответвлён.

### Заметки

Каждая личная [заметка](/docs/notes/) синхронизируется как проект библиотеки, а заметка внутри проекта синхронизируется вместе с файлами этого проекта. Если личная заметка изменилась на двух компьютерах, версия с другого компьютера сохраняется в папке заметки как конфликтная копия, например `note (Laptop 2026-10-14).md`, а **Сравнить конфликтную копию** в меню заметки позволяет оставить одну из версий. Заметка внутри проекта получает конфликтную копию рядом с собой в папке `notes` проекта, как и любой другой файл проекта.

### Настройки

Ваши настройки приложения синхронизируются, включая инструкции для ИИ, персоны и пользовательский словарь. Некоторые настройки остаются на каждом компьютере: включён ли **Синхронизировать автоматически**, **Движок компиляции по умолчанию** для LaTeX, **Shell** и **Путь к shell** терминала, **Computer Use** в разделе «Интеграции», переключатель **Исследовательские задачи** в разделе «Эксперименты» и **По умолчанию разрешать командам задач доступ к сети** в разделе «Исследования». Поэтому агент никогда не получит доступ к приложениям на компьютере только потому, что вы включили их где-то ещё, а компьютер без установленного TeX остаётся на Tectonic, когда другой использует latexmk.

Чаты с ИИ, пароли, ключи API и другие секреты никогда не синхронизируются.

## Что лежит в вашем Dropbox

Всё размещается в папке `Apps/Oleafly`:

```text
Apps/Oleafly/
├── projects/
│   └── <project id>/
│       ├── files/          the project's files, under their own names
│       └── version.json    which version of each file belongs to the project
└── settings/
    └── settings.json       your synced settings
```

Файлы проекта сохраняют собственные имена, поэтому их можно открыть прямо из Dropbox. Редактирование или перемещение файлов в `Apps/Oleafly` вручную не поддерживается. Oleafly считает всё в этой папке недоверенным и проверяет.

## Как работает цикл синхронизации

Каждый цикл проходит одни и те же шаги:

1. Oleafly спрашивает у Dropbox, какие проекты изменились с прошлого цикла. Когда ничего не изменилось, это один запрос.
2. Он сканирует файлы каждого проекта на этом компьютере. Неизменённые файлы распознаются быстро, без повторного чтения.
3. Для каждого файла он сравнивает три версии: ту, что на этом компьютере, ту, что в Dropbox, и последнюю версию, о которой обе стороны пришли к согласию. Это показывает, какая сторона изменилась.
4. Изменения с других ваших компьютеров скачиваются во временное место, и каждый файл проверяется по отпечатку (хешу), записанному для него. Только после этого файл попадает в проект. Если вы изменили этот файл на этом компьютере после сканирования, Oleafly не трогает его до следующего цикла.
5. Изменения с этого компьютера загружаются, затем контрольная сумма самого Dropbox сравнивается с отправленными данными.
6. Сохраняется запись версий проекта с проверкой, что ни один другой компьютер не сохранил свою за это время. Если всё же сохранил, цикл запускается снова с более новой записью, так что работа ни одного компьютера не теряется.
7. В конце из Dropbox удаляются файлы, которые вы удалили на этом компьютере.

## Когда Oleafly синхронизируется

**Синхронизировать автоматически** включено, пока вы его не выключите. Пока оно включено, Oleafly синхронизируется через несколько секунд после сохранения файла и вскоре после того, как другой компьютер изменит ваш Dropbox. Между этими моментами он проверяет Dropbox каждые 5 минут, а пока окно Oleafly скрыто, каждые 15 минут. Первый цикл запускается примерно через 20 секунд после старта Oleafly, а изменения настроек синхронизируются примерно через 3 секунды после того, как вы их внесли. Когда **Синхронизировать автоматически** выключено, Oleafly синхронизируется, когда вы выбираете **Синхронизировать**, и один раз при подключении, при повторном включении **Синхронизация на этом компьютере** или при повторном включении переключателя проекта.

Если цикл завершается неудачно, например потому что вы не в сети, Oleafly повторяет попытку через 30 секунд и после каждой неудачи ждёт дольше, до 5 минут, а пока окно скрыто, до 15 минут. К обычному расписанию он возвращается, как только цикл завершится успешно. Синхронизация также выполняется, когда ваш компьютер снова выходит в сеть.

**Синхронизировать** запускает цикл немедленно и показывает одно сообщение с результатом. Автоматические циклы никогда не показывают всплывающие окна. Их статус отображается в разделе «Проекты»: «Последняя синхронизация» со временем, «Синхронизация проектов» или строка, описывающая проблему.

Когда требуется ваше внимание, например при заполненном Dropbox, приостановленном проекте, копии конфликта или выборе настроек, на кнопке «Настройки» появляется маленькая янтарная точка. «Настройки» затем открываются сразу на облачной синхронизации, чтобы вы первым делом увидели, что не так.

## Конфликты

Если один и тот же файл изменился на двух компьютерах между синхронизациями, Oleafly сохраняет обе версии. Версия этого компьютера остаётся под исходным именем. Версия другого компьютера сохраняется рядом с ней и называется по компьютеру, который её записал, и по дате, например `ch1 (Laptop 2026-10-14).tex`. Второй конфликт в тот же день добавляет число к имени. Строка проекта перечисляет копии конфликтов, пока вы не выберете **Закрыть**.

Откройте оба файла, оставьте нужное и удалите ненужную копию.

`project.json` никогда не получает копию конфликта. Его поля сливаются. Изменения каждого компьютера сохраняются, а если оба компьютера изменили одно поле, побеждает значение этого компьютера.

### Несохранённые правки в безопасности

Синхронизация никогда не перезаписывает файл, открытый в редакторе с несохранёнными изменениями. Изменения с других ваших компьютеров ждут. Как только вы сохраните файл, следующий цикл рассмотрит вашу правку как любую другую, поэтому если файл изменили обе стороны, вы получите копию конфликта.

Открытый файл, который вы не меняли, обновляется в редакторе, как только приходит изменение с другого компьютера. Если изменение приходит во время редактирования, редактор сообщает, что файл изменился на диске, и вы выбираете **Перезагрузить** или **Оставить мою версию**. Новые файлы и копии конфликтов появляются в дереве файлов, а файл, удалённый на другом компьютере, закрывается здесь.

### Переименование и имена файлов

Изменение только регистра имени файла считается переименованием, а не удалением.

Oleafly пропускает эти файлы и перечисляет их в строке проекта:

- Файлы с именами, которые не работают на любом компьютере, например имена с `:` или вроде `CON.tex`
- Файлы, имена которых отличаются от другого имени в той же папке только регистром. Файл, который уже синхронизируется, продолжает синхронизироваться.

Список также показывает файлы, которые Oleafly не смог прочитать здесь или не смог скачать либо загрузить. Файл, который не удалось скачать, будет повторно опробован через час или раньше, если он изменится.

## Удаление файлов

Когда вы удаляете файл на одном компьютере, он удаляется и на других ваших компьютерах. Там файл попадает в системную корзину, а если её нет — в собственную корзину Oleafly. Оттуда его можно вернуть.

Запись, отсутствующая в Dropbox, никогда не удаляет файлы на компьютере. Если кто-то удалит папку проекта в Dropbox вручную, Oleafly загрузит проект заново. Если в записи проекта в Dropbox нет `project.json`, Oleafly загружает этот файл заново, а не удаляет его.

### Защита от удаления множества файлов

Если за один раз удаляется больше половины файлов проекта на одном компьютере и это больше 20 файлов, Oleafly не передаёт удаление дальше. То же происходит, если удалены все файлы проекта. Перемещение или переименование папки не считается удалением, потому что файлы всё ещё существуют. Проект показывает «Приостановлено для защиты ваших файлов» с двумя вариантами:

- **Вернуть их** восстанавливает файлы из Dropbox.
- **Удалить и из Dropbox** удаляет их и из Dropbox после вашего подтверждения. Тогда другие ваши компьютеры тоже их потеряют.

Та же проверка работает и в обратную сторону. Если из записи проекта в Dropbox вдруг пропало много файлов, например потому что запись восстановили из более старой версии, Oleafly не удаляет их на этом компьютере. Проект показывает «Приостановлено для защиты ваших файлов» с двумя вариантами:

- **Вернуть их в Dropbox** загружает файлы с этого компьютера заново.
- **Удалить и здесь** перемещает их в корзину этого компьютера после вашего подтверждения.

## Список проектов

У каждого проекта вашей библиотеки есть строка, показывающая его размер и время последней синхронизации.

- Его переключатель включает синхронизацию проекта на этом компьютере или приостанавливает её здесь.
- У проекта, который есть только в Dropbox, есть кнопка скачивания. **Скачать все** скачивает их все, кроме проектов, находящихся в корзине этого компьютера. Скачанный проект появляется в вашей библиотеке.
- Если проект находится в корзине этого компьютера, скачивание восстанавливает его из корзины, а не создаёт вторую копию. Следующая синхронизация принесёт изменения, сделанные в другом месте.
- Проект, скачанный из Dropbox, открывается в ограниченном режиме, пока вы не доверите ему на этом компьютере. Появляется то же приглашение доверия, что и для [папки, открытой на месте](/docs/library/#folders-opened-in-place).

### Удаление проекта из Dropbox

Чтобы освободить место, выберите **Удалить из Dropbox** в меню **…** в строке проекта. Это удаляет копию проекта в Dropbox. Проект остаётся на этом компьютере и перестаёт синхронизироваться здесь. Другие ваши компьютеры сохраняют свои копии и показывают «Удалено из Dropbox на компьютере», за которым идёт имя этого компьютера.

Включите переключатель проекта снова, чтобы загрузить его заново.

У проектов, которые есть только в Dropbox, в меню тоже есть **Удалить из Dropbox**. Это удаляет их из вашего Dropbox, поэтому потом их нельзя скачать на этом компьютере. Компьютеры, на которых они уже есть, сохраняют свои копии.

Если Dropbox не может удалить папку сразу, проект всё равно отображается как удалённый, и Oleafly завершит удаление при одной из следующих синхронизаций.

## Хранилище и заполненный Dropbox

Кольцо на карточке облачной синхронизации показывает, насколько заполнен ваш Dropbox, и становится красным от 80%. В бесплатном аккаунте Dropbox Basic доступно 2 ГБ.

Когда ваш Dropbox заполнен, загрузки останавливаются, но скачивания продолжают работать. Об этом сообщает баннер, и это же показывает каждый проект, который не удалось загрузить. Пока место занято, Oleafly проверяет перед загрузкой, сколько места осталось, поэтому никогда не отправляет файл, который не поместится. Чтобы освободить место, сделайте одно из следующего:

- Выключите синхронизацию для больших проектов.
- Удалите проекты из Dropbox.
- Освободите место в Dropbox.

Синхронизация продолжится сама, как только появится место.

## Работа без сети и прерванные синхронизации

Когда вы не в сети, ваши правки остаются на вашем компьютере, и ничего не теряется. Синхронизация продолжится после восстановления соединения.

Если цикл останавливается на полпути, например из-за обрыва сети или закрытия Oleafly, следующий цикл завершит работу. Долгое первое резервное копирование сохраняет прогресс каждые 200 файлов или 256 МБ, поэтому не начинается заново. Выключение переключателя **Синхронизация на этом компьютере** останавливает выполняющийся цикл.

Пока команда Git меняет файлы проекта, например checkout или pull в терминале, цикл ждёт и повторяет попытку в следующий раз. В Windows файл, открытый в другой программе, обрабатывается повторно через несколько минут.

Когда Dropbox просит Oleafly замедлиться или происходит временная ошибка, Oleafly повторяет попытки самостоятельно.

Если на этом компьютере заканчивается место на диске, скачивания ждут, пока вы его освободите. Загрузки продолжаются.

## Синхронизация настроек

При первом подключении компьютера Oleafly сравнивает его настройки с теми, что находятся в вашем Dropbox. Если они различаются, он один раз спрашивает: «Какие настройки должен использовать Oleafly?» Выберите **Использовать настройки из Dropbox** или **Оставить настройки этого компьютера**. Если закрыть диалог, сам он больше не появится. Те же два варианта ждут на карточке облачной синхронизации, и ничего не перезаписывается, пока вы не выберете один из них.

После этого настройки сливаются автоматически:

- Изменения разных настроек на разных компьютерах сохраняются все.
- Если одна и та же настройка изменилась на обоих, побеждает значение этого компьютера.
- Списки, например слова из вашего словаря, объединяются. Персоны ИИ сливаются по одной, поэтому персона, изменённая на двух компьютерах, остаётся одной персоной.

Чтобы самому загрузить настройки из Dropbox, откройте **Настройки → Общие → Импортировать** и выберите **Импортировать из облака**. Вы пройдёте тот же шаг просмотра, что и при импорте файла настроек.

## Компьютеры и аккаунты

### Имя этого компьютера

У каждого компьютера есть имя. Изначально это имя хоста компьютера. Нажмите имя на карточке облачной синхронизации, чтобы изменить его. Другие ваши компьютеры показывают его на копиях конфликтов и в отметках «Удалено из Dropbox».

### Отключение

Откройте **Дополнительно**, выберите **Отключить** и подтвердите. Синхронизация на этом компьютере останавливается, и доступ Oleafly к вашему Dropbox удаляется. Ваши проекты остаются на этом компьютере и в вашем Dropbox. Если в этот момент Oleafly не может связаться с Dropbox, он всё равно отключается здесь и сообщает вам об этом, а удалить Oleafly из подключённых приложений Dropbox вы можете сами.

### Переход на другой аккаунт Dropbox

Подключение другого аккаунта Dropbox начинается с чистого листа. Ничего не сравнивается со старым аккаунтом, и ничего из-за этого не удаляется.

### Когда доступ прекращается

Если доступ Oleafly прекращается, например потому что вы удалили Oleafly из подключённых приложений Dropbox, карточка сообщает: «Доступ к Dropbox прекращён. Подключитесь снова, чтобы продолжить синхронизацию.» Выберите **Подключить снова**.

### Более новый Oleafly на другом компьютере

Если на другом компьютере работает более новая версия Oleafly, которая сохранила проект в новом формате, старые версии прекращают синхронизацию этого проекта и просят вас [обновить Oleafly](/docs/updates/).

## Проверки безопасности

- Каждый файл из Dropbox проверяется по записанному для него отпечатку, прежде чем что-либо заменить.
- Ничто из Dropbox не записывается в `.git`, за пределы папки проекта или через символическую ссылку.
- Файл `project.json` из Dropbox, который эта версия Oleafly не может открыть, никогда не заменяет файл на этом компьютере.
- Проект, которому вы доверили запуск команд оболочки при компиляции, снова спрашивает об этом перед следующей компиляцией, после того как файлы пришли из Dropbox, так же как после Git pull.
- Oleafly считает всё в `Apps/Oleafly` недоверенным и проверяет.
- Oleafly не добавляет сквозное шифрование для ваших файлов в Dropbox. Они хранятся в вашем Dropbox как любые другие файлы.

## Устранение неполадок

| Сообщение или признак | Что делать |
| --- | --- |
| Браузер не возвращается в Oleafly | Выберите **Не получается войти? Вставьте код** и вставьте код, который покажет Dropbox. |
| «Доступ к Dropbox прекращён. Подключитесь снова, чтобы продолжить синхронизацию.» | Выберите **Подключить снова** и разрешите Oleafly в браузере. |
| «Какие настройки должен использовать Oleafly?» | Выберите **Использовать настройки из Dropbox** или **Оставить настройки этого компьютера**. Закройте диалог, чтобы решить позже на карточке облачной синхронизации. Ничего не перезаписывается. |
| «Приостановлено для защиты ваших файлов» | За один раз было удалено много файлов, здесь или в Dropbox. Выберите **Вернуть их** или **Вернуть их в Dropbox**, чтобы сохранить файлы, или **Удалить и из Dropbox** либо **Удалить и здесь**, если они должны исчезнуть. |
| Появляется файл вроде `ch1 (Laptop 2026-10-14).tex` | Это копия конфликта с компьютера, в честь которого она названа. Сравните два файла, оставьте нужное и удалите другой. |
| Строка проекта сообщает, что файлы были пропущены | Откройте список, чтобы увидеть каждый файл и причину. Переименуйте файлы с именами, которые не работают на любом компьютере или совпадают с другим именем не только регистром. |
| Янтарная точка на кнопке «Настройки» | Облачной синхронизации нужно ваше внимание. Откройте «Настройки» и прочитайте карточку облачной синхронизации. |
| «Oleafly не может прочитать копию в вашем Dropbox, поэтому этот проект не синхронизируется.» | Выберите **Заменить копией с этого компьютера**. Всё, что есть только в копии в Dropbox, будет потеряно, поэтому сначала проверьте другие ваши компьютеры. |
| «Oleafly не может прочитать настройки в вашем Dropbox.» | Выберите **Использовать настройки этого компьютера**, чтобы заменить их. |
| «На этом компьютере заканчивается место на диске.» | Освободите место на диске. Синхронизация продолжится сама. |
| «В этом проекте больше 100 000 файлов. Это слишком много для синхронизации.» | Переместите файлы, которые не нужны проекту, из его папки. |
| «Удалено из Dropbox на компьютере» и имя компьютера | Тот компьютер удалил проект из Dropbox. Ваша копия здесь в безопасности. Включите переключатель проекта, чтобы загрузить его заново. |
| «Ваш Dropbox заполнен.» | Выключите синхронизацию для больших проектов, удалите проекты из Dropbox или освободите место в Dropbox. Скачивания продолжают работать, а синхронизация продолжится, как только появится место. |
| «Ваш Dropbox достиг лимита отправки на этот месяц.» | Dropbox ограничивает, сколько данных некоторые аккаунты могут отправить за месяц. Ваши изменения остаются на этом компьютере и будут отправлены, когда Dropbox снова это разрешит. |
| «Не удалось связаться с Dropbox. Oleafly попробует ещё раз.» | Проверьте подключение. Ваши правки остаются на этом компьютере, и Oleafly синхронизирует их, когда вы снова будете в сети. |
| «Этот проект синхронизирован более новой версией Oleafly. Обновите Oleafly, чтобы продолжить его синхронизацию.» | [Обновите Oleafly](/docs/updates/) на этом компьютере. |
| Скачанный проект открывается в ограниченном режиме | Доверьте ему на этом компьютере, когда узнаете, что в нём находится. |
| Ничего не синхронизируется | Проверьте, что включён переключатель **Синхронизация на этом компьютере** и включён переключатель проекта. Oleafly синхронизирует данные, только пока он открыт. Если **Синхронизировать автоматически** выключено, выберите **Синхронизировать**. |

Перемещаете проекты с помощью Git? См. [Синхронизация с GitHub](/docs/github-sync/). О том, что Oleafly хранит на вашем компьютере, см. [Ваши файлы и данные](/docs/where-your-data-lives/).
