droboticflow/docs/annotation-time-integrity.zh-CN.md
d-robotics 63512da71f
Some checks failed
web-ci / checks (push) Waiting to run
web-ci / checks (pull_request) Has been cancelled
🐛 Preserve confirmed annotation frames and enforce v4 time evidence
2026-10-22 12:54:08 +08:00

4.0 KiB
Raw Blame History

标注确认、时间映射与存量兼容

2026-10-22 修复契约

合法的源帧边界不等于用户确认了该边界。页面恢复自动保存草稿,不能使失败重试静默采用另一份已确认工作区。切片、动作、字典版本与标签、舍弃理由必须属于同一次确认。

普通失败重试只接受与原生成确认相同的业务内容。服务端比较规范化的切片、动作和状态,不将保存时间及压缩后的操作历史作为业务差异。有较新的不同草稿时返回 409 slice_retry_snapshot_conflict,不入队、不清空或替换两份保存内容。

操作者可显式选择“按当前保存内容重新确认生成”。该请求仅传任务版本和 reconfirmSaved,服务端读取已保存草稿,核对操作者、任务版本、保存先后、字典及统一帧边界,建立新的持久作业;客户端提供的重试快照与内容哈希不被信任。它不沿用初次切片确认清空动作的语义。

每次确认记录业务内容指纹。后台生成前及完成发布前分别核对指纹与当前可恢复内容;不一致时生成失败,保留内容及失败作业输入,不能通过删除新草稿发布旧结果。部署前已入队、没有新指纹的作业也执行内容比较。旧租约和任务版本机制继续阻止过期进程写入。

重新确认前,旧工作区和可获得的失败作业快照以内部准备事件保存;准备事件不是已经受理或生成成功的证据。若事件保存失败或超过完整保存上限,请求停止。生成结果及内部事件关联确认指纹;这些过程字段不进入客户总 JSON。

时间与来源检查

原时间网格和已保存秒数不在此次修复中重算。硬件 PTS、左右相机各自帧范围及半开区间语义保持不变。新 v4 要求可靠完整的秒数与硬件 PTS 映射;仅有首尾连续性不能证明两种坐标一致,缺证据时拒绝新交付,而不是按固定帧率或时长插值猜补。

接入时的原始 Run 已保存所选对象键及由 key|ETag|size 生成的指纹。v4 在打包执行前、写交付目录归属标记前,以及批次预览/发布时重新 HEAD 同一选择并核对该指纹,包括原选择中的可选音频。不能从当前列表、Capture 的新状态或当前文件重新生成“期望值”。读取键有界,不重新下载或哈希整段视频。

ETag/大小指纹用于检测对象身份变化,不等同于逐对象 SHA256 或不可变对象版本;无法证明外部对象从未被覆盖后恢复。保留内部固定源的现有 SHA256 校验。原始选择缺失、范围不一致或身份发生变化时,只拒绝该次 v4 发布,不自动修复历史。

所有 v4 打包节点和源索引输入使用 Worker 已有的 ANNOTATION_SOURCE_PACKAGE_IMAGE 不可变镜像配置。物理 v1–v3 输入继续使用原工作流镜像,历史读者与已交付文件保持兼容;此次发布不原地改写工作流定义。

旧数据处理

  • 编辑中或生成失败的冲突内容:两份保留,操作者核对后显式重新确认;不按保存时间自动择新。
  • 已生成、待质检或待验收:被审修订固定。发现确认/生成不一致时走正式返修,不以新草稿替换被审结果。
  • 已交付:不覆盖原文件。确认错误后重新验收并建立新不可变批次;证据一致的历史交付无需重生成。
  • 缺历史来源或映射:报告缺口,不猜补、插值或把当前证据冒充过去证据。

本次应用升级没有启动历史盘点、回填、时间重算或批量重生成。任何生产修复脚本需要另列具体范围、预览及授权。

验证要求

回归覆盖保存版本冲突、显式重新确认、原标签与动作保留、任务归属及版本拒绝、失败/进程重启恢复、旧作业与后来的草稿竞争,以及物理/源索引两种 v4 独立消费路径。构造“秒数连续但 PTS 错误”及“同大小、不同 ETag 的原始文件”,必须在发布前拒绝。