Cursor
by Neoren
History
-
Cursor由Anysphere开发，2023年推出，是一款深度融合AI的编程IDE
-
本质上是Visual Studio Code的衍生版本，内置强大的AI编程助手
Interesting ideas
- A human-AI programmer, orders of magnitude more effective than any developer alone : )
Main features
Agent (智能体)
-
Cursor Agent turns ideas into code
-
Agent uses tools to search, edit, and run commands. From semantic codebase search to terminal execution, these tools enable autonomous task completion
-
可连接_MCP_ (Model Context Protocol, Anthropic提出):
- Agent客户端连接一个或多个_MCP服务器_
- MCP 服务器去对接真实的资源/工具（文件、DB、API、脚本等），并把它们以 MCP 的 resources/tools/prompts 形式暴露出来
- Agent再通过 _MCP 接口_按需读取资源、调用工具，把读到的内容当上下文、把工具当可执行动作来用
-
有_Rules_:
-
可定义Agent行为的自定义说明
-
Rules用来维持编码规范、强制约定的模式。比如必须用Swift Concurrency、必须MVVM、必须写单元测试、禁止强引用循环、命名规则等
-
Rules = 把你反复对AI说的话，变成项目里的“制度 + 自动化流程”
-
四种Rules类型：
- Project Rules: 存放在_.cursor/rules_里（在Cursor/Settings里添加），会进Git，只作用在当前代码库。适合做MVVM架构约定、命名规范、目录结构等。这是最常用、最核心的一类。
- User Rules: 个人偏好，所有项目通用。存放在Cursor/Settings里，作用在你自己的Cursor环境。适合做回答风格（简洁/中文/多示例）、通用编码习惯（比如默认给我最小改动）
- Team Rules: 管理位置在Cursor/Dashboard(团队/企业版)，作用在整个团队的所有项目，可强制（成员不能关）。是公司/团队强制统一的“红线规则”。适合做公司级编码规范、合规/安全要求、统一工作流。
- AGENTS.md: 最简单的规则形式，一份Markdown说明书。存放在项目根目录（或子目录），作用在当前项目/子目录。是一份纯文本，非常直观。适合做小项目、个人项目、想快速告诉Agent这个项目怎么写代码。是轻量版的Project Rules。
- 优先级：Team > Project/Agent > User
-
Rule应用的控制：
-
-
有_Checkpoints_:
- 给Agent每次改代码做的自动快照和一键回滚
- 如何恢复：在对应那次请求旁边会有_Restore checkpoint_ 按钮
- 它不是 Git 的替代品，仍建议关键节点用 Git commit 做可靠版本管理
-
生成_Todos_:
- Plan 模式生成的一个计划文件，保存在_.cursor/plans/_ 文件夹（Todos的待办项也都会显示在Cursor页面上）
- 运行Plan后，点按_build_ 会执行计划，会按照Todos改代码并记录进度、完成勾选
- 总之，Todos = 计划书 + 进度条。它把复杂任务拆成一串可执行的小步骤，并标记哪些已完成、哪些卡住、下一步是什么
-
操作_Terminal_:
- Cursor会操作终端（应该是Cursor的内嵌终端），并且会盯着终端的输出把流程走完
- 可以构建受信任的自动流程，或者安全考虑需要确认
- Agent是在一个沙盒中运行终端的，它会阻止非授权的文件访问和网络活动
-
Diff 功能：
- 在接受Agent的改变之前，先把所有改动用类似Git diff 的方式给你看，让你逐行决定要不要保留
- 所有改动将以有颜色的行显示在_Review_ 界面
Modes
-
Agent:
- For: 复杂功能、重构
- Capabilities: 自主探索、多文件编辑
- Tools: 启用所有工具
-
Plan:
- For: 需要计划的复杂功能
- Capabilities: 执行前做出详细的计划，ask clarifying questions
- Tools: 启用所有工具
-
Debug:
-
For: tricky bugs, regression
-
Capabilities: hypothesis generation, log instrumentation, runtime analysis
-
Tools: 启用所有工具 + debug server
-
-
Ask:
- For: 学习、计划、提问
- Capabilities: 只读探索、没有自主修改
- Tools: 只启用搜索工具
Cursor Tab
- A special Cursor Model for autocompletion
- The more you use it, the better it becomes as you inject intent by accepting or rejecting suggestions (这里指的是你通过“接受 / 拒绝 / 改掉建议”这些动作，把你当下真正想写的方向（意图）用行为信号注入到补全系统里，让它后续的建议更贴近你要做的事)
- Tab的实际功能：
- 一次修改多行
- 添加缺少的Import语句
- 在文件内及跨文件跳转以进行协同编辑
- 根据最近的更改、linter 错误和已接受的编辑获取建议
- Tab 预测跨文件的上下文感知编辑。当建议进行跨文件跳转时，底部会出现一个门户窗口
- You can accept a suggestion by pressing Tab, or reject it by pressing Esc. To partially accept a suggestion word-by-word, press ⌘ →.
Cursor Terminal
- 按_command K_ 会打开一个prompt bar，在里面用自然语言描述你的动作就能生成对应的指令
- 例如，不记得 find 命令的复杂参数时，只需输入“查找过去24小时修改的所有文件”，Cursor 会自动转换成正确的 shell 命令。
Context
- @Docs lets you use documentation to help write code (包括Apple Developer Documentation)
- 添加上下文的方式：
- @+显式点名要带哪些上下文
- 自动上下文（隐式）
- Rules（持久上下文）
- MCP 接入外部上下文/工具
- 拖拽文件/文本进输入框
Bugbot
- 绑定GitHub，用于Pull Request代码审查：
- 它会自动审查 PR，发现潜在 bug 或问题后留下评论提示修复
- 开发者也可以在 PR 评论中手动调用 BugBot，让其审查代码并列出 bug 清单及解释
- 相当于一个自动化的资深代码审查员，能够在数十秒内完成过去需要几天的人力 code review 工作
Cloud Agent
- 在云端远程环境里异步运行的 agent
- 它可以自己跑、改代码、（按配置）跑命令，完成后给你结果/PR
- 有点类似“拥有了一支不需要休息的AI开发小组”
Cursor Models
Codebase Embedding Model
- It gives agent deep understanding and recall
- 这个模型首先把你仓库里的代码片段（Cursor会先把文件按块/语法块切分）转换成_embedding向量表示并存到索引里，用来支持semantic search_（语义检索），即当你用自然语言提问时，Cursor会用你的问题生成一个向量，再用向量相似度在索引里找最相关的代码块，再把这些代码块拿来给Agent/Chat作为上下文
Reranker
- _重排_模型。在检索到一堆候选代码/上下文后，用重排把最相关的片段排到前面并压缩到可用的上下文预算里
Composer 1
- Cursor自家的agentic coding模型
Cursor Tab
- 专门用于实时自动补全/下一步编辑预测的模型
Cursor-Xcode
读取项目
-
假报错，需要通过终端创建一个_buildServer.json_文件:
进入目录后，可仅运行第三行。（Cursor 里的 Swift 语言服务SourceKit-LSP没拿到 Xcode 工程的编译参数/SDK/scheme，于是把很多符号当成“找不到”）（运行类似_xcode-build-server config -project GratefulMoments.xcodeproj -scheme GratefulMoments_）