droboticflow/docs/annotation-workspace-layout.md

74 lines
9.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 标注工作页操作说明
选择项目后,个人任务池旁的总开关选择工作模式:点亮“连续工作 · 自动接取”才自动接取,熄灭“手动接取”时只有点击“随机领取任务”才接取新任务。首次默认手动;按账号在当前浏览器保存,切换项目、进入专注视图或重新打开都沿用选择。点击已有任务只恢复它,不会开启连续工作。领取前不能挑选视频。
## 连接方式与手动模式
独立工作页和连续领取需要支持 Web Locks 的安全连接,例如 HTTPS;浏览器也将本机 localhost 视为安全上下文。普通 HTTP 连接下会显示“当前连接使用手动模式;独立工作页和连续领取需安全连接”。此时在原工作台点击“随机领取任务”,从“我的任务”继续切片、标注、保存和送检;送检后手动领取下一条。
手动模式保留服务端任务归属、版本检查和领取请求重试,但不提供多页面互斥。不要同时在多个页面编辑同一任务。直接打开 HTTP 工作页时,点击“返回手动工作台”会保留原项目和任务,不会释放或重新领取。领取结果未知时再次点击“随机领取任务”,沿用原请求编号核对结果。
浏览器支持页面锁、但锁被另一页占用或协调出错时,不会降级绕过锁;按提示返回活动页或刷新重试。
## 进入、停止与退出
首次进入默认使用专注视图:平台导航收起,左侧是同步双视频、播放控制和时间轴,右侧是当前切片或动作描述编辑区。页面顶部始终保留“切回原布局”和“返回任务池”。
点亮总开关后,连续工作可在后台处理期间接续其他任务,实际送检后补足容量。熄灭立即进入手动模式,停止后续补领和自动切换;当前任务、草稿和已受理后台任务保留。任务池为空、网络结果不确定或权限变化时关闭并记住手动状态,须明确点亮才恢复。视口临时暂停不改变选择。已有返工任务优先恢复,自动补领不会重复请求同一任务。
“返回任务池”会执行原有离开保护。若有未保存草稿,选择继续编辑可返回当前工作;确认离开会丢弃页面中未保存的编辑。刷新、关闭标签页或重新打开后,须显式点击已有任务或“继续工作”,沿用保存的工作模式并恢复服务端已经保存的内容,不能恢复浏览器草稿与撤销历史。
安全连接下,同一浏览器的同源标签页中,同一账号、同一项目只能有一个活动工作页。第二个标签页提示已有活动页时,返回原页继续;原页退出或关闭后再恢复。不要通过反复开页重复领取。
## 切片:确认名称后生成
1. 观看两路视频,用播放、逐帧按钮或快捷键定位。按 `C` 或“在播放头分割切片”新增边界;切分点须位于片内,不能落在现有边界。
2. 从项目切片字典选择名称。`F` / `D` 可打开字典,搜索、分页后用鼠标或方向键选择,`Enter` 填入,按一次 `Esc` 返回工作台。选择名称仅修改当前编辑,未确认前不会保存。
3. 检查边界与名称,点击“确认全部切片”,再点击“确认生成”。系统处理完成后才进入描述阶段;收到处理中提示不代表已经生成完成。
切片保持源视频有效帧范围的完整覆盖。删除切片会把范围并入相邻切片。需要舍弃时使用“舍弃片段”并填写原因;舍弃保留审核证据,不等于删除视频,也不移动相邻边界。
## 描述:先保存,再送检
点击“新增动作描述”或按 `N` 标记起点;播放或逐帧定位后再按 `N` / `Enter` 确认结束点。进入文本框后填写描述,也可以从描述字典填入模板再修改。模板只是草稿,不会自动保存。
“确认保存描述”或 `Ctrl / ⌘ + Enter` 保存当前描述。“取消编辑”放弃当前未保存修改。切换切片可以保留各片草稿,但送检前必须处理所有未保存草稿。保存失败时先按提示核对版本、权限或网络,不要把仍显示的草稿当成已保存。
完成后点击“完成任务并提交质检”,检查切片、描述、留空和舍弃汇总,再点击“确认送检”。审核数据准备完成、任务进入待质检后才算送检成功。**送检成功不等于质检通过**;连续工作也不需要等质检员作出通过结论。
语义留空是合法的未描述范围,仍参与审核和媒体交付;“无效区间”是明确的语义判断;“舍弃切片”是不交付该切片并保留证据。这三种处理不能混用。删除动作描述会留下空白,不删除视频或合并相邻动作。
## 长列表、字典和长文本
专注视图中的切片和描述时间轴每页最多显示 4 条。使用前后页、查找或“当前”定位;输入文字查找下一匹配项,输入 `#13` 可直接定位第 13 条。查找不会筛除数据。`Ctrl / ⌘ + 左右方向键` 仍按全部切片的时间顺序导航;撤销、重做与草稿恢复会显示目标所在页。
字典在右侧固定编辑区内打开,不挤压视频。每页条目数根据编辑区剩余高度自动调整,分页按钮、页码和总条目数固定在搜索框下方。词条以单行显示,鼠标悬停可查看完整文本;返回编辑后可查看完整填入内容。字典内按 ← / → 翻页、↑ / ↓ 选择、Enter 填入、Esc 返回。有搜索文字时,← / → 保留移动光标功能,先按 ↓ 进入词条再翻页。文本输入、字典导航和中文组合输入拥有自己的按键,不应触发工作台操作。
长描述可以在文本框内滚动。“展开描述编辑”暂时收起精确边界区域,让出更多文字空间;“收起描述编辑”恢复边界。保存与取消始终在文本滚动区外。展开、收起、翻页和切换布局都不会自动保存。
## 放大画面与快捷键
默认完整、等比显示两路同步画面,不裁剪。点击“放大左相机”或“放大右相机”临时检查细节,详细时间轴会收成进度条,当前编辑、逐帧和保存仍可操作。点击“恢复双画面”回到详细时间轴,播放帧、草稿和选中项保持不变。
常用快捷键可从“快捷键帮助”查看:`Space` 播放/暂停,左右键逐帧,`B` 复查本片,`V` 返回工作点,`F` / `D` 打开字典。工作台内 `Ctrl / ⌘ + Z` 撤销、`Ctrl / ⌘ + Shift + Z` 重做;输入框内仍使用原生文本撤销。撤销/重做有一秒节流,只覆盖当前任务的当前编辑阶段;生成、送检和换任务会截断历史。
## 小窗口、缩放和原布局
专注视图要求浏览器**内容区至少 1280×640 CSS 像素**。显示器标称分辨率不等于内容区:窗口边框、浏览器工具栏、系统缩放和浏览器缩放都会减少可用空间。
低于底线时,页面暂停播放与自动接续,保留当前任务、播放位置、草稿和历史。放大窗口或降低浏览器缩放后,必须点击“继续当前工作”;仅调整尺寸不会恢复工作,视频仍需手动播放。此前选择的“完成当前任务后停止”仍然有效。
已发出的保存、生成、送检或领取请求可能在暂停期间完成。系统会核对原请求,不能把暂停当作取消,也不会因窗口改变重复领取。提示结果未知时,使用“核对阶段结果”;领取结果未知时手动点击“随机领取任务”;领取核对沿用原请求编号。权限变化或活动页冲突须先处理,恢复窗口不会解除这些限制。
随时可点击“切回原布局”,返回旧版的滚动布局;“进入专注视图”再次收起导航。运行中切换保留任务、阶段、选中项、播放帧、各片草稿、撤销记录及连续工作选择,不会保存或重新领取。布局偏好按当前账号和当前浏览器保存,不会串到其他账号;浏览器禁止本地存储时,当前切换仍可用,但下次未必记住。
## 恢复范围与验收边界
工作中的布局切换是当前页面内的回退。源码恢复则使用本地标签 `codex/annotation-keyboard-baseline-20260918`,指向 `54a35afad95d77b1f23c955f9c4671cae83a664d`;完整备份位于忽略目录 `local-data/backups/annotation-keyboard-baseline-20260918.bundle`。标签指向及 bundle 完整历史已再次核验。恢复前应由维护人员保留当前改动并另建检出进行核对。
本轮 PR 意见修改前的新工作页另有备份:标签 `codex/annotation-workspace-pre-review-20260918` 指向 `7585b43f0c14b29015541fc3a33d914227ce4366`;完整历史包为 `local-data/backups/annotation-workspace-pre-review-20260918.bundle`,不覆盖上述旧版快捷键备份。
Git 标签和 bundle 只恢复代码,不能恢复数据库、下载的视频、浏览器未保存草稿或撤销记录。这些数据须分别备份与恢复。本次没有执行代码回退、数据库回滚、远端推送或公司环境部署。
本地验收包括真实 590×480 双视频、五档 CSS 内容区、四档窗口及真实浏览器缩放、实际保存和送检。16:9 / 9:16 使用合成素材验证比例适配;浏览器派发的组合输入检查不代表原生操作系统中文输入法验收。物理显示器、操作系统缩放、原生输入法及公司部署环境尚未全面实测。旧本地验收任务的文件产物不可用,因此该页仅核对了布局与面板隔离,未完成媒体加载验证。详细证据、已有测试债与运行方式见[整体验收报告](verification/annotation-workspace-layout/acceptance-results.md)及[全套检查结果](verification/annotation-workspace-layout/full-suite-results.md)。