From c1950b0ed9bc4e76c29000b101ff8874bf3cd704 Mon Sep 17 00:00:00 2001 From: d-robotics Date: Tue, 22 Sep 2026 13:01:51 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Record=20revised=20annotation=20?= =?UTF-8?q?workflow=20decisions=20and=20open=20questions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../followup-usability-20260922.md | 58 +++++++++++++++++++ .scratch/annotation-contiguous-actions/map.md | 2 + CONTEXT.md | 10 ++-- docs/adr/0002-contiguous-action-coverage.md | 2 + 4 files changed, 68 insertions(+), 4 deletions(-) create mode 100644 .scratch/annotation-contiguous-actions/followup-usability-20260922.md diff --git a/.scratch/annotation-contiguous-actions/followup-usability-20260922.md b/.scratch/annotation-contiguous-actions/followup-usability-20260922.md new file mode 100644 index 00000000..5caabb3d --- /dev/null +++ b/.scratch/annotation-contiguous-actions/followup-usability-20260922.md @@ -0,0 +1,58 @@ +# 追加讨论:重切、互斥切片类型、留空送检与取消切分 + +Type: grilling +Status: in-discussion +日期:2026-09-22 + +本轮接续已实施的连续动作工作台及 9 月 21 日修复。用户文字和裁决优先于历史规格;截图仅作为问题证据。当前只核对事实和更新需求记录,不修改产品、不部署、不修改公司任务。 + +## 版本事实 + +- 本地基线 `ae02428e`,工作树调查前干净。 +- 公司 `/api/health` 返回 `6bc3127228670c680e501ea6f33128a536085708`。只读 fetch 后,`origin/dev=94a98efc` 已合入 PR #5;公司版本另包含同事 `d84b83c9` 的舍弃证据和持久化撤销修复,以及 `6bc31272` 部署配置调整。 +- 本轮没有合并远端代码。后续实施须先保留同事已部署的证据及撤销修复,不能以本地旧实现覆盖。 +- 同事 `d84b83c9` 增加服务端切片编辑恢复接口与已持久化历史标记;保存后撤销经版本校验、结果核对才移动历史。它还保护舍弃操作人、原因和归档来源,并正确处理恢复后修改文字再舍弃的证据。新跨类型取消切分应扩展这些保证,不能简单去掉校验或复活旧归档文字。 +- 线上与本地的工作台组件、重切处理函数、名称校验及连续动作门禁相同;以下代码事实不是只根据旧部署推测。 + +## 用户明确要求 + +1. 排查并修复标注阶段“重新切片”无效。 +2. 舍弃作为独立切片类型,只用舍弃原因定义,不要求或允许同时选择普通切片名称。 +3. 动作无需逐段写描述或判无效;进入标注后即允许全空送检,部分留空也不阻止送检。 +4. 鼠标点击切片/动作时间轴切分后仍能立即使用快捷键,操作不应把使用者困在局部控件焦点中。 +5. Ctrl+X 对明确选中段执行与垃圾桶一致的取消切分;切片和动作条每段右上角提供该入口,舍弃切片、无效动作也可操作。 +6. 延续同一工作台、现有风格及两种布局,不因焦点修复重建组件或移除真实输入框保护。G 仍在切片阶段选舍弃原因、在标注阶段标记当前动作为无效;Ctrl+X 不恢复旧“标无效”含义。 + +## 已核查事实 + +- 名称校验:`src/lib/annotation-workbench.js` 和 `internal/api/slice_dictionary_names.go` 已跳过舍弃段,增量舍弃也不校验其他片名称;但 UI 仍允许舍弃段选择切片字典,服务端仍保留原 `Name`。新互斥要求需同时落到展示和契约。客户本次报错仍需核对请求是否确为 discard、报错是否指另一保留段,不能断言“未实现跳过”。 +- 重切:前端始终发送 `resetToUnifiedRange:true`;`internal/api/annotation_operations.go` 遇任一舍弃段返回 409。失败提示只在父页工作说明中,确认弹窗内没有错误反馈。现在成功重置会恢复为一整段、清空动作,现有弹窗却未充分说明会清空切片划分。请求发出前即清撤销历史,失败也丢历史。 +- 焦点:时间轴选中名称是只读 input,却被快捷键解析视为正在输入;两种鼠标“+”切分都会移除刚点击按钮且没有显式还回工作台焦点。前者有直接代码证据,后者实际落点仍待浏览器复现。修复目标是操作完成后的键盘可用性,不是取消 React 组件层级。 +- 门禁:完整判断分别在前端、提交接口、后台生成校验;最终动作 JSON 另要求非空描述。允许空白不能只放开提交按钮。 +- 现有切片垃圾桶移除当前段,由右邻接管,末段由左邻接管,保留存活邻段身份和名称;只有一段时不操作。目标或邻段为舍弃时前后端均有保护。连续动作当前没有垃圾桶,旧动作删除是删描述留空,与本轮“取消切分”不同。 + +## 设计树 + +1. 留空可送检(明确要求)→ 空白语义及分区保留(Q1)→ 质检与交付数据表示、未保存文字处理。 +2. 舍弃类型互斥(明确要求)→ 普通恢复与撤销时名称处理(Q2)→ 存量名称兼容和校验路径。 +3. 重切缺陷事实 → 保留划分或全量重置(Q3)→ 舍弃证据与动作清空、成功/失败/结果未知反馈。 +4. Ctrl+X/垃圾桶取消切分(明确要求)→ 邻段接管判断(Q4)→ 混合类型证据、未保存编辑、持久化撤销。 +5. 焦点缺陷 → 两条时间轴鼠标入口与工作台快捷键复现 → 真实输入、字典、IME 和原生剪切隔离。 + +## 裁决 + +- **Q1 已确认**:保留当前动作分区和空白供质检查看;不自动判无效、不补默认描述,空白不再拦送检。保存失败、处理中、非法边界等实际错误仍按既有保护处理。 +- **Q2 已确认**:舍弃后只显示及校验舍弃原因,不再携带有效切片名称;原名称仅保留为可撤销信息。点击恢复片段回到待命名状态,普通切片提交前重新选字典;Ctrl+Z 完整恢复舍弃前名称。 +- **Q3 已确认**:重切弹窗增加选择,默认全部重置,另可保留外层切片。用户补充确认“保留”只保留外层划分、普通名称与舍弃原因,清空片内动作;不要求保留或重新映射跨界动作。两种方式均清空片内动作,全部重置另清外层划分及判断、回到统一范围一段。确认文案须明确区别,成功才清本阶段历史,失败不丢内容;原始视频及历史审计不物理删除。 +- **Q4 已确认(未采用推荐的继承方案)**:取消切分后清空合并结果的判断,重新命名或标注。仍按现有右邻优先、末段左邻的范围合并方向;普通与舍弃混合后回到待定义普通切片,动作合并后回到语义留空,不继承两边的名称、舍弃原因、描述或无效状态。一次撤销恢复合并前完整两段。只有一段时不可取消。动作留空仍按 Q1 允许送检,普通切片提交仍需命名。 +- **Q5 待答**:推荐质检保留完整分区和空白,保留视频照常交付,交付动作 JSON 只输出有描述或明确无效的记录,整片空白则动作列表为空;备选交付 JSON 也显式包含空白记录。 +- **Q6 待答**:Shift 微调缩零/吞并也会合并,旧规则为继承存活段判断。推荐所有合并都清空判断以与 Q4 一致;备选仅垃圾桶/Ctrl+X 清空而 Shift 保留。普通未合并的边界微调仍保留原判断。 + +## 延续的操作边界 + +- Ctrl+X 在切片阶段针对明确选中的切片,在标注阶段针对明确选中的动作;不因播放头经过另一段而换目标。字典或真实文字输入、中文输入法仍隔离工作台快捷键,输入框 Ctrl+X 是原生剪切。 +- 切片阶段的切片条、标注阶段的动作条都要显示取消切分入口,包括舍弃/无效状态;标注阶段外层切片边界依旧固定,调整需显式重切。 +- 沿用当前未保存文字保护:除已单独确认的 G 直接改判外,切换或结构调整不能悄悄丢弃尚未确认的文字。空白提交不等于自动把半写草稿当作已保存描述。 +- 失败、版本冲突、结果未知要可见且保留原状态;保存后的取消切分撤销必须经服务端合法快照、归属与版本校验。普通编辑仍受任务、阶段边界约束。 + +本轮明确替代旧完整语义门禁、禁用 Ctrl+X、取消动作垃圾桶及舍弃不得参与取消切分的规则。其他既有约定继续适用;未回答问题不视为已采用推荐,未展开的分支仍待后续裁决。 diff --git a/.scratch/annotation-contiguous-actions/map.md b/.scratch/annotation-contiguous-actions/map.md index 361b9c1c..5085a28b 100644 --- a/.scratch/annotation-contiguous-actions/map.md +++ b/.scratch/annotation-contiguous-actions/map.md @@ -1,5 +1,7 @@ # 连续动作标注与摄像机工作视图:设计讨论 +2026-09-22 新增[重切、互斥切片类型、留空送检与取消切分讨论](./followup-usability-20260922.md)。新裁决替代冲突的旧门禁与快捷键规则,尚未实施;以下保留原设计与实施历史。 + Type: grilling 日期:2026-09-18,2026-09-21 更新。状态:原业务与快捷键选择作为基线;九项追加需求已完成 Q16–Q32 的逐项裁决,合并规则见[追加讨论](./supplement-20260921.md)。已发布[正式规格](./spec.md),状态为 `ready-for-agent`。保留现有页面风格,以局部排版调整承载新能力;此前独立布局示意仍撤回。以上为实施前讨论基线;2026-09-21 已完成本轮实现与公司部署,最终状态见下方“实施与验收”及执行报告。 diff --git a/CONTEXT.md b/CONTEXT.md index f350cb17..2760ae84 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -20,27 +20,29 @@ _Avoid_:历史操作日志(本列表不展示修改前的旧版本) ## 留空与交付 -**待标注区间**:尚未确认动作描述或明确无效判断的动作区间,是未完成的标注工作。 +**待标注区间**:尚未填写动作描述或明确无效判断的动作区间。它表示语义留空,不等于无效判断,也不表示任务一定不能送检。 **语义留空**:切片内尚未填写动作描述、也未明确标为无效的时间范围,可以覆盖部分或全部切片。留空不自动代表无效或舍弃。 **无效区间(无效动作)**:标注员明确判断为无效、仍作为动作标注结果保留的区间。无效标记本身不删除动作记录或对应视频,也不等于从交付范围中舍弃切片。 -**舍弃切片**:标注员明确选择不交付、并记录原因的切片。切片及其证据仍参与审核,舍弃本身不移动相邻边界。 +**舍弃切片**:标注员明确选择不交付、以舍弃原因定义的切片类型,与使用切片名称定义的普通切片互斥。切片及其证据仍参与审核,舍弃本身不移动相邻边界。 ## 操作含义 **删除切片**:移除一个切片划分并将其范围并入相邻切片,保持源采集的处理覆盖。 +**取消切分**:撤去当前切片或动作区间的一个划分,将其范围并入相邻区间,合并结果回到未定义状态;不是删除这段视频。它与撤销最近一次操作不同,可以针对明确选中的已有区间。 + **删除动作描述**:移除一条语义描述并保留原时间范围的空白,不合并相邻动作,也不删除视频。 **动作改判**:将动作区间的原描述或无效判断更正为另一项语义判断,不等于删除该区间或对应视频。 -**动作区间合并**:调整两个相邻动作区间的共同边界,使其中一段归入另一段;存活区间覆盖合并后的范围并保留原描述、待标注或无效判断,被合并区间不再单独存在,视频不因此删除。 +**动作区间合并**:将两个相邻动作区间合为覆盖两者范围的一个区间,被合并区间不再单独存在,视频不因此删除。 **保存进度**:保留当前动作划分和完成状态,允许仍有待标注区间;不代表标注已经完成或已经送检。 -**切片字典**:项目启用的切片名称集合;新确认的切片名称从中选择,多个切片可以同名。 +**切片字典**:项目启用的普通切片名称集合;普通切片从中选择名称,多个切片可以同名。舍弃切片以舍弃原因定义,不同时选择此字典。 **描述字典**:用于填写动作描述草稿的模板集合;选择后允许编辑描述文本。 diff --git a/docs/adr/0002-contiguous-action-coverage.md b/docs/adr/0002-contiguous-action-coverage.md index 40b1bffc..57859d5e 100644 --- a/docs/adr/0002-contiguous-action-coverage.md +++ b/docs/adr/0002-contiguous-action-coverage.md @@ -4,6 +4,8 @@ status: accepted # 泛宇连续动作标注以完整语义覆盖作为送检条件 +> 2026-09-22 裁决更新:用户明确取消本 ADR 中“每段必须描述或标无效才能送检”的门禁,允许部分或全部语义留空送检,保留当前分区和空白供质检查看,不自动判无效。连续分区与语义判断是不同概念;保存失败、非法边界等校验仍保留。以下正文保留历史决策来源;本轮取消切分、重切与交付表示的细节仍在[追加讨论](../../.scratch/annotation-contiguous-actions/followup-usability-20260922.md)中确认,文档裁决不代表代码已实施。 + 此前允许切片内部分或全部语义留空后送检,无法区分标注员有意跳过的内容与尚未完成的工作。按客户本轮要求,当前泛宇人工切片/标注流程下全部项目采用连续动作区间:需要标注的切片由首尾相接、互不重叠的区间完整覆盖,每段必须明确填写动作描述或标为无效后才能送检;待标注与明确无效保持不同,舍弃切片继续遵守原有原因及证据规则。 这一变更适用于新任务和仍在编辑的任务,保留已有描述及边界,仅将语义空白呈现为待标注区间;已送检、已验收的数据不追溯改写,退回重做后再按新规则提交。该边界接受编辑中任务补齐语义的成本,同时避免以新规则改写既有审核与交付事实;其他客户或其他工作流保持原规则。