SFX-Library-Automation 🎧

基于 Ollama 本地大模型与 Python 的音效库整理工具集：自动汉化文件名、目录名，及多线程压缩瘦身。

✨ 功能特性 (Features)

这是我为了整理几百 GB 英文音效库而编写的三个 Python 脚本，旨在解决“英文文件名难检索”和“WAV文件占用空间大”的痛点。

1. 🤖 智能汉化文件名 (translate_sfx.py)

   • 使用本地 Ollama API (推荐 Gemma/Llama3) 进行翻译。
   • 理解音效术语 (如 Whoosh -> 嗖嗖声, Impact -> 撞击)。
   • 格式：【中文翻译】原始英文名.wav，保留原文以便对照。
   • 支持断点续传（跳过已汉化文件）。

2. 📂 智能汉化文件夹 (translate_folders.py)

   • 采用 Bottom-Up (倒序) 逻辑，安全处理多层级嵌套目录。
   • 智能识别并跳过已包含中文的目录，保护根目录结构。

3. ⚡ 多线程音频压缩 (wav_to_mp3.py)

   • 利用 concurrent.futures 跑满 CPU 核心。
   • 实测 16 线程下，处理 500+ 文件仅需 20多秒。
   • 推荐 320kbps MP3，在缩减 75% 体积的同时保留高频细节。
   • 安全模式：只有在 MP3 生成且校验成功后，才询问是否删除原 WAV。

🚀 快速开始 (Quick Start)

依赖

• Python 3.x
• pip install requests
• Ollama (运行中, 默认端口 11434)
• FFmpeg (需添加到环境变量或放置在脚本同级目录)

使用

1. 启动 Ollama: ollama run gemma3:12b (或其他模型)
2. 运行脚本: python translate_sfx.py
3. 拖入文件夹路径，按提示操作即可。建议先选择 模式1 (模拟/Dry Run) 查看效果。

---

Made with ❤️ for Sound Designers & Editors.