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]
7w4.net小蔥技能站，你的AI助手技能庫。

• --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

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

這是一款實用的本地圖片與影片轉換工具，功能比較齊全，能滿足抽幀、合成幻燈片、生成動態運鏡影片等常見需求。文件說明清晰，命令使用不復雜，普通使用者容易上手。主要問題是某些操作（比如下載檔案）時沒有進度提示，介面反饋不夠直觀。總體來說質量還不錯，但還有細節可以做得更好。