VideoHub Media Processing

复用 F:/work/VideoHub/src/youtube_transcriber.py 的 CLI；当前 CLI 入口在文件末尾的 if __name__ == "__main__"。

适用场景

• 处理 YouTube URL
• 批量处理多个 URL
• 转写本地音频 / 视频
• 从文本直接生成总结
• 生成字幕、翻译字幕、烧录字幕
• 选择字幕目标语言
• 查看模板、历史记录、清理工作目录

常用命令

python src/youtube_transcriber.py --youtube "<url>"
python src/youtube_transcriber.py --youtube "<url>" --generate-subtitles
python src/youtube_transcriber.py --youtube "<url>" --generate-subtitles --target-language ja
python src/youtube_transcriber.py --youtube "<url>" --download-video --embed-subtitles
python src/youtube_transcriber.py --audio "path/to/file.mp3"
python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles
python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles --target-language ko
python src/youtube_transcriber.py --video "path/to/series" --generate-subtitles
python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles --series-project
python src/youtube_transcriber.py --text "path/to/file.txt"
python src/youtube_transcriber.py --urls "<url1>" "<url2>"
python src/youtube_transcriber.py --history
python src/youtube_transcriber.py --cleanup-preview

重要参数

• --youtube / --audio / --video / --text / --batch / --urls
• --generate-subtitles
• --no-translate
• --target-language：支持 zh-CN、zh-TW、en、ja、ko、ru、fr、de、es、it、pt、ar，默认 zh-CN
• --embed-subtitles
• --download-video
• --transcribe-only
• --template / --create-template / --list-templates

注意

• 这是当前最强的执行型 skill，优先走现有 CLI。
• 对需要登录的 YouTube 内容，可使用 --cookies。
• 输出目录遵循 paths_config.py 下的 workspace 结构。
• 字幕翻译默认使用 Google；Google 失败时会尝试 DeepSeek/OpenAI 备用翻译。中文目标语言可选 DeepSeek 润色。
• 本地 GUI 里还有“提取本地视频音频到 songs 目录”的功能，对应 extract_audio_from_local_videos()，不属于当前 CLI 的主参数。
• 本地目录输入会作为剧集项目处理，在视频目录内建立 subtitles/、transcripts/、 summaries/、audio/、videos_with_subtitles/ 和 videohub_project.json。后续故事剪辑或 影视解说只需接收该目录并读取项目清单。