{"meta":{"title":"通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话","intro":"启用对会话的 Copilot 命令行界面（CLI） 远程访问，以便你可以监视进度、响应提示以及继续从 GitHub.com 或 GitHub Mobile继续工作。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/how-tos","title":"操作方法"},{"href":"/zh/copilot/how-tos/copilot-cli","title":"Copilot 命令行界面（CLI）"},{"href":"/zh/copilot/how-tos/copilot-cli/use-copilot-cli","title":"使用 Copilot 命令行界面（CLI）"},{"href":"/zh/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely","title":"远程引导会话"}],"documentType":"article"},"body":"# 通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话\n\n启用对会话的 Copilot 命令行界面（CLI） 远程访问，以便你可以监视进度、响应提示以及继续从 GitHub.com 或 GitHub Mobile继续工作。\n\n远程访问使你能够从任何浏览器或从Copilot 命令行界面（CLI）连接到正在运行的GitHub Mobile会话。 可以查看会话输出、响应权限请求，并继续在会话中工作，而无需在运行会话的计算机。\n\n本文介绍如何启用和使用远程访问。 有关更多概念性信息，请参阅 [关于对会话的 GitHub Copilot 命令行界面 (CLI) 远程访问](/zh/copilot/concepts/agents/copilot-cli/about-remote-access)。\n\n> \\[!NOTE]\n>\n> * Copilot 命令行界面（CLI） 会话远程访问处于 公共预览版 状态，并且随时可能会发生更改。\n> * 移动访问目前仅在最新 beta 版本的GitHub Mobile中可用。 可以通过GitHub Mobile 和[适用于 Android 的 Google Play](https://testflight.apple.com/join/NLskzwi5) 加入测试计划[](https://play.google.com/apps/testing/com.github.android)。 \n\n## 先决条件\n\n* 运行 CLI 会话的计算机必须处于联机状态，会话在终端中主动运行。\n\n > \\[!TIP]\n > 使用 `/keep-alive` 斜杠命令可防止你的计算机在你不在时进入睡眠状态。 请参阅 [防止计算机进入睡眠](#preventing-your-machine-from-going-to-sleep)状态。\n\n* 工作目录必须包含托管在上的 GitHub.comGit 存储库。 如果不在存储库中 GitHub ，CLI 将显示：“远程会话已禁用：不在存储库中 GitHub 。\n\n## 为会话启用远程访问\n\n可以通过三种方式启用远程访问：\n\n* 在交互式会话期间使用斜杠命令。\n* 启动 Copilot 命令行界面（CLI）时使用命令行选项。\n* 通过将 CLI 配置为在所有交互式会话中默认启用远程访问。\n\n### 使用`/remote`斜杠命令\n\n如果已在交互式会话中并想要启用远程访问，请输入：\n\n```copilot copy\n/remote\n```\n\nCLI 连接到 GitHub.com，并显示远程访问该会话的详细信息 - 请参阅本文后面的[从 GitHub.com 访问会话](#accessing-a-session-from-githubcom)和[从 GitHub Mobile 访问会话](#accessing-a-session-from-github-mobile)。\n\n### 使用`--remote`命令行选项\n\n如果认为你可能想要远程访问会话，可以使用命令行选项启动 CLI `--remote` 。 这样就无需记住在会话期间使用 `/remote` 斜杠命令。\n\n```bash copy\ncopilot --remote\n```\n\n当交互式会话启动时，将显示远程访问会话的详细信息，并且随时可以使用 `/remote` 斜杠命令再次显示。\n\n### 配置远程访问以始终启用\n\n如果始终希望远程访问交互式 CLI 会话，请将以下内容 Copilot 添加到配置文件（通常位于 `~/.copilot/settings.json`）：\n\n```json copy\n{\n \"remoteSessions\": true\n}\n```\n\n若要覆盖特定会话的此设置，请使用 `--no-remote` 启动会话时的选项：\n\n```bash copy\ncopilot --no-remote\n```\n\n> \\[!NOTE]\n> 命令行选项 `--remote` ，并且 `--no-remote` 始终优先于 `remoteSessions` 配置文件中的设置。\n\n## 从 GitHub.com 访问会话\n\n启用远程访问后，CLI 将显示采用以下格式的链接：\n\n```text\nhttps://github.com/OWNER/REPO/tasks/TASK_ID\n```\n\n使用此链接访问 Web 浏览器中的会话。 必须使用启动 CLI 会话的同一帐户登录 GitHub 。\n\n还可以从最近的代理会话 GitHub.com列表中访问会话：\n\n1. 在 GitHub 的左上角，单击 。\n2. 单击 **Copilot**。\n3. 在“最近的代理会话”中，单击您的 Copilot 命令行界面（CLI） 会话以将其打开。\n\n> \\[!IMPORTANT]\n> 会话特定于用户：只能访问自己的 Copilot 命令行界面（CLI） 会话。 其他用户 GitHub 无法访问会话。\n\n## 从 GitHub Mobile 访问会话\n\n启用远程访问后，便可以在Copilot 命令行界面（CLI）中立即提供GitHub Mobile会话。 在 GitHub Mobile 中找到您的会话，请执行以下步骤：\n\n1. ```\n **\n \n Copilot\n **点击屏幕右下角的按钮。\n ```\n\n 会话列在“代理会话”下。\n\n2. 点击会话以打开它。\n\n### 使用 QR 码快速打开手机上的会话\n\n1. 在交互式会话中 `/remote` ，输入斜杠命令以重新显示远程会话详细信息。\n\n2. 按 Ctrl+E 可打开/关闭 QR 码的显示。\n\n > \\[!NOTE]\n > 此键盘快捷方式可展开/折叠会话对话中的所有详细信息，而不仅仅是 QR 码。 仅当输入字段当前为空时，它才有效。\n\n3. 使用手机扫描 QR 码以直接转到会话。GitHub Mobile\n\n## 防止计算机进入睡眠状态\n\n可以使用 `/keep-alive` 斜杠命令阻止计算机进入睡眠状态。 这样，就可以保持远程连接，并且继续从GitHub.com或GitHub Mobile与会话交互。\n\n在交互式会话中，输入 `/keep-alive OPTION` ，其中 `OPTION` 为以下之一：\n\n* `on`：阻止计算机在 CLI 会话处于活动状态时进入睡眠状态。\n* `off`：允许计算机正常进入睡眠状态。\n* `busy`：仅当 Copilot 正在执行任务时，防止计算机进入睡眠状态。 代理完成任务后，计算机可以正常进入睡眠状态。 如果 Copilot 等待你响应来自你的输入请求，计算机将不会进入睡眠状态。\n* `NUMBERm`、、`NUMBERh`或`NUMBERd`（例如，`30m`）`8h``1d`防止计算机在特定分钟数、小时数或天数内进入睡眠状态。 如果提供的是未加后缀的数值，则会将其视为分钟数。\n\n未传递`OPTION`时，`/keep-alive`命令会显示当前保持活动状态。\n\n## 恢复具有远程访问的会话\n\n关闭启用了远程访问的会话时，CLI 会显示一个恢复命令，其中包括 `--remote`：\n\n```bash\ncopilot --resume=SESSION_ID --remote\n```\n\n使用此命令重启启用了远程访问的会话。\n\n同样，将`--remote`添加到`copilot --continue`命令中会恢复启用远程访问的最新会话。\n\n如果在您的`\"remoteSessions\": true`配置文件中包含Copilot，则会话恢复时将自动启用远程访问，您无需使用`--remote`选项。\n\n## 阻止远程访问\n\n默认情况下禁用远程访问，但可以在配置文件Copilot中启用。 可以通过以下方式确保无法远程访问会话：\n\n* **对于单个会话**：启动 CLI `--no-remote`，即便配置文件中有设置，仍可防止该会话的远程访问。\n* **永久**：从`\"remoteSessions\": true`配置文件中删除Copilot设置（或将其设置为 `false`）。"}