任务故障与人工接手

先保留原生任务、服务实例与版本，再诊断，不通过重复建任务或反复改状态试出结果。本页是使用者的操作路径；调度与恢复原理引用失败与恢复，服务维护从部署排障进入。

开始前准备

需要原生 issue 标识与 URL、所属项目、预期执行服务，以及已有的只读观察权限。先确认实例和任务范围，再看状态；本站不提供实时查询，也不创建、恢复或派发任务。独立参考实例可按首次运行准备，已有自用实例不需要另启服务。

现象	操作	预期结果	异常下一步
保存后没有执行	先重开原任务，核对项目、原生状态、依赖和所需资料，再读对应服务	区分保存成功、已符合准入、已派发三个阶段	自用 Backlog 补具体缺口；Plane 核对项目接入与委托；不要复制到另一 tracker
显示活跃但没有运行记录	核对服务版本、provider scope、路由、标签及并发 / 认领	找到具体未选入原因或当前等待项	来源访问或配置错误交 owner；不要把 In Progress 文字当作服务在线证明
正在 retrying	读取同一任务的错误、attempt 与 due time，核对目录已有成果	解释等待的是正常续跑还是异常重试	先修根因与副作用；重复错误按项目恢复合同处理，不新建同一任务
显示 blocked	读取输入 / 审批请求及对应会话	找到需要处理的实际问题	由有权操作者处理；不降低审批策略或重启清空记录来绕过
来源已终态但仍见旧反馈	核对记录时间、服务实例、当前快照及来源刷新错误	确认反馈是否只是历史，当前执行是否停止	服务 owner 查残留进程与外部动作；不能仅凭旧评论判断
已显示完成但产物不符	比对任务范围、文件 / commit、精确 CI 与适用部署	确认是缺证据、版本不符或实际结果失败	在原任务反馈复现与版本；打回和部署回滚分别处理

来源状态与核心执行的关系见任务生命周期；来源配置范围见任务来源。本表不新增通用业务状态或操作 API。

下列路径已按官方 be10a1b79df723d6d7612b5651c8522704dafb2e 的 Router、Controller与 Presenter核对，未在团队目标实例执行。该版本必须启用可选 HTTP 服务才有接口；其他部署先确认其版本与授权观察地址。

用 owner 已确认的地址设置 SYMPHONY_URL，它只是下例 shell 变量，不是新增 WORKFLOW 参数。把第二条的标识替换为真实值：

curl --fail "$SYMPHONY_URL/api/v1/state"
curl --fail "$SYMPHONY_URL/api/v1/YOUR-ISSUE-IDENTIFIER"

结果	应怎样理解
summary 的 running / retrying / blocked	当前实例的内存观察；结合生成时间及具体任务，不是永久历史
HTTP 200 但 JSON 有 snapshot 错误	此版本可能返回 snapshot_timeout / snapshot_unavailable；不能仅凭 HTTP 成功断言调度健康
issue 接口 404	当前 running / retrying / blocked 未找到，或 snapshot 不可用；不能证明原生任务不存在、未执行或业务完成
连接失败	先核对已启用接口、地址、宿主运行与现有访问边界；不要猜端口或新开公网权限

POST /api/v1/refresh 是请求轮询 / 核对的控制动作，不是创建、强制执行、复活或改业务状态接口；排队成功也不证明任务已执行。普通排错先使用上述只读路径，操作触发按服务 owner 的合同处理。

没有对所有版本和来源统一的 pause / resume / takeover 按钮。先说明要暂停哪一个原生任务、当前执行与保留成果，再按实际来源合同操作：Plane 撤销委托，Linear 由项目 owner 使用已约定的接管方式。不得借用另一来源的 UUID、状态或动作。

接手的预期结果是旧执行已经停止，当前目录、分支和外部写入结果清楚，接手者拥有适用权限。若只能确认业务状态改变，尚未确认服务停止，就保持具体阻塞，避免同时写同一目录。关闭至终态可能清理目录，先保留所需成果；重启会丢失内存阻塞状态，可能使活跃任务再次入选，不能把重启当作暂停。

反馈写回原任务或已授权审核入口，说明实际结果、期望、复现、范围、精确版本和证据引用。原 MR 已合并时，新修复从当前注册基线继续；返工不是撤销历史合并，也不是部署回滚。

按提交与跟进处理业务决定，按部署排障处理环境恢复。普通执行者不得凭排错需要启用自动审核、绕过来源拒绝、删除锁、扩权或操作宿主服务。

保留：任务 URL、来源与项目、服务版本和观察时间、问题阶段、预期 / 实际结果、最后可确认的副作用、证据引用与待补条件。凭据、私人截图和完整敏感日志继续留在受控系统；公开文档不保存一次执行的原始记录。

结束排错的判据是根因或具体阻塞已明确，恢复后对应任务与产物有真实读回；不是仅看一次 HTTP 成功、状态变绿或“已完成”评论。