JetBrains 集成
基于 Cursor 官方 JetBrains integration 文档解释 ACP、AI Assistant、安装、认证、能力、定价和迁移边界。
JetBrains 集成让你不用离开 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE，就能通过 ACP 使用 Cursor agent。
阅读目标：读完本章，你应该能判断是迁移到 Cursor，还是保留 JetBrains 并通过 Agent Client Protocol 接入 Cursor agent。
1. 先判断
JetBrains 集成不是把 Cursor UI 嵌进 JetBrains，而是通过 Agent Client Protocol 让 JetBrains IDE 作为 client，Cursor agent 作为 server。
| 需求 | 推荐 |
|---|---|
| 团队强依赖 IntelliJ / PyCharm / WebStorm 工程模型 | 用 JetBrains ACP |
| 想完整使用 Cursor 编辑器体验 | 迁移到 Cursor |
| 只想保留 JetBrains 快捷键 | 在 Cursor 装 JetBrains keymap extension |
| 需要 IDE 内文件编辑和终端命令 | JetBrains ACP 可覆盖核心 agent 能力 |
官方帮助页也确认：可以不切换编辑器，通过 ACP 在 JetBrains 中连接 Cursor agent。
2. 前置条件
| 条件 | 要求 |
|---|---|
| Cursor plan | 需要 paid Cursor plan |
| JetBrains IDE | IntelliJ IDEA、PyCharm、WebStorm 或其他 JetBrains IDE |
| Plugin | AI Assistant plugin enabled |
| Version | 官方说明为 JetBrains 2025.1+ |
如果团队卡在旧版 JetBrains 或禁用了 AI Assistant plugin，就先不要把 ACP 写成可用路径。
3. 安装流程
- 打开 JetBrains IDE 的 AI Chat panel。位置通常在右侧 sidebar，或 View -> Tool Windows -> AI Chat。
- 在 AI Chat panel 打开 agent provider list。
- 选择 Add Agent from Registry。
- 搜索 Cursor 并安装。
- 选择 Cursor 作为 agent provider。
- 完成认证。
- 在 AI Chat panel 中发送 prompt 开始使用。
初次验证建议用小任务，例如“解释当前文件的测试入口”或“在当前项目里找登录逻辑”，不要直接让 agent 批量改代码。
4. 能力边界
Cursor ACP 在 JetBrains 中提供的能力包括：
| 能力 | 说明 |
|---|---|
| Model selection | 可选择适合任务的 frontier models |
| Codebase understanding | Cursor indexing 和 semantic search 用于大项目检索 |
| File editing | agent 读写项目文件，结果反映在 JetBrains editor |
| Terminal commands | agent 在 IDE integrated terminal 中运行 shell commands |
这覆盖了 agent-driven development 的核心，但具体体验仍由 JetBrains AI Chat 和 ACP client 决定。遇到 UI、快捷键、工程结构问题，要先区分是 JetBrains、AI Assistant、ACP 还是 Cursor agent 层。
5. 工作方式
ACP 是连接 AI agents 和 IDEs 的开放标准。
flowchart LR
User["Prompt in JetBrains AI Chat"] --> Client["JetBrains ACP client"]
Client --> Server["Cursor agent server"]
Server --> Index["Cursor indexing / semantic search"]
Server --> Edits["File edits"]
Server --> Terminal["Terminal commands"]
Edits --> IDE["JetBrains editor"]
Terminal --> IDE当你发送 prompt，AI Chat plugin 会通过 ACP 转发给 Cursor agent。agent 读取项目文件，处理请求，并把 edits 和 terminal commands streaming 回 JetBrains IDE。
6. 迁移和并行使用
从 JetBrains 迁到 Cursor 时：
- 可安装 IntelliJ IDEA Keybindings extension 保留快捷键肌肉记忆。
- Cursor 使用 folder-based project model，不是 JetBrains project system。
- 语言支持更多依赖 extensions，而不是 JetBrains 内置插件。
如果团队暂时不能迁移，可以先用 JetBrains ACP 做过渡：保留 JetBrains 工程和插件生态，同时接入 Cursor agent。
7. 定价和治理
Cursor ACP 使用 Cursor subscription 的 usage-based pricing。上线前要确认：
- 参与试用的成员是否有 paid plan。
- 模型选择是否符合团队成本策略。
- JetBrains 中 agent terminal command 的权限边界。
- 项目代码 indexing 是否符合团队隐私策略。
- 是否需要给团队写统一的 JetBrains ACP 使用 SOP。
商业级验收
上线前至少完成：
- 在目标 JetBrains IDE + 2025.1+ 环境中安装 AI Assistant。
- 从 ACP registry 安装 Cursor。
- 完成认证并能发起一次只读 agent 任务。
- 验证文件编辑能落回 JetBrains editor。
- 验证 terminal command 可运行且日志可审查。
- 明确哪些任务用 JetBrains ACP，哪些任务转到 Cursor editor 或 Cloud Agent。
官方来源
- Cursor JetBrains Integration —— 官方 ACP、前置条件、安装、能力、工作方式和 pricing。
- Cursor Help: Migrate from JetBrains —— 官方迁移和 ACP 说明。
- Cursor ACP Mode —— ACP 背景。
- Cursor Models and Pricing —— 官方定价入口。