Agent 文件发现与执行问题
检查忽略、索引、CI 环境以及 Extension Host 超时，保留诊断日志。
结果偏离需求时先补明确目标、约束和相关文件，跨文件任务用 Plan Mode。完成一个功能或切换任务后可新建 chat；反复需要的约定写入 .cursor/rules/。
文件没有进入上下文
检查项目根 .cursorignore 与 .gitignore，后者也可能影响发现。命令面板搜索 Reindex 重建索引，再用 @filename 明确附加需要的文件。忽略策略的范围见Ignore files，不要把重新索引当成绕过忽略的办法。
要撤销 Agent 修改，从先前消息 Restore Checkpoint 恢复；只恢复文件，不删除聊天消息。检查点本地保存且独立于 Git。
CI=1 改变命令行为
Agent 终端设置 CI=1，使输出更适合自动处理。若工具因此走不同路径或跳过交互，可在对应命令中取消：
unset CI && your-command-here也可给规则写明只在 CI 环境改变行为时使用此前缀，不需要对所有项目一概修改。
Agent Execution Timed Out
此错误表示 Extension Host 未在 60 秒内完成启动；Network diagnostics 中 Timeout waiting for EverythingProvider 可能有相同根因。
先运行 Developer: Export Logs...，选择 Main、Window、Extension Host。检查 Output > Extension Host，若为空也记录下来，这是有用的诊断信号。提供系统和 Cursor 版本后再定位原因。
企业 AV/EDR 是可能原因之一，不凭报错直接断定。经 IT 确认后按端点安全文档检查应用路径和进程策略。
云端或自托管
worker 可运行 agent worker debug 收集 preflight；池容量可在 Cloud Agents dashboard 查看。网页附件显示 4MB limit 时按该入口的附件规则压缩或拆分，不把它推广为全部 IDE/SDK 上传限制。