🎬 MP4 转音频/文字工具 (极速 & 智能版)

这是一个专门为处理大量课程、视频而设计的极速工具。它可以帮你把 MP4 视频提取出音频（MP3），或者直接转录成文字（TXT）。

---

✨ 为什么用它？

• 特别快：音频提取用的是 FFmpeg（业界最快），分分钟搞定一仓库视频。
• 特别省：默认只取音频，不花钱也不费流量，只有你想看文字时才启动转录。
• 特别稳：视频文件太大（超过 200MB）它会自动切开，视频损坏它会自动修复。
• 特别智能：文件超过 20 个时，它会自动开启“并发加速”，像开了挂一样快。

---

🛠️ 第一步：快速准备 (只需一次)

小白用户请按顺序执行以下命令：

1. 安装基础运行环境 (macOS 用户)： 在终端输入：brew install ffmpeg
2. 安装 Python 插件： 在终端输入：pip install -r requirements.txt
3. 可选：设置转录 Key： 如果你需要转文字，请在文件夹下创建一个 .env 文件，里面写上：GROQ_API_KEY=你的Key

---

🚀 第二步：一键运行

打开终端，把文件夹拖进来执行：

1. 只要音频 (最常用，极速)

直接输入 python3 extract.py 加上你的文件夹路径：

python3 extract.py "/你的/视频/路径"

2. 既要音频也要文字

加上 --mode all 参数：

python3 extract.py "/你的/视频/路径" --mode all

3. 我想更快 (手动开启高并发)

默认 20 个文件以上会自动加速，手动加速请输入：

python3 extract.py "/你的/视频/路径" --workers 4

---

📜 结果在哪看？

1. 文件位置：生成的 .mp3 和 .txt 会乖乖躺在原视频旁边。
2. 总报告：每次跑完，程序会生成一个日志文件。
   • 位置：项目下的 logs/ 文件夹。
   • 内容：包含每个文件的大小、完成时间和处理状态。

---

❓ 常见问题

• Q: 为什么文字转录报错 429？
  • A: 说明你用的是免费 Key，每分钟有字数限制。程序会自动告诉你需要等多久。
• Q: 为什么有的视频提示“截断”？
  • A: 原始视频可能坏了。程序会启动“深度修复”尝试挽救，虽然可能不完美，但能保住音频不丢。
• Q: 文件夹里有很多子目录能处理吗？
  • A: 没问题，程序会掘地三尺把所有 .mp4 都找出来。