用途：配置 Cursor 的代码库索引，使相关源码与文档可被 AI 检索，同时把敏感、生成、超大和无关文件排除在 AI 上下文之外。
主要能力：索引将代码分块并生成向量嵌入，支持 @Codebase 语义搜索，提升 Chat、Composer 和 Agent 模式的上下文感知。使用 Merkle 树做变更检测，仅重新索引修改过的文件（约每 10 分钟一次）；服务端不存明文代码，仅存嵌入与混淆元数据；兼容 Privacy Mode。索引在后台运行，小项目数秒完成，5 万文件以上项目首次可能需数小时。
使用方式：在 Cursor 打开项目后索引自动开始，底部状态栏显示 Indexing... 或 Indexed。可在 Cursor Settings > Features > Codebase Indexing > View included files 查看已索引文件。用 .cursorignore（.gitignore 语法）同时排除索引与 AI 功能；用 .cursorindexingignore 仅排除索引，文件仍可通过 @Files 引用。Cursor 默认排除 .gitignore 中的内容。查询示例：@Codebase where is user authentication handled?。发现阶段用 @Codebase，已知文件用 @Files，精确匹配用 Ctrl+Shift+F。
适用场景：单仓库、多包 monorepo（可只打开具体包目录或在根目录用 .cursorignore 排除不活跃包）、需要语义检索的大型代码库。
限制与注意：索引需要访问 Cursor 嵌入 API 的网络，离线/气隙环境不可用；嵌入存于 Turbopuffer 云端，存在混淆元数据；仅索引当前打开工作区的文件。搜索陈旧或卡住时可用 Cmd+Shift+P > Cursor: Resync Index，或删除本地缓存目录后重启。Linux 大项目可能触及 inotify 限制，可调整 fs.inotify.max_user_watches。具体收费、价格与平台细节暂未提供。