# Синхронизация с GitHub

Подключите GitHub по коду устройства или токену, опубликуйте проект как новый или существующий репозиторий, отправляйте и получайте изменения между компьютерами и узнайте, как защищён ваш токен.

Синхронизация с GitHub — это необязательная резервная копия вне этого компьютера и перенос работы между машинами, построенные на [настоящем репозитории Git](/docs/git-history/), которым и так является каждый проект. Локальные коммиты работают и без GitHub. Когда вы подключаетесь, учётной записи Oleafly в этой схеме по-прежнему нет: только ваш GitHub.

## Подключение учётной записи

Настройки, **Интеграции**, **GitHub**, затем любой из двух путей:

- **Подключить GitHub** (рекомендуется): поток с кодом устройства. Oleafly показывает короткий код, ваш браузер открывает `github.com/login/device` (с кнопкой **Копировать** для кода), вы подтверждаете, и приложение обнаруживает это за секунды. Подключение запрашивает только права `repo` и `read:user`.
- **Личный токен доступа**: разверните «Дополнительно: использовать личный токен доступа» и вставьте PAT, если предпочитаете создавать учётные данные самостоятельно.

После подключения ваш аватар и имя пользователя появляются в Настройках и в меню GitHub верхней панели. **Отключить** забывает токен.

### Как защищён ваш токен

Токен хранится в зашифрованном алгоритмом AES-256-GCM локальном файле, доступном только владельцу, и никогда не передаётся слою интерфейса приложения; интерфейс узнаёт лишь «подключено как @you». Когда Git требуется аутентификация, токен подставляется через находящийся в памяти помощник учётных данных, поэтому он не появляется ни в командной строке, ни в `.git/config`, ни в истории вашей оболочки. Старые сборки, встраивавшие токены в URL внешних репозиториев, очищаются автоматически при запуске.

## Публикация проекта

В панели Контроля версий нажмите **Опубликовать на GitHub**:

- **Создать новый репозиторий**: выберите имя (предзаполненное из проекта), оставьте или снимьте флажок **Закрытый** (рекомендуется оставить) и нажмите **Создать и отправить**. Oleafly создаст репозиторий, закоммитит файлы проекта, подключит `origin` и отправит изменения.
- **Связать с существующим**: выберите из списка ваших репозиториев с поиском (закрытые помечены замком) и нажмите **Связать и отправить**.

После публикации меню GitHub на панели инструментов предлагает **Открыть в GitHub** и **Копировать ссылку на репозиторий**.

### Файлы, похожие на секреты, остаются локальными

Публикация никогда не коммитит файлы, которые обычно содержат ключи или пароли, например `.env`, `*.pem`, приватные ключи SSH или `credentials.json`. Они остаются в папке проекта без индексации, и диалог называет их по именам. Чтобы всё же опубликовать такой файл, добавьте его в индекс и закоммитьте сами в Контроле версий. Шаблоны вроде `.env.example`, публичные ключи и файлы Keynote `.key` публикуются как обычно.

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

## Повседневная синхронизация

Кнопки **Отправить** и **Получить** панели Контроля версий делают ровно то, что написано: работают с `origin` в вашей текущей ветке. **Извлечь** и **Синхронизировать** находятся в меню **Другие действия контроля версий**, а **Коммит и отправка** и **Коммит и синхронизация** — в меню рядом с **Коммит**. Индикатор **вперёд/назад** (↑ ↓) рядом с плашкой ветки подсказывает, когда есть что отправить или получить.

### Два компьютера

1. На компьютере A: опубликуйте проект, поработайте, нажмите **Отправить**.
2. На компьютере B: подключите ту же учётную запись GitHub, затем выберите **Импорт проекта → GitHub** и укажите репозиторий. См. [руководство по импорту](/docs/import-project/#import-from-github). Дальше: **Получить**, поработать, **Отправить**.
3. Вернувшись на A: нажмите **Получить**, прежде чем начать. Индикатор об этом напомнит.

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

## Если вы передумали

Когда внешний репозиторий задан, в меню **Другие действия контроля версий** появляются ещё два пункта:

- **Сменить репозиторий** заново открывает диалог публикации, чтобы направить `origin` в другое место.
- **Отвязать** убирает внешний репозиторий; локальный проект и его история не затрагиваются.

## Конфликты и ветки

Если получение натыкается на конфликт слияния, Контроль версий перечисляет конфликтующие файлы. Для каждого выберите **Взять текущую** или **Взять входящую** либо отредактируйте файл и выберите **Отметить как разрешённый**, затем нажмите **Завершить слияние**. **Прервать слияние** возвращает файлы в прежнее состояние. Отправить и Получить работают с веткой, на которой вы стоите, а меню веток вверху панели переключает или создаёт ветки. См. [Git и контроль версий](/docs/git-history/#branches-and-stashes).

## Ограничения, коротко и прямо

Oleafly аутентифицирует внешние репозитории по HTTPS. Публикация настраивает всё правильно за вас.

## Если что-то не работает

- «No remote 'origin'»: сначала опубликуйте проект; Отправить и Получить требуют внешний репозиторий.
- Отправка отклонена, потому что во внешнем репозитории есть коммиты: сначала получите изменения, затем отправьте.
- «No GitHub token set»: подключитесь в Настройках, в разделе Интеграции, пункт GitHub.

Больше ответов — в [FAQ](/docs/faq/#history-and-collaboration).
