li_nvvideocodec - NVIDIA AV1 视频压缩工具#

🌍 多语言支持 / Multi-Language Support#

本工具支持10种语言：

语言代码文档路径🇺🇸 Englishenlocales/en/README.md🇯🇵 日本語jalocales/ja/README.md🇰🇷 한국어kolocales/ko/README.md🇨🇳 简体中文zh-CNlocales/zh-CN/README.md🇹🇼 繁體中文zh-TWlocales/zh-TW/README.md🇫🇷 Françaisfrlocales/fr/README.md🇩🇪 Deutschdelocales/de/README.md🇪🇸 Españoleslocales/es/README.md🇷🇺 Русскийrulocales/ru/README.md🇸🇦 العربيةarlocales/ar/README.md

📋 功能简介#

使用NVIDIA GPU硬件加速的AV1视频批量压缩工具，可以：

• 🎯 智能验证 - 自动测试压缩效果，避免无效压缩
• 📊 三种方案 - 保守/平衡/激进，满足不同需求
• 🖥️ 双平台 - 支持Windows和Ubuntu Linux
• 📈 实时进度 - 显示压缩进度和详细统计
• 🔒 安全保护 - 原文件不删除，输出到独立目录

兼容Agent: hermes, openclaw, qwen-code

🚀 快速使用#

基本用法#

bash

# 交互式模式（会引导你选择参数）
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保持128k40-60%追求质量B ⭐1280x7202424fps96k65-75%平衡推荐****C1280x7202815fps64k78-85%最大节省

⚙️ 系统要求#

必需#

• ✅ FFmpeg - 需要支持av1_nvenc编码器
• ✅ NVIDIA GPU - GTX 1650及以上（支持NVENC）
• ✅ NVIDIA驱动 - 已安装并正常工作
• ✅ Python 3.7+ - 运行脚本

可选#

• tqdm库 - 显示进度条（脚本会自动安装）

安装FFmpeg#

Windows:

bash

# 下载: https://ffmpeg.org/download.html
# 解压后将ffmpeg.exe添加到PATH

Ubuntu:

bash

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

🔍 工作流程#

text

1. 环境检查
   ↓
   检查FFmpeg、GPU、编码器支持
   ↓
2. 选择压缩方案
   ↓
   A（保守）/ B（平衡）/ C（激进）
   ↓
3. 验证压缩效果
   ↓
   测试压缩1个小视频，对比大小
   ↓
4. 智能判断
   ↓
   如果有效 → 继续批量压缩
   如果无效 → 提示取消任务
   ↓
5. 批量压缩
   ↓
   显示进度、统计信息
   ↓
6. 生成报告

⚠️ 重要提示#

B站视频等特殊情況#

如果视频来自B站（Bilibili）等平台：

• 这些视频已被高度压缩（低码率）
• AV1压缩可能 不会节省空间
• 脚本会自动检测并提示

原文件保护#

• ✅ 原文件 不会删除
• ✅ 压缩文件输出到 独立目录
• ✅ 可以安全对比测试

📞 技术支持#

如遇问题，请检查：

1. NVIDIA驱动是否正常（ nvidia-smi）
2. FFmpeg是否安装（ ffmpeg -version）
3. FFmpeg是否支持av1_nvenc（ ffmpeg -encoders | grep av1_nvenc）

📄 许可证#

作者: 北京老李 (beijingLL)