用途：对视频文件做只读分析，读取元数据、编解码信息、分辨率、码率、时长、HDR 状态、关键帧结构、音频参数与章节，并评估画面质量。
主要能力：用 ffprobe 输出完整元数据（-show_format -show_streams -show_chapters）或单项属性，如分辨率、时长、编解码器、帧率、码率、像素格式、音频信息；通过 color_transfer 判断 HDR（smpte2084 为 HDR10/Dolby Vision，arib-std-b67 为 HLG，bt709 为 SDR）；用 -skip_frame nokey 列出或统计关键帧，并分析 GOP 中 I/P/B 帧分布；用 FFmpeg 的 scdet 滤镜或 PySceneDetect（detect-adaptive、detect-content 等）做场景检测；用 loudnorm 测量音频响度（input_i、input_tp、input_lra）；用 libvmaf、SSIM、PSNR 对比编码前后画质，并可循环不同 CRF 编码测试寻找质量与体积的平衡点。
使用方式：分析命令直接以 ffprobe/ffmpeg 对输入文件执行。例如完整元数据：ffprobe -v error -print_format json -show_format -show_streams -show_chapters "$INPUT"。VMAF 需同时提供失真视频与参考视频。需要细化的质量指标说明、场景检测参数与高级 ffprobe 用法时，加载 references/analyze.md。
适用场景：检查视频规格与兼容性、定位 HDR/SDR、分析关键帧与 GOP、做场景切分、验证音频响度是否符合标准、评估转码质量与选择合适 CRF。
限制：所有分析均为只读，不修改源文件；VMAF 与 SSIM/PSNR 需要参考原始视频；部分指标（码率、HDR 等）依赖文件自身元数据，可能为空或标记为未知；更详细的参数与高级用法需查阅随附参考文档。