使用本地沙盒

注意

本地沙盒 GitHub Copilot 位于公开预览且可能会更改。

重要

Windows上的本地沙盒需要Windows预览体验成员版本。

关于本地沙盒

沙盒目前是一项实验性功能。若要使用它，请从Copilot 命令行界面（CLI）命令行选项开始‑‑experimental，或在会话期间输入/experimental on。

启用本地沙盒时， Copilot 命令行界面（CLI）在操作系统沙盒中代表你运行大部分命令和工具。启用本地沙盒后，它将用于所有 Copilot 命令行界面（CLI）会话，直到禁用它，或为特定会话关闭它。

默认情况下，沙盒命令和工具可以在当前工作目录和临时文件夹中写入。用户配置文件（主页）目录以及系统和工具位置都是只读的。其他磁盘位置将被阻止。在 Git 存储库中，当前工作目录上方的访问因操作系统而异。允许访问本地和专用网络，出站 Internet 访问也是允许的。

默认情况下，经过身份验证的 Git 和 GitHub CLI （gh）操作将继续在沙盒中工作，因为 Copilot 命令行界面（CLI）使 GitHub 凭据可用于沙盒命令。这允许诸如 git push 和 gh pr create 成功之类的操作。可以在沙盒设置中关闭此功能。

有关沙盒 Copilot 命令行界面（CLI）的概念性概述，请参阅关于云和本地沙盒 GitHub Copilot。

若要启用本地沙盒，请在交互式 Copilot 命令行界面（CLI）会话中输入以下命令：

Shell

/sandbox enable

/sandbox enable

沙盒开始立即用于当前会话。

启用本地沙盒后，它将继续用于当前和将来的交互式会话，以及用于编程会话。

注意

如果输入 /sandbox enable时已打开其他会话，则沙盒不会立即在这些会话中使用。若要在已打开的会话中使用沙盒，请在该会话中执行下列操作之一：

若要停止使用本地沙盒，请在交互式 Copilot 命令行界面（CLI）会话中输入以下命令：

Shell

/sandbox disable

/sandbox disable

沙盒不再用于当前会话或新的和重启的会话。

选择是否使用本地沙盒保存为 sandbox.enabled CLI 的个人设置文件中的设置（~/.copilot/settings.json 默认情况下）。

可以使用 --sandbox 命令行选项为单个会话使用沙盒，而无需为其他会话启用沙盒。如果已启用沙盒，则可以使用 --no-sandbox 此选项为单个会话禁用沙盒。

可以将这些选项与 -p 命令行选项结合使用，以控制沙盒以编程方式使用 CLI。例如：

Shell

copilot --sandbox -p "PROMPT"

copilot --sandbox -p "PROMPT"

当命令需要比沙盒允许的更广泛的访问权限时， Copilot 可以请求在沙盒外部运行该单一命令。将显示描述命令的确认提示，并且仅在你批准该命令时才在沙盒外部运行;否则，它将保持沙盒化。会话的其余部分将保持沙盒化。

此行为默认处于启用状态，可在沙盒设置中关闭。

若要检查沙盒是否用于当前会话，请查看状态行。如果使用沙盒，则状态行包含 sandbox enabled。

默认情况下，状态行中沙盒信息的显示处于打开状态。如果它已关闭，则可以将其重新打开：