转写后自动处理

本文同步自 MAW 原始仓库的 docs/user/POSTPROCESS_PIPELINE.md。

Launcher 可在转写成功后自动运行字幕处理链。总开关默认关闭，原始转写产物保留；单独处理已有字幕见 工具箱。

选择步骤

顺序固定，只执行勾选项：

1. 文稿匹配（本地确定性对齐）
2. AI 口播整理（参考文稿可选）
3. 固定替换（批量规则，再简繁转换）
4. AI 校对
5. 重新断句
6. OCR 去重
7. 翻译
8. 烧录字幕

配置不完整时不会直接启用，Launcher 会跳转到对应工具并定位无效字段。LLM 步骤必须以当前供应商、Key、地址和模型完成实际连接测试；修改这些字段会让验证失效，修改提示词或翻译目标不影响连接验证。

开始转写时固定本次设置快照，运行中修改界面不改变已启动任务。批量转写跳过文稿匹配和 AI 口播整理，其他步骤照常执行。

AI 整理的「补充说明」也属于任务快照，用法见 工具箱。最后的烧录步骤使用前面步骤产出的当前 SRT 与原视频，生成新视频，不覆盖源媒体；使用样式库的 SRT 默认样式，自动选择可用视频编码器，其余编码参数采用默认值。需要指定编码器或自定义编码参数时用工具箱单独 烧录字幕。纯音频不能启用该步骤。

重新断句可设置每条字幕最大字数（留空不限），与供应商、提示词一起保存到任务快照；本地脚本校验与补拆，不能安全细分的超长词项或缺时间码段保留并报告。

翻译结果

翻译目标只能选中文或英文。双语合一与回填互斥：

默认中文译文在上，英文翻译原文在上；可手动选择行序。空 cue 不生成输出。中文预过滤、英文翻译与严格一对一校验按 LLM 协议 执行；不会只因文字是拉丁字母就跳过英文翻译。

独立原文/译文只作为中间产物，最终不另发译文副轨。带双语合一或回填标记的工程/SRT 会拦截重复翻译。

文件与恢复

每次运行先复制原始 SRT / MOSP，再按实际阶段编号写入运行目录：

<媒体目录>/_maw/后处理/<媒体名>-<时间戳>/

英文界面使用 postprocess；开启每视频子文件夹时，_maw 替换为 <媒体名>_maw。阶段产物同名配对，跳过且无产物的步骤不占编号。manifest.json 记录原始快照、阶段产物和结果。

最终文件写回原 SRT 目录，中文后缀为 .后处理、英文 .postprocess；双语合一/回填再追加对应模式后缀。写入使用临时文件并防止重名覆盖。

• 「保留中间产物」默认开启；关闭后，成功运行清理该运行目录及因此变空的父目录。
• 失败、取消或异常时始终保留运行目录和已有结果；原始转写不撤销。
• 「打开自动处理中间产物」用于检查快照；「从失败步骤重试后处理」从同一次快照继续，不重新转写。
• 文件创建或写入失败时显示对应原因；文件名或路径过长时，请缩短原文件名或目录路径，重新选择文件后重试。原失败目录中的恢复路径不会自动迁移。
• 固定替换没有规则且没有简繁转换时会跳过，不生成空产物。

AI 口播整理使用原文、划删和待确认注释构成编辑稿，由固定脚本转换成可恢复的 MOSP 删除区间与待核查标记；最终仍需到编辑器回听确认。勾选「生成处理前后对比结果」时，AI 步骤另存离线 HTML；关闭保留中间产物也会保留对比页。

AI 校对、重新断句、翻译或自定义任务的单批瞬时请求错误（网络中断、超时、HTTP 408 / 429 / 5xx）会保留该批原字幕并继续后续批次。步骤结果带警告，最终产物可能混有已处理与原文字幕，需按警告范围复核。全部批次请求失败、无可用结果、鉴权 / 配置或协议错误仍按步骤失败处理。

日志与配置

处理设置保存在用户级配置，API Key 仍在本机 .env。主日志记录步骤、节流进度与产物名称，不记录 Key、完整提示词或模型原始响应。字幕文字会发送给所选 LLM；OCR 与普通文稿匹配在本机处理。

协议与时间码边界见 LLM_POSTPROCESS_PROTOCOL，OCR 环境与报告见 OCR_SUBTITLE_DEDUP。