name: video-auto-editor description: "影片剪輯自動化處理工具。支援本地影片擷取、字幕生成(Whisper)、字幕嵌入、影片拼接、格式轉換/縮放、新增水印、音訊提取/替換、直播切片、JSON工作流編排等功能。適用於錄屏後期、直播回放切片、短影片批次處理等場景。" author: WorkBuddy agent_created: true commands: - trim: "擷取影片片段 (需指定 start/end/duration)" - subtitle: "Whisper語音識別生成SRT字幕" - burn: "將SRT字幕硬編碼嵌入影片" - concat: "拼接多個影片檔案" - convert: "格式轉換/解析度縮放" - watermark: "疊加圖片水印" - audio: "提取音訊檔案" - replace-audio: "替換或混合影片音訊" - slice: "直播回放按時長切分" - workflow: "從JSON配置批次執行多步驟"

影片剪輯自動化處理技能 (video-auto-editor)

前置條件

必要依賴

1. FFmpeg — 核心影片處理引擎
2. Windows: 下載後加入 PATH，或放在 ~/.workbuddy/binaries/ffmpeg/bin/
3. 驗證: ffmpeg -version

4. 本技能預設查詢的系統 PATH 中的 ffmpeg

5. Python 3.8+ 及以下包: bash pip install openai-whisper moviepy pillow

可選依賴

• openpyxl — 如需寫入Excel格式報告

用法

命令列方式

# 環境檢查
python scripts/video_auto_editor.py check

# 檢視影片資訊
python scripts/video_auto_editor.py info input.mp4

# 擷取片段
python scripts/video_auto_editor.py trim input.mp4 -s 00:05:00 -e 00:10:00 -o clip.mp4

# 生成字幕(Whisper)
python scripts/video_auto_editor.py subtitle input.mp4 --model base

# 嵌入字幕
python scripts/video_auto_editor.py burn input.mp4 -s input.srt -o output.mp4

# 拼接影片
python scripts/video_auto_editor.py concat "video1.mp4,video2.mp4" -o merged.mp4

# 格式轉換
python scripts/video_auto_editor.py convert input.mp4 -o output.mp4 -r 1920x1080

# 新增水印
python scripts/video_auto_editor.py watermark input.mp4 logo.png -o output.mp4

# 提取音訊
python scripts/video_auto_editor.py audio input.mp4 -f mp3

# 替換音訊
python scripts/video_auto_editor.py replace-audio video.mp4 audio.mp3 -o output.mp4 --mix

# 直播切片(每5分鐘一段)
python scripts/video_auto_editor.py slice input.mp4 -d 300 -o ./clips/

# JSON工作流(批次執行多步驟)
python scripts/video_auto_editor.py workflow config.json

Python API 方式

from scripts.video_auto_editor import (
    check_ffmpeg, get_video_info,
    trim_video, generate_subtitles, burn_subtitles,
    concat_videos, convert_video,
    add_watermark, add_intro_outro,
    extract_audio, replace_audio,
    live_slice, live_slice_by_markers,
    run_from_json
)

# 檢視資訊
info = get_video_info("input.mp4")
print(info)

# 擷取
trim_video("input.mp4", "clip.mp4", start_time="00:05:00", end_time="00:10:00")

# 字幕生成+嵌入
generate_subtitles("input.mp4", model_size="base")
burn_subtitles("input.mp4", "output.mp4", "input.srt")

工作流配置 (JSON)

通過 workflow 命令可批次執行多步驟流水線:

{
  "input": "input_video.mp4",
  "output": "output/final.mp4",
  "work_dir": "output",
  "steps": [
    {"action": "trim", "params": {"start": "00:05:00", "end": "00:10:00"}},
    {"action": "subtitle", "params": {"model": "base"}},
    {"action": "burn_subtitle", "params": {"font_size": 28}},
    {"action": "convert", "params": {"resolution": "1920x1080", "bitrate": "5M"}},
    {"action": "watermark", "params": {"image": "logo.png", "position": "top-right"}},
    {"action": "extract_audio", "params": {"format": "mp3"}}
  ]
}
想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

安全說明

• 本工具僅操作本地影片檔案，不聯網、不上傳資料
• Whisper 語音識別為本地模型，音訊資料不出本機
• 所有 FFmpeg 命令僅作用於使用者指定的檔案路徑，不涉及系統級操作
• 請確保輸入檔案來源可信，避免處理惡意構造的媒體檔案