Синхронизация с GitHub
Подключите GitHub по коду устройства или токену, опубликуйте проект как новый или существующий репозиторий, отправляйте и получайте изменения между компьютерами и узнайте, как защищён ваш токен.
Синхронизация с GitHub — это необязательная резервная копия вне этого компьютера и перенос работы между машинами, построенные на настоящем репозитории Git, которым и так является каждый проект. Локальные коммиты работают и без 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 в вашей текущей ветке. Извлечь и Синхронизировать находятся в меню Другие действия контроля версий, а Коммит и отправка и Коммит и синхронизация — в меню рядом с Коммит. Индикатор вперёд/назад (↑ ↓) рядом с плашкой ветки подсказывает, когда есть что отправить или получить.
Два компьютера
Заголовок раздела «Два компьютера»- На компьютере A: опубликуйте проект, поработайте, нажмите Отправить.
- На компьютере B: подключите ту же учётную запись GitHub, затем выберите Импорт проекта → GitHub и укажите репозиторий. См. руководство по импорту. Дальше: Получить, поработать, Отправить.
- Вернувшись на A: нажмите Получить, прежде чем начать. Индикатор об этом напомнит.
Цвет обложки, выбор главного документа и история переезжают вместе с проектом, потому что живут в самой папке проекта.
Если вы передумали
Заголовок раздела «Если вы передумали»Когда внешний репозиторий задан, в меню Другие действия контроля версий появляются ещё два пункта:
- Сменить репозиторий заново открывает диалог публикации, чтобы направить
originв другое место. - Отвязать убирает внешний репозиторий; локальный проект и его история не затрагиваются.
Конфликты и ветки
Заголовок раздела «Конфликты и ветки»Если получение натыкается на конфликт слияния, Контроль версий перечисляет конфликтующие файлы. Для каждого выберите Взять текущую или Взять входящую либо отредактируйте файл и выберите Отметить как разрешённый, затем нажмите Завершить слияние. Прервать слияние возвращает файлы в прежнее состояние. Отправить и Получить работают с веткой, на которой вы стоите, а меню веток вверху панели переключает или создаёт ветки. См. Git и контроль версий.
Ограничения, коротко и прямо
Заголовок раздела «Ограничения, коротко и прямо»Oleafly аутентифицирует внешние репозитории по HTTPS. Публикация настраивает всё правильно за вас.
Если что-то не работает
Заголовок раздела «Если что-то не работает»- «No remote ‘origin’»: сначала опубликуйте проект; Отправить и Получить требуют внешний репозиторий.
- Отправка отклонена, потому что во внешнем репозитории есть коммиты: сначала получите изменения, затем отправьте.
- «No GitHub token set»: подключитесь в Настройках, в разделе Интеграции, пункт GitHub.
Больше ответов — в FAQ.