故障排查｜定位连接、任务与内容问题

先把问题定位到连接、材料范围、等待状态或成果位置。保留原输入与错误，避免在不知道是否已经执行的情况下重复整项任务。

模型没有正常回复复制小节链接

看当前错误属于哪一类，再处理：

• 认证失败：检查供应商地址、API Key 和账号状态。
• 余额或账单异常：到相应模型服务确认账户，不要只反复更换同一把 Key。
• 网络连接异常：先验证服务能否访问，再重试。
• 限流或配额限制：等限制恢复，或切换确实可用的模型。
• 上下文过长：减少本轮附件和无关背景，或压缩会话。
• 其他失败：阅读技术详情，记录具体条件，不要一律归因于配置。

新连接先按Provider设置测试，再确认当前对话实际选中了正确模型。连接测试通过也不保证所有视觉、生图或工具能力都已验证。

AI 说找不到资料复制小节链接

1. 确认当前资料库与关联目录。
2. 用文件浏览或 @ 查找实际文件。
3. 对照完整路径，排除同名笔记。
4. 直接引用关键材料，再要求查证。
5. 索引仍在处理或读取失败时，按提示等待或重试。

地图上有一个节点，不等于该节点正文已经进入当前请求。范围选择也不会自动授予外部目录权限。

任务看起来停住了复制小节链接

先读状态：

• 等待提问：在提问卡回答。
• 等待计划审核：批准方案或要求修改。
• 等待权限：核对范围后允许或拒绝。
• 排队或限流：查看待发送与服务限制。
• 正在压缩：等待压缩结束，不要同时重复发起。
• 已停止、中断或失败：读恢复提示，核对已经完成的部分。

仍在等待的卡片与历史已结束卡片不同。不要向旧卡片重复提交，也不要仅发一句“继续”就假定原等待点已解决。

找不到成果复制小节链接

先看聊天中的本次产出和文件卡，再看右侧工作区与实际项目目录。右侧列表只显示部分支持格式；音频、PDF或其他文件可能通过消息卡和系统打开。

要求 Agent 给出准确路径，并核对文件实际存在。没有可打开文件时，“已经生成”不是充分证据。完整说明见成果指南。

网页读取不完整复制小节链接

读取成功、内容有限和读取失败是不同结果。先展开工具结果，确认有无正文；看到错误时，可按可用入口重试、切换读取方式或打开原网页。

不要因为返回了网页标题就把全文视为已读。页面需要登录、图文提取有限或正文缺失时，把缺口告诉 Agent，并另找可核对来源。

报告一个能定位的问题复制小节链接

写清版本与平台、你做了什么、预期什么、实际什么、错误出现时间，以及是否已生成文件。尽量提供最小复现步骤，保留关键错误与必要截图。

隐藏凭据和无关私人材料。任务可能涉及写入时，先保存当前文件与备份，再决定重试或恢复。

搜索 Connected 但没有结果复制小节链接

当前搜索“测试连接”主要请求服务地址的 HEAD 响应，只把部分认证错误视为失败。HTTP 405、404 或服务端错误可能仍显示 Connected，因此这个提示不能证明 Key、查询接口或真实结果可用。

使用一条公开、简短的查询核对实际来源；若失败，检查端点、密钥与错误，不要反复重跑可能写文件的完整研究任务。

等待卡失效或 Inbox 首次加载报错复制小节链接

计划列表显示待批准，而打开后提示审批已失效时，不要根据旧状态继续执行。让 Agent 在当前会话重新提交可用计划，并核对新卡片。授权卡过期也不代表自动拒绝，仍需检查任务是否停在等待状态。

Inbox 显示当前资料库或上下文已变化时，先确认资料库没切错，再使用重新读取。重复出现时记录版本与操作顺序，先停止批量归位。当前文档不把一次重读成功当作已确定并修复了首开竞态根因。

模型输出预算耗尽复制小节链接

出现 provider output budget was exhausted 一类错误时，表示本次未得到可用的完整输出，不代表任务已完成或无需修改。检查输出预算、模型与材料规模后再决定重试；先核对已保存文件，避免重复提交整批任务。