Cursor
用于将想法转为代码与协作开发的 AI 编程代理。
Cursor 是面向软件开发的 AI 工具，官方入门流程从打开项目、理解代码，到完成一处小改动并审查结果。
Cursor 能做什么
Agent 可搜索和阅读文件、修改代码及运行终端命令；较大的任务可先用 Plan Mode 研究代码并形成可编辑的实施计划。适合将明确需求交给工具协助执行，再由开发者检查改动与运行结果。
搜索项目并理解代码
官方入门说明可让 Agent 搜索仓库、读取相关文件并总结项目结构。适合先定位入口和模块，再提出有范围的修改要求。
修改文件并运行命令
Agent 文档列出文件搜索、读取、编辑和终端执行工具。执行前明确可修改的目录及验收方式，完成后检查每个改动。
先形成可审查的实施计划
Plan Mode 会研究代码、提出澄清问题，并生成可以编辑的计划；用户审阅后再进入实现。适用于多文件变更或方案尚未明确的任务。
查看差异并验证结果
官方快速入门要求审阅 diff，并运行项目已有的测试、类型检查、lint 或构建。通过哪些检查应以实际输出为准。
回看 Agent 会话中的改动
Agent 会在重要修改前建立本地检查点，支持预览并恢复文件状态。官方说明它与 Git 分开，永久版本管理仍应使用 Git。
- 核心用途
- 理解代码、协助修改与实施计划
- 可完成的工作
- 读项目、修复问题与规划小功能
- 如何开始
- 安装Cursor并打开项目
- 使用条件
- 先确认权限，再审查代码改动
如何使用 Cursor
- 安装并打开项目
按官方入门从下载、打开应用、登录和选择文件夹开始。编辑建议：先在有备份或版本记录的项目中选择低风险任务。
- 先让 Agent 解释代码
打开 Agent，要求说明仓库入口、关键模块和需要先读的文件。编辑建议：核对说明后再提供具体修改需求。
- 按任务规模选择工作方式
小改动可直接给出范围与预期；复杂任务可用 Plan Mode 研究并形成计划，审阅后继续实现。
- 审查差异与运行检查
逐个查看 diff，运行项目已有测试或构建；保留实际结果和必要的版本记录，再决定是否接纳改动。
熟悉已有代码仓库
适合：接手项目的开发者
- 准备输入
- 项目目录、README、技术栈和需要理解的业务流程。
- 操作方法
- 编辑建议：先要求解释入口与调用路径，并标出文件位置；选一个小功能对照源码验证，再补充项目约定。
- 预期交付物
- 可复核的代码导览和待阅读文件清单。
- 人工检查
- 实际打开文件，确认目录、函数和执行路径存在；避免只相信模型概述。
修复一个可以复现的问题
适合：需要定位故障的开发者
- 准备输入
- 复现步骤、报错、预期行为和相关测试。
- 操作方法
- 编辑建议：先要求定位原因并提出最小修复，再查看差异；使用同一复现步骤和已有检查验证前后行为。
- 预期交付物
- 供审查的修复改动和验证记录。
- 人工检查
- 问题是否消失、相邻行为是否正常；确认没有顺带改变无关文件。
为小功能准备实现方案
适合：独立开发者与小团队
- 准备输入
- 用户流程、涉及模块、范围边界及验收要求。
- 操作方法
- 编辑建议：先进入 Plan Mode，确认数据、页面和测试影响；审阅计划后按阶段实现，每阶段查看差异与输出。
- 预期交付物
- 实施计划及可逐步审查的代码候选。
- 人工检查
- 检查计划覆盖需求；代码需通过实际测试和运行，部署另按项目授权执行。
界面与参考图片
开始前需要了解
检查点不能代替长期版本记录
官方说明检查点与 Git 分开，只用于撤销 Agent 的改动；永久版本管理应使用 Git。
终端操作应有明确范围
Agent 提供运行终端命令的工具。编辑建议：执行前限定项目与允许操作，核对删除、迁移和部署命令；结果仍需查看实际输出。
安装与账户按当前入门说明
官方快速入门从安装应用、登录和选择项目文件夹开始。编辑建议：按当前下载说明选择系统版本；收费、模型及用量另外回查官网，不从示例界面推断账户条件。
Hobby 有免费额度；付费套餐增加用量，具体模型与额度以账户为准。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
Cursor 会直接修改项目文件吗？
Agent 文档列出编辑文件和运行终端命令的能力。编辑建议：先限定范围，并在完成后审阅差异和检查输出。
什么时候适合先用 Plan Mode？
当任务跨多个文件、需要研究或要求先审阅方案时，可先让工具理解代码、澄清需求并生成计划。
检查点恢复会清除对话吗？
官方文档说明恢复检查点会回退文件，不删除会话消息；检查点与 Git 的用途不同。
生成完成是否就算功能通过验收？
不算。官方入门要求审阅改动并运行项目已有检查；编辑建议：补充真实用户流程验证，保留实际结果。
