droboticflow/docs/verification/slice-generation-sync.md

20 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 切片生成失败后的状态同步
基线:统一工作树 `codex/recent-integration@e351ddce`。本次不修改生产数据、不自动重试作业,也未确认案例 `FYLX_B11_AZEC86400SC_19700104_182758/part0001` 首次失败的底层原因。
原页面仅在 materializing 阶段读取状态。直接执行实际 effect 的隔离测试复现:服务器已完成时,失败后的 slice/annotate 阶段没有状态读取或详情刷新。
修复后,明确的 sliceWorkflow.failed 状态每 10 秒读取一次摘要;正常生成保持 2 秒,正常标注不增加轮询。同一请求完成后才安排下一次,没有自动生成写请求。失败未变化不反复拉详情;检测到后台恢复后重新读取权威详情,不用前端猜测解锁提交。
未保存编辑或正在进行的写操作会推迟详情刷新;读取期间发生编辑也再次检查。保存后后续摘要检查继续同步,任务切换取消旧请求。恢复详情会清除本次生成失败及等待同步提示,其他错误不清除。失败提示明确说明暂不可提交、已有标注保留,沿用原重试和按当前保存内容重新确认入口。
验证:
- 新增 9 项实际轮询代码测试,覆盖外部恢复、持续失败、断网重试、未保存编辑、保存后恢复、请求期间编辑、离开页面、正常页面无新增轮询及频率。与原读取成本测试合计 11 项通过。
- 前端全量门禁通过,13 项既有失败,零新增;类型/架构、格式、构建与生产包启动通过。旧源码定位断言更新入口,仍断言不反复拉时间轴或完整任务。
- 本地真实浏览器通过:以明确合成的任务详情/摘要状态模拟失败→后台完成,约 10 秒内清除失败提示,未增加生成、保存或送检写请求。原源校验恢复场景仍通过,总约 19.11 秒。
- 浏览器首次因同一错误的两处展示造成严格定位失败,改为定位工作台并验证恢复后所有该错误均消失,保留首次失败日志。
本机日志:`local-data/verification/slice-generation-sync/`;截图:`local-data/test-results/source-validation-browser/generation-failed.png`、`generation-recovered.png`。截图中的视频地址为夹具占位,视频播放与并发容量不在此次验收范围。
能力边界:本次解决已证实的页面状态同步和恢复反馈问题,不保证未知的生成失败不会发生。首次失败原因仍需对应作业的原始错误及事件时间线;不能归因为网络或源数据。