通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话

为 Copilot 命令行界面（CLI） 会话启用远程控制，以便你可以监视进度、响应提示以及继续从 GitHub.com 或 GitHub Mobile继续工作。

在本文中

通过远程控制，可以从任何浏览器或从Copilot 命令行界面（CLI）连接到正在运行的GitHub Mobile会话。 可以查看会话输出、响应权限请求，并继续在会话中工作，而无需在运行会话的计算机。

本文介绍如何启用和使用远程控制。 有关更多概念性信息，请参阅 GitHub Copilot 命令行界面 (CLI) 会话的远程控制。

先决条件

  • 运行 CLI 会话的计算机必须处于联机状态，会话在终端中主动运行。

    提示

    使用 /keep-alive 斜杠命令可防止你的计算机在你不在时进入睡眠状态。 请参阅 防止计算机进入睡眠状态。

  • 工作目录必须包含托管在上的 GitHub.comGit 存储库。 如果不在存储库中 GitHub ，CLI 将显示：“远程会话已禁用：不在存储库中 GitHub 。

为会话启用远程控制

可以通过三种方式启用远程控制：

  • 在交互式会话期间使用斜杠命令。
  • 通过命令行选项（在启动 Copilot 命令行界面（CLI） 时）。
  • 通过将 CLI 配置为在所有交互式会话中默认启用远程控制。

使用/remote斜杠命令

如果已在交互式会话中并且想要启用远程控制，请输入：

Copilot prompt
/remote on

CLI 连接到 GitHub.com，并显示远程访问该会话的详细信息 - 请参阅本文后面的从 GitHub.com 访问会话和从 GitHub Mobile 访问会话。

可以使用不带参数的 /remote 斜杠命令来检查当前远程控制状态，或者重新显示远程访问详细信息（如果当前已启用远程控制）。 如果要结束当前会话的远程连接，请输入 /remote off。

使用--remote命令行选项

如果认为你可能想要远程访问会话，可以使用命令行选项启动 CLI --remote 。 这样就无需记住在会话期间使用 /remote 斜杠命令。

Bash
copilot --remote

当交互式会话启动时，将显示远程访问会话的详细信息，并且随时可以使用 /remote 斜杠命令再次显示。

将远程控制配置为始终启用

如果始终希望远程访问交互式 CLI 会话，请将以下内容添加到 Copilot 设置文件（通常位于 ~/.copilot/settings.json）：

JSON
{
  "remoteSessions": true
}

若要覆盖特定会话的此设置，请使用 --no-remote 启动会话时的选项：

Bash
copilot --no-remote

注意

命令行选项 --remote ，并且 --no-remote 始终优先于 remoteSessions 设置文件中的设置。

从 GitHub.com 访问会话

启用远程控制时，CLI 会显示指向会话的链接 GitHub.com。

使用链接访问默认 Web 浏览器中的会话。 必须使用启动 CLI 会话的同一帐户登录 GitHub 。

还可以在没有链接的情况下访问会话：

  1. 请在任何计算机上登录 GitHub.com 。

  2. 在 GitHub 的左上角，单击 。

  3. 单击 Copilot。

    CLI 会话在“最近的代理会话”下列出。

  4. （可选）使用列表右上角的 “类型” 筛选器仅显示 Copilot 命令行界面（CLI） 会话。

  5. 单击您的Copilot 命令行界面（CLI）会话以打开它。

如果从存储库的GitHub本地副本启动会话，则还可以从该存储库**** 的GitHub.com”选项卡访问会话。

重要

远程访问的会话特定于用户：只能访问自己的 Copilot 命令行界面（CLI） 会话。 其他用户 GitHub 无法访问会话。

从 GitHub Mobile 访问会话

          Copilot 命令行界面（CLI）启用远程控制后，GitHub Mobile的会话即可用。 在 GitHub Mobile 中找到您的会话，请执行以下步骤：

1. ** Copilot **点击屏幕右下角的按钮。

会话列在“代理会话”下。

  1. 点击会话以打开它。

使用 QR 码快速打开手机上的会话

  1. 在交互式会话中 /remote ，输入斜杠命令以重新显示远程会话详细信息。

  2. 按 Ctrl+E 可打开/关闭 QR 码的显示。

    注意

    此键盘快捷方式可展开/折叠会话对话中的所有详细信息，而不仅仅是 QR 码。 仅当输入字段当前为空时，它才有效。

  3. 使用手机扫描 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 命令会显示当前的保持活动状态。

回顾以前的会话

可以在Copilot 命令行界面（CLI）或GitHub.com中查看旧GitHub Mobile会话。

  1. 请在GitHub.com或GitHub Mobile中查看您最近的代理会话列表。 请参阅本文前面的访问 github.com 会话和访问 GitHub 移动版会话。
  2. 单击或点击要审阅的会话。

在 GitHub.com 上，会有一条消息告诉你要使用 copilot --resume 命令以恢复会话。 在运行该会话的计算机上的终端中输入此命令。

恢复会话

使用 copilot --continue 或 copilot --resume 恢复启用了远程控制的 CLI 会话时，会自动重新启用远程控制。

防止远程控制

默认情况下，远程控制是禁用的，但可以在您的Copilot设置文件中启用（通常为~/.copilot/settings.json）。 可以通过以下方式确保会话不可远程控制：

  • 对于单个会话：启动 CLI 命令--no-remote 以防止该会话的远程控制，而不考虑设置文件值。
  • 永久：从"remoteSessions": true中删除~/.copilot/settings.json设置（或将其设置为false）。

延伸阅读