用途:cursor-models 是 Cursor SDK 中负责模型发现与选择的模块,暴露与 Cursor 应用相同的模型目录,用于在创建时选模型、按运行覆盖模型,并通过参数微调。
主要能力:Cursor.models.list() 返回 SDKModel[],模型对象包含 id、displayName、description、parameters、variants;参数由 ModelParameterDefinition 及取值枚举描述,可用于调节思考深度等;选择用 { id, params? } 形式表达;支持按单次运行的 sticky 覆盖语义;可用于按工作负载类别做模型路由(class→model 映射)。
使用方式:在 Agent.create({ model }) 时传入模型选择;单次运行覆盖参考 send-options;子智能体可继承模型。
适用场景:为界面或配置列出可用模型;在成本与能力之间取舍(如 Composer 2 与 GPT-5.5 等);调节思考深度等参数;把不同任务类别路由到不同模型。
限制:资料未提供具体模型清单、参数取值范围、价格与平台支持等细节,需以实际 SDK 返回为准。