Jarvis-Video-STT Skill#

快速开始#

1. 安装依赖#

pip install faster-whisper tqdm 确保ffmpeg已安装 (brew install ffmpeg on macOS)

2. 基本用法#

medium模式（高精度，推荐）： python ~/.openclaw/workspace-researcher/tools/jarvis-video-stt/batch_whisper.py -i videos/*.mp4 -o results -m medium

small模式（快速）： python ~/.openclaw/workspace-researcher/tools/jarvis-video-stt/batch_whisper.py -i videos/*.mp4 -o results -m small

指定语言（略快）： python batch_whisper.py -i videos/ -o results -m medium -l zh

调整并行数： python batch_whisper.py -i videos/ -o results -w 4

3. 参数说明#

参数简写说明默认值--input-i视频路径/文件夹/通配符必填--output-o输出目录output--model-msmall/mediummedium--language-l语言代码，None=自动None--workers-w并行进程数3--cpu-强制使用CPUFalse

4. 输出文件#

每个视频生成：

• 视频名.srt - 带时间戳字幕
• 视频名.txt - 纯文本

整体生成：

• report.json - JSON汇总报告
• report.md - Markdown汇总报告

性能参考#

模型一小时视频(单进程)推荐并行small2分钟4进程medium5分钟3进程large-v3~8分钟2进程

适用场景#

• 课程视频转文字
• 电影/纪录片字幕生成
• 播客/访谈转录
• 短视频内容分析
• 视频内容检索预处理

故障排除#

Q: 报 faster-whisper 找不到？ pip install faster-whisper

Q: 报 ffmpeg 找不到？ brew install ffmpeg (macOS) apt install ffmpeg (Ubuntu)

Q: Mac显存不足？ 减少并行数：-w 2