droboticflow/docs/operations/annotation-work-availability.md

23 lines
2.6 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.

# 标注作业优先恢复
2026-11-11 用户批准:优先恢复标注、切片、送检、质检和最终验收;保留原标注、权限、版本和源身份校验。暂停性能优化与批量补验。
## 本次行为
API 与切片处理器同时配置 `ANNOTATION_SOURCE_VALIDATION_MODE=advisory`。未设置、`strict` 或未知值均保持原严格路径。发布检查要求两个组件的值一致且合法。
- 缺少完整源证书、历史审计失败或审计排队不再决定能否领取、保存或读取审核内容。详情返回 `unverified / required=false`,不伪造 `valid` 或修改旧审计作业。
- 生成源索引仍要求视频可读、帧数与 PTS 数量一致、双目与 IMU 能形成合法统一边界、源版本固定,切片无重叠和缺口。逐帧解码与严格固定帧节奏检查不在作业前置路径运行。
- 基础作业索引使用 `annotation-processing-v1:<org>:<fingerprint>`,正文为 `droboticflow.annotation-processing-index/v1`,与完整证书分开存储。显式全量审计只接受完整证书,不能复用基础索引冒充校验成功。
- 源索引修订仍输出原 `droboticflow.source-slice-index/v1`,冻结源文件、时间戳、IMU 边界和标注格式保持兼容。审核帧时间线优先使用已发布源索引的身份与缓存,不依赖后续审计或可变原文件。
- 实际无法建立基础映射的生成作业保留输入与标注,单条隔离;个人列表保留任务,但释放其容量名额。未决领取意图仍保留槽位,避免重复领取或重启超领。修复后重试使用正常持久作业和版本校验。
- 账号、供应商、项目隔离、自审禁止、审查租约、版本冲突、送检输入保护及失败快照保留规则不变。
## 验证和发布
仅使用合成媒体与本机隔离 Mongo。用严格时钟检查会失败的媒体验证:保存非空标注、切片、旧工作器拒绝、重启接管、送检、质检、最终验收;同时检查审核读取冻结证据、角色拒绝和旧版本拒绝。浏览器另覆盖首标确认与失败保存恢复。
本次不更改生产任务、不触发批量补验、不改公网带宽或 Pod 资源。准备发布时先核对同步 dev,明确展示 API/处理器配置变更与镜像切换计划。现用 Worker 和校验器保持原版本;校验器仍可处理原有显式审计请求,但作业不等待其结果。
移除 advisory 会恢复严格准入,可能再次拦住没有完整证明的任务。回退前必须重新盘点,不能自动关闭模式。基础索引不转写为完整证书,不改客户源文件;既有源索引修订继续走原兼容读取路径。