用途：translate-video 是一条端到端视频翻译流水线，流程为转写→翻译→精修字幕→嵌入，适合把视频字幕翻译成任意语言并做母语级润色。
主要能力：支持两种模式，--shorts 面向 TikTok/Reels，仅修正文本、保留全部时间戳、不合并；--regular 面向 YouTube/教程，借助词级时间戳合并成完整句子。可对希伯来语、阿拉伯语、波斯语等 RTL 语言做 Unicode 标记修复，并强制每行字符上限（--shorts 38，--regular 42）与最多两行。
使用方式：命令为 /translate-video /path/to/video.mp4 he --regular 或 --shorts。$1 为视频路径（必填），$2 为目标语言代码（默认 he），$3 为模式，省略时会询问用户。音频超过 25MB 时先用 ffmpeg 提取 mp3；转写使用 npx ts-node transcribe.ts -i "$INPUT" -o "$BASENAME.srt" --json，生成 .srt、.md 和词级 JSON。翻译时保留时间戳与序号，精修按 references/modes.md 规则，--regular 需填写 scripts/build-timestamps.py 的 GROUP_SIZES 后运行。随后运行 postprocess.py 限制行数，RTL 语言再运行 rtl-fix.py，最后用 ffmpeg-ass 嵌入字幕并打开输出。
输出文件：原始 SRT、可读转录 md、词级时间戳 JSON、翻译精修后的 SRT，以及带字幕的 mp4。
限制：资料提示在 ARM Mac 上处理长视频不要使用 Docker 版 ffmpeg，x86 模拟约慢 100 倍。语言代码与 RTL 标记见 references/languages.md。其余收费、平台与效果信息暂未提供。