SuperAPI AI 工具集

ffmpeg-media-finishing

设计与创作

查看项目

更新于 10-15 20:10

技能介绍

用途:在创意生成或编辑产出源媒体之后、交付给用户之前进行收尾处理,把脆弱、不一致的媒体输出转为可复现、符合规格并带审计记录的文件。技能与供应商无关,假定本地有 ffmpeg 和 ffprobe,但不假定已编译所有编解码器、滤镜、硬件编码器或字幕渲染器。

主要能力:先探测再决策,运行确定性命令后再次探测输出。每次收尾交接应包含 ffprobe 输入审计摘要、所选交付规格与未决假设、实际运行的命令(含 FFmpeg 版本/构建)、输出审计摘要、校验和及帧哈希、已知风险(如字幕重编码、色彩元数据歧义、削波、有损转码、平台不确定性)。

使用方式:内置 Python 3.11+ 标准库辅助脚本 scripts/media_probe.py,可做可重复技术审计或交付规格门禁。调用示例:python skills/production/runtime-assembly/ffmpeg-media-finishing/scripts/media_probe.py input.mp4 --pretty;带期望规格:python ... input.mp4 --expect expected.json --pretty。选项含 --expect、--ffprobe、--timeout、--pretty。退出码 0 通过、1 期望失败、2 用法/输入错误、3 ffprobe 不可用、4 ffprobe 非零退出、5 超时、6 输出非有效 JSON、7 期望 JSON 无法读取或校验。

流程要点:用 ffmpeg -hide_banner -version、-encoders、-muxers、-filters 等预检工具链;用 ffprobe 审计容器、时长、视频/音频参数、色彩元数据、字幕、附件等;选择流复制、转码或滤镜;注意容器与编解码器区别、缩放裁剪填充与宽高比、帧率与时间戳同步、色彩范围与色彩空间、音频响度与采样率声道布局。

限制:该辅助脚本不能替代感知审查、色彩管理审批、音频试听、字幕/无障碍审查、版权审查或平台/客户签收。FFmpeg 构建能力、编码器名称、平台上传规则与社交规格易变,需在生产时重新核对。缺失或元数据不一致应视为警告,不得凭空编造数值。