SuperAPI AI 工具集

cursor

编程与开发

查看项目

更新于 10-22 20:09

技能介绍

用途:当任务需要交由 Cursor 编码智能体处理时,可使用此 worker。它提供两条使用路径:一是在 LLM Router 中选择 cursor/* 模型,通过常规 Cursor 登录进行纯文本对话;二是直接调用 Cursor 编码智能体能力,执行本地或云端的会话型任务。

主要能力与使用方式:

  1. 文本提供方:在 LLM Router 中选择 cursor/* 模型进行纯文本聊天。由于 Cursor ACP 不暴露原始模型契约,该提供方不声明 router 工具、视觉、结构化输出、用量或成本信息。LLM Router 的提供方函数属于内部接口,对智能体关闭,应通过所选 cursor/* 模型使用 router::chat 或 router::complete。
  2. 阻塞式执行:调用 cursor::run 执行一个阻塞回合,run::start_and_wait 为标准别名。
  3. 异步生命周期:调用 cursor::start 启动会话,并以 { "session_id": <返回的会话 ID> } 绑定 cursor::agent-event 触发类型;事件帧是临时的,cursor::status 才是持久视图;需要停止时调用 cursor::stop。
  4. 会话复用:后续回合复用 session_id。本地会话必须保持原始 cwd;sdk-bridge 会话还必须保持原始工具列表。
  5. 状态与发现:调用 cursor::status 或 cursor::sessions::list 进行持久生命周期发现;调用 cursor::auth::status 检查登录可用性(不返回账户详情或凭据);调用 cursor::models::list 查询账户范围内的模型 ID,而非猜测。登录返回的结果仅包含 ACP 兼容的 ID,并将 ACP 默认值表示为 auto;cursor-agent --list-models 还包含 ACP 会拒绝的仅 CLI 可用 ID。传入 { "backend": "sdk-bridge" } 可获取云端/API Key 目录。
  6. 用量:仅云端智能体可调用 cursor::usage;缺失的用量或成本应视为未上报,不能当作零。

适用场景:需要在 iii 工作流中接入 Cursor 的文本对话或编码任务;需要本地持久会话、异步启动与停止、会话列表与状态查询;需要云端智能体与用量信息(需 SDK Bridge 与 CURSOR_API_KEY)。

限制:登录支持的本地执行停留在 Cursor 的 ask 模式并取消所有权限请求;Cursor ACP 无法按请求强制工具列表,因此应省略 tools,任何显式值都会被拒绝。云端运行需单独安装 SDK Bridge 和 CURSOR_API_KEY,且默认既不工作于当前分支也不创建拉取请求。本地安装若仅以 agent 暴露,需使用官方 CLI 的绝对路径。默认策略允许只读的状态、会话、认证与模型发现;直接的 run、start、stop 与 usage 调用需要审批。

其他:收费、价格与具体平台支持等细节,资料暂未提供。