9.2 KiB
标注工作页的专注视图与原布局
从任务池选择项目并点击“开始工作”,仍使用现有的领取与继续任务链路,在当前标签页进入工作页。没有布局偏好的账号默认进入专注视图,收起平台导航和状态栏;“返回任务池”保留原有未保存修改确认。
工作页顶部的“切回原布局”恢复现有工作页及平台导航;“进入专注视图”再次收起导航。入口随编辑页面滚动保持可达。任务池原入口仍保持原有呈现。
布局选择只属于当前账号和当前浏览器,不是项目设置,也不会写入服务端。浏览器禁用本地存储时仍可切换,但无法保证刷新后记住选择。刷新、关闭或重新打开页面后仍需显式“继续工作”,仅恢复后端保存内容,不自动领取任务,也不恢复未保存草稿和撤销历史。
运行中切换布局只改变外壳。任务、阶段、播放位置、选中切片、各片草稿和撤销/重做共用原编辑会话;切换不会保存、释放或重新领取任务。正在处理的保存仍归属原会话,原有处理中限制继续生效。
任务 02 已为切片阶段提供固定布局:左侧为双画面、播放/逐帧控制与时间轴,右侧为当前切片命名、舍弃入口和确认区。1280×640 CSS 像素及以上内容区无需页面滚动;590×480 的实测双视频在最小内容区各约 410.5×334,并随窗口扩大。双画面均等比完整显示。工作状态、较长说明和返工原因可从固定入口展开。
原 Space、C、逐帧、B/V、字典命名与撤销快捷键继续使用同一编辑器;右下角另提供撤销/重做按钮。确认全部切片仍需再次确认,处理请求被接收不代表生成完成,服务端完成生成后才进入描述编辑。原布局继续保留原来的滚动方式。
任务 03 将动作描述接入相同骨架:右侧固定文本、精确边界、保存和取消,底部固定撤销/重做与送检入口。N 定起点,再按 N / Enter 定结束点后仍聚焦编辑区;Enter 进入文本,Ctrl / ⌘ + Enter 优先保存当前描述。已有描述可在专注视图点击“取消编辑”,丢弃当前未保存修改;保存、撤销、重做仍走现有版本与归属校验。跨片草稿继续保留,提交时必须先处理草稿;真实送检仍等待审核数据准备完成。
任务 04 为专注视图中的切片和描述时间轴提供每页最多 4 条的连续时间区间。页码、全局条目范围、前后页、查找及当前项定位始终可达;输入名称或描述文本查找下一匹配项,输入 #13 可直接打开第 13 条,即使区间只有一帧也无需点击狭小色块。搜索不筛除数据,Ctrl / ⌘ + 左右仍选择全局相邻切片;B/V、草稿恢复与撤销/重做会显示目标所在页。翻页、查找和切换布局不会保存草稿。原布局继续显示完整时间轴。
任务 05 将两类字典放入固定编辑区:搜索、每页 2 项、前后页和返回入口固定,长词条显示两行预览,悬停或辅助技术可读取完整词条,填入后可继续完整阅读。F / D 打开,方向键选择,Enter 填入,Esc 一次返回工作台;选择描述模板不会保存,可继续修改。长描述在同一个文本框内滚动,“展开描述编辑”暂时收起精确边界区域以增加文字空间,保存和取消始终在文本滚动区外;收起、切片导航与布局切换不保存草稿。原布局仍使用原有字典弹层。
任务 06 在专注视图的视频上方提供“放大左相机”“放大右相机”和“恢复双画面”。单路检查期间只改变呈现:两路视频节点保留,隐藏路继续同步;详细切片/描述时间轴临时收成画面之外的 Capture 进度条,把其余高度让给所选画面。切片阶段的当前播放头分割入口、播放与逐帧、当前编辑、保存、撤销/重做及阶段提交仍可达。恢复双画面或切回原布局保留播放帧、草稿、选择和历史。原布局继续使用原来的左右相机显示复选框并保留用户的显示选择;进入专注视图时则派生为双路有效可见,必要时由现有媒体传输重新接入被原布局隐藏的源并定位到当前帧,返回原布局后仍恢复原显示选择。
真实 590×480 双视频在 1280×640 内容区的实测每路有效画面约 410.5×334,单路约 531×432;两种模式在五档内容区均随窗口扩大。16:9 与 9:16 的 12 秒、30fps 本地 testsrc2 文件只用于验证左右不同比例时的 contain 适配,不代表客户素材或真实工作流覆盖。窗口过小时暂停仍由后续任务交付;当前浏览器尺寸验证不代表已覆盖各种操作系统缩放设置。
源码恢复与业务数据恢复
原键盘工作流的源码恢复点为本地标签 codex/annotation-keyboard-baseline-20260918,指向提交 54a35afad95d77b1f23c955f9c4671cae83a664d。本地忽略目录中的完整备份为 local-data/backups/annotation-keyboard-baseline-20260918.bundle。任务 01 核验标签指向与 git bundle verify 均通过;备份包含完整历史。
工作中的“切回原布局”与 Git 源码恢复是两件事:前者保留当前编辑会话,后者恢复整版代码。Git 标签和 bundle 不恢复数据库、下载媒体、浏览器未保存草稿或撤销记录;业务数据需要独立备份与恢复。本次没有恢复源码、回滚业务数据、推送或部署。
本地浏览器回归脚本:tests/browser/annotation-workspace-shell.mjs。使用隔离本地项目和已有认证会话文件,覆盖导航回退、刷新偏好、实际媒体/帧与草稿保留、延迟保存 API 回读以及撤销/重做。传入第二个真实本地账号的会话文件可额外验证同一浏览器存储中的账号隔离。会话文件和原始测试证据仅存放在忽略的 local-data/ 中。
切片阶段的本地浏览器验收脚本为 tests/browser/annotation-workspace-slice.mjs,只允许本地隔离 fixture。ANNOTATION_TASK_ID 可选择仍处于切片阶段的隔离任务;默认运行几何与编辑检查,不保存草稿。ANNOTATION_GENERATE=1 才执行真实两步确认并等待生成,这会推进该 fixture 的阶段;不要为重跑检查而重置已完成任务。ANNOTATION_VERIFY_GENERATED=1 可只检查已生成的主 fixture 和公共 API 回读。原始截图、认证会话和日志仍仅存放在忽略目录。
描述阶段浏览器验收为 tests/browser/annotation-workspace-annotation.mjs:默认使用 annotate-primary 检查五档内容区、固定编辑、过期版本真实拒绝、保存/撤销/重做回读和草稿拦截。ANNOTATION_SUBMIT=1 仅允许 annotate-delayed 专用任务执行真实送检,推进后不应重跑或重置;ANNOTATION_VERIFY_SUBMITTED=1 配合该任务 ID 只回读已完成送检。shell 回归以 ANNOTATION_SLICE_TASK_ID 指定仍处于切片阶段的 pool fixture,默认 pool-01,避免误用已生成的 slice-primary。
大量条目的浏览器验收为 tests/browser/annotation-workspace-navigation.mjs,使用独立的 many-annotate-04 与 many-slice-04 任务(后者传入 NAVIGATION_PHASE=slice)。两者均有 13 个切片,描述任务首片有 13 条描述。脚本检查五档尺寸、全局导航、草稿与布局切换、尾页删除、跨页历史、单帧描述查找及公共 API 回读;仅显式保存与历史恢复写入本地描述任务,不生成切片或送检。禁止通过重置已有任务重跑验收;任务 ID 可指定该命名前缀下的新增隔离任务。
分页边界拖动验收为 tests/browser/annotation-workspace-boundaries.mjs,默认检查切片,传入 NAVIGATION_PHASE=annotate 检查描述。它使用真实鼠标手势将页尾边界向两侧移动,并检查同一横坐标不会重复改变边界;描述模式通过现有编辑、确认结束点和保存建立相邻区间,再以公共 API 核对共享精确帧。历史验收还覆盖从另一切片重做已保存描述时,关闭编辑器并显示目标页。
字典与长文本验收为 tests/browser/annotation-workspace-dictionaries.mjs,使用 pool-01 与 annotate-primary。隔离项目需配置多页字典,以及“布局长名称验收”长名称与“布局长文本模板”长描述。脚本验证两类字典在五档内容区的固定入口、搜索分页、原布局回退、一次 Esc、原生剪切/撤销、草稿展开/收起/跨片保存及 API 撤销/重做回读。组合事件检查是浏览器派发的快捷键归属检查,不代表操作系统输入法验收;完整 OS 缩放与输入法矩阵仍需人工验证。
单路检查与比例适配验收为 tests/browser/annotation-workspace-camera-inspection.mjs,使用 annotate-primary 与 pool-01 且不执行保存、生成、送检或领取。脚本以真实 590×480 双视频检查五档双路/单路有效画面、左右放大、播放逐帧、进度条指针、草稿与媒体节点、历史、布局回退和公共 API 版本不变;随后在独立无缓存浏览器上下文中仅把两路 subject-content 映射到忽略目录的 16:9 / 9:16 合成文件,验证完整等比显示。合成文件不参与真实帧/API 工作流结论。