视频追踪标注

视频任务在同一个工作台里打开，左侧队列、顶部提交、右侧属性与评论仍沿用图片工作台。画布区域会切换为视频播放器，时间轴悬浮在画布底部。

基本操作

1. 打开 video-track 项目的任务。
2. 用悬浮时间轴、← / → 或 , / . 定位到目标帧。
3. 暂停视频，选择左侧工具：B 是当前帧独立矩形框，T 是跨帧轨迹。
4. 在当前帧拖拽绘制 bbox，画完后在类别浮层里选择类别。
5. 如果使用轨迹工具，选中这条轨迹后跳到其它帧继续画框、拖动框体或调整框体大小，系统会把它保存为同一条轨迹的关键帧。若当前帧还没有框，画布会显示最近关键帧的虚线参考框，也可以点击「复制到当前帧」先生成当前帧关键帧再微调。
6. 如果目标在当前帧消失或被遮挡，在右侧轨迹面板点击「消失」或「遮挡」。
7. 标完后点击「提交质检」。

播放与逐帧

操作	说明
Space	播放 / 暂停
J / K / L	反向播放或减速 / 暂停 / 正向播放或加速
← / →	后退 / 前进 1 帧
, / .	后退 / 前进 1 帧
Shift + ← / Shift + →	后退 / 前进 10 帧
B / T	切换矩形框 / 轨迹工具
1-9	有选中对象时改该对象类别；无选中时切换默认类别
时间轴拖动	直接跳到指定帧

播放时画布只读，暂停后才能编辑，避免拖框和播放状态互相抢焦点。时间轴会在鼠标进入画布时显示；选中框体时，框体和 resize 控制点会优先响应，拖拽时自动隐藏时间轴。

J/K/L 播放支持 0.25x / 0.5x / 1x / 2x / 4x 档位。反向播放按帧步进，因此不会依赖浏览器不稳定的负速率播放。

矩形框、轨迹与关键帧

v0.9.20 起，视频工作台明确区分两类对象：

工具	数据	说明
矩形框 B	video_bbox	只属于当前 frame_index，其它帧不显示
轨迹 T	video_track	一条对象轨迹，多个关键帧之间会插值

选中当前帧的矩形框或轨迹框后，画布会显示 8 个控制点；拖动边或角可调整大小。按住 Shift 可锁定纵横比，按住 Alt 可从中心缩放。

轨迹规则：

• 一条轨迹对应一个对象，轨迹列表会显示类别和 track_id。
• 同一对象在不同帧上的框会保存为 keyframes[]，不会展开成每一帧一条 annotation。
• 两个有效关键帧之间会显示线性插值框，插值框用虚线区分。
• 当前帧不在两个有效关键帧之间时，选中轨迹会显示最近关键帧的参考框；拖动参考框、调整参考框大小或点击「复制到当前帧」会在当前帧创建关键帧。
• 如果某段目标消失，给当前帧标记「消失」后，插值不会跨过该帧。
• 「遮挡」用于标记目标仍存在但可见性差，画布会用虚线状态展示。
• 单个关键帧的新增、移动、消失和遮挡标记支持 Ctrl + Z / Ctrl + Shift + Z 撤销重做。
• 在当前帧已有关键帧时，可以点击「复制当前关键帧」，跳到目标帧后点「粘贴到当前帧」复用同一框位置；这不会占用全局 Ctrl + C / Ctrl + V。

轨迹列表支持：

操作	说明
多选	Shift / Cmd / Ctrl + 点击轨迹行，显示批量操作条
批量操作	对已选轨迹批量改类、删除、显隐或锁定
显隐	临时隐藏 / 显示某条轨迹，只影响当前工作台视图
锁定	防止误拖动或误追加关键帧，只影响当前工作台视图
重命名	修改该轨迹的类别名
关键帧列表	查看、删除、复制或拆分某个关键帧
复制 / 拆分	把当前帧、关键帧或整条轨迹转换为独立 video_bbox
删除	选中轨迹后按 Delete 删除整条轨迹

“复制为独立框”会保留原轨迹并新增 video_bbox；“拆为独立框”会从原轨迹中移除对应关键帧，整条拆分会删除原轨迹。选择“全帧”时会把插值后的可见帧展开为独立框，系统会限制一次最多生成 5000 个框。

质量提示

工作台会在画布左下角提示基础质量问题：

• 同一轨迹关键帧间隔过大。
• 当前帧存在极小框。
• 当前帧同类别框高度重叠。

这些提示不会阻止保存，但提交前应尽量处理。

AI 传播（v0.9.40）

在选中一条 video_track 后，工具栏「AI 传播」按钮（快捷键 Shift+T）会弹出对话框，可以选择：

• 方向：向后 / 向前 / 双向。
• 范围：10/30/60 帧、到下一关键帧、到结尾。
• 模型：mock_bbox（测试用，无需 ML backend）、sam2_video、sam3_video（需项目绑定 ML backend）。

发起后，轨迹卡片会显示进度 badge（queued / running / completed / failed / cancelled），运行中可点击 ✕ 取消。job 完成后写回的 prediction 关键帧会自动出现在时间轴和关键帧列表里。

接受 / 拒绝 prediction

关键帧列表中，预测帧带「预测」徽章，旁边的按钮：

• 接受：把该帧的 source 改为 manual，保留几何。
• 拒绝：把该帧并入 outside（来源标记 prediction），表示主观判定 AI 错了。

「下一预测」按钮可以跳到当前轨迹的下一条预测关键帧。

章节（v0.9.40）

长视频可以通过「章节」侧栏（位于轨迹侧栏下方）划分场景：

• 项目负责人 / 超级管理员可以新建、编辑、删除章节。
• 表单支持「使用当前帧」按钮一键填入起止帧。
• 时间轴上方有彩色色带，点击跳到章节起点。
• PageDown / PageUp 在章节之间跳转（如果当前帧在某章节内部，PageUp 先回到该章节起点）。

章节是纯展示语义，不影响 video_segments（协作分片）的 claim/lock。

当前版本边界

视频导出支持 Video Tracks JSON，可选择只导出关键帧或展开逐帧结果；章节信息暂不进 COCO / MOT 导出。

v0.9.16 保存的旧 video_bbox 会继续在对应帧显示；v0.9.20 后也可以通过矩形框工具继续创建新的单帧 video_bbox。

SAM 视频 backend、polygon track、Re-ID 自动 join 仍在后续 Roadmap。