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 模式之間切換。