dvcrn 字幕格式转换
支持 VTT、SRT、ASS、LRC 四种字幕格式的相互转换，以及时间轴偏移和双语字幕合并功能。
支持格式
| 格式 | 用途 | 特点 |
|---|---|---|
| VTT | 网络视频（YouTube等） | 支持样式、定位 |
| SRT | 通用格式（剪映支持） | 简单、兼容性好 |
| ASS | 高级字幕（动画、卡拉OK） | 完整样式控制 |
| LRC | 歌词同步 | 行级时间戳 |
工作流
格式转换
- 确定源文件格式和目标格式
- 运行转换脚本：
python scripts/convert.py <输入文件> --format <目标格式> - 输出文件默认在同目录，使用
.srt/.vtt等扩展名
批量转换
- 确定目标目录和格式
- 运行批量转换：
python scripts/convert.py <目录> --batch --format <目标格式>
时间轴偏移
- 确定偏移秒数（正数延后，负数提前）
- 运行偏移命令：
python scripts/convert.py <文件> --shift <秒数>
双语字幕合并
- 准备两个字幕文件（不同语言）
- 运行合并命令：
python scripts/convert.py <文件1> <文件2> --merge
命令参考
# 格式转换
python scripts/convert.py input.vtt --format srt
python scripts/convert.py input.vtt --output output.srt
# 批量转换
python scripts/convert.py ./subs --batch --format srt
python scripts/convert.py ./subs --batch --format srt --output ./output
# 时间轴偏移
python scripts/convert.py input.srt --shift 2.5 # 延后2.5秒
python scripts/convert.py input.srt --shift -1.0 # 提前1秒
# 双语字幕合并
python scripts/convert.py zh.srt en.srt --merge
python scripts/convert.py zh.srt en.srt --merge --output bilingual.srt
常见场景
YouTube VTT 转 剪映 SRT
YouTube 自动生成的 VTT 字幕包含滚动显示和逐词时间戳，转换时会自动清理：
python scripts/convert.py video.zh-Hans.vtt --format srt
批量转换目录下的 VTT 文件
python scripts/convert.py /path/to/subs --batch --format srt
字幕与视频不同步
如果字幕整体提前或延后，使用时间轴偏移：
# 字幕提前了3秒，需要延后
python scripts/convert.py subtitle.srt --shift 3
# 字幕延后了2秒，需要提前
python scripts/convert.py subtitle.srt --shift -2
制作中英双语字幕
python scripts/convert.py chinese.srt english.srt --merge --output bilingual.srt
技术细节
详见 references/formats.md：
- 四种格式的语法规范
- 时间格式差异（毫秒分隔符、精度）
- 转换注意事项（标签清理、编码处理）
注意事项
- YouTube VTT：自动合并滚动块、清理逐词标签
- SRT 必须有序号：转换到 SRT 时自动生成
- ASS 精度损失：毫秒转厘秒时会四舍五入
- LRC 无结束时间：自动设为下一行开始时间
- 编码统一：输出文件使用 UTF-8 编码