🐛 Keep discarded slices editable and support persisted undo #5

Merged
longtao.wu merged 8 commits from feature/local-dev-toolkit into dev 2026-09-22 00:28:50 +08:00
Collaborator

舍弃一片后,原实现会禁用整个切片编辑器:即使播放头已进入后面的正常片段,C 也无效;舍弃/恢复还会清空编辑历史。本次将舍弃视为可继续编辑的切片状态,恢复连续切分及可持久化的撤销/重做。

  • 切片阶段允许 C 切分舍弃片段,两侧继承舍弃原因;G 可修改原因,鼠标和 Shift+左右可调整共同边界。删除或吞并舍弃片段仍需先恢复,已生成媒体的标注阶段边界仍固定。
  • 舍弃/恢复加入编辑历史,撤销和重做通过服务端接口保存,成功后才推进历史,失败或冲突保留记录。服务端校验切片来源、原因及版本,恢复子片段时按当前范围裁剪归档描述。
  • 任务就绪后将焦点移交工作台,修复刚进入任务时快捷键无效,同时保留输入框、弹层及暂停状态的焦点保护。

验证:

  • TypeScript 检查、前端构建、diff 检查通过;37 项工作台/快捷键测试通过,历史相关测试在前次提交验证通过。
  • Go 定向回归通过,覆盖舍弃继承、连续切分撤销、边界调整、归档恢复、伪造来源/原因拒绝、版本冲突及媒体边界保护。
  • 公司集群 API 和 annotation processor 已部署实现提交 2d380b5b,健康与就绪检查均通过。真实浏览器在独立合成任务验证普通、专注两种布局:舍弃后 C 切后续正常片段及舍弃片段、G 修改原因、微调/撤销、保存/API 回读、撤销后重存、刷新及恢复保留。未修改客户任务或送检。
  • 本次未重跑全量测试,不宣称已有测试基线失败已修复。

报告:舍弃后继续编辑与公司验收、入口快捷键验证、舍弃撤销/重做验证。

