视频抽帧选主图
介绍如何从档口试穿、走秀或商品展示视频中批量抽帧，筛除模糊、重复和不适合作主图的画面，输出清晰的竖版商品主图候选图。
这个功能能解决什么问题
视频抽帧选主图 可以把档口试穿、走秀或商品展示视频拆成连续画面，再按人物穿搭或商品主体两种方式筛掉模糊、重复和不适合做主图的画面，输出一批竖版商品主图候选图。
它适合解决这些问题：
- 档口只提供了视频，没有提供足够的模特主图。
- 一批商品都有视频，希望按款式批量提取图片。
- 视频截图数量太多，不想逐张人工检查清晰度和重复动作。
- 希望优先保留正脸、人物清楚、构图较完整的画面。
- 鞋子、箱包、饰品等视频没有人物，希望直接按商品画面的清晰度和差异选图。
- 想先用少量款式试跑，再决定是否处理整批。
这个功能输出的是“主图候选素材”。正式上架前仍建议人工看一遍，确认商品、人物、构图和平台要求都合适。
使用前怎样整理视频目录
页面的来源目录结构可以选择兼容1—3级目录结构，也可以只检查指定的1级、2级或3级。系统只检查这些固定位置，不会无限向下递归。
这里从本次选择的原视频根目录开始计算：根目录本身是第1层，具体文件不算文件夹。完整层级规范见 42_商品文件夹结构与标准目录_用户说明。
1级目录结构
视频直接位于所选根目录，文件名应带商品编码。商品文件夹智能提取生成的标准名称可以直接使用：
原视频根目录
├─ HZ-RF-1D075-C29-P165-K218-视频(01).mov
└─ HZ-RF-1D076-C30-P175-K228-视频(01).mp4系统会去掉末尾的-视频(序号)，按商品编码把同款视频归到一起。
2级目录结构
原视频根目录
├─ 01-女装-档口A-货号1001-170-P20
│ ├─ 试穿视频.mp4
│ └─ 细节展示.mov
├─ 02-女装-档口B-货号2002-180-P30
│ └─ 走秀视频.mp4
└─ 03-女装-档口C-货号3003
└─ 上身展示.mkv3级目录结构
3级支持两种明确位置：
原视频根目录\商品文件夹\视频\具体视频
原视频根目录\分组文件夹\商品文件夹\具体视频其中“分组”可以是档口或厂家、系列、类别、品牌、来源、日期或批次。原视频根目录\分组\商品\视频\具体视频已经是4级结构，不在本设置的扫描范围内。
兼容1—3级目录结构
这是默认选项。系统同时检查上面三种固定位置，适合同一批视频有时在根目录、有时在商品目录或素材子目录的情况。它仍然不会继续扫描第4级及更深位置。
请特别注意：
- 已经明确知道结构时，可以选择精确的1级、2级或3级，避免扫描到不需要的位置。
- 没有视频的商品会被跳过，不影响其它商品继续处理。
- 当前可扫描
MOV、MP4、AVI、MKV，实际处理哪些格式由页面勾选项决定。 - 同一商品有多种格式时，处理顺序固定为
MOV → MP4 → AVI → MKV；同格式再按文件名自然排序。
如果商品文件夹名称需要和价格、档口、货号等信息联动，建议先阅读 商品编码规范：全编码与半编码。
输出目录怎样选择
抽帧主图输出目录 用来保存处理后的候选图、废片和处理摘要。
建议为每一批任务单独选择一个输出目录，并遵守两条安全规则：
- 输出目录不能和原视频父目录相同。
- 输出目录不能建在原视频父目录里面。
- 原视频父目录也不能建在输出目录里面；两边必须使用互不包含的独立目录。
这样可以避免再次扫描时把输出结果误当成新的款式，也能防止原始视频和生成图片混在一起。
页面设置怎样选择
选择设置模板
设置模板保存来源目录结构、抽帧、清晰度、筛选、裁剪和导出规则，不保存本批原视频目录或输出目录。
同一类档口视频可以复用同一套模板：
保存模板：覆盖当前选中的模板。另存为模板：保留原模板，再创建一套新规则。
已经保存的模板可以到 设置中心 -> 设置模板管理 统一查看和删除；“默认模板”不能删除。
输出命名规则
全编码：使用完整的款式文件夹名称作为输出文件夹名称。半编码：款式名称按短横线-分段后，只使用第 3 段和第 4 段，例如01-女装-档口A-货号1001-170-P20会输出为档口A-货号1001。
如果文件夹名称不足 4 段，选择半编码时会回退为完整文件夹名称。第一次使用或需要精准核对原款式时，建议选全编码。
输出图片尺寸
用于控制最终导出图片的宽度和高度。常见选择包括：
750x1000：3:4800x1200：2:31440x1920：3:4
如果主要用于淘宝 3:4 商品主图，可以先使用 750x1000。尺寸越大，处理和写入图片所需时间通常越长。
视频格式
系统只扫描已勾选的格式。没有勾选任何格式时不能开始任务；不确定时保持常见格式全选即可。
当每款最多处理视频数小于该商品的视频总数时，系统先按格式优先级选择：MOV → MP4 → AVI → MKV；同格式按文件名自然排序。
选图模式
人物穿搭：默认模式，适合真人试穿、走秀和穿搭展示。系统会使用人物、正脸、整体清晰度、脸部清晰度和画面差异共同筛选。商品主体：适合鞋子、箱包、饰品等以商品本身为主、画面中可能完全没有人物的视频。无人画面不会因为“没有识别到人物”被直接淘汰，而是继续参加整体清晰度和画面差异筛选。
选择商品主体后，首图正脸优先、正脸判定、脸部清晰度、脸部权重、氛围图数量和人物居中裁剪不会参与本次处理；整体清晰度、动作去重、主图数量、保底和通用画质处理仍然生效。
不同来源的视频差异较大。第一次更换类目或视频来源时，建议先跑 2 到 3 款小样本，再决定是否处理整批。
首图正脸优先与正脸判定严格度
开启 首图正脸优先 后，系统会优先把正脸更清楚、综合评分更高的图片排在前面。
正脸判定严格度 越高，正脸要求越严格。数值调得过高可能减少可用图，第一次使用建议保持默认。
主图不足时保底与主图数量
开启保底后，如果严格筛选留下的主图少于“保留最少”数量，系统会从备选画面中按评分补回，避免某个款式完全没有结果。
“最多”控制每款主图候选图的上限。保底图会在文件名中标记为 保底，建议人工复核后再使用。
每秒抽帧数
表示每秒从视频中截取多少张候选画面。
- 数值越大：捕捉到的动作更多，但处理时间和临时图片数量也会增加。
- 数值越小：处理更快，但可能错过短暂的好画面。
每款最多处理视频数
用于限制每个款式最多处理多少个视频。填 0 表示处理该款式文件夹内所有已勾选格式的视频。
小样本款式数
点击 小样本抽帧预览 时，只处理前几个“确实包含视频”的款式。前面有空文件夹时，不会浪费小样本名额。
第一次使用建议先试 2 到 3 款。
视频慢放倍数
用于让抽帧过程更细地捕捉动作。数值越小，处理通常越慢。没有明确需求时建议保持默认。
清晰度、动作去重与评分权重
整体清晰度阈值：过滤整张画面模糊的图片，数值越高要求越严格。脸部清晰度阈值：过滤脸部区域模糊的图片。动作去重阈值：过滤画面过于相似的图片，数值越小通常去重越严格。脸部/整体权重：决定综合评分更看重脸部还是整张画面，两项不能同时为 0。
这些参数会互相影响。输出太少时不要一次改很多项，建议每次只调一个参数并重新跑小样本。
氛围图数量
无正脸但有人体姿态的背影、侧身或局部画面，可以作为氛围图保留。该设置控制每款最多保留多少张氛围图。
智能裁剪人物居中
开启后，系统会在人物上方留白较多时，尝试把人物裁剪到更适合主图的构图。
裁剪触发/头顶留白 用于控制什么时候裁剪以及保留多少顶部空间；头顶留白值必须小于裁剪触发比例。裁剪名额 填 0 表示检查全部主图。
画质处理与废片保留
美肤提亮：轻微提亮画面并柔化人物皮肤。细节增强：增强衣物纹理，力度过大可能显得生硬。边缘锐化：让轮廓更清楚，过度锐化可能不自然。ImageMagick命令：边缘锐化使用的本地命令，正常安装后保持magick即可。锐化参数：控制锐化范围和力度，没有明确调图经验时保持默认。废片默认保留：保存模糊、雷同、没有人物或超过数量限制的图片，便于回看筛选原因。
第一次调试建议保留废片。确认规则稳定后，再根据磁盘空间决定是否关闭。
FFmpeg 命令和人物识别模型
这两项属于本地处理环境设置，正常安装后保持默认即可。只有任务中心明确提示找不到处理环境或模型文件时，才需要检查对应路径。
三个任务按钮有什么区别
扫描预估
只检查所选目录结构、视频数量和可处理商品，不生成候选图，也不要求先把正式抽帧参数全部调好。FFmpeg、人物识别模型等运行环境会在小样本或正式抽帧开始前检查。开始正式处理前建议先扫描一次。
小样本抽帧预览
按“小样本款式数”处理少量有视频的款式。每次预览都会在输出目录下新建独立的 小样本预览_日期_时间 文件夹，不会和正式结果混在一起，也不会覆盖上一次预览。
开始正式抽帧
处理根目录下所有符合条件的款式。正式处理前建议先确认小样本效果、输出目录和命名规则。
任务中心按商品显示真实数字进度；某款跳过或失败也会推进已处理数量并记录原因。同一个输出根目录同一时间只允许一个正式抽帧任务写入，避免两个任务互相覆盖。不同来源如果经过全编码或半编码后会写入同一个商品结果文件夹，任务会在开始前明确提示，要求先调整名称。
任务中断后怎样继续
再次点击“开始正式抽帧”时，系统会先检查是否存在同一批未完成任务：
继续上次进度（推荐）：结果图片仍完整的成功商品不会重复抽帧；处理中、失败或结果图片缺失的商品会从该款开头重新处理。放弃上次进度，从头开始：按当前设置重新处理全部商品。旧任务记录会保留供倒查。处理到每款商品时，只清理并重新生成该款对应的抽帧结果和废片目录，不会清空整个输出根目录，也不会删除或修改源视频。取消：不启动任务，不处理文件，也不会占用本次运行次数。
如果抽帧设置、来源目录、输出目录或源视频已经变化，为避免把两批结果混在一起，页面只允许从头开始或取消。任务还在运行时，请先到任务中心停止任务，再回到本页重新点击正式抽帧。电脑或软件重启后不会自行恢复运行，仍由你决定继续还是从头开始。
页面端必填规则：
原视频父目录：扫描、小样本和正式抽帧都必须选择。抽帧主图输出目录：小样本和正式抽帧必须选择，单独扫描目录时不要求。视频格式：默认已经全选；如果手动全部取消，继续操作时会提示至少选择一种。
缺少这些内容时，当前页面会一次汇总、标红对应字段并定位第一个缺项，不会等任务进入任务中心后再报错。
推荐操作步骤
- 按实际情况整理好1级、2级或3级视频目录。
- 选择
原视频父目录。 - 选择
来源目录结构；不确定时保持兼容1—3级目录结构。 - 选择独立的
抽帧主图输出目录。 - 选择设置模板、命名规则、图片尺寸和视频格式。
- 点击
扫描预估，确认识别到的商品和视频数量正确。 - 设置2到3个小样本商品，点击
小样本抽帧预览。 - 打开预览输出目录，检查主图、氛围图、保底图和废片。
- 必要时一次只调整一类筛选参数，再次预览。
- 效果满意后点击
开始正式抽帧。 - 到任务中心查看实时进度、完成摘要和失败原因。
处理结果保存在哪里
正式任务会在你选择的输出目录下，按全编码或半编码为每个款式建立结果文件夹：
抽帧主图输出目录
├─ 档口A-货号1001
│ ├─ 档口A-货号1001_01.jpg
│ ├─ 档口A-货号1001_氛围01.jpg
│ └─ 档口A-货号1001_保底01.jpg
├─ 档口B-货号2002
│ └─ ...
└─ 检测废片
├─ 档口A-货号1001
└─ 档口B-货号2002结果含义：
- 普通编号图片：主要候选图。
- 带
氛围：背影、侧身或局部氛围素材。 - 带
保底：严格筛选数量不足时补回的候选图。 检测废片：被清晰度、重复度、人物识别或数量规则淘汰的图片。
页面不再单独放“运行记录”和“历史结果”页签。任务的实时播报、成功与失败数量、失败原因、历史任务和详细日志统一在全局 任务中心 查看。
常见问题
扫描不到视频怎么办
依次检查：
- 是否选择了正确的原视频根目录。
来源目录结构是否和视频实际位置一致。- 视频是否位于所选根目录的1—3级固定位置；第4级及更深位置不会扫描。
- 1级平铺视频是否使用能识别商品编码的文件名。
- 视频格式是否已经勾选。
- 视频能否正常播放。
为什么小样本没有处理前几个文件夹
小样本按“包含可处理视频的款式”计数。没有视频或格式未勾选的文件夹会跳过，因此实际处理的可能不是按名称排序看到的前几个空文件夹。
为什么处理时间较长
常见原因包括视频较长、每秒抽帧数较高、慢放倍数较低、每款视频较多、输出尺寸较大，或者同时开启了裁剪和多种画质处理。
建议先用小样本确认设置，再处理整批。
为什么输出图很少或只有保底图
通常表示严格筛选后合格画面不足。可以检查视频本身是否模糊，并适当放宽整体清晰度、脸部清晰度、正脸严格度或动作去重规则。
保底图不是程序报错，而是系统为避免零结果补回的候选图，需要人工重点复核。
为什么输出图太多或动作重复
可以减少每秒抽帧数、降低每款最多视频数、减少主图上限，或让动作去重更严格。调整后先跑小样本对比。
为什么有些图片进入检测废片
常见原因有画面模糊、动作与已选图片太相似、数量超过上限，或综合评分较低。在人物穿搭模式下，没有识别到人物也会进入检测废片；在商品主体模式下，“没有人物”本身不会成为淘汰原因。
废片目录主要用于复核筛选过程，不代表任务失败。
为什么任务显示失败
任务中心会显示用户可理解的失败摘要。常见原因包括：
- 原视频父目录不存在。
- 没有可处理的直接子文件夹或视频。
- 没有选择任何视频格式。
- 输出目录未选择或位置不安全。
- 本地视频处理环境或人物识别模型不可用。
- 某款视频损坏，无法抽取画面。
- 全部款式都没有生成任何可用候选图。
某一个款式失败时，其它款式仍会继续处理；如果整批没有一个款式成功，任务会明确标记为失败。
云店Agent可以怎样帮助你
你可以这样问云店Agent：
帮我检查这批视频的目录结构能不能扫描。我只想先试 3 款，应该怎么设置？这次为什么只有保底图？帮我解释最近一次视频抽帧任务失败的原因。输出图动作太重复，建议先调整哪一个设置？云店Agent会优先查询本说明、当前页面设置和任务中心结果。正式处理整批前，它会优先建议扫描和小样本预览，不会替你忽略输出目录或任务失败信息。