Cursor客户端解剖系列学习笔记

前言

最近一直在用 Cursor，越用越想搞清楚：它到底在客户端里做了什么。

网上讲用法的文章很多，但我更关心工程问题——Agent 能力是怎么嵌进 IDE 的。手头有一份对 Cursor macOS 应用包（Contents）的学习笔记：版本线索是 Cursor 3.13.25，底座 VS Code 1.128.0。主包 JS 被打成超大 bundle，谈不上完整源码还原；真正可读的路径是：

VS Code 开源分层 + Cursor 内置扩展的 package.json / 进程切分 + 协议字段（agent.v1.* / aiserver.v1.*）

本系列据此写成，目标不是破解，而是把设计理念学到手。文中会尽量写清「包内证据」和「推断」，避免把猜测写成事实。

系列目录

• Cursor客户端解剖（一）为什么是-VS-Code-Fork
• Cursor客户端解剖（二）整体架构鸟瞰
• Cursor客户端解剖（三）上下文引擎：索引与检索
• Cursor客户端解剖（四）Agent三件套：Host、Exec、Worker
• Cursor客户端解剖（五）Chat、Composer-与-Agent
• Cursor客户端解剖（六）工具循环：终端、MCP、Rules、Skills
• Cursor客户端解剖（七）一次请求怎么走完
• Cursor客户端解剖（八）系列总结：真正的护城河

学习材料里最重要的一张图

读完你会带走什么

1. 为什么是「Fork 内核 + 能力插件化」，而不是侧边栏插件
2. Host / Exec / Retrieval / MCP 为什么要拆成不同故障域
3. 一次任务里：哪些在本地做、哪些在服务端想
4. 做自己的 AI IDE / Agent 时，最值得抄的是哪几条架构原则