一、功能介绍
批量视频抽帧用于从一个文件夹中的 MP4、MOV 视频按固定时间间隔提取 PNG 图片。适合制作视频截图、素材帧、内容审核样本、商品视频画面和后续图像处理素材。
插件支持：
识别
.mp4和.mov，扩展名大小写均可。扫描当前视频文件夹，或同时扫描所有子文件夹。
选择文件夹或把视频、文件夹拖入操作页。
按
0.1秒精度设置抽帧间隔，默认每1.0秒提取一张。把图片保存到自选文件夹、视频所在文件夹，或覆盖视频旁同名目录中的编号 PNG。
按视频顺序逐个处理，并显示等待中、处理中、已暂停、已完成、失败和已取消状态。
立即暂停当前 FFmpeg 进程；继续时从已生成的连续图片编号接续。
取消整个批次；单个视频失败时继续处理后续视频。
所有处理都在本机完成，不会上传视频或图片。插件不会修改、移动或删除源视频。
二、使用前准备
安装并启用“批量视频抽帧”插件。
准备包含 MP4 或 MOV 视频的文件夹。
如果使用默认输出模式，准备一个用于保存 PNG 图片的文件夹。
确认当前 Windows 账号能够读取视频文件夹，并能写入所选输出位置。
确认工具箱已安装插件绑定的
ffmpeg.exe和ffprobe.exe外部资源。资源缺失时插件会拒绝启动，不会改用系统 PATH 中的其它程序。使用“覆盖视频目录中的图片”前，先确认视频旁同名目录中的旧 PNG 是否仍需保留。
三、操作页说明
1. 视频文件夹
选择待处理视频所在的根文件夹。可使用以下方式：
点击右侧“选择”按钮。
把视频文件夹拖到输入区域。
把 MP4、MOV 视频或包含这些视频的文件夹拖到文件列表区域。
拖入多个视频时，它们必须能够归入同一个视频根目录；跨盘或没有共同目录的输入会被拒绝。
2. 图片输出文件夹
默认输出模式下，选择所有图片的保存根目录。插件会在其中按视频相对路径建立同名子文件夹。
开启“保存到视频文件夹”或“覆盖视频目录中的图片”后，该输入框会禁用，因为输出位置由视频路径决定。
3. 包含子文件夹
关闭：只加载视频文件夹第一层的 MP4、MOV。
开启：同时扫描所有下级文件夹。
切换该开关后，插件会按当前视频文件夹重新加载列表。
4. 操作按钮
加载文件：按当前视频文件夹和递归设置重新扫描。
开始抽帧：按列表顺序逐个生成 PNG，使用“配置”页当前保存的抽帧间隔和输出模式。
暂停：立即停止当前 FFmpeg 尝试，并保留已经完整写出的连续 PNG。
继续：从现有连续编号后的下一张继续当前视频。
取消：二次确认后停止当前进程，并把当前及等待中的视频标记为已取消。
清空：只清空页面列表，不删除视频或已生成图片。
5. 文件列表
列表显示视频相对路径、进度和状态。点击顶部状态筛选按钮可筛选总数、等待中、处理中、已暂停、已完成、失败和已取消项。
任务未运行时，可以右键单个列表项并选择“移除”。此操作只移除当前队列记录，不删除磁盘上的视频。
四、配置页说明
抽帧间隔和输出模式只在“配置”页设置，避免与操作页重复。修改后会立即同步到当前操作列表和下一次任务；插件也会自动保存当前标签页、输入目录、输出目录、递归开关、抽帧间隔、输出模式和列表分页数量。
1. 抽帧间隔
默认值：
1.0秒。最小值：
0.1秒。调整步长：
0.1秒。
2. 保存到视频文件夹
每个视频旁建立一个与视频主文件名相同的图片目录。若该目录已经存在且非空，会自动依次尝试 _1、_2 等新目录，不覆盖旧内容。
3. 覆盖已有图片
输出固定为视频旁的同名目录，只清理其中的六位编号 PNG，例如 000001.png；不会删除其它文件、子文件夹或修改源视频。如果同一目录中同时存在同名 .mp4 和 .mov，插件会在启动前拒绝该批次，防止互相覆盖。
两个输出模式开关互斥，打开一个会自动关闭另一个。
五、标准操作步骤
默认输出到自选文件夹
打开“批量视频抽帧”。
选择“视频文件夹”。
根据需要开启“包含子文件夹”。
点击“加载文件”，核对列表。
选择“图片输出文件夹”。
打开“配置”页设置抽帧间隔。
确认两个输出模式开关都处于关闭状态。
点击“开始抽帧”。
等待列表中的视频变为“已完成”。
打开图片输出文件夹检查 PNG。
输出到每个视频旁
选择视频文件夹并加载视频。
在“配置”页开启“保存到视频文件夹”。
按需要调整抽帧间隔。
返回“操作”页，点击“开始抽帧”。
在每个视频旁查看同名图片目录；已有非空目录时查看带
_1、_2后缀的新目录。
覆盖视频旁已有编号图片
备份仍需保留的旧编号 PNG。
选择视频文件夹并加载视频。
在“配置”页开启“覆盖视频目录中的图片”。
返回“操作”页，点击“开始抽帧”。
确认视频旁同名目录中的六位编号 PNG 已更新，源视频仍保持原样。
六、输入与输出规则
支持的输入
MP4：
.mp4、.MP4等大小写形式。MOV：
.mov、.MOV等大小写形式。不支持 AVI、MKV、WMV、音频文件或图片文件。
文件扩展名只是初步筛选。ffprobe 无法读取视频流或时长时，该视频会标记为失败，队列继续处理下一个视频。
输出格式与名称
输出固定为 PNG，不提供 JPG、质量、缩放或分辨率设置。每个视频的图片从六位编号开始：
000001.png
000002.png
000003.png
默认输出目录规则
假设：
视频根目录：D:\视频素材
视频：D:\视频素材\产品A\展示.mp4
图片输出文件夹：E:\抽帧结果
默认模式输出为：
E:\抽帧结果\产品A\展示\000001.png
E:\抽帧结果\产品A\展示\000002.png
如果 E:\抽帧结果\产品A\展示 已存在且非空，本次会使用 展示_1；该目录也占用时继续使用 展示_2。
视频文件夹输出规则
同一个视频在“保存到视频文件夹”模式下输出为：
D:\视频素材\产品A\展示\000001.png
已有非空 展示 目录时自动使用 展示_1，不会把新图片混入旧目录。
七、暂停、继续与取消
暂停
点击暂停后，插件会立即终止当前 FFmpeg 尝试。已经完整写出的连续 PNG 保留；不完整的尾部文件和连续编号之后的异常尾部图片会清理。当前项显示“已暂停”。
继续
点击继续后，插件根据现有的 000001.png、000002.png 等连续完整图片计算下一编号和视频时间点，再启动新的 FFmpeg 进程接续。已有连续图片不会重新生成。
暂停或取消瞬间可能恰好有一张图片尚未完整写入，该不完整文件会被清理，因此继续后的最终数量可能与从头一次完成存在一个时间点内的边界差异；编号仍保持连续。
取消
点击取消并确认后：
当前 FFmpeg/ffprobe 进程立即终止。
当前视频和所有等待视频标记为“已取消”。
已经完整生成的 PNG 保留。
源视频不受影响。
返回插件列表、切换插件或退出工具箱时，如果任务仍在运行，工具箱会提示未完成任务。确认离开后，宿主会强制停止插件后台进程。
八、失败处理
某个视频失败不会终止整批任务。常见失败原因：
视频损坏或不包含可读取的视频流。
ffprobe 无法读取有效时长。
视频、输出目录没有读取或写入权限。
任务运行期间视频或文件夹被移动、改名或删除。
FFmpeg 或 ffprobe 外部资源缺失。
覆盖模式检测到同名 MP4、MOV 的输出目录冲突。
磁盘空间不足。
把鼠标移到失败项的状态或进度区域，可以查看具体失败信息。错误也会写入工具箱统一 error.log，便于排查。
九、常见问题
1. 文件列表为空
检查视频是否为 MP4 或 MOV；如果视频只在子文件夹中，请开启“包含子文件夹”；同时确认当前账号有读取权限。
2. 点击开始提示 FFmpeg 或 ffprobe 不可用
该插件依赖后台绑定的 ffmpeg.exe 和 ffprobe.exe。请重新安装已正确绑定资源的插件版本，或联系管理员检查资源绑定和下载完整性。
3. 为什么没有 JPG 选项
本插件按参考功能固定输出 PNG，保证无损画面和连续编号。本次不提供 JPG、质量、尺寸或并发设置。
4. 为什么生成了 _1 文件夹
非覆盖模式不会把新图片混入已有非空目录。检测到同名目录已有内容时会自动使用 _1、_2 等目录。
5. “覆盖视频目录中的图片”会覆盖视频吗
不会。它只清理并重新生成视频旁同名目录中的六位编号 PNG，不会写入或替换 MP4、MOV 文件。
6. 为什么暂停后已有图片仍在
暂停用于稍后继续，完整 PNG 会保留。继续时依靠这些图片确定下一个编号，避免从头重复处理。
7. 为什么某个失败后下一个视频仍开始处理
插件按批量任务设计：单个视频失败只记录该项错误，后续视频继续处理。需要停止全部任务时使用“取消”。
十、风险与注意事项
覆盖模式会删除视频旁同名目录中的六位编号 PNG。重要图片请先备份。
处理期间不要移动、改名或删除视频、视频根目录和输出目录。
抽帧间隔越小，图片数量、磁盘占用和处理时长越大；长视频建议先用少量样本验证。
确保目标磁盘有足够空间，PNG 通常比有损图片占用更多空间。
不要把默认输出目录放在会被其它同步或清理程序频繁修改的位置。
强制离开或取消会保留已经完整生成的 PNG，但未完成批次不会自动恢复；重新开始非覆盖模式会创建新的避让目录。
抽帧在本机完成，不提供上传、云端保存、视频预览、图片编辑或联网下载视频功能；首次授权取钥仍需联网。