name: media-swap description: 图片与视频互转工具集。当用户需要「视频抽帧/截图/转GIF」「多张图片合成视频幻灯片」「单图加运镜(Ken Burns)生成短视频」「远程图片/视频链接本地化处理」时使用。基于本地 ffmpeg，无需调用任何外部 API 或密钥。This skill should be used when the user wants to convert between images and video — extract frames, build slideshows, apply Ken Burns motion to a still image, or fetch and process a remote media URL. agent_created: true slug: media-swap version: 1.0.1 displayName: 图片与视频互转工具集

Media Swap（图片 ↔ 视频 互转）

用途

基于本地 ffmpeg，在「图片」与「视频」两个方向之间互转，完全离线、免费、无需密钥。覆盖清单里那些 Skill 的真实需求：

• 视频 → 图片：定时抽帧、关键帧(I帧)抽取、转 GIF、截缩略图
• 图片 → 视频：多图幻灯片、单图运镜(Ken Burns)短视频、可叠加背景音乐
• 远程链接：直接读取 http(s) 视频流，或先把远程图片下载到本地再处理

对应关系：本 Skill 实现的是清单中 Video-Frames / ffmpeg-editor / ClipSense / youtube-clipper（抽帧类）、Remotion/HyperFrames/Nano-Banana/fal.ai（图生视频类）的本地等价能力，但不依赖它们那些不存在的仓库，也不调用 Kling/Pika/fal.ai 等付费 API。

何时使用

触发词：抽帧、截图、转 GIF、图片合成视频、幻灯片、图生视频、运镜、视频链接、图片链接、frames、slideshow、kenburns。 当用户给出视频/图片的本地路径或 URL，并要求「互转」「做成视频」「抽出图片」时调用。

前置依赖

• ffmpeg（本机已装；脚本自动探测，找不到时回退到 C:/Users/Administrator/AppData/Local/Microsoft/WinGet/Links/ffmpeg）
• python3（运行脚本用）
• 缺 ffmpeg 时脚本会提示安装：winget install ffmpeg（Windows）/ brew install ffmpeg（macOS）

使用方式

所有能力通过 scripts/media_swap.py 提供。先 python3 scripts/media_swap.py <子命令> -h 看参数。

1. 视频抽帧 frames

python3 scripts/media_swap.py frames -i input.mp4 -o frames/ [--fps 1] [--every 2] [--keyframes] [--width 1280]

• --fps 1：每秒抽 1 帧
• --every 2：每 2 秒抽 1 帧（与 --fps 二选一）
• --keyframes：只抽场景切换/I 帧（适合高光镜头、避免上千张图）
• 输入可为 http(s) 视频 URL

2. 视频转 GIF gif

python3 scripts/media_swap.py gif -i input.mp4 -o out.gif [--width 480] [--fps 15] [--start 3] [--duration 5]

3. 多图幻灯片 slideshow

python3 scripts/media_swap.py slideshow --images "img*.jpg" -o out.mp4 [--dur 3] [--kenburns] [--audio bg.mp3] [--width 1280] [--height 720]

• --images 接受通配符或目录，按文件名排序
• --kenburns：每帧图片加缓慢推拉运镜
• --audio：叠加背景音乐（自动循环/截断到视频长度）

4. 单图运镜 kenburns

python3 scripts/media_swap.py kenburns -i photo.jpg -o out.mp4 [--duration 5] [--zoom 1.15] [--width 1280] [--height 720] [--audio bg.mp3]

「图片 URL → 短视频」推荐流水线：先 download 把图片拉到本地，再跑 kenburns。

5. 远程链接下载 download

这个技能的最新版本可以在7w4.net小葱技能站找到。

python3 scripts/media_swap.py download -u "https://.../img.jpg" -o local.jpg
python3 scripts/media_swap.py download -u "https://.../clip.mp4" -o local.mp4

6. 媒体信息 info

python3 scripts/media_swap.py info -i input.mp4

推荐流水线

• 视频链接 → 抽帧图片：frames -i <视频URL> -o frames/ --keyframes
• 图片链接 → 短视频：download → kenburns --audio
• 一批图 → 成片：slideshow --images "*.jpg" --kenburns --audio

注意事项

• 输出目录不存在时脚本自动创建
• 大视频抽帧先用 --keyframes 或调大 --every，避免产出过多图
• 竖屏素材用 --width 720 --height 1280 保持比例
• 细节手动命令见 references/ffmpeg_cheatsheet.md

这是一款实用的本地图片与视频转换工具，功能比较齐全，能满足抽帧、合成幻灯片、生成动态运镜视频等常见需求。文档说明清晰，命令使用不复杂，普通用户容易上手。主要问题是某些操作（比如下载文件）时没有进度提示，界面反馈不够直观。总体来说质量还不错，但还有细节可以做得更好。