li_nvvideocodec - NVIDIA AV1 视频压缩工具
🌍 多语言支持 / Multi-Language Support
本工具支持10种语言：
| 语言 | 代码 | 文档路径 |
|---|---|---|
| 🇺🇸 English | en | locales/en/README.md |
| 🇯🇵 日本語 | ja | locales/ja/README.md |
| 🇰🇷 한국어 | ko | locales/ko/README.md |
| 🇨🇳 简体中文 | zh-CN | locales/zh-CN/README.md |
| 🇹🇼 繁體中文 | zh-TW | locales/zh-TW/README.md |
| 🇫🇷 Français | fr | locales/fr/README.md |
| 🇩🇪 Deutsch | de | locales/de/README.md |
| 🇪🇸 Español | es | locales/es/README.md |
| 🇷🇺 Русский | ru | locales/ru/README.md |
| 🇸🇦 العربية | ar | locales/ar/README.md |
📋 功能简介
使用NVIDIA GPU硬件加速的AV1视频批量压缩工具，可以：
- 🎯 智能验证 - 自动测试压缩效果，避免无效压缩
- 📊 三种方案 - 保守/平衡/激进，满足不同需求
- 🖥️ 双平台 - 支持Windows和Ubuntu Linux
- 📈 实时进度 - 显示压缩进度和详细统计
- 🔒 安全保护 - 原文件不删除，输出到独立目录
兼容Agent: hermes, openclaw, qwen-code
🚀 快速使用
基本用法
# 交互式模式（会引导你选择参数）
python scripts/compress_videos.py
# 指定目录和方案
python scripts/compress_videos.py -i "输入目录" -p B
# 测试模式（只压缩1个视频验证）
python scripts/compress_videos.py -i "输入目录" -p B --test --test-count 1 --no-confirm
# 完整压缩（非交互）
python scripts/compress_scripts/compress_videos.py -i "输入目录" -p B --no-confirm
📊 压缩方案
| 方案 | 分辨率 | CRF | 帧率 | 音频 | 预估节省 | 适用场景 |
|---|---|---|---|---|---|---|
| A | 保持原样 | 23 | 保持 | 128k | 40-60% | 追求质量 |
| B ⭐ | 1280x720 | 24 | 24fps | 96k | 65-75% | 平衡推荐 |
| C | 1280x720 | 28 | 15fps | 64k | 78-85% | 最大节省 |
⚙️ 系统要求
必需
- ✅ FFmpeg - 需要支持av1_nvenc编码器
- ✅ NVIDIA GPU - GTX 1650及以上（支持NVENC）
- ✅ NVIDIA驱动 - 已安装并正常工作
- ✅ Python 3.7+ - 运行脚本
可选
- tqdm库 - 显示进度条（脚本会自动安装）
安装FFmpeg
Windows:
# 下载: https://ffmpeg.org/download.html
# 解压后将ffmpeg.exe添加到PATH
Ubuntu:
sudo apt update
sudo apt install ffmpeg
📝 完整参数
| 参数 | 简写 | 说明 | 示例 |
|---|---|---|---|
--input |
-i |
输入视频目录 | -i "E:\视频" |
--output |
-o |
输出目录 | -o "F:\压缩后" |
--profile |
-p |
压缩方案 (A/B/C) | -p B |
--test |
测试模式 | --test |
|
--test-count |
测试文件数 | --test-count 5 |
|
--no-confirm |
跳过确认 | --no-confirm |
🔍 工作流程
1. 环境检查
↓
检查FFmpeg、GPU、编码器支持
↓
2. 选择压缩方案
↓
A（保守）/ B（平衡）/ C（激进）
↓
3. 验证压缩效果
↓
测试压缩1个小视频，对比大小
↓
4. 智能判断
↓
如果有效 → 继续批量压缩
如果无效 → 提示取消任务
↓
5. 批量压缩
↓
显示进度、统计信息
↓
6. 生成报告
⚠️ 重要提示
B站视频等特殊情況
如果视频来自B站（Bilibili）等平台：
- 这些视频已被高度压缩（低码率）
- AV1压缩可能不会节省空间
- 脚本会自动检测并提示
原文件保护
- ✅ 原文件不会删除
- ✅ 压缩文件输出到独立目录
- ✅ 可以安全对比测试
📞 技术支持
如遇问题，请检查：
- NVIDIA驱动是否正常（
nvidia-smi） - FFmpeg是否安装（
ffmpeg -version） - FFmpeg是否支持av1_nvenc（
ffmpeg -encoders | grep av1_nvenc）
📄 许可证
作者: 北京老李 (beijingLL)