This guide is currently available in Simplified Chinese.
任务停留在同一页面，可能正在执行、等待人工确认，也可能遇到了环境或执行错误。先找到当前工作对象和页面提示，再判断下一步，可以避免重复创建任务或重复执行已经完成的操作。
本篇适用于需求会话、技术设计和交付批次。各项目的工作流可以不同，恢复与重试操作以当前实例实际提供的入口为准。
先确认当前状态
开始排查前，依次检查：
- 位置是否正确：当前组织、工作空间、需求或批次是否就是本次工作。
- 是否在当前阶段：历史节点通常只读，需要回到当前阶段继续处理。
- 最新进展是什么：查看会话、阶段状态和待处理卡片，区分执行中、等待确认与失败。
- 页面是否已更新：留意连接异常、刷新失败或正在展示上次结果的提示。
- 是否已有处理中的操作：任务排队、执行或提交中时，先跟踪已有请求。
如果页面显示 “连接异常，正在恢复”，等待连接恢复；长时间未恢复时，刷新页面，再核对服务端返回的状态。刷新页面后仍要检查实际进度，不能仅凭之前停留的画面判断任务失败。
按现象找到处理方向
看不到入口，或需求项列表为空
工作空间不可见时，先确认所在租户正确，再请管理员检查账号角色和授权工作空间。切换业务或研发视角不会增加权限。
从首页进入技术设计时，需求项需要属于当前工作空间、已通过准入，并且尚未加入交付批次。从首页进入生产实施时，还要确认技术设计已提交；设计正文更新后，可能需要重新确认提交。
如果需求项已经加入批次，应进入原批次跟踪。筛选条件导致列表为空时，清除不必要的条件后重新查看。
成员与项目配置可参考管理员配置指南。
AI 没有回复，或环境一直在准备
先查看页面中的具体错误，区分以下情况：
- 没有可用模型、调用被拒绝或调用超时：由配置负责人检查模型是否启用、接入地址、凭据及上游服务。
- 无法分配或连接执行环境：由平台管理员检查运行服务、可用 Worker，以及工作空间配置的资源标签。
- 仓库准备失败：由研发人员检查仓库地址、访问权限、目标分支及实际错误。
- 项目启动失败：检查依赖、启动命令、必要配置和应用日志。
有新进度或明确显示正在执行时，继续跟踪当前任务。若进度长期没有变化，保留最后一次变化时间和页面错误，交给相应负责人定位。
页面提供 “继续准备”、“继续方案检查” 或初始化恢复入口时，先处理其指出的问题，再使用该入口继续同一次请求。没有恢复入口时，提供原任务信息请求协助。
AI 说完成了，但工作流没有进入下一阶段
AI 的回复说明本轮会话结果；工作流推进还可能需要检查和人工确认。查看当前阶段附近的待处理卡片，确认它正在要求什么。
- 等待确认：审阅当前范围、内容和目标，由具备权限的成员提交决定。
- 准备未完成：使用页面提供的继续准备操作，或在当前会话中说明需要补齐的内容。
- 检查未通过：阅读具体问题，修复后重新提交检查。
- 操作执行中：等待当前请求完成，再检查结果。
如果提示 “agent 处理中，请等待完成后再操作”，应先等待正在进行的会话结束。如果正在查看历史阶段，回到当前阶段后再检查按钮是否可用。
遇到代码版本、分支或未提交改动的提示时，由研发人员核对当前仓库。保留并处理实际改动，按要求重新验证，确认合并目标与已验证版本一致后再操作。
测试没有继续，或报告不可用
在 API、E2E 区域分别查看本轮状态，不能只看上一份报告：
- 等待执行或正在执行：先查看已有任务进展；提示已有任务时，不重复发起。
- 测试未通过：检查失败用例、实际结果和预期结果，修复后重跑受影响内容。
- 执行失败或阻断：查看是否缺少服务、浏览器、账号、测试数据，或执行会话异常。
- 报告未生成、发布失败或读取失败：检查实际执行日志和当前环境，确认验证是否完成，以及哪些结果可以核实。
记录缺失与业务操作失败应分别处理。报告打不开，不能据此认定测试用例失败；没有可核实的验证结果，也不能认定已通过。必要时补做验证，并记录仍未确认的部分。
如果只有历史报告、快照或交接记录缺失，应保留告警，并结合当前沙箱、仓库和实际执行情况处理。若页面因此无法继续，请提供诊断信息让负责人排查记录问题；不要伪造报告或填写未经验证的“通过”。
人工上传报告只用于留档，不会覆盖 API/E2E 结果。详细查看方法见查看预览、测试结果并完成业务验收。
提交业务验收或完成验收时被阻止
提交业务验收前，检查当前阶段提示的前置条件。接入独立 TEST 验证的项目，可能要求先完成 TEST 部署与健康检查；应到页面指出的验证区域处理。
进入验收后，核对当前轮次及各需求项：
- 是否每项都有结论，验收人和意见是否填写完整。
- 选择“不通过”或“需要修复”时，是否已填写缺陷说明。
- 是否仍存在未通过项，需要返回生产修复并进入新一轮验收。
- 所有要求满足后，是否执行了单独的 “完成业务验收” 阶段操作。
“已验收”数量只表示已记录结论的数量。逐项提交完成，并不自动表示本轮全部通过或已完成阶段确认。
合并或部署后报错，先核实操作结果
页面刷新失败可能发生在实际操作成功之后。例如，页面提示 “代码已合并，但页面状态刷新失败” 时，应先刷新当前批次，并到目标仓库检查合并结果。
涉及代码合并、部署、发布或规格归档时，核对本次操作的目标、版本及已有结果。外部系统已经完成的操作，应让负责人核对平台记录与外部结果，避免因页面未更新而重复执行。
标准流程的 “确认上线” 本身不执行部署。若流程已确认但实际环境没有新版本，应检查项目约定的发布过程和目标环境，而不是再次点击确认来触发部署。
怎样使用恢复或重试操作
恢复入口只在当前工作流允许、账号具备权限且状态满足条件时提供。不同实例可能有不同操作，不能用另一批次的阶段顺序推断当前任务应如何恢复。
使用前先核对当前提示、待处理请求及已有结果。需要填写 “恢复原因” 时，说明发生了什么、已经处理了什么，以及为何可以继续，再点击 “确认恢复”。
例如：
仓库访问令牌已更新，已在当前工作环境确认能够读取目标分支。本次环境准备尚未完成，继续处理原批次的初始化请求。
提交后观察新的状态和执行结果。若再次失败，补充新错误，请负责人继续定位。权限、人工决定、当前执行中的操作和外部目标等必要条件仍需满足，恢复不会替代这些确认。
请求协助时提供什么
可以复制下面的模板发给项目负责人或管理员：
组织与工作空间：
需求 / 需求项 / 批次编号及页面链接：
当前阶段与状态：
操作人及账号角色：
发生时间（含时区）与最后有进展的时间：
执行了什么操作：
预期结果与实际结果：
完整错误文案、错误码或运行编号（如有）：
已经进行的检查或重试：
涉及的环境、代码版本及已确认的合并 / 部署结果：
相关截图或脱敏日志：
保留原任务和诊断信息，便于负责人找到同一次执行。提交截图或日志前，移除密码、访问令牌、模型密钥及无关的敏感业务数据。