Subtitle Translate Agent Skill

字幕翻译 / 双语字幕

> 把已有字幕翻译成目标语言，产出双语（原文+译文）或纯译文字幕，可选烧录进视频。

> 翻译交给 LLM（你自己），确定性部分（解析/合并/格式/时间轴/烧录）全交给

> skills/shared/scripts/subtitle_ops.py。不要手拼 ffmpeg，也不要手改时间轴。

> 只做"已有字幕 → 翻译/双语/烧录"。语音识别生成字幕见 auto-subtitle；

> 通用视频剪辑见 video-editing。

输入

| 字段 | 必填 | 说明 |

|------|------|------|

| 字幕文件 | 是 | .srt / .vtt / .ass 路径（没给就问） |

| 目标语言 | 是 | 译成什么语言（如中文 / English / 日本語） |

| 输出形态 | 否 | 双语（默认）/ 纯译文 |

| 原译顺序 | 否 | 双语时原文在上（默认）或译文在上 |

| 视频文件 | 否 | 给了则可烧录；软挂载（可开关）或硬烧录（烧进画面） |

输出（outputs/主题名/）

• 双语 / 纯译文字幕文件（.srt 或 .ass）
• 若烧录：带字幕的视频（*-sub.mp4）
• 报告：条数、目标语言、形态、输出路径

执行步骤

脚本路径（相对项目根）：skills/shared/scripts/subtitle_ops.py（每个子命令支持 -h）。

1. 提取待译文本

python skills/shared/scripts/subtitle_ops.py extract -i <字幕> -o /tmp/st_lines.txt

每条字幕一行、行号与顺序固定。记住总行数 N。

2. 逐行翻译（你来做）

读 /tmp/st_lines.txt，逐行翻译成目标语言，写入 /tmp/st_trans.txt：

• 行数必须严格等于 N，顺序一一对应，不增删空行、不合并、不拆行（脚本会校验，不一致直接报错）。
• 一行内如原文有多句，整合成一行译文，不要拆成多行。
• 语气/术语按内容领域走；口语内容译得自然口语，书面内容译得书面。
• 空行原文对应空行译文（保持占位）。

3. 合并成双语 / 纯译文字幕

# 双语 SRT（原文在上，译文在下）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-bilingual.srt

# 双语 ASS（原文白色较大 / 译文黄色略小，样式更佳，推荐用于硬烧录）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-bilingual.ass --format ass

# 纯译文（不保留原文）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-<lang>.srt --trans-only

--order trans-top 可让译文在上。

4.（可选）烧录进视频

# 硬烧录（烧进画面，推荐用 .ass 保留双语样式）
python skills/shared/scripts/subtitle_ops.py burn -i <视频> \
  --sub outputs/主题名/<名>-bilingual.ass \
  -o outputs/主题名/<名>-sub.mp4

# 软挂载（可在播放器开关，不改画面；mp4→mov_text，mkv→srt）
python skills/shared/scripts/subtitle_ops.py burn -i <视频> \
  --sub outputs/主题名/<名>-bilingual.srt \
  -o outputs/主题名/<名>-sub.mp4 --soft

其它子命令

• parse -i <字幕> [-o out.json] — 解析成 JSON（含时间轴），供程序化处理或核对。
• build --json <cues.json> -o <字幕> — 从 JSON（cue 带 text 与可选 trans）构建，适合批量/整段翻译回填。
• convert -i a.srt -o b.vtt — 格式互转（srt ↔ vtt ↔ ass）。

规则

• 翻译走 extract → 逐行译 → merge 三步，严守行数一致，绝不让脚本回退到"猜行对应"。
• 时间轴、字幕条数、格式一律由脚本产出，禁止手改时间戳。
• 硬烧录中文优先用 .ass（内置 Noto Sans CJK 样式）；若用 srt 硬烧录且中文变方块，burn 加 --font-dir 指向含 CJK 字体的目录。
• 双语默认原文在上、译文在下（--order 可调）；纯译文用 --trans-only。
• 产物统一进 outputs/主题名/。

参考来源

字幕翻译工具形态参考开源项目：rockbenben/subtitle-translator（批量双语、译文上下对齐）、

bonigarcia/dualsub（双语合并）、innovationmech/video-translate（软/硬字幕嵌入）。

本 SKILL 把"翻译"交给 LLM，只把易错的解析/时间轴/合并/烧录做成确定性脚本。