droboticflow/CONTEXT.md
2026-11-19 11:35:20 +08:00

201 lines
21 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.

# Droboticflow 领域术语
以下词汇描述人工标注与审核中的业务对象。
**分类标签**:管理员为字典词条明确维护的 tags 集合,用于按已确认类别归组;它不同于词条分类 category、别名 aliases 或动作描述文本。确认后的词条身份、版本和标签共同构成当次分类快照,字典后续更新不改写该快照。
**最终分类结果**:最终验收通过的固定版本中,视频各区间的基础分类、动作细分、显式无效及舍弃判断。未写动作描述不撤销基础分类;审核批注和返工过程不属于分类结果。
**动作有效标签**:动作独立选择描述字典词条时,使用当次选择冻结的标签;未独立选择时,继承所属切片冻结的分类标签。是否填写自由描述不决定继承,无效判断与标签分别保留。
**原始区间定位**:以原始采集及 part 的文件身份和硬件时间戳定位人工确认区间;切片内相对时间与原始 part 相对时间是不同坐标,不能混用。下游按定位和分类处理原始数据,不依赖平台内部审核文件。
## 标注对象
**Capture(源采集)**:一次源采集所关联的双目视频、时间戳与传感器数据,是本流程组织人工处理和审核的对象。
**项目源数据量**:每个项目内已发现并登记、按同一来源目录的 Capture 去重后的份数;同源用于两个项目时各计一份,总览为项目之和。同项目内双目、跨工作流重复处理、切片、动作划分或重跑不增加源数据量;同名但不同来源目录分别计数,不按视频内容去重。
_Avoid_:全局唯一源文件数、累计提交次数、切片数量(均不等于项目源数据量)
**当前生产进度**:项目源数据在最新一轮正式处理中的当前主阶段,每份数据只占一个主阶段;同轮存在多条任务时按最早尚未完成的环节归类。正式重跑可使当前阶段回退,旧交付结果保留为历史;调试运行不改变当前生产进度。
**期间阶段完成量**:在所选期间内发生过指定阶段成功完成事件的项目源数据份数,同一项目的同一源数据在该指标中只计一次。新增、送检、质检通过、终审通过与交付分别计算,退回另计发生次数。一源包含多个 part 时,阶段完成须所有所需 part 达成,按最后一个 part 完成时间计入期间;正式重跑或退回后的对应 part 不能复用已失效的完成证据。
_Avoid_:操作次数(同一份数据可以重复操作,但期间完成份数不因此重复累计)
**供应商期间参与产出量**:供应商在所选期间内参与完成某环节的项目源数据份数,按事件当时的生产归属统计。同一份数据在期间内可先后由多家供应商处理,各家可分别计入,总览仍按项目源数据去重;存在交叉时供应商小计不能直接相加。
**首交任务数**:在所选期间首次成功送检的 part 标注任务数,同一任务只计一次。它不等于源采集份数、切片数或已验收产出。
**返工重提次数**:任务被退回后再次成功送检的次数,与收到正式打回决定的次数分别统计。内部数据版本的增加不代表发生返工。
**审查次数**:质检员或验收员在所选期间作出的正式通过与退回决定,按决定所涉 part 计数;同一 part 返工后再次审查重复计入,其中再次审查另计为复审。终审一次决定涉及多个 part 时按 part 分别计入。它与标注员产出分开,不相加。
_Avoid_:审查份数(同一 part 可以计入多次)
**人天**:一名人员在一个本地自然日至少有一次本角色正式工作即计 1 人天:标注员为成功送检(含返工重提),质检员、验收员为正式审查决定。人均日产出为期间视频小时除以人天,不是实际工时。
_Avoid_:工时、出勤时长
**问题对象数**:每轮正式打回中具有意见的切片、动作及时间点对象数,同一对象的旧版多条意见只计一个对象,原文保留。停用前的整体意见不再计入。它不等于已独立证实的错误数量。
**问题覆盖视频时长**:正式打回意见所定位的视频区间,在每轮同一来源内去除重叠后的覆盖时长,跨轮累计。时间点意见只定位单一时间点,不计入覆盖时长;缺少可靠区间的记录不推定为整段视频,也不等于实际工时或精确缺陷持续时间。
**切片**:标注员在源采集的统一有效帧范围内划定的连续区间。全部切片完整覆盖该范围,互不重叠;一个切片可以包含多个动作区间。
_Avoid_:动作描述区间(两者不是同一层级)
**动作区间**:属于一个切片、具有起止边界的语义区间,可处于待标注、有动作描述或明确无效的状态。连续动作标注中的各动作区间首尾相接、互不重叠,完整覆盖需要标注的切片。
_Avoid_:子切片、子标注(容易与媒体切片或描述文本混淆)
**动作描述区间**:已经填写动作描述内容的动作区间,不包含待标注区间。
_Avoid_:切片(描述边界不等于切片边界)
**动作列表**:按时间顺序展示当前切片全部动作区间的列表,包括待标注、有描述和无效的区间,用于选择、回查和修改当前结果。
_Avoid_:历史操作日志(本列表不展示修改前的旧版本)
## 留空与交付
**待标注区间**:尚未填写动作描述或明确无效判断的动作区间。它表示语义留空,不等于无效判断,也不表示任务一定不能送检。
**语义留空**:切片内尚未填写动作描述、也未明确标为无效的时间范围,可以覆盖部分或全部切片。留空不自动代表无效或舍弃。
**空白动作记录**:描述为空且明确记录为语义留空的动作区间结果,保留区间身份与时间范围,参与质检及交付。它不是无效动作,也不意味着缺失该段视频。
**无效区间(无效动作)**:标注员明确判断为无效、仍作为动作标注结果保留的区间,在标注与审查界面中始终以特殊样式可见。无效标记本身不删除动作记录或对应视频,也不等于从交付范围中舍弃切片;切片结构调整不得使无效区间消失或缩减为零长度。
**舍弃切片**:标注员明确选择不交付、以舍弃原因定义的切片类型,与使用切片名称定义的普通切片互斥。切片及其证据仍参与审核,舍弃本身不移动相邻边界。
**取消舍弃**:显式恢复为普通切片时,将整片重置为一个覆盖首尾边界的待标注动作,不恢复旧描述或无效判断;旧内容保留为审计证据。撤销/重做按对应操作快照恢复,与此显式重置分开。正常可编辑切片始终保留动作分区,语义为空以待标注动作呈现,不能成为空轨道。
## 操作含义
**删除切片**:移除一个切片划分并将其范围并入相邻切片,保持源采集的处理覆盖。
**取消切分**:撤去当前切片或动作区间的一个划分,将其范围并入相邻区间,合并结果回到未定义状态;不是删除这段视频。它与撤销最近一次操作不同,可以针对明确选中的已有区间。
**删除动作描述**:移除一条语义描述并保留原时间范围的空白,不合并相邻动作,也不删除视频。
**动作改判**:将动作区间的原描述或无效判断更正为另一项语义判断,不等于删除该区间或对应视频。
**动作区间合并**:将两个相邻动作区间合为覆盖两者范围的一个区间,被合并区间不再单独存在,视频不因此删除。
**越界处置**:切片边界移动时,按受影响动作与边界的几何关系当场决定动作归属的判定。完全落入新归属侧的动作自动跟随;被边界穿过的动作由标注员当场三选(截断 / 挪片 / 判无效);恰好贴边的动作按语义区分——无效动作自动跟随伸缩,有效动作两选(跟随伸缩或保持原边界)。任何动作不会因边界移动被静默删除;存在未当场处置的动作时,边界保持不动。
_Avoid_:待核对(越界处置取代旧“拆两段待核对”,该中间状态不复存在)
**切片重设面板**:逐片标注阶段按 E 进入的专注编辑界面:设置所选切片的首尾帧、切分、舍弃、修改切片字典描述。改动在面板内只作预览、不落库;Enter 应用,Esc 整体回退到进入面板时的结构。首标与返修同样可用,模式外键位不受影响。
_Avoid_:切片编辑模式(2026-10-13 交互重设计,原地挪边界模式升级为重设面板)
**冲突清单**:结构改动应用前对受影响动作的集中处置界面:逐条列出每个被穿过或贴边的动作,要求逐条选定处置(截断 / 挪片 / 判无效)后才应用改动;中途取消则整个待应用改动集回退。它取代逐边界现场弹卡,任何动作不会因结构改动被静默删除或丢弃区间。
**保存进度**:保留当前动作划分和完成状态,允许仍有待标注区间;不代表标注已经完成或已经送检。
**切片字典**:项目启用的普通切片名称集合;普通切片从中选择名称,多个切片可以同名。舍弃切片以舍弃原因定义,不同时选择此字典。
**描述字典**:用于填写动作描述草稿的模板集合;选择后允许编辑描述文本。
**舍弃原因字典**:管理员维护并由项目启用的舍弃原因词条集合;舍弃切片时选定原因,并按词条要求补充说明。已记录的原因保留当时快照,不随字典后续修改而改写。项目未配置舍弃原因字典时允许手填非空原因;字典加载失败或已配置但无可用词条不属于未配置。
## 连续作业
**送检**:标注结果及其审核数据已经准备完成,任务交给质检环节等待处理。送检成功不代表质检通过。
_Avoid_:质检完成(属于后续审核结果)
**连续工作**:标注员明确开启后,在所选项目内接续处理本人可操作任务的工作方式;切片在后台生成时可处理另一任务,任务实际交给质检后再按个人缓冲容量补充随机任务。进入专注视图、打开任务或继续已有任务本身不代表开启连续工作。
**手动接取**:标注员关闭连续工作后,仅在主动点击随机领取时接取新任务;选择和处理本人已有任务不触发自动补领或自动切换。工作模式选择须明确保留,不能因重新进入工作页而改为连续。
**个人任务缓冲池**:当前标注员在一个项目内已经领取、尚未实际交给质检的任务集合;包括正在切片生成、送检处理或失败待处理的任务,用于在后台处理期间继续其他可操作任务。
_Avoid_:公共可领取任务池(其中的任务尚未归属当前标注员)
**暂停连续工作**:停止自动切换任务和补充领取,保留当前编辑、已领取任务及已经开始的后台处理;不是释放任务或取消切片生成。
**随机领取**:在操作者有权限的项目和供应商范围内,从可领取的标注任务中随机分配任务;操作者在领取前不能挑选视频。它不包含主动释放已领取任务。
## 审查
**审查追溯**:已授权任务的只读事件投影。任务来源与流转记录合并为右栏顶部的一张可折叠卡片,标题行显示当前版本与打回次数,默认展示最近两条流转;普通任务卡可批量附加人员、供应商和退回统计。缺失值用 `-`,已知零次保留 `0`;版本来自修订字段,退回次数来自正式退回事件,不使用轮数或版本相减。历史没有创建起点时,首次提交和总退回次数保留未知。最终验收按当前来源分段展示送检与质检流转和验收所依据的标注版本,分别显示该分段的质检退回次数与验收任务的验收退回次数。来源流转不展示人员身份,供应商继续遵守匿名规则。辅助统计失败不阻断任务列表,不回填或改写历史数据。
**审查**:质检审核与最终验收的统称,操作者核对已有结果、记录问题并作出通过或退回决定,不直接修改原标注结果。
**质检审核**:对标注员提交的切片、动作结果及相关证据进行检查的环节。不通过的结果回到标注环节返工。
**最终验收**:对质检通过的待交付结果进行最终检查的环节,与质检审核是不同的决定;泛宇三角色流程中不通过的结果退回质检环节。
**审核意见**:审查者对某个切片、某个动作或某个时间点的问题与修改要求。同一轮、同一被审版本中,每个对象只有一份当前有效意见,可编辑或清除;无意见不表示已经核对或通过。切片和动作意见按来源区分;停用前的整体意见不再展示。它不改变原标注判断,也不等于已提交退回决定。
**时间点意见**:锚定在单一播放时间点上的审核意见,不占用切片或动作区间,在轨道上以标记点呈现。同一时间点只保留一份当前有效意见。
**退回意见**:随质检退回决定送达标注员、要求在返工中处理的意见集合。再退回时的新退回意见只由上一轮判"仍有问题"的旧意见与新增意见构成;已判定解决的旧意见不再进入后续轮次的退回意见(界面上不再显示),完整处理轨迹保留在正式审查记录中供追溯。
_Avoid_:回退意见(易与撤销操作混淆)
**本轮审核意见**:复审视图中质检员本轮正在新写的审核意见集合(右栏板块,与左栏"退回意见"相对);判"仍有问题"的旧意见仍是原条目(质检备注并入原文),不拆入此栏。随再退回决定与未解决旧意见一同构成下一轮退回意见。它不是新的意见类型,只是当前审查草稿在复审视图中的呈现。
**旧版问题批注**:旧规则下同一对象的多条独立问题记录;尚未提交的重复意见需明确整理为一份最终意见,原文保留为历史。已正式提交的历史批注不因新规则而改写。
**审查字幕**:随当前播放位置展示被审动作描述、语义留空、无效或切片舍弃判断的文字,呈现原结果,不包含审查者正在填写的问题批注。
**审查草稿**:尚未形成正式通过或退回决定的审查意见,属于特定审查者、审核阶段、任务及被审结果版本;保存草稿不代表任务已完成审查。
**正式审查记录**:已随通过或退回决定提交的审查结果与意见,不属于当前可编辑的审查草稿;删除本轮问题批注不删除正式审查记录。
**连续审查**:审查者在当前审核环节接续处理任务的工作方式;最终验收跟随项目筛选,“全部项目”跨有权限的项目接续,指定项目仅在该项目接续,质检仍在当前任务所属项目接续。单纯领取保留可领取列表,“继续处理”进入任务并启动连续审查;当前决定实际成功后才进入下一条,暂停不撤回已提交决定。
**返工任务**:质检退回后按意见修改并重新送检的任务。原标注员仍有资格时定向归还本人;原标注员已删除时,保留正式标注和质检意见,在原供应商有项目权限且容量允许的标注员中按负载优先、同负载随机分配,不混入普通随机领取。
**接手返工**:接手已删除原标注员留下的返工任务。每名标注员跨项目最多同时接手一条,不触发本人返工阻止领取新任务的规则;历史意见与责任不因接手而改写。
_Avoid_:公共池任务(返工任务定向归属,不参与随机领取)
**意见处理状态**:标注员对某条退回意见的处理在界面上的呈现——"未修改(红)"或"已修改待复审(灰)"。已修改由"意见目标相对退回基线已改动"自动判定(切片内容含片内动作,不落库、不等于质检确认解决);另有免打字的一键"不改了"(跳过留痕,落库且复审可见),用于误报/不适用。它不是审核意见,也不改写原意见。
_Avoid_:处理反馈(2026-10-13 返工界面重设计删除了文字反馈编辑器:标注员零文字输入;历史数据只读保留)
**复审**:质检环节对返工重提结果的核对模式:对比退回基线与当前工作区差异,逐条判定旧问题状态(含"不改了"跳过项);复审的通过或退回仍是质检决定,不是新增工作流阶段。
_Avoid_:重新初审(复审保留原意见与退回基线,不是从零开始)
**复验**:终审环节对退回批次全部来源重新质检通过后的核对模式;复验清单必须包含原失败样本,沿用冻结抽样,不重新随机。
_Avoid_:重新抽签(退回不改变抽样)
**确认已解决**:复审员对旧问题已解决的正式判定,随复审决定提交后不可撤销;取消强提醒但保留意见原文与历史。
_Avoid_:删除意见(确认解决不删除任何历史记录)
## 账号与项目授权
**已删除账号身份**:保留原用户 ID、姓名、手机号和历史归属的不可重新启用记录。删除完成后手机号可用于创建新身份,新账号不继承旧账号的任务或历史;仅停用及删除未完成的账号继续占用手机号。
**账号角色**:一个账号只有一个角色。管理员独立;供应商管理员、标注员、质检审核员和最终验收员均归属一个供应商。
**项目成员**:账号参与项目的授权关系,生产职责继承账号角色。一个项目可以同时包含多个供应商,各供应商可以在该项目内处理其归属的任务;不能把项目成员角色当作额外账号权限。
**供应商项目授权**:平台管理员授予供应商参与某项目的资格;供应商与项目为多对多关系。授权涵盖该供应商当前及以后新增的在职生产人员,具体职责继承账号角色;停用账号不因此获得访问资格。
**项目公共任务池**:供项目已授权供应商共同领取的待处理任务集合;同一任务只允许一家供应商领取,领取后归属该供应商,其他供应商不能重复领取或查看其标注内容。
_Avoid_:供应商任务副本(公共池不为每家供应商复制同一任务)
**供应商最终验收授权**:平台管理员单独授予供应商创建最终验收员和参与同组织全部生产项目终审的资格,独立于供应商项目授权,默认未授权。
**共享验收池**:同组织生产项目待最终验收任务的共同入口,获授权供应商的验收员竞争领取同一份任务,不复制任务,也不改变生产供应商归属。
**本轮验收处理资格**:共享授权有效时成功领取任务的验收员完成该轮验收的资格;共享授权关闭不使其失效,但不延续到重新送审或改派后的下一次领取。
**历史验收资格**:升级前已有验收账号按原规则保留的权限范围,不代表获得共享验收授权;账号改为其他角色后不再保留。
**生产供应商归属**:生产任务所属的供应商,不随质检或最终验收的处理人员变化而改变;公共池尚未归属供应商的任务为未分配。撤销项目授权不抹去该供应商已归属任务的存量与历史统计。
## 内部测试
**内部测试任务池**:仅供内部人员复现问题和验收版本的独立任务集合;测试中的领取、标注、审查和交付不改变客户生产任务。
_Avoid_:客户公共池(内部测试不参与客户任务的竞争领取)
**测试任务副本**:以经批准的客户样本为来源、拥有独立身份和处理历史的内部测试任务;副本的修改不回写来源任务。
_Avoid_:供应商任务副本(不代表给每家生产供应商复制客户任务)
**内部测试环境**:与客户生产隔离、一次运行一个候选版本的完整平台,用经批准的少量客户样本模拟客户生产处理流程;其中的账号、任务、审查和交付不计入客户生产、统计或交付出口。
_Avoid_:测试 pod(一套环境包含多个组件)、生产内测试项目(与客户共用业务数据,不构成环境隔离)
**版本晋升**:把已在内部测试环境验收的同一候选版本发布到客户生产;只带走版本本身,不带走测试数据、账号或配置,每次发布仍需单独授权。测试通过不等于获准发布。
_Avoid_:推送 pod、迁移测试环境
**撤销供应商项目授权**:停止供应商领取该项目的新任务,但保留其既有任务的标注、质检与返工处理资格,直至存量完成;不等于停用账号或释放已领取任务。
**生产统计异常**:仅指当前正式处理中的执行故障,包括运行失败、源采集处理失败、切片或送检处理作业失败、交付打包失败。供应商归属不同、部分未领取、归属待核对、审核退回、业务升级处理及正常等待不单独计为异常;这些状态保留在明细,不增加红色异常数量。
## 交付批次
**交付批次快照**:一次明确选定、已验收的 part 修订集合及其交付清单。批次只表示本次交付范围;新增 part 或替换修订形成新批次,已交付批次保留。批次完成不代表原始采集的全部 part 已交齐。