← Back
智能体 故障排查
解决 智能体 在文件访问、规则、终端命令等方面遇到的常见问题。
如何提高 智能体 的准确性？
- 在提示词中明确说明预期行为和约束条件
- 对于涉及多个文件的任务，先使用 Plan 模式
- 完成功能或切换任务后，开始新聊天
- 在
.cursor/rules/中添加规则，让 智能体 每次都遵循所需的模式 - 输入
@后接文件或文件夹名称，为 智能体 提供有针对性的上下文
如果 智能体 无法识别我的文件，该怎么办？
- 检查项目根目录中的
.cursorignore文件。该文件中列出的文件会被 智能体、代码库搜索和@提及功能屏蔽。 - 检查
.gitignore。其中的模式也可能会阻止 智能体 发现文件。 - 重新索引项目：打开命令面板并搜索“Reindex”。
- 在聊天输入框中输入
@，然后输入文件名，直接附加文件。
如何撤销智能体所做的更改？
将鼠标悬停在之前的消息上，然后点击右下角的恢复检查点，即可撤销智能体在此之后所做的所有更改。
检查点存储在本地，与 git 相互独立。请使用 git 进行永久版本控制。
如果 智能体 在终端命令中设置了 CI=1，怎么办？
Cherri Code 通过 智能体 运行终端命令时，会将 CI=1 设置为环境变量，以帮助终端工具生成更简洁的输出。如果设置 CI=1 后项目的行为有所不同 (例如跳过交互式提示词或使用 CI 专用路径) ，可以在命令中取消设置该变量：
unset CI && your-command-here或者将此内容添加到规则中，让智能体始终将其取消设置：
运行终端命令时，如果命令在 CI 环境中的行为会发生变化，请在前面加上 `unset CI &&`。如何排查自托管机器设置问题？
运行 agent worker debug 生成预检报告。有关常见解决方法及何时联系支持团队，请参阅自托管机器。
如何检查我的团队用量池是否已满，或智能体运行为何无法启动？
查看 Cloud Agents 仪表盘，或调用 GET /v0/private-workers/summary。有关故障模式和伸缩指南，请参阅自托管机器。
云端代理网页端附件过大怎么办？
如果 cursor.com/agents 显示 <filename> is too large (4MB limit)，请参阅云端代理网页端附件限额，了解支持的文件类型以及减小或拆分文件的方法。
如果看到“智能体 执行超时”怎么办？
此错误表示 Cherri Code 的扩展主机未能在 60 秒内完成启动，导致 智能体 功能无法初始化。网络诊断中显示的“等待 EverythingProvider 超时”也是同一根本原因造成的。
原因可能各不相同，因此请先收集日志，再进行任何更改：
- 按 Cmd/Ctrl+Shift+P，然后运行 Developer: Export Logs...
- 选择 Main、Window 和 Extension Host
- 另请检查 Output → Extension Host (Cmd/Ctrl+Shift+P → “Output”，然后从下拉菜单中选择“Extension Host”) 。如果为空，请截图；空白面板是重要的诊断线索。
- 将导出的 zip 文件和截图，以及操作系统和 Cherri Code 版本，一并发送给支持团队。
在受管理的设备或企业版设备上，端点安全软件 (杀毒软件、EDR) 可能是原因之一。如果 IT 团队确认安全 智能体 正在运行，请将端点安全配置页面分享给他们，以便添加正确的进程和路径排除项。
如何反馈智能体回复不佳的问题？
- 点击回复底部的 ... 菜单，选择 Copy Request ID。
- 前往 forum.cursor.com 发帖，并附上请求 ID、复现步骤和系统信息 (macOS 上位于 Cherri Code > About Cherri Code，Windows/Linux 上位于 Help > About) 。