舍弃一片后,原实现会禁用整个切片编辑器:即使播放头已进入后面的正常片段,C 也无效;舍弃/恢复还会清空编辑历史。本次将舍弃视为可继续编辑的切片状态,恢复连续切分及可持久化的撤销/重做。 - 切片阶段允许 C 切分舍弃片段,两侧继承舍弃原因;G 可修改原因,鼠标和 Shift+左右可调整共同边界。删除或吞并舍弃片段仍需先恢复,已生成媒体的标注阶段边界仍固定。 - 舍弃/恢复加入编辑历史,撤销和重做通过服务端接口保存,成功后才推进历史,失败或冲突保留记录。服务端校验切片来源、原因及版本,恢复子片段时按当前范围裁剪归档描述。 - 任务就绪后将焦点移交工作台,修复刚进入任务时快捷键无效,同时保留输入框、弹层及暂停状态的焦点保护。 验证: - TypeScript 检查、前端构建、diff 检查通过;37 项工作台/快捷键测试通过,历史相关测试在前次提交验证通过。 - Go 定向回归通过,覆盖舍弃继承、连续切分撤销、边界调整、归档恢复、伪造来源/原因拒绝、版本冲突及媒体边界保护。 - 公司集群 API 和 annotation processor 已部署实现提交 2d380b5b,健康与就绪检查均通过。真实浏览器在独立合成任务验证普通、专注两种布局:舍弃后 C 切后续正常片段及舍弃片段、G 修改原因、微调/撤销、保存/API 回读、撤销后重存、刷新及恢复保留。未修改客户任务或送检。 - 本次未重跑全量测试,不宣称已有测试基线失败已修复。 报告:[舍弃后继续编辑与公司验收](https://gitea.d-robotics.cc/longtao.wu/droboticflow/src/branch/feature/local-dev-toolkit/docs/verification/discard-editing-deployment-20260921.md)、[入口快捷键验证](https://gitea.d-robotics.cc/longtao.wu/droboticflow/src/branch/feature/local-dev-toolkit/docs/verification/shortcut-entry-deployment-20260921.md)、[舍弃撤销/重做验证](https://gitea.d-robotics.cc/longtao.wu/droboticflow/src/branch/feature/local-dev-toolkit/docs/verification/disposition-undo-deployment-20260921.md)。
zhanghongming added 3 commits 2026-09-21 22:47:31 +08:00
zhanghongming added 5 commits 2026-09-21 23:58:25 +08:00
zhanghongming changed title from 🐛 Support persisted undo and redo for slice disposition to 🐛 Keep discarded slices editable and support persisted undo 2026-09-21 23:59:08 +08:00
Owner

审查结论:建议暂缓合并,先修复下面两项问题。

审查基准:head ae02428e806dfe0bad8f695e762b41589383eec1,base af0b8fb7e957817075b0e89f204ce941b44770fb。当前 PR 为 open、merged=false;mergeable=true 仅代表没有 Git 合并冲突。已核对合成合并树与本次 head 内容一致。

Standards

[P2] 已持久化的切片操作撤销仅修改页面,刷新后撤销结果消失。
位置:AnnotationOperations.tsx L2468–2475。本次保留了舍弃操作前的切片历史,但舍弃接口会把整个当前分区保存到服务端。执行“切分 → 舍弃其中一片 → 撤销舍弃 → 撤销切分”时,第二次撤销走 slice snapshot 分支,只 setState 后返回 true,没有版本保护的服务端保存,历史却已推进。刷新后仍得到切分后的分区。
违反 ADR-0001 中“已保存内容通过受当前版本与归属校验保护的写入恢复”“服务端写入成功后才宣告撤销成功”的约定。建议区分未保存草稿与已保存快照,后者确认服务端写入成功后才推进历史。已从真实 restoreEdit 函数提取执行,配合原 createAnnotationHistory 与替身持久层复现:local=[original]、persisted=[left,right]、只有撤销舍弃产生一次写入;此项不是浏览器端到端实测。

Spec

[P1] 缩短舍弃片段后恢复、再撤销,会丢失原始归档描述的一部分。
位置:slice_disposition.go L161–174,以及恢复时 L321 清空 DiscardedAnnotations。
复现:片段 b=[3,7] 有 old text → 舍弃 → 边界缩至 [3,5] 并恢复 → 撤销恢复(再次舍弃)→ 撤销边界调整至 [3,7] 后再恢复。恢复第一次裁切为 [3,5] 并清空归档,再次舍弃只能归档裁切后的描述;最后原 [5,7] 描述无法恢复。
在 PR 独立源码副本新增临时 HTTP handler 回归,四次请求均返回 200,但最终断言失败:期望 old text=[3,7],实际=[3,5]。这与 docs/discard-reason-dictionary.md 中“原始归档描述继续保留”及边界撤销要求不符。建议保留可追溯的完整原始归档,或通过受校验的历史恢复原始证据,并补上上述组合回归。

验证范围

  • 原有 47 项前端定向测试、TypeScript 检查、前端生产构建、diff 检查均通过。
  • Go 定向回归 TestDiscardedSlice / TestDiscardInheritance / TestDispositionHistory / TestSliceDisposition / TestDiscardReason 通过。
  • 新增临时复现 TestPR5ReviewArchiveBoundaryUndo 失败,确认上述归档丢失问题。
  • 未重跑全量测试、未在公司环境修改任务或重做浏览器验收;未合并、推送或部署。

规范轴 1 项(P2);需求轴 1 项(P1)。建议修复后补充“混合编辑历史 + 刷新回读”和“缩短/恢复/撤销/扩大后描述完整性”回归,再考虑合并。

审查结论:建议暂缓合并,先修复下面两项问题。 审查基准:head `ae02428e806dfe0bad8f695e762b41589383eec1`,base `af0b8fb7e957817075b0e89f204ce941b44770fb`。当前 PR 为 open、merged=false;mergeable=true 仅代表没有 Git 合并冲突。已核对合成合并树与本次 head 内容一致。 ## Standards **[P2] 已持久化的切片操作撤销仅修改页面,刷新后撤销结果消失。** 位置:[AnnotationOperations.tsx L2468–2475](https://gitea.d-robotics.cc/longtao.wu/droboticflow/src/commit/ae02428e806dfe0bad8f695e762b41589383eec1/src/pages/AnnotationOperations.tsx#L2468)。本次保留了舍弃操作前的切片历史,但舍弃接口会把整个当前分区保存到服务端。执行“切分 → 舍弃其中一片 → 撤销舍弃 → 撤销切分”时,第二次撤销走 slice snapshot 分支,只 setState 后返回 true,没有版本保护的服务端保存,历史却已推进。刷新后仍得到切分后的分区。 违反 ADR-0001 中“已保存内容通过受当前版本与归属校验保护的写入恢复”“服务端写入成功后才宣告撤销成功”的约定。建议区分未保存草稿与已保存快照,后者确认服务端写入成功后才推进历史。已从真实 restoreEdit 函数提取执行,配合原 createAnnotationHistory 与替身持久层复现:local=[original]、persisted=[left,right]、只有撤销舍弃产生一次写入;此项不是浏览器端到端实测。 ## Spec **[P1] 缩短舍弃片段后恢复、再撤销,会丢失原始归档描述的一部分。** 位置:[slice_disposition.go L161–174](https://gitea.d-robotics.cc/longtao.wu/droboticflow/src/commit/ae02428e806dfe0bad8f695e762b41589383eec1/internal/api/slice_disposition.go#L161),以及恢复时 L321 清空 DiscardedAnnotations。 复现:片段 b=[3,7] 有 old text → 舍弃 → 边界缩至 [3,5] 并恢复 → 撤销恢复(再次舍弃)→ 撤销边界调整至 [3,7] 后再恢复。恢复第一次裁切为 [3,5] 并清空归档,再次舍弃只能归档裁切后的描述;最后原 [5,7] 描述无法恢复。 在 PR 独立源码副本新增临时 HTTP handler 回归,四次请求均返回 200,但最终断言失败:期望 old text=[3,7],实际=[3,5]。这与 docs/discard-reason-dictionary.md 中“原始归档描述继续保留”及边界撤销要求不符。建议保留可追溯的完整原始归档,或通过受校验的历史恢复原始证据,并补上上述组合回归。 ## 验证范围 - 原有 47 项前端定向测试、TypeScript 检查、前端生产构建、diff 检查均通过。 - Go 定向回归 TestDiscardedSlice / TestDiscardInheritance / TestDispositionHistory / TestSliceDisposition / TestDiscardReason 通过。 - 新增临时复现 TestPR5ReviewArchiveBoundaryUndo 失败,确认上述归档丢失问题。 - 未重跑全量测试、未在公司环境修改任务或重做浏览器验收;未合并、推送或部署。 规范轴 1 项(P2);需求轴 1 项(P1)。建议修复后补充“混合编辑历史 + 刷新回读”和“缩短/恢复/撤销/扩大后描述完整性”回归,再考虑合并。
Owner

补充处理安排:我们先 merge 当前 PR,我拉取合并后的代码,再修复上面审查指出的两个问题:

  1. 缩短舍弃片段后恢复、撤销导致部分归档描述丢失。
  2. 混合编辑历史中的切片撤销未持久化,刷新后恢复旧分区。

这两项问题继续保留跟踪,后续补齐对应回归测试;本次调整为合并后由我接手修复,不要求在当前 PR 中先修完。

补充处理安排:我们先 merge 当前 PR,我拉取合并后的代码,再修复上面审查指出的两个问题: 1. 缩短舍弃片段后恢复、撤销导致部分归档描述丢失。 2. 混合编辑历史中的切片撤销未持久化,刷新后恢复旧分区。 这两项问题继续保留跟踪,后续补齐对应回归测试;本次调整为合并后由我接手修复,不要求在当前 PR 中先修完。
longtao.wu merged commit 94a98efc03 into dev 2026-09-22 00:28:50 +08:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: longtao.wu/droboticflow#5
No description provided.