{"meta":{"title":"通过其他设备控制 GitHub Copilot CLI 会话","intro":"为 Copilot CLI 会话启用远程控制，以便你可以监视进度、响应提示以及继续从 GitHub.com 或 GitHub Mobile继续工作。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos","title":"操作方法"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli","title":"使用 Copilot CLI"},{"href":"/zh/enterprise-cloud@latest/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/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-remote-control)。\n\n远程访问不同于会话同步。 默认情况下，您的 Copilot CLI 会话会同步到您的 GitHub 帐户，并且同步的会话在 GitHub.com 和 GitHub Mobile 上显示为仅供查看。 这些会话不可操控。 若要远程引导会话，必须启用远程控制。 有关会话同步的详细信息，请参阅 [关于 GitHub Copilot CLI 会话数据](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/chronicle#session-syncing)。\n\n## 先决条件\n\n* 运行 CLI 会话的计算机必须处于联机状态，会话在终端中主动运行。\n\n > \\[!TIP]\n > 使用 `/keep-alive` 斜杠命令可防止你的计算机在你不在时进入睡眠状态。 请参阅 [防止计算机进入睡眠](#preventing-your-machine-from-going-to-sleep)状态。\n\n* 远程控制不要求将 Git 仓库托管在 GitHub.com 上。 你可以在本身不是 Git 仓库的目录中启用远程控制功能，包括包含多个仓库的父目录，以及托管在 GitHub.com 之外其他位置的仓库。 在 GitHub 存储库外部启动的会话似乎与任何存储库（“无存储库”）都无关联，并且仅显示在 [github.com/copilot/agents](https://github.com/copilot/agents) 的智能体页面上。 在存储库中 GitHub 启动的会话也显示在该存储库的 **“代理** ”选项卡上。\n\n 在某些情况下，CLI 可能仍无法解析工作目录的存储库，例如，如果配置了 Git 远程，但无法访问。 发生这种情况时，远程控制处于禁用状态，CLI 会显示“远程会话已禁用”消息。\n\n## 为会话启用远程控制\n\n可以通过多种方式启用远程控制：\n\n* 在交互式会话期间使用斜杠命令。\n* 通过命令行选项（在启动 Copilot CLI 时）。\n* 通过将 CLI 配置为在所有交互式会话中默认启用远程控制。\n* 在 JetBrains IDE 设置中，于会话开始前进行配置。\n\n### 使用`/remote`斜杠命令\n\n如果已在交互式会话中并且想要启用远程控制，请输入：\n\n```copilot copy\n/remote on\n```\n\nCLI 连接到 GitHub.com，并显示远程访问该会话的详细信息 - 请参阅本文后面的[从 GitHub.com 访问会话](#accessing-a-session-from-githubcom)和[从 GitHub Mobile 访问会话](#accessing-a-session-from-github-mobile)。\n\n可以使用不带参数的 `/remote` 斜杠命令来检查当前远程控制状态，或者重新显示远程访问详细信息（如果当前已启用远程控制）。 如果要结束当前会话的远程连接，请输入 `/remote off`。\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` 始终优先于 `remote` 设置文件中的设置。\n\n### 使用 JetBrains IDE 的设置\n\n如果在 JetBrains IDE 中使用 Copilot CLI ，可以在启动会话之前从 IDE 启用远程控制。\n\n1. 在 JetBrains IDE 中，单击“文件”\\*\\*\\*\\* 菜单 (Windows) 或菜单栏中的应用程序名称 (macOS)，然后单击“设置”\\*\\*\\*\\*。\n\n2. 在左侧栏中，单击 **工具**，单击 **GitHub Copilot**，然后单击 **“聊天**”。\n\n3. 选择“**启用远程 Copilot CLI**”。\n\n4. 从 IDE 启动交互式 Copilot CLI 会话。\n\n启用此设置后，您可以在会话中随时使用 `/remote` 查看当前的远程控制状态，或重新显示用于远程访问该会话的链接和二维码。\n\n## 从 GitHub.com 访问会话\n\n启用远程控制时，CLI 会显示指向会话的链接 GitHub.com。\n\n使用链接访问默认 Web 浏览器中的会话。 必须使用启动 CLI 会话的同一帐户登录 GitHub 。\n\n还可以在没有链接的情况下访问会话：\n\n1. 请在任何计算机上登录 GitHub.com 。\n\n2. 在 GitHub 的左上角，单击 。\n\n3. 单击 **Copilot**。\n\n CLI 会话在“最近的代理会话”下列出。\n\n4. （可选）使用列表右上角的 **“类型”** 筛选器仅显示 Copilot CLI 会话。\n\n5. 单击您的Copilot CLI会话以打开它。\n\n如果从存储库的GitHub本地副本启动会话，则还可以从该存储库\\*\\*\\*\\* 的GitHub.com”选项卡访问会话。\n\n> \\[!IMPORTANT]\n> 远程访问的会话特定于用户：只能访问自己的 Copilot CLI 会话。 其他用户 GitHub 无法访问会话。\n\n## 从 GitHub Mobile 访问会话\n\n启用远程控制后，便可以在 Copilot CLI 中提供 GitHub Mobile 会话。 在 GitHub Mobile 中找到您的会话，请执行以下步骤：\n\n1. \\*\\* \n Copilot\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可以在Copilot CLI或GitHub.com中查看旧GitHub Mobile会话。\n\n1. 请在GitHub.com或GitHub Mobile中查看您最近的代理会话列表。 请参阅本文前面的[访问 github.com 会话](#accessing-a-session-from-githubcom)和[访问 GitHub 移动版会话](#accessing-a-session-from-github-mobile)。\n2. 单击或点击要审阅的会话。\n\n在 GitHub.com 上，会有一条消息告诉你要使用 `copilot --resume` 命令以恢复会话。 在运行该会话的计算机上的终端中输入此命令。\n\n## 恢复会话\n\n使用 `copilot --continue` 或 `copilot --resume` 恢复启用了远程控制的 CLI 会话时，会自动重新启用远程控制。\n\n## 防止远程控制\n\n默认情况下，远程控制是禁用的，但可以在您的Copilot设置文件中启用（通常为`~/.copilot/settings.json`）。 可以通过以下方式确保会话不可远程控制：\n\n* **对于单个会话**：使用 `--no-remote` 启动 CLI 以阻止该会话的远程控制，无论设置文件中的值如何。\n* **永久**：从`\"remoteSessions\": true`中删除设置`~/.copilot/settings.json`，或将其设置为 `false`。\n\n企业管理员还可以通过企业管理设置限制对你设备上托管会话的远程控制，而不受你的个人设置影响。 根据已配置的策略，您设备上会话的远程控制功能可能会被完全禁用，或者仅对已获特定组织 SSO 授权的控制端客户端可用。 这不会影响远程控制在其他设备上托管的自有会话的能力。 请参阅“[企业管理设置](/zh/enterprise-cloud@latest/copilot/reference/enterprise-administrators/enterprise-managed-settings)”。\n\n## 延伸阅读\n\n* [\n Copilot CLI 文档中有关 Visual Studio Code](https://code.visualstudio.com/docs/copilot/agents/copilot-cli) 内 VS Code 会话的相关内容。"}