AutoVideoMerge：让二刷更沉浸的自动化视频处理脚本工具

🎬 AutoVideoMerge：让二刷更沉浸的自动化视频处理脚本工具

项目地址：xing-tang/AutoVideoMerge

一个集成 片头片尾检测 + 智能视频合并 的一站式脚本解决方案，为动漫、短剧、电视剧和教学视频等提供自动化批量处理。

1. 📖 背景

相信很多人和我一样，在二刷甚至多刷 动漫、短剧、电视剧或学习视频 时，经常被反复出现的片头、片尾打断，严重影响沉浸式体验。

为了解决这一痛点，我突发好奇结合 AI 利用一天时间开发了 AutoVideoMerge ------ 一个基于 Python + FFmpeg 的自动化工具，可以智能检测视频片头片尾并自动合并，保留首集片头和末集片尾，让观看体验更加流畅自然。

处理完成的视频，尤其适合在 家庭影院 中观看，也能在学习复盘时大幅提升专注度和效率。

2. 🌟 核心功能

功能	描述	特色
🔍 片头片尾检测	智能识别视频开头和结尾位置	基于参考时间±5秒精准定位
🔗 智能视频合并	自动裁剪并拼接视频	保留首集片头、末集片尾
🚀 一键处理	检测+合并完整流程	交互式确认，可控流程
⚡ 快速处理	全自动无确认模式	输入目录即可，零干预
⚙️ 配置管理	持久化用户设置	记住常用路径和参数

3. 🎯 使用场景

动漫合集制作：去除片头片尾，打造无缝观影体验
短剧批处理：快速生成整合版合集
电视剧整理：批量裁剪，保存整季观看版本
教学/学习视频：移除重复开场结尾，专注知识点
会议录像：剔除冗余开场和收尾，提炼核心内容

4. ⚡ 快速上手

1️⃣ 安装依赖

bash 复制代码

# 安装 Python 依赖
pip install opencv-python numpy tqdm

# macOS 安装 FFmpeg
brew install ffmpeg

# Windows 安装 FFmpeg
# 前往 https://ffmpeg.org/download.html 下载并配置环境变量

2️⃣ 启动程序

bash 复制代码

# 推荐方式：启动器
python3 run.py

# 主程序
python3 video_processor.py

# 批处理模式
python3 video_processor.py --batch --input ./videos

5. 📋 功能菜单预览

markdown 复制代码

📋 主菜单
1. 🔍 检测片头片尾
2. 🔗 合并视频  
3. 🚀 一键处理 (检测+合并)
4. ⚡ 快速一键处理 (全自动)
5. ⚙️ 配置设置
6. 📊 查看历史记录
7. 🛠️ 工具和实用功能
8. ❓ 帮助
0. 👋 退出

6. 🎥 实际案例

6.1 动漫合集制作

bash 复制代码

8.重返天南[连载中]/
├── 《凡人修仙传之重返天南》第1集.mp4
├── 《凡人修仙传之重返天南》第2集.mp4
├── 《凡人修仙传之重返天南》第3集.mp4
└── reference_times.json

# 处理结果
8.重返天南[连载中]/
├── detection_results.json
└── 8.重返天南[连载中]_合集.mp4

7. ❗ 常见问题

Q1. 提示 "FFmpeg 未找到"？

macOS: brew install ffmpeg
Windows: 下载并配置环境变量
Linux: sudo apt install ffmpeg 或 sudo yum install ffmpeg

Q2. 合并时报 "零转码失败"？

程序会自动切换到重编码模式
也可手动开启配置 → 强制重编码

Q3. 没有进度条显示？

安装 tqdm 即可：

bash 复制代码

pip install tqdm

8. 🔄 更新日志

v2.0: 新增快速一键处理模式；修复特殊字符目录识别
v1.1: 全新交互菜单、进度条和配置管理
v1.0: 初始版本，支持片头片尾检测和合并

9. 📈 性能指标

指标	性能	说明
检测速度	~30秒/集	20分钟视频，±5秒搜索范围
合并速度	~5分钟/GB	取决于磁盘 I/O
内存占用	<500MB	处理 4K 视频峰值
支持格式	MP4/AVI/MKV/MOV/WMV	主流格式全覆盖

10. 🤝 如何参与

欢迎提交 Issue 或 Pull Request！

🐛 Bug 报告：提供详细错误和复现步骤
💡 功能建议：描述使用场景与预期效果
📝 文档改进：补充案例与操作说明

11. 📄 声明

本项目仅用于 学习与技术交流 ，请勿用于任何商业用途。

请大家 自觉遵守版权法规，确保视频资源来源合法合规。

🎬 AutoVideoMerge ------ 让二刷更沉浸，让观影更专注。

GitHub 地址：xing-tang/AutoVideoMerge