Sync Fork

Кнопка Sync Fork из GitHub — прямо в VS Code. Нажмите кнопку, чтобы обновить ветку своего форка на GitHub из исходного репозитория.

Как пользоваться

1. Откройте локальный клон форка. Remote origin должен указывать на ваш форк на GitHub.com.
2. Нажмите Sync Fork внизу окна или значок синхронизации в заголовке Source Control (Ctrl+Shift+G). Также доступна команда Sync Fork через Ctrl+Shift+P.
3. При первом запуске разрешите расширению доступ к GitHub через стандартный вход VS Code.
4. Готово: GitHub синхронизирует ветку форка с исходным репозиторием. Отдельный push не нужен.

Исходный репозиторий определяется самим GitHub. Настраивать upstream и вручную вводить его URL не нужно.

Какая ветка обновляется

Если текущая локальная ветка отслеживает ветку origin, обновляется эта удалённая ветка. Иначе используется имя текущей локальной ветки. Если такой ветки на GitHub нет, расширение предлагает основную ветку форка (main, master или другую). При detached HEAD используется основная ветка форка.

Как и кнопка на сайте GitHub, расширение обновляет репозиторий на сервере. Локальные файлы, коммиты и незакоммиченные изменения остаются на месте. Чтобы получить результат на компьютер, используйте обычный Pull в VS Code.

При конфликте GitHub отклоняет синхронизацию; расширение предлагает открыть форк на сайте. Принудительного сброса или удаления собственных коммитов нет. Фоновой синхронизации нет — операция запускается по нажатию.

Закрытые репозитории

Поддерживаются при наличии у выбранного аккаунта доступа к исходному репозиторию и права записи в форк. Вход использует GitHub Authentication в VS Code со scopes repo и workflow (для обновлений файлов GitHub Actions). Токены не записываются в настройки или логи расширения. Организация может требовать разрешения OAuth-приложения и SSO.

Поддерживаются стандартные HTTPS и SSH URL GitHub.com. GitHub Enterprise и SSH-алиасы пока не поддерживаются. Требуются Git и доверенная рабочая папка.

Разработка

F5 запускает отдельное окно с расширением. npm test проверяет выбор ветки, API-вызовы и обработку ошибок на подставных ответах GitHub. npm run package собирает VSIX. Для проверки реальной авторизации и синхронизации используйте тестовый форк.