Cursor

Cursor 提供商通过 Cursor Agent SDK，在中继所在的机器上运行 Cursor 的智能体。OAR 为每个对话启动一个 worker 进程。智能体在对话的工作目录中工作，使用你 Cursor 账户的模型。与 Claude 不同，它不使用机器上的登录：你给 OAR 一个 Cursor API 密钥。

本页介绍 Cursor 特有的内容。对话、队列和文件浏览器的工作方式与其他提供商相同；Cursor 的比较见提供商一览。

你需要什么 #

• 一个 Cursor API 密钥。你把它粘贴进 OAR 一次；见启用。
• 无需安装任何东西。Cursor 不需要机器上有 CLI 或 Cursor 应用，因此 Cursor 子选项卡没有 CLI 一行。

各项内容的位置：

默认情况下，状态文件夹在中继数据文件夹的 cursor-agents 下：全局安装时为 ~/.oar/data/cursor-agents（Windows 上为 %APPDATA%\oar\data\cursor-agents），git 检出时为 server/data/cursor-agents。0.9.14 新增 0.9.14 之前，全局安装会把它们放在包文件夹内，而更新会替换该文件夹，因此对话可能丢失它的智能体；文件夹仍存在的对话会继续使用它。CURSOR_AGENT_STORE_DIR 会移动它们；见环境变量。

启用 #

打开 Settings → Providers → Cursor（设置 → 提供商 → Cursor）。面板标题为 Cursor SDK。

字段下方的状态行会说明当前所处的状态：

保存会做什么：

• 模型发现。 当 Cursor 开启且你保存了新密钥、更改了模型或再次开启它时，OAR 会向 Cursor 询问你的密钥可用的模型，以及每个模型的推理选项。请求会在 20 秒后放弃。失败会在提示中显示为警告，例如 Cursor model discovery failed: …。在发现成功之前，列表只保留默认模型。
• 更换密钥。 保存新密钥会清空已发现的模型，并且如果 Cursor 已开启，会再次运行发现。当已有保存的密钥时，中继还会停止每一个 Cursor worker，包括处于一轮之中的，因此请在轮次之间保存新密钥。worker 会在下一条消息时用新密钥再次启动。
• 移除密钥在有任何 Cursor 对话已发送消息或有排队消息时会被拒绝：Cannot remove Cursor API key while N active Cursor conversation(s) still exist. Disable Cursor for new conversations instead.。因此移除不会影响任何正在运行的轮次。请改为关闭 Cursor。移除成功后，尚未发送消息的对话会移回 Copilot。关闭 Cursor 不会移动它们。

然后照常开始对话：在 New Chat 中选择提供商 Cursor SDK。见开始对话。

模型与推理强度 #

列表的来源。 来自 Cursor 本身，通过你的密钥，在上述时刻读取。🤗 Select Models → Cursor SDK（选择模型 → Cursor SDK）决定输入区提供其中哪些模型；💾 Save enabled models（保存已启用的模型）保存选择，Refresh（刷新）再次运行发现。没有做选择时，会提供所有已发现的模型。Cursor model ID 中的模型始终提供。

按消息。 对话可以在一条消息到下一条之间更换模型和推理强度；Cursor 模型 ID 按 Cursor 的写法使用。不在提供给你的模型（已启用的那些，加上 Cursor model ID 和对话自己的模型）之中的 ID 会被拒绝，显示 Cursor model "…" is not available。

推理强度。 推理强度选项来自模型，按模型列出的为准。OAR 认识这些级别：none、low、medium、high、xhigh 和 max。Cursor 的 extra-high 显示为 xhigh。OAR 不认识的级别不会被提供。

• none 始终在列表中。如果模型能关闭推理，none 就会关闭推理。如果不能，输入区会把该条目显示为 default（默认），模型按正常方式运行。
• 不列出任何推理强度的模型只有 none，显示为 default。
• 在有思考开关的模型上，选择某个级别会开启思考，none 会关闭它。

在其他模型上的子智能体。 Cursor 内置的子智能体菜单只提供少数模型。因此 OAR 会为你已在 Select Models 中启用的每个模型声明一个子智能体，这样智能体就能把任务交给例如 Grok 或 GPT 模型。名称使用连字符（grok-4.5 变成 grok-4-5）。子智能体运行其模型的默认变体：不能给它指定推理强度。更改选择会在下一条消息生效。

OAR 的功能在 Cursor 上的表现 #

工作目录下 .cursor 文件夹中 Cursor 自己的项目规则、子智能体文件和 MCP 服务器不会被加载。OAR 自己定义智能体的工具和子智能体。

长时间空闲的智能体 #

30 分钟未使用的 Cursor 智能体会在下一条消息时被关闭并重新打开，因为它的登录在空闲几小时后会过期。你看不到这个过程。如果登录仍然过期，OAR 会重建智能体并再次发送消息，最多两次，并添加活动行 Cursor session re-authenticated; retrying this message on a fresh agent handle.。第三次失败会以无法正常工作时中的登录消息结束该轮。

用量 #

Cursor 轮次在回复下方没有用量行。📊 Check Usage（查看用量）有一张 Cursor 卡片。当 Cursor 关闭时，它显示 Cursor is not enabled in provider settings.。它的数字来自两个来源，卡片会说明它使用了哪一个。

来自 OAR 的花费，一个估算。 每轮之后，OAR 从 Cursor 读取智能体的已计费花费，并把增量计入当前计费周期。它把每一轮归到运行它的模型的额度池下：

匹配不区分大小写，且 router 名称会优先检查。

Cursor 不会告诉 SDK 你的套餐包含什么。由你输入：

计量条按原始模型成本对照你的额度进行衡量。卡片还会列出 Cursor 实际收取的费用，对套餐内使用这通常为零。所有这些数字都是估算。Cursor 延迟报告的成本会与看到它的那一轮一起入账。Cursor 自己的 Spending 仪表盘才是权威来源，卡片会链接到它。

实时套餐进度条，来自仪表盘。 有了仪表盘会话令牌，卡片会增加 Plan usage (total)（套餐用量，总计）、Auto + Composer 和 API 条，实时从 Cursor 的仪表盘读取，还有套餐名称、包含的和按需的花费，以及周期的真实日期。本地额度池计量条随即退居次要。该令牌是会话 cookie，不是 API 密钥，API 密钥无法读取这些数字。

OAR 按此顺序查找令牌：

1. 你保存的那个。
2. 中继环境中的 CURSOR_SESSION_TOKEN，用于没有 Cursor 应用的主机。
3. 中继机器上 Cursor 应用的登录，无需设置即可从其本地状态读取。

字段下方的状态行会说明正在使用的来源。令牌留在中继上，绝不会发送到浏览器。如果 Cursor 不接受该令牌，卡片会回退到估算，并说明被拒绝的是哪个来源，或没有找到令牌。

智能体可以用 relay_tool 的 usage 操作读取同样的数字。

环境变量 #

在中继启动时的环境中设置这些变量。

API 密钥无法这样设置：中继会从面板把密钥传给它的 worker，并忽略其自身环境中的 CURSOR_API_KEY。

限制 #

除上表中的缺口外（没有引导、没有任务面板、没有压缩设置、只有一层子智能体）：

• 提问卡片取决于智能体调用 ask_user。
• 花费和额度是估算。只有仪表盘条来自 Cursor。
• Cursor 套餐上的用量上限不会暂停对话。该轮像任何失败的轮一样失败，你重新发送消息。

无法正常工作时 #