fitchmultz/pi-cursor-sdk

解决的问题

pi-cursor-sdk 允许 pi 代理运行时的用户在使用 Cursor 模型的同时，保留 Cursor 的原生 SDK 代理循环。它避免了使用 OpenAI 兼容代理，这些代理通常会将 Cursor 的行为转换为通用格式，而是提供一种原生集成，支持 Cursor 的特定功能，如思考控制、会话行为和本地代理工具。

工作原理

该扩展将 @cursor/sdk 集成到 pi 中。默认采用本地优先运行时，但允许显式选择使用 Cursor Cloud。它管理模型发现、通过 API 密钥进行身份验证，并将 pi 的原生控制（如思考级别）映射到 Cursor SDK 参数（如 reasoning 或 effort）。此外，它还实现了模型目录的缓存系统以加速启动，并使用每会话的 SQLite 存储来处理代理恢复和状态管理。

适用人群

希望在 pi 生态系统内直接获得 Cursor 模型及其代理功能（包括本地 SDK 工具和 MCP）一等访问权限的开发者和 pi 用户。

主要亮点

• 原生 Cursor 集成：保留 Cursor SDK 代理循环，而非使用 OpenAI 风格的适配器。
• 思考控制：将 pi 的思考级别（medium、xhigh、max）映射到 Cursor SDK 参数。
• 灵活的运行时：默认本地执行，可显式选择使用 Cursor Cloud。
• 会话管理：支持分支范围的本地恢复，可在 pi 重启后重新连接到记录的本地 SDK 代理。
• 快速模式：提供持久化切换（/cursor-fast）和虚拟模型别名（如 :fast、:slow），适用于支持 Cursor 快速参数的模型。
• 模式切换：通过 CLI 标志或斜杠命令支持在 agent 和 plan 模式之间切换。