OpenBBQ

质量关卡

理解 OpenBBQ 的结构硬关卡、初稿质量提示,以及按需启用的专业复核。

OpenBBQ 会在每个阶段检查工作,但不同发现的处理方式并不相同。结构硬关卡负责保证工作区状态正确、产物新鲜;在默认 Agent 工作流中,普通低置信词、显示预算和术语一致性只作为提示,交付结果也会明确标成可编辑初稿。需要人工确认的专业质量时,再进入完整语义或可视化复核。

初稿路径与专业路径

默认的 agent init/next/apply/finish 路径只解决结构阻塞,不会创建强制的全覆盖审核队列。下面的专家命令用于检查或启用更严格的复核状态;复核状态一旦存在,导出就会尊重它,人工修改始终具有最高权威。

下面按工作流顺序,介绍手动和专业路径中可用的质量控制。

1. 听写检查——openbbq asr check

翻译之前,OpenBBQ 先把识别器没听准的地方指出来:存疑的词,以及疑似重复的片段。每一处都要做出带理由的决定——词和专名用 accept(接受)或 replace(替换),重复片段用 keep_first(保留第一个)或 drop(丢弃)。

把听写稿切成字幕行(segment)之前,必须等到 ready: true。详见听写与检查

2. 翻译检查——openbbq translate check

译文填好之后,这道关卡抓的是:漏译的行、长到在显示时长内读不完的行、时长为零的预算,以及前后漂移的术语。这些问题不解决,就无法干净地导出。详见翻译与审校

3. 逐句审校——openbbq translate audit

全覆盖的语义审校:每一行都带着前后句的上下文摆出来,每一行都要有一个带理由的 accept(通过)或 revise(修改)决定。只要还有未审校的条目,导出就会拦截,除非你明确加上 --allow-quality-warnings,刻意出一份草稿。

4. 可视化校对——openbbq review

一旦存在 review.<lang>.json(本地校对编辑器创建的),导出会等到该范围内的每一行都标记为已校对。--allow-unreviewed 用于刻意出草稿。详见可视化校对

5. 最终检查——openbbq delivery check --to zh

上桌前的硬关卡。它会重新核验:听写决定、翻译检查、语义审校、双语 ASS 的精确内容(ASS 是烧录用的带样式字幕格式)、导出与烧录的新鲜度、烧录来源(用的是哪个视频、哪份字幕),以及 MP4 非空。任何一项失败,都回答 ready: false,退出码非零。

画面布局不是默认关卡:没有视觉能力的模型不必检查画面帧,跳过也不会被扣分。

草稿出口

每道关卡都留了一个显式的“我就是要出草稿“的出口。每个开关都得每次刻意地加上:

  • --allow-missing——有些行还没翻译,也照常导出
  • --allow-quality-warnings——翻译或审校警告未清,也导出
  • --allow-unreviewed——校对范围未完成,也导出
  • --allow-stale——字幕在导出后被改动过,仍然烧录

这些开关不会把任何事标记为“已完成”,只放行这一次。

亲眼检查(可选)

你明确要求视觉检查时,有三条命令帮你看。它们绝不会自己挑选字幕样式,也不会自己触发重新烧录:

  • openbbq qa render——从烧好的 MP4 里抽取带字幕的画面帧(--count 取 1 到 9,默认 7)。
  • openbbq qa check——只读地重新核验 MP4 和帧的哈希。
  • openbbq qa attest --result pass|fail --reason "what you saw"——记录一次人或 Agent 的视觉判断;--issue 可重复,用于结构化的失败记录。

接下来

本页目录