用途：Cursor 是构建在 VS Code 之上的 AI 原生代码编辑器，面向 AI 优先的软件开发，用于加速功能开发、仓库级上下文推理、内联代码编辑与调试。
主要能力：通过 Cursor Composer 进行多文件代码编辑；对代码库做预测性索引，并用 @codebase 在项目语义嵌入中搜索；用 .cursorrules 定义架构、框架与测试规范等持久项目规则；用 Cmd+K 在编辑器缓冲区内生成、重构和修复代码；支持 @file、@docs、@symbol 等定向上下文标记。
使用方式：在项目根目录创建 .cursorrules 写入约定，例如偏好 React 19 函数组件与 hooks、使用严格 TypeScript、用 Vitest 写单元测试。提示中可用 @codebase 提问，或指定 @middleware.ts、@src/auth/session.ts 等文件实现具体改动。Composer 中可跨架构边界重构，如把旧 REST 端点改为 Server Actions 并补充测试。
适用场景：AI 优先的功能工程、仓库级上下文推理、自定义项目规范、交互式内联编辑。
限制与注意：不要向 AI 输入数据库密码、生产 API 密钥或客户隐私数据；接受多文件 Composer 改动前应仔细审查 diff 并运行测试（npm test）；用 .cursorignore 排除生成文件、.env 与构建产物。常见问题包括索引失败（需在 .cursorignore 排除大文件）、Composer diff 无法应用（文件被外部修改，需用最新状态重跑）、Tab 自动补全变慢（可重启 Cursor 或禁用未用扩展）。