Cursor

Cursor 供應商透過 Cursor Agent SDK，在中繼所在的機器上執行 Cursor 的 agent。OAR 會為每個對話啟動一個 worker 處理程序。agent 在對話的工作資料夾中工作，使用你 Cursor 帳戶的模型。和 Claude 不同，它不使用機器上的登入：你要提供 OAR 一個 Cursor API 金鑰。

本頁說明 Cursor 特有的部分。對話、佇列和檔案瀏覽器的運作方式和其他供應商相同；Cursor 和其他供應商的比較見供應商一覽。

你需要什麼 #

• 一個 Cursor API 金鑰。只要在 OAR 中貼上一次；見啟用。
• 不需要安裝任何東西。Cursor 不需要 CLI，機器上也不需要 Cursor app，所以 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 之前，全域安裝會把它們放在套件資料夾內，而更新會取代整個套件資料夾，因此對話可能失去它的 agent；資料夾仍在的對話會繼續使用它。CURSOR_AGENT_STORE_DIR 可以變更它們的位置；見環境變數。

啟用 #

開啟 Settings → Providers → Cursor（設定 → 供應商 → Cursor）。面板標題是 Cursor SDK。

欄位下方的狀態行會顯示目前的狀態：

儲存時會做的事：

• 模型探索。 在 Cursor 已啟用的情況下，當你儲存新金鑰、變更模型或重新啟用時，OAR 會向 Cursor 查詢你的金鑰可用的模型，以及每個模型的推理選項。請求在 20 秒後放棄。失敗時會在通知中顯示警告，例如 Cursor model discovery failed: …。探索成功之前，清單中只有預設模型。
• 變更金鑰。 儲存新金鑰會清除已探索的模型；若 Cursor 已啟用，則會重新探索。如果之前已儲存過金鑰，中繼還會停止所有 Cursor worker，包括正在執行回合的 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 供應商。見開始對話。

模型與 reasoning effort #

清單的來源。 清單來自 Cursor 本身，透過你的金鑰，在上述時機取得。🤗 Select Models → Cursor SDK（選擇模型 → Cursor SDK）決定輸入區要提供其中哪些模型；💾 Save enabled models（儲存已啟用的模型）會保存這個選擇，Refresh（重新整理）則重新執行探索。沒有做任何選擇時，會提供所有探索到的模型。Cursor model ID 中的模型一律會提供。

以訊息為單位。 對話可以在每則訊息之間變更模型和 reasoning effort；Cursor 模型 ID 照 Cursor 的寫法使用。不在你可用模型（已啟用的模型，加上 Cursor model ID 和對話本身的模型）之中的 ID，會被拒絕並顯示 Cursor model "…" is not available。

Reasoning effort。 可選的 effort 等級來自模型本身列出的內容。OAR 認得這些等級：none、low、medium、high、xhigh 和 max。Cursor 的 extra-high 會顯示為 xhigh。OAR 不認得的等級不會提供。

• none 一定會在清單中。如果模型可以關閉推理，none 就會關閉推理。如果不行，輸入區會把這個項目顯示為 default（預設），模型則照平常的方式執行。
• 沒有列出任何 effort 的模型只有 none，顯示為 default。
• 在有思考開關的模型上，選擇任一等級會開啟思考，選 none 則會關閉思考。

使用其他模型的 subagent。 Cursor 內建的 subagent 選單只提供少數幾個模型。因此 OAR 會為你在 Select Models 中啟用的每個模型各宣告一個 subagent，讓 agent 可以把任務交給例如 Grok 或 GPT 模型。名稱使用連字號（grok-4.5 會變成 grok-4-5）。subagent 會以其模型的預設變體執行：無法指定 effort。變更選擇會在下一則訊息生效。

OAR 功能在 Cursor 上的運作方式 #

工作資料夾中 .cursor 資料夾裡的 Cursor 專案規則、subagent 檔案和 MCP 伺服器都不會載入。agent 的工具和 subagent 由 OAR 自行定義。

閒置很久的 agent #

30 分鐘沒有使用的 Cursor agent 會被關閉，並在下一則訊息時重新開啟，因為它的登入在閒置幾個小時後就會失效。你不會察覺到這件事。如果登入還是失效了，OAR 會重建 agent 並重新傳送訊息，最多兩次，並加上活動行 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 讀取 agent 的計費花費，並把增加的部分記入目前的計費週期。每個回合會歸入執行它的模型所屬的額度池：

比對時不分大小寫，且會先檢查 router 名稱。

Cursor 不會告訴 SDK 你的方案包含哪些內容。這部分由你自己輸入：

計量條是以原始模型費用對比你的額度。卡片也會列出 Cursor 實際收取的費用，方案內含的用量通常為零。這些數字都是估算值。Cursor 較晚回報的費用，會記入發現它的那個回合。Cursor 自己的 Spending 儀表板才是權威來源，卡片上也有它的連結。

來自儀表板的即時方案進度條。 有了儀表板 session token，卡片會加上即時讀取自 Cursor 儀表板的 Plan usage (total)（方案用量，總計）、Auto + Composer 和 API 進度條，以及方案名稱、方案內含與隨用隨付的花費，和計費週期的實際日期。本機的額度池計量條則退居次要。這個 token 是 session cookie，不是 API 金鑰，而 API 金鑰無法讀取這些數字。

OAR 依以下順序尋找 token：

1. 你儲存的 token。
2. 中繼環境中的 CURSOR_SESSION_TOKEN，適用於沒有 Cursor app 的主機。
3. 中繼所在機器上 Cursor app 的登入，從它的本機狀態讀取，不需要任何設定。

欄位下方的狀態行會顯示目前使用的來源。token 只留在中繼上，絕不會送到瀏覽器。如果 Cursor 不接受這個 token，卡片會改回顯示估算值，並說明哪個來源被拒絕，或是找不到 token。

agent 可以用 relay_tool 的 usage 動作讀取同樣的數字。

環境變數 #

在中繼啟動時所用的環境中設定這些變數。

API 金鑰無法用這種方式設定：中繼會把面板中的金鑰傳給 worker，並忽略它自己環境中的 CURSOR_API_KEY。

限制 #

除了上表中的不足之處（不支援導正、沒有任務面板、沒有壓縮設定、subagent 只有一層）：

• 提問卡片取決於 agent 是否呼叫 ask_user。
• 花費和額度都是估算值。只有儀表板進度條的數字來自 Cursor。
• Cursor 方案的用量上限不會讓對話暫停。回合會像其他失敗的回合一樣失敗，你需要重新傳送訊息。

無法正常運作時 #