droboticflow/docs/discard-reason-dictionary.md

6.5 KiB
Raw Permalink Blame History

舍弃原因字典

在项目“语义标签”页增加“舍弃原因字典”。与切片、动作描述字典共用同一组件,直接添加、编辑、删除;只显示当前项目词条,无启用/停用开关。三个字典分别按名称防重,修改当前项目不改变其他项目及历史审核。

项目已配置字典时,舍弃片段必须单选项目已有的原因。补充说明默认选填;“其他”以及历史上已有说明要求的词条要求说明,最多 1000 字。项目未配置字典时允许手填非空原因,最多 1000 字;字典读取失败或已配置但没有有效词条时仍禁止绕过校验,不自动生成示例词条。恢复为保留不依赖字典可用性。

接口:

  • GET /api/annotation-labels?kind=discard_reason:管理员组织字典。
  • POST /api/annotation-labels、PATCH /api/annotation-labels/{id}:复用词条管理,新增 requiresNote。
  • GET/PUT /api/projects/{id}/discard-reason-labels:项目词条/项目引用列表,PUT 使用 labelIds,GET 返回 allowManual 表示是否允许手填。
  • POST /api/plugins/annotation-qa/tasks/{id}/slice-dispositions:新增 reasonLabelId、reasonVersion、reasonNote;仅项目未配置字典时接受 reason 手填原因;有配置时不可用自由文本替代选词。

后端校验组织、项目引用、词条类型、有效状态和版本;耗时的帧校验完成后再次检查词条。记录的 discardReasonLabelId、discardReasonVersion、discardReasonName、discardReasonNote 均由服务端确认。兼容字符串 discardReason 为名称与说明的可读组合。

已有自由文本原样保留,无词条 ID 的原因显示“手动填写”。普通保存不能篡改原因快照;字典改名/停用不追写历史。舍弃/恢复记录保留前后快照。新生成和复用媒体的审核 JSON 均保留词条快照。舍弃仍保留完整审核媒体,不改变切片边界,也不进入最终交付。

已舍弃片段免除切片名称字典校验,包括默认名称。舍弃/恢复属于逐片编辑操作,不校验整组切片名称,因此其他尚未命名的保留片段不会阻止当前操作;舍弃原因、边界、归属、版本和审核证据仍正常校验。最终确认整组切片时,保留片段(包括恢复后的片段)必须符合命名字典规则,已舍弃片段免检;历史名称沿用已有兼容规则。

验证入口:

  • Go TestDiscardReason*:字典隔离、独立项目配置、旧版本/停用/跨组织校验、快照、历史名称与恢复。
  • Go TestSliceDiscardMaterialization60Seconds + Python tests/backend/test_slice_discard_package.py:真实双目、PTS、IMU审核文件;包含复用媒体时的原因快照和交付过滤。
  • node tests/browser/discard-reason-dictionary.mjs:真实组件、隔离接口,Chrome验证项目词条、必选/必填、返回修正和请求内容。
  • TestDiscardReasonDictionaryLiveFixture:显式开启的独立组织验收;只引用既有合成视频,不启动接入监听、不改客户账号,验收后停用测试账号。

线上媒体验收需要遵循 Fanyu 工作区连接的组织范围:字典管理使用独立组织;媒体舍弃使用工作区所属组织中的独立项目、专用供应商和受限标注/审核账号,不新增客户组织管理员。只引用已有合成媒体。测试词条带唯一验收后缀,结束时连同验收账号停用。

工作台通过 G 打开右侧舍弃面板,Esc 返回,Ctrl/⌘+Enter 确认;切换切片时关闭旧目标面板,不会将其原因误用于另一片。

舍弃和恢复均进入当前任务、当前编辑阶段的撤销历史,不清空此前操作。Ctrl/⌘+Z 撤销、Ctrl/⌘+Shift+Z 重做时调用显式舍弃/恢复接口,服务端成功后才推进历史;失败或版本冲突保留历史并提示核对。恢复保留原描述,重做保留原因快照参数并重新校验词条有效性;词条已更新或停用时不能绕过校验。沿用每秒一次、最多 100 步及刷新/跨任务/阶段切换清空历史的规则。

2026-09-21 交互修正:切片阶段将舍弃视为一种可编辑的切片状态。舍弃后播放、导航、C、F、G 和撤销继续生效;C 按播放头所在片段切分,不因选中片段已舍弃而禁用其他片段。舍弃片段切分出的两侧继承已保存的原因、字典版本和审核证据;G 可重新选择原因。鼠标拖动及 Shift+左右可调整共同边界,双方至少保留一帧。涉及舍弃片段的删除或吞并仍需先恢复,不在此次确认的切分和边界调整范围内。

后端从同一任务已保存的切片解析继承关系,覆盖客户端提交的审计字段;不会凭空接受新舍弃原因。支持连续多次未保存切分及其撤销、重新保存。原始归档描述继续保留;恢复子片段时只激活其当前时间范围内的内容,裁切后的描述使用不同 ID,避免跨越相邻子片段或 ID 冲突。已生成媒体的标注阶段仍固定切片边界。

回归入口补充:TestDiscardedSlice*、TestDiscardInheritance* 与 tests/browser/discarded-slice-editing.mjs。浏览器通过真实保存接口验证舍弃后继续编辑及刷新回读,仅允许显式指定隔离验收项目。

2026-09-22 撤销修正:舍弃操作保存整组分区时,将此前切片编辑标记为已持久化;撤销和重做这些编辑通过 POST /api/plugins/annotation-qa/tasks/{id}/slice-edit-restorations 保存权威工作区,成功后才推进历史。未保存编辑继续在当前页面撤销。接口仅允许当前领取人在可编辑切片阶段操作,校验版本、完整覆盖和帧边界,不触发切片生成;历史审计字段由服务端当前证据覆盖,舍弃判断仍只能通过显式舍弃/恢复接口变更。

恢复舍弃片段时,完整原始归档与本次实际恢复的描述由服务端分别保存;再次舍弃时,未改动的恢复结果可以恢复完整归档,实际编辑或删除则覆盖已暴露的范围,避免旧描述复活。切片合回父片段时采用子片段当前证据;恢复证据受阶段和媒体版本限制。该修正预防新的归档丢失,不自动重建此前已经丢失的历史内容。

补充回归:TestPR5ReviewArchiveBoundaryUndo、TestArchive*、TestSliceEditRestoration* 和 tests/frontend/annotation-history.test.mjs。本地隔离内存 API 与浏览器已验证切分→舍弃→连续撤销→重做→再次撤销→刷新,页面与 API 分区一致;这不替代公司环境验收。