GitHub Copilot

GitHub Copilot 是 OAR 一开始就提供的提供商：它始终可用，并使用中继主机上已登录的 Copilot CLI。中继在两种引擎之一上运行它。SDK 引擎是默认引擎，为你提供引导、后台任务面板和多选问题。扩展引擎在一个你可以观看的终端中运行真正的 Copilot CLI。

使用你自己密钥的 OpenAI 运行在同样的两种引擎上，因此本页关于引擎的章节同样适用于它。它的密钥和模型见 OpenAI 页面。

你需要什么 #

• 中继主机上已登录的 Copilot CLI。用 npm install -g @github/copilot 安装它，运行一次 copilot 并登录。你的 GitHub 账户需要一个包含 Copilot CLI 的 Copilot 套餐。
• 安装或升级 CLI 后重启中继。 中继在启动时查找 CLI 的运行时，看不到之后的安装。
• 已登录的 GitHub CLI（gh），用于 oar copilot、Windows 上的扩展引擎会话，以及 Check Usage（查看用量）中的 Copilot 卡片。
• tmux（可选，Linux 和 macOS），如果你想用 🖥️ Inspect tmux console（查看 tmux 控制台）观看会话的终端。

中继不会安装或更新 Copilot CLI。在 Settings → Providers → Copilot（设置 → 提供商 → Copilot）中，顶部的 GitHub Copilot CLI 一行只报告它的状态。

OAR 如何找到 CLI #

SDK 引擎驱动 Copilot CLI 自带的运行时。启动时，中继会在 CLI 的包缓存中查找，并采用其中最新的版本：

在 Linux 上，如果你设置了 XDG_CACHE_HOME 和 XDG_DATA_HOME，这两个文件夹会随之变化。设置 COPILOT_PKG_DIR 可以添加一个要搜索的文件夹，设置 COPILOT_SDK_PATH 则直接指定运行时的 copilot-sdk 目录。如果什么都没找到，SDK 引擎就不可用（见选择引擎）。

使用 oar copilot #

如果其端口上没有中继响应，oar copilot 会在后台启动中继，然后在你的 shell 中打开 Copilot CLI（gh copilot）。由它启动的中继会在会话结束时再次停止。-- 之后的参数会传给 gh copilot。

oar copilot
oar copilot --port 3400 -- --help

每次运行还会在 ~/.copilot/extensions/web-relay/ 中写入或刷新一个小的包装器，这是一个用户全局扩展，用于把 OAR 的扩展加载到 Copilot CLI 中。oar copilot --install-extension 只做这件事然后退出（它不需要 gh）；--no-install-extension 在一次运行中跳过它。如果缺少 gh，oar copilot 会说明并停止；请安装 GitHub CLI，或用 oar start 只运行中继。

两种引擎 #

两种引擎显示相同的对话记录、提问卡片、计划看板、模型列表和每条回复的用量行。Steer、Queue（加入队列）和卡住轮次的时间窗口见轮次与队列，上表相应各行见中继模式和压缩，提问卡片见 ask_user。

在 SDK 引擎上，Stop 只结束回复。该轮启动的后台智能体会继续运行，在任务面板中各有自己的 Stop。

选择引擎 #

该选择是整个中继的一项设置：Settings → Providers → Copilot → Copilot engine（设置 → 提供商 → Copilot → Copilot 引擎），选项为 Extension（扩展）和 SDK — default（SDK — 默认）。更改后按 Save Copilot settings（保存 Copilot 设置）。

• 它适用于之后才启动 worker 的对话。已经在运行的会话会保留它的引擎，直到其 worker 重启。
• 如果没有人保存过选择，中继会在能用 SDK 时使用 SDK，不能用时使用 Extension。你保存的选择始终优先。这也包括已保存的 SDK：如果之后某次重启不再找到 CLI，中继不会自行切换回去，新对话的 worker 也无法启动，直到再次找到 CLI 或你保存 Extension。
• 面板会说明设置的是哪种引擎：New Copilot conversations run on the headless SDK worker. No tmux inspector for these sessions. 或 New Copilot conversations run on the Copilot CLI with the web-relay extension.

要判断正在运行的对话使用哪种引擎，请查看它的输入区和 tmux 控制台。一轮期间，发送按钮在 SDK 引擎上显示 Steer（当提问卡片或审批打开、该轮正在压缩或有工具调用正在运行时，显示 Queue），在扩展引擎上始终显示 Queue。tmux 控制台只在扩展引擎上显示 Copilot 界面。对话本身不带引擎标签。

保存 SDK 被拒绝时 #

当中继无法运行 SDK 时，它会拒绝保存，并在引擎说明的位置显示原因。已存储的设置不会改变，选择框会回到中继实际运行的引擎。

设置 #

在 Settings → Providers → Copilot 下：

其他影响 Copilot 会话的设置位于别处：

模型 #

中继在启动几秒后从已安装的 Copilot CLI 运行时读取模型列表。每个模型显示运行时所报告的推理强度和上下文窗口。列表以 auto 开头，然后按厂商分组（OpenAI、Anthropic、Google、xAI、Microsoft、Azure OpenAI、Moonshot AI，然后其他厂商按字母顺序），最新版本排在前面。

在第一次发现之前，新的中继提供 gpt-5.4、gpt-5.4-mini（默认）、gpt-5.3-codex、claude-sonnet-4.6 和 claude-haiku-4.5。

在对话的 ⋯ 菜单中使用 🤗 Select Models → Copilot（选择模型 → Copilot）选择哪些模型出现在输入区中，然后按 💾 Save enabled models（保存已启用的模型）。Refresh（刷新）会重新读取列表。如果列表看起来过时，请按 Refresh。

用量 #

• 在回复下方，Copilot 的一轮会显示它的用量：+N 表示额度，括号中是占你每月套餐的比例，以及 month N% left。stale 标签表示该轮的数字无法刷新。只有 Copilot 的轮次才有这一行；其他提供商（包括 OpenAI）不使用 Copilot 额度。
• 在标题栏中，会话行会汇总整个对话，例如 Session: 1.25 AIC used。
• 在 Check Usage 中，在 ⋯ 菜单中打开 📊 Check Usage 并选择 Copilot 选项卡，查看实时配额（AI 额度或高级请求、对话和套餐）。在 SDK 引擎上，它会添加 Last SDK worker turn：该轮实际花费的额度、它的 token 和模型调用。这些是单轮的数字，不是累计总数，并且该部分会在七天后消失。

Copilot 卡片通过 gh 读取你的账户。如果你不使用 gh，请在中继的环境中设置 GH_TOKEN 或 GITHUB_TOKEN。

导入你已有的会话 #

中继启动时会导入主机上存储的 Copilot 会话，使它们连同历史记录出现在你的列表中。它通过已安装的 Copilot 运行时读取这些会话。如果运行时不可用，导入会报告为失败。中继不会根据文件进行猜测。

删除这样的会话只会隐藏它：Copilot CLI 自己的会话会保留，因为中继从未运行过它。

环境变量 #

在中继进程的环境中设置这些变量，然后重启中继。

限制 #

• 中继需要重启，才能发现在它启动后安装或升级的 Copilot CLI。
• 在 SDK 引擎上没有可以连接的终端。
• 在扩展引擎上，一轮期间的消息会排队；它们无法引导。
• 在 SDK 引擎上，中继判定一轮失败之前，会给它 2 分钟无任何运行的静默时间，模型请求期间 5 分钟，工具运行期间 30 分钟。等待提问卡片的一轮永远不会被视为卡住。这些时间窗口见轮次与队列。
• 使用你自己密钥的 OpenAI 对话也使用这些引擎，但花费的是你的密钥，因此它的轮次不带 Copilot 用量行。

无法正常工作时 #

不依赖于引擎的智能体会话、中继模式和其他行为，按会话和智能体协作各页所述工作。