用途：诊断 Cursor 代码库索引缺失、过时、缓慢或范围过宽的问题，同时在调整索引范围时确保敏感文件和生成文件不被纳入 AI 上下文。
主要能力：
- 按症状快速定位：状态栏卡在 Indexing、@Codebase 无结果、结果错误、索引崩溃或重启、无法索引等；
- 通过 .cursorignore 缩小索引范围（排除构建产物、依赖、生成文件、数据、媒体等）；
- 重新同步索引：Cmd+Shift+P > Cursor: Resync Index；
- 必要时清理缓存后重启，触发完整重建；
- 区分 .cursorignore 与 .cursorindexingignore：前者不进索引也不供 AI 使用，后者不进索引但可通过 @Files 引用；
- 大型项目优化：不打开整个 monorepo，只打开目标包，或用 .cursorignore 排除其他包；
- Linux 文件监听限制与内存压力参数调整；
- 企业环境关注点：嵌入存储于 Turbopuffer 云端、需出站 HTTPS、10 分钟轮询不可配置、无索引审计日志。
必要用法：确认文件位于已批准工作区根目录且未被忽略规则排除；查看索引状态，仅刷新受影响的工作区，并与已知预期文件对比；通过正常评审流程修改忽略或规则配置，再验证必需文件被纳入、敏感路径被排除。缓存清理命令与设置项均按资料原样保留。
适用场景：本地开发中索引卡住、@Codebase 返回空或错误代码、索引结果陈旧、大型或 monorepo 项目索引缓慢、Linux 监听上限与内存不足导致崩溃。
限制：索引需要访问 Cursor 嵌入 API 的网络连接，完全气隙环境不可用；10 分钟索引刷新间隔不可配置，只能手动重同步；索引文件无日志审计；语义搜索可能因语义差异漏掉文件，精确关键字匹配应改用工作区搜索。若敏感文件被索引，应立即停止共享上下文、修复排除并遵循暴露政策；索引仍陈旧时收集脱敏诊断并上报，不要移除全部忽略控制。