fitchmultz/pi-cursor-sdk

pi-cursor-sdk – 将 Cursor 的 LLM 连接到 Pi 的终端界面

它是什么

• 一个开源扩展，在本地运行 Cursor SDK 代理，并将其接入 Pi 终端 AI 助手。它让 Pi 用户可以选择并调用 Cursor 模型（例如 grok-4.6、gpt-5.5），并在 Pi 会话中使用 Cursor 的内置工具（文件编辑、Shell 命令、MCP 服务器）。

为什么重要

• 结合了两种新兴的 AI 开发者工具：Cursor（一个以代码为中心的 LLM 平台，具有工具使用能力）和 Pi（一个用于对话式 AI 的终端界面）。用户可以获得 Cursor 丰富的工具生态系统，同时保持在 Pi 熟悉的命令行工作流程中。

主要功能

• 模型选择 – 使用 pi --model cursor/<model> 选择任何 Cursor 模型；支持上下文窗口标签（@1m）和速度模式（:fast、:slow）。
• 思考级别 – 通过 --thinking 标志调整 Cursor 的“思考”参数。
• 工具桥接 – 将 Pi 扩展工具作为 pi__* 函数暴露给 Cursor，支持 Cursor 侧的工具调用。
• 快速/计划模式 – 使用 /cursor-fast 和 /cursor-mode 命令切换 Cursor 的快速模式和计划模式。
• 本地和云运行时 – 在本地（默认）或 Cursor Cloud 中运行 Cursor 代理（/cursor-runtime cloud）。
• 计费可见性 – 将 Cursor 使用统计（/cursor-usage）与 Pi 的原生计费分开。
• 安全与配置 – 环境变量用于禁用 Pi-Cursor 工具桥接、忽略本地 Cursor 设置以及控制 HTTP 传输。

开始使用

1. 前提条件 – Node 24+、Pi 0.87.1+ 以及 Cursor SDK API 密钥（用户级密钥，不是团队管理员密钥）。
2. 通过 Pi 的包管理器安装：

   pi install npm:pi-cursor-sdk
   pi --model cursor/grok-4.6   # 或任何其他模型
   

3. 在 Pi 内部：
   • 运行 /login → 使用 API 密钥 → Cursor → 粘贴你的密钥。
   • 使用 /cursor-refresh-models 刷新模型目录。
   • 像往常一样发出提示。

配置快捷方式

• 启动标志：--cursor-fast、--cursor-no-fast、--cursor-mode plan。
• 环境变量：
  • PI_CURSOR_FOOTER=0 – 隐藏状态页脚。
  • PI_CURSOR_PI_TOOL_BRIDGE=0 – 关闭 Pi-Cursor 工具桥接。
  • PI_CURSOR_SETTING_SOURCES=none – 忽略本地 Cursor 配置文件。

故障排除要点

症状	快速修复
模型列表显示但调用失败	使用有效的 Cursor SDK 密钥重新登录并运行 /cursor-refresh-models。
首次回复缓慢	验证 MCP 服务器设置；参见“first-cursor-message-is-slow”文档。
流在 VPN/代理下中断	使用 /cursor-http on 启用 HTTP 传输。

文档

• 完整参考：docs/reference.md
• 开发说明：docs/development.md
• 维护者的模型 UX 规范：docs/cursor-model-ux-spec.md
• 提供变更日志和许可证。

许可证

• MIT © Mitch Fultz。

---

pi-cursor-sdk 是两个 AI 开发者工具之间的真正、功能性的桥接器，可以在 Pi 的终端界面中无缝使用 Cursor 的 LLM 和工具生态系统。