Удалённый доступ позволяет подключаться к текущей Copilot CLI сессии из любого браузера или из GitHub Mobile. Вы можете просматривать результаты сессии, отвечать на запросы разрешений и продолжать работу в сессии, не находясь на машине, где она работает.
В этой статье объясняется, как включить и использовать удалённый доступ. Для получения дополнительной концептуальной информации см. О удалёном доступе к GitHub Copilot CLI сессиям.
Примечание.
- Удалённый доступ к Copilot CLI сессиям актуален public preview и может измениться.
- Мобильный доступ в настоящее время доступен только в последней бета-версии GitHub Mobile. Вы можете присоединиться к тестовой GitHub Mobile программе через Apple TestFlight для iOS и Google Play для Android.
Необходимые условия
-
Машина, на которой работает сессия CLI, должна быть онлайн, а сессия активно работает в терминале.
Совет
Используйте
/keep-aliveкоманду слэш, чтобы не дать машине засыпать, пока вас нет. См. раздел «Предотвращение перехода вашей машины в спящий режим». -
Рабочий каталог должен содержать репозиторий Git, размещённый на GitHub.com. Если вы не находитесь в GitHub репозитории, CLI отображает: «Удаленная сессия отключена: не в GitHub репозитории.»
Включение удалённого доступа для сессии
Вы можете включить удалённый доступ тремя способами:
- С помощью команды «слэш» во время интерактивной сессии.
- С командной строкой при запуске Copilot CLI.
- Настроив CLI так, чтобы по умолчанию был доступен удалённый доступ для всех интерактивных сессий.
Использование /remote команды косой черты
Если вы уже находитесь в интерактивной сессии и хотите включить удалённый доступ, введите:
/remote
/remote
CLI подключается к GitHub.com и отображает детали для удалённого доступа к сессии — см. разделы «Доступ к сессии с GitHub.com и Доступ к сессии из GitHub Mobile позже» в этой статье.
Использование --remote опции командной строки
Если вы думаете, что хотите получить доступ к сессии удалённо, можно запустить CLI с --remote командной строки. Это избавляет от необходимости не забывать использовать /remote команду «слэш» во время сессии.
copilot --remote
copilot --remote
Детали для удалённого доступа к сессии отображаются при начале интерактивной сессии и могут быть отображены снова в любое время с помощью /remote команды slash.
Настройка удалённого доступа так, чтобы он всегда был включён
Если вы всегда хотите, чтобы ваши интерактивные CLI-сессии были удалённо доступны, добавьте следующее в ваш Copilot конфигурационный файл (обычно расположенный по адресу ~/.copilot/config.json:
{
"remoteSessions": true
}
{
"remoteSessions": true
}
Чтобы переопределить эту настановку для конкретной сессии, используйте --no-remote опцию при начале сессии:
copilot --no-remote
copilot --no-remote
Примечание.
Командные опции --remote всегда --no-remote имеют приоритет над remoteSessions настройками в конфигурационном файле.
Доступ к сессии из GitHub.com
Когда удалённый доступ включен, CLI отображает ссылку в формате:
https://github.com/OWNER/REPO/tasks/TASK_ID
Используйте эту ссылку, чтобы получить доступ к сессии в веб-браузере. Вы должны войти GitHub с той же учётной записи, с которой началась сессия CLI.
Вы также можете получить доступ к сессии из списка недавних сессий агентов по адресу GitHub.com:
- В левом верхнем углу GitHubнажмите .
- Клик Copilot.
- В разделе «Недавние сессии агента» нажмите на вашу Copilot CLI сессию, чтобы открыть её.
Внимание
Сессии зависят от пользователя: вы можете получить доступ только к своим сессиям Copilot CLI . Другие GitHub пользователи не могут получить доступ к вашим сессиям.
Доступ к сессии из GitHub Mobile
Copilot CLI Сессия доступна GitHub Mobile сразу после включения удалённого доступа. Чтобы найти свою сессию в:GitHub Mobile
-
Нажмите кнопку Copilot в правом нижнем углу экрана.
Сессия указана в разделе «Сессии агентов».
-
Нажмите на сессию, чтобы открыть её.
Используйте QR-код, чтобы быстро открыть сессию на телефоне
-
В интерактивной сессии введите
/remoteкоманду слэш, чтобы повторно отобразить данные удалённой сессии. -
Нажмите Ctrl+E , чтобы включить/выключить отображение QR-кода.
Примечание.
Этот клавишный ярлык расширяет/сворачивает все детали сессионного разговора, а не только QR-код. Это работает только если поле ввода в данный момент пусто.
-
Отсканируйте QR-код на телефоне, чтобы сразу перейти к сессии в GitHub Mobile.
Предотвращение перехода машины в спящий режим
Вы можете использовать /keep-alive команду «слэш», чтобы не дать машине засыпать. Это позволяет поддерживать удалённое соединение и продолжать взаимодействие с сессией из GitHub.com или GitHub Mobile.
В интерактивной сессии введите /keep-alive OPTION, где OPTION — один из:
-
`on`: Предотвращает переход машины в спящий режим, пока активна сессия CLI. -
`off`: Позволяет машине засыпать как обычно. -
`busy`: Не даёт машине засыпать только во время Copilot выполнения задачи. После выполнения задачи машина может перейти в режим спящего режима. Машина не перейдёт в спящий режим, если Copilot ждёт вашего ответа на ваш запрос. -
`NUMBERm`, `NUMBERh`, или `NUMBERd` (например, `30m`, `8h`, `1d`): Не даёт машине засыпать на определённое количество минут, часов или дней. Если чистое число указано без суффикса, это считается минутами.
Без передачи OPTION, /keep-alive команда отображает текущий статус keep-alive.
Возобновление сессии с удалённым доступом
Когда вы закрываете сессию с включённым удалённым доступом, CLI отображает команду возобновления, включающую --remoteв себя:
copilot --resume=SESSION_ID --remote
Используйте эту команду, чтобы перезапустить сессию с включённым удалённым доступом.
Аналогично, добавление --remote команды copilot --continue возобновляет последнюю сессию с включённым удалённым доступом.
Если у вас в Copilot конфигурационном файле"remoteSessions": true, возобновлённые сессии будут автоматически включать удалённый доступ, и вам не нужно использовать эту --remote опцию.
Предотвращение удалённого доступа
Удалённый доступ по умолчанию отключён, но может быть включен в вашем Copilot конфигурационном файле. Вы можете убедиться, что сессия не будет доступна удалённо, следующим образом:
-
**Для одной сессии**: Запустите CLI, `--no-remote` чтобы предотвратить удалённый доступ для этой сессии, независимо от настройки конфигурационного файла. -
**Навсегда**: удалите `"remoteSessions": true` эту настановку из Copilot файла конфигурации (или установите его на `false`).