检查媒体完整性工具使用教程

1. 项目目录结构及介绍

check-media-integrity 项目是一个用于检查媒体文件（图片、视频、音频）完整性的命令行工具。项目目录结构如下：

check-media-integrity/
├── check_mi.py           # 主程序文件
├── test_damage.py        # 损坏检测实验脚本
├── requirements.txt      # 项目依赖
├── LICENSE              # 开源许可证文件
└── README.md            # 项目说明文件

• check_mi.py：这是项目的主要脚本，用于执行媒体文件的完整性检查。
• test_damage.py：一个辅助脚本，用于评估随机损坏被工具检测到的概率。
• requirements.txt：包含项目运行所需的Python库依赖。
• LICENSE：项目的开源协议，本项目采用GPL-3.0许可证。
• README.md：项目的说明文档，包含项目的基本信息和如何使用。

2. 项目的启动文件介绍

项目的启动文件是 check_mi.py。这个脚本可以通过命令行接收不同的参数来执行媒体文件的完整性检查。以下是一些基本的命令行使用示例：

• 检查单个文件：

  python check_mi.py ./path/to/your/file.jpg
  

• 检查一个文件夹内的所有文件：

  python check_mi.py ./path/to/your/folder
  

• 递归检查一个文件夹及其子文件夹内的所有文件：

  python check_mi.py -r ./path/to/your/folder
  

更多详细的参数和使用方法可以在命令行中使用 -h 或 --help 参数来查看帮助信息。

3. 项目的配置文件介绍

本项目没有特定的配置文件。所有的参数都是在命令行中通过参数的形式传递给 check_mi.py 脚本的。用户可以根据需要调整以下参数：

• -c X 或 --csv X：将检测到的损坏文件详情保存到CSV文件X中。
• -r 或 --recurse：递归检查子文件夹。
• -z Z 或 --enable_zero_detect Z：检测文件中包含的至少Z个相同字节的序列。
• -i 或 --disable-images：忽略图片文件。
• -m 或 --enable-media：启用音频/视频文件的检查。
• -p 或 --disable-pdf：忽略PDF文件。
• -e 或 --disable-extra：忽略额外的图片格式扩展名。
• -x E 或 --err-detect E：执行ffmpeg解码时使用特定的错误检测标志。
• -l L 或 --strict_level L：根据L的整数值使用不同的方法检查图片。
• -t T 或 --threads T：用于加速的并行线程数。
• -T K 或 --timeout K：等待队列中新执行的检查的秒数。

用户可以根据自己的需求和文件类型，组合使用上述参数来进行媒体文件的完整性检查。