ZJU-REAL/Easel / skills/builtin/subtitle-translate
subtitle-translate
Verified字幕翻译 / 双语字幕:把已有字幕(SRT/VTT/ASS)翻译成目标语言,生成双语(原文+译文)或纯译文字幕,并可软挂载 / 硬烧录进视频。当用户说 字幕翻译、翻译字幕、双语字幕、中英字幕、给视频加翻译、SRT 翻译、字幕本地化、把字幕翻成中文/英文、字幕转双语 时使用。翻译由 LLM 完成,时间轴/格式/烧录由 shared/scripts/subtitle_ops.py 确定性处理。与 auto-subtitle 区别:auto-subtitle 是语音识别生成字幕,本 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,只把易错的解析/时间轴/合并/烧录做成确定性脚本。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |