用途:把已批准的母版视觉与视频素材,统一转换为各目标平台的适配版本,完成缩放、重编码、安全区校验,并按平台整理成可直接交付的目录结构,同时生成机器可读清单。
主要能力:图片与视频走同一管线;按平台规格确定尺寸、宽高比、安全区、文件大小上限,视频还涉及编码、码率、时长与字幕处理;图片按同比例缩放、以焦点为中心裁剪或加品牌色边条,并校验文字、Logo、主体不落入平台 UI 遮挡区;视频支持横转竖智能裁剪、竖转横加模糊或品牌色边条、字幕重新定位;输出命名规则为 {brand}{campaign}{platform}{asset-type}{variant}.{ext},缺失品牌或活动名时省略对应段。
使用方式:接受 --headless / -H 非交互执行,无头模式需提供母版路径与目标平台列表,或从当前活动简报读取。启动时读取 {project-root}/.pawbytes/config/config.yaml 与 config.user.yaml,输出目录默认 .pawbytes/creative-suites。依赖 ffmpeg,缺失则中止并提示 winget install ffmpeg 或 brew install ffmpeg;ImageMagick 可选。
输出:按平台分文件夹的变体文件,以及根目录 export-manifest.json,记录每个变体的平台、规格、尺寸、格式、状态(ok、duration_exceeded、size_exceeded、quality_reduced、skipped)与警告。
限制:时长超限不自动裁剪,仅标记;放大超过 150% 会提示质量下降;压缩后仍超限仅标记并建议手动优化;不支持格式跳过并建议先转换。具体平台规格以 ./references/platform-export-specs.md 为准,资料未提供其完整数值。