Skip to main content

Использование локальной песочницы

Включите локальную песочницу, чтобы Copilot CLI запустить команды и средства, которые он вызывает от вашего имени в песочнице операционной системы.

Примечание.

Локальные песочницы для GitHub Copilot них находятся и подвергаются Публичный предварительный просмотр изменению.

Внимание

Для локальной песочницы в Windows требуется сборка Windows insiders.

Сведения о локальной песочнице

Песочница в настоящее время является экспериментальной функцией. Чтобы воспользоваться им, начните Copilot CLI с ‑‑experimental командной строки или введите /experimental on во время сессии.

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

По умолчанию изолированные команды и средства могут записываться в текущий рабочий каталог и временные папки. Каталог профилей пользователей (дома) вместе с расположениями систем и инструментов доступны только для чтения. Другие расположения дисков заблокированы. В репозитории Git остальная часть репозитория над текущим рабочим каталогом доступна для чтения, но не доступна для записи. Доступ к локальной и частной сети разрешен, так как исходящий доступ к Интернету.

По умолчанию операции с проверкой подлинности Git и GitHub CLI (gh) продолжают работать в песочнице, так как Copilot CLI ваши GitHub учетные данные доступны для изолированных команд. Это позволяет выполнять такие действия, как git push и gh pr create успешно. Это можно отключить в параметрах песочницы.

Общие сведения об песочнице см. в Copilot CLIразделе Сведения об облачных и локальных песочницах для GitHub Copilot.

Команды песочницы

Вы управляете локальной песочницей из сеанса Copilot CLI с помощью команды косой /sandbox черты. Он содержит следующие подкоманда.

CommandОписание
/sandbox statusОтображение того, используется ли песочница в настоящее время для сеанса. Проверьте, используется ли песочница.
/sandbox policyОтображение эффективной политики файловой системы для текущего каталога — путей, доступных для чтения, записи или блокировки, а также принудительного доступа к сети. Дополнительные сведения см. в разделе Общие сведения о политиках файловой системы для локальной песочницы GitHub Copilot CLI.
/sandbox configОткройте интерфейс интерактивных параметров. Вход /sandbox в себя делает то же самое. Дополнительные сведения см. в разделе Настройка локальных настроек песочницы.
/sandbox enableВключите локальную песочницу. См. раздел "Включение локальной песочницы".
/sandbox disableОтключите локальную песочницу. Если для управляемых параметров предприятия требуется песочница, это отказано. См. раздел "Отключение локальной песочницы".

Возможность локального песочницы

Чтобы включить локальную песочницу, введите следующую команду в интерактивном Copilot CLI сеансе:

Shell
/sandbox enable

Песочница начинает использоваться немедленно для текущего сеанса.

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

Примечание.

Если при вводе /sandbox enableоткрыты другие сеансы, песочница не сразу используется в этих сеансах. Чтобы использовать песочницу в уже открытом сеансе, выполните одно из следующих действий в этом сеансе:

  • Закройте сеанс и перезапустите его, например, выполнив команду copilot --continue.
  • Введите /sandbox enable.

Отключение локальной песочницы

Если для управляемых параметров предприятия требуется песочница, ее нельзя отключить и /sandbox disable отклонить.

Чтобы остановить использование локальной песочницы, введите следующую команду в интерактивном Copilot CLI сеансе:

Shell
/sandbox disable

Песочница больше не используется в текущем сеансе или в новых и перезапускаемых сеансах.

Выбор того, следует ли использовать локальную песочницу в качестве sandbox.enabled параметра в файле личных параметров для ИНТЕРФЕЙСА командной строки (~/.copilot/settings.json по умолчанию).

Использование песочницы для одного сеанса

Вы можете использовать --sandbox параметр командной строки для использования песочницы для одного сеанса без включения песочницы для других сеансов. Если песочница уже включена, ее можно отключить для одного сеанса --no-sandbox с помощью параметра. Параметр --no-sandbox не может переопределить управляемые корпоративные параметры, требующие песочницы.

Эти параметры можно объединить с параметром -p командной строки для управления песочницей для программного использования интерфейса командной строки. Рассмотрим пример.

Shell
copilot --sandbox -p "PROMPT"

Выполнение одной команды за пределами песочницы

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

Это поведение включено по умолчанию и может быть отключено в параметрах песочницы.

Проверка того, используется ли песочница

Чтобы проверить, используется ли локальная песочница для текущего сеанса, введите:

Shell
/sandbox status

Copilot CLI сообщает, включена ли песочница для сеанса. Если для управляемых параметров вашей организации требуется песочница, это также отмечает состояние. Так как состояние отражает то, что на самом деле применяется сеанс, это надежный способ подтвердить, выполняются ли команды Copilot в песочнице.

Чтобы узнать не только о том, включена ли песочница, но и какие пути доступны для чтения, записи или заблокированы, введите /sandbox policy. Дополнительные сведения см. в разделе Общие сведения о политиках файловой системы для локальной песочницы GitHub Copilot CLI.

Вы также можете просмотреть состояние песочницы в строке состояния, которая содержит sandbox enabled при использовании песочницы. Отображение сведений песочницы в строке состояния включается по умолчанию. Если он отключен, вы можете включить его обратно:

  1. Введите /statusline.
  2. Переместите выделение вниз по списку параметров в песочницу.
  3. Нажмите клавишу ВВОД , чтобы переключить параметр, чтобы он отображал флажок.

Дополнительные материалы