droboticflow/docs/verification/annotation-navigation-20260918.md

6.3 KiB
Raw Permalink Blame History

标注时间轴与动作导航调整(2026-09-18)

用户要求与实现

专注模式与原布局共用工作台,统一完成以下修改:

  • 移除切片/标注页的“原始数据人工版”提示,不改变视频处理配置。
  • 移除两条时间轴的分页、查找和“当前”导航栏。切片轴始终使用完整 Capture 范围,动作轴始终使用当前切片范围,滑块、色块和蓝色播放线使用同一时间比例;消除动作滑块单独缩短 400px 的样式。统一 16px 滑块圆心、蓝线、区间色块和鼠标定位的坐标,拖动边界也使用同一换算。
  • 专注模式中的切片色块由 20px 加高至 48px,动作色块加高至 42px;原布局切片、动作色块均为 64px。短动作的时间文字不再换行挤出边框,超长文字截断;完整内容仍可通过编辑区及悬浮详情查看。保留边界拖动手柄。
  • ↑/↓:按时间顺序切换当前切片内的上一个/下一个动作,暂停并定位到目标动作结束时间;到首尾不循环,不跨切片。无选中动作时,从播放头附近开始。
  • Ctrl/⌘ + ↑/↓:暂停并定位到当前动作的开始/结束时间。文本输入、中文输入法、字典弹层保留自身按键行为;按住按键不会连续触发切换。
  • 未保存动作编辑先保存或取消后再切换;确定结束点时不允许导航悄悄改变正在编辑的边界。导航不会自动保存或提交任务,键盘切换不会把视频滚出视野。
  • 快捷键帮助按切片/逐片标注分别展示分割、删除、字典与阶段提交含义,标注阶段增加动作导航说明。

验证与发布边界

用户明确要求跳过本地测试,提交后直接部署公司集群验证。本次执行静态类型检查和构建,不运行本地测试套件或本地浏览器工作台。为后续 CI 补充快捷键、动作邻接选择的回归用例;未运行的用例不记为通过。

仅部署 droboticflow-fanyu 的 API 前端镜像,以已发布的心跳修复镜像为基础,保持后端二进制不变;保留回退镜像和配置版本信息。代码提交在个人功能分支本地保存,本次未获 Git push 请求。

线上验证覆盖真实已存在任务、两种布局、不同窗口尺寸、键盘导航、文本/字典隔离、布局和视频加载,不保存或提交测试业务数据。

发布记录

  • 最终功能代码:64118cad183d6bb4eb89c1ac8b78ff01e95eaab6。此前两次任务内提交为 0ab57b67(布局及快捷键)和 3cf94299(滑块圆心对齐)。
  • 目标:http://120.48.180.80,命名空间 droboticflow-fanyu,仅更新 deployment/droboticflow-api。
  • 最终镜像:ccr-29eug8s3-vpc.cnc.bj.baidubce.com/fanyu/droboticflow-api@sha256:e95f9613156c6448b92edeee5c1392cbe52497e785ee632a95e30ef860b454bc。
  • 上线完成,API 1 个副本就绪,检查时重启次数为 0。公开就绪接口返回本次提交及镜像,61 个前端文件的 SHA-256 与提交后构建产物逐一一致。
  • API 后端二进制 SHA-256 为 7d823fc765b334f980a2701d7b903e3dd5ed1fc445fb52e879cd86a24b527876,与此前心跳修复版本一致;切片处理器镜像未变。本次未重启 worker 或切片处理器。
  • 静态类型检查 npm run lint:web、干净源码构建通过。按用户要求未运行本地测试套件,也未启动本地浏览器验收。新增的回归用例留待后续 CI 执行。

本地证据目录:local-data/verification/annotation-navigation-final-20260918/,包含镜像记录、资源校验、后端校验、线上浏览器结果、局部时间轴截图和回滚配置,均不随 Git 提交。

公司环境验收结果

使用现有已领取任务在公司网站实际操作,浏览器脚本退出码为 0:

检查项 结果
专注模式尺寸 1280×640、1440×900、1920×1080、2560×1440 均通过;页面无需整体滚动,两条时间轴均在视口内
原布局尺寸 1280×640、1440×900、1920×1080 均通过;保留原布局原有滚动方式
播放线对齐 7 组布局测量中,蓝线与滑块圆心理论位置误差最大约 0.012px
文字及占用空间 两种布局切片/动作文字均限制在卡片边界内;已查看实际截图;原始数据提示及两行查找/当前导航均不存在
↑ / ↓ 在当前切片的两个真实动作间切换,双视频均暂停并到达所选动作结束点
Ctrl / ⌘ + ↑ / ↓ 双视频均暂停并到达当前动作起点/终点
输入与弹层 文本框方向键、中文输入法事件、长按重复事件不会误切换;字典继续响应自己的方向键,一次 Esc 退出
未保存编辑 临时编辑后尝试切换会被阻止并提示先保存或取消;取消后恢复,未发送保存请求
分阶段帮助 两种布局分别验证切片/逐片标注帮助;动作导航仅在标注阶段出现,分割说明与阶段一致
数据与页面错误 标注任务版本保持 11,工作区内容回读前后相同;无保存、提交或领取业务请求,无页面脚本异常;测试后退出登录

浏览器覆盖为 Edge(Chromium)。公司站点仍是 HTTP,独立工作页验收沿用此前获准的、仅限该站点的临时安全来源例外;普通浏览器检查仍为非安全上下文、无 Web Locks,并保留登录要求。本次未修改浏览器默认安全策略或网站的连接模式。

质检布局的空间和未保存评论保护经过代码审查,本轮未执行质检账号的浏览器验收。切片生成、任务提交等后端业务流程未在本轮重复执行,避免改变真实业务任务。

回退与使用

上线前记录了原镜像及公开构建元数据;最终版本的回滚补丁已经服务端 dry-run 验证通过,未实际回滚。完整任务前的基线镜像和中间版本记录也保留在同级验证目录,部署失败时可选择对应记录恢复。本次临时构建 Job、ConfigMap 及校验过的上传包已清理,线上镜像、回退记录与业务数据保留。

刷新公司网页即可加载本次版本。标注时先选中切片,再使用 ↑/↓ 选择动作;若焦点在描述输入框,先按 Esc 回到工作台。未保存内容需要先保存或取消,才可切换动作。Mac 可用 ⌘ 替代 Ctrl 定位动作起止点。