功能描述

使用 FFmpeg 进行多媒体编辑，包括视频剪辑、拼接、转码、特效、截图、水印、变速、音频处理等 20 种操作。当用户提到"FFmpeg""视频剪辑""视频拼接""视频压缩""视频格式转换""截图""水印""变速""倒放""GIF""音频提取""音频降噪""音量调节""画中画""裁剪""旋转""字幕""过渡特效"...

使用说明 (SKILL.md)

FFmpeg 多媒体编辑工具箱

Name: ffmpeg剪辑大师
Author: showtimewalker

使用 FFmpeg 对本地视频和音频文件进行编辑处理，支持 20 种常用操作。本 Skill 不调用任何外部 API，所有处理在本地完成。

适用场景：

用户需要对视频文件进行剪辑、拼接、转码、压缩、加特效等操作
用户需要从视频中提取音频、截图、获取首尾帧
用户需要添加字幕、水印、画中画等叠加效果
用户需要音频拼接、提取、降噪、音量调节
用户需要进行视频和 GIF 之间的转换
用户需要变速（慢动作/加速）、倒放、分段拆分

使用脚本

脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。

设 FFMPEG_SKILL_DIR 为 .claude/skills/ffmpeg-multimedia-editing 的绝对路径。

视频操作

功能	脚本	关键参数
字幕	`video_subtitle.py`	`--input`, `--subtitle \x3Csrt/ass>`, `--mode soft\|hard`
视频拼接	`video_concat.py`	`--inputs a.mp4 b.mp4 ...`
截图	`video_screenshot.py`	`--input`, `--time`, `--interval`, `--count`
获取首尾帧	`video_firstlast_frame.py`	`--input`
过渡特效	`video_transition.py`	`--inputs a.mp4 b.mp4`, `--type fade\|dissolve`, `--duration`
视频剪辑	`video_trim.py`	`--input`, `--start`, `--end`
格式转换	`video_convert.py`	`--input`, `--format webm`
压缩/缩放	`video_compress_scale.py`	`--input`, `--resolution 720p`, `--crf 28`
变速	`video_speed.py`	`--input`, `--speed 0.5`
水印	`video_watermark.py`	`--input`, `--watermark \x3Cimg>`, `--position top-right`
裁剪/旋转/翻转	`video_crop_rotate.py`	`--input`, `--crop WxH+X+Y`, `--rotate 90`, `--flip h\|v`
画中画	`video_pip.py`	`--main`, `--overlay`, `--position bottom-right`
倒放	`video_reverse.py`	`--input`
分段拆分	`video_split.py`	`--input`, `--segment-duration 60`
视频/GIF互转	`video_gif_convert.py`	`--input`, `--to gif\|mp4`
音画合成	`video_image_compose.py`	`--images \x3Cglob>`, `--duration 5`, `--audio`

音频操作

功能	脚本	关键参数
音乐拼接	`audio_concat.py`	`--inputs a.mp3 b.mp3 ...`
音频提取/替换	`audio_extract_replace.py`	`--input video.mp4`, `--extract-audio`
音量调节	`audio_volume.py`	`--input`, `--volume 1.5`, `--normalize`
音频降噪	`audio_denoise.py`	`--input`, `--strength medium`

快速调用

# 截图
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_screenshot.py --input video.mp4 --time 00:01:30

# 视频拼接
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_concat.py --inputs a.mp4 b.mp4 c.mp4

# 音频提取
uv run --python python $FFMPEG_SKILL_DIR/scripts/audio_extract_replace.py --input video.mp4 --extract-audio

# 字幕嵌入
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_subtitle.py --input video.mp4 --subtitle subs.srt

输出约定

本地输出目录：outputs/ffmpeg/\x3Coperation>/（相对于 OUTPUT_ROOT，默认为项目根目录）
所有脚本输出 JSON 至少包含：
- type — video / audio / image
- operation — 操作名称（如 subtitle, concat, trim）
- local_path — 输出文件路径
- input_path — 输入文件路径
- elapsed_seconds — 处理耗时

配置

依赖：ffmpeg（full build 8.1+）和 ffprobe，需在 PATH 中可用
环境变量：OUTPUT_ROOT（可选，输出根目录，支持 ~ 展开，默认为用户主目录）
无需环境变量或外部 API 密钥
所有操作在本地执行，不涉及网络传输

协作方式

本 skill 为独立工具，可直接完成所有多媒体编辑操作
不与 content_generation_workflow 集成，也不依赖 AI 生成能力
如果用户需要将编辑后的文件上传为公网链接，可后续调用 qiniu skill 处理

安全使用建议

This skill appears to do what it claims: run FFmpeg locally on files. Before installing or running it, consider: 1) Ensure you have trusted ffmpeg/ffprobe builds on PATH (the scripts expect full-featured ffmpeg). 2) Confirm what 'uv' is on your system (the README uses `uv run`) or run the scripts directly with your Python interpreter if you prefer. 3) Set OUTPUT_ROOT to a directory you control (not your entire home) to avoid unexpected files/logs being created in your home directory. 4) Inspect the common.py emit_result/emit_multi_result implementations (the provided excerpt was truncated) to verify they only write local JSON/logs and do not transmit data externally. 5) If you plan to run on sensitive files, test the skill in an isolated environment first and back up originals. Overall the codebase shows no apparent network exfiltration or unrelated credential requests.

功能分析

Type: OpenClaw Skill Name: ffmpeg-multimedia-editing Version: 1.0.0 The skill bundle provides a comprehensive set of multimedia editing tools using FFmpeg, but it contains several security vulnerabilities. Specifically, scripts like `video_watermark.py` and `video_subtitle.py` construct FFmpeg filter strings by interpolating user-provided arguments (such as `--text`, `--font-color`, and `--style`) without adequate sanitization, which could lead to FFmpeg filtergraph injection. Furthermore, `video_watermark.py` uses the `movie` filter with user-controlled paths, a known risk for unauthorized file access in FFmpeg. The scripts also specify an unusual requirement for a future Python version (`>=3.14`) in their metadata. While the behavior aligns with the stated purpose and lacks clear evidence of intentional malice, these vulnerabilities pose a risk if the agent is manipulated via prompt injection.

能力评估

✓ Purpose & Capability

Name/description (FFmpeg multimedia editing) match the included scripts and declared requirements. Required binaries (ffmpeg, ffprobe, python/py) are expected. The 'uv' binary is required by the SKILL.md examples (uv run ...) and is consistent with the provided quick-call instructions, though users unfamiliar with 'uv' should verify what that tool is.

✓ Instruction Scope

SKILL.md and the scripts consistently operate on local files using ffmpeg/ffprobe. The runtime instructions focus on running scripts in the skill directory and writing outputs locally; they explicitly state no external APIs or network transfer. The code validates inputs and uses temporary files for concat/palette generation and cleans them up.

✓ Install Mechanism

There is no install spec (no external downloads or installers). The skill ships Python scripts that are executed directly. No network-based installation or archive extraction is requested, which keeps install risk low.

ℹ Credentials

Only OUTPUT_ROOT is requested (optional; defaults to the user's home). The common code writes outputs and log files under OUTPUT_ROOT/outputs/ffmpeg and OUTPUT_ROOT/outputs/logs — this is appropriate for a file-processing tool but you should be aware it will create files under that directory by default. No API keys or unrelated credentials are requested.

✓ Persistence & Privilege

always: false and model invocation not disabled (normal). The skill does not request persistent platform-level privileges. It writes logs and outputs to its own subdirectories under OUTPUT_ROOT but does not modify other skills or system-wide configurations.

版本历史

v1.0.0

- 首个版本发布，提供基于 FFmpeg 的本地多媒体编辑工具箱 - 支持 20 项常用视频与音频操作：剪辑、拼接、转码、压缩、加字幕、水印、截图、画中画、变速、倒放、GIF 转换等 - 所有功能通过 Python 脚本调用，完全本地处理，无需外部 API - 标准输出格式，输出 JSON 包含文件类型、路径和耗时等信息 - 案例命令行演示，依赖 ffmpeg、ffprobe 和 Python - 输出文件统一保存在指定 outputs 目录

元数据

Slug ffmpeg-multimedia-editing

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

ffmpeg剪辑大师是什么？

使用 FFmpeg 进行多媒体编辑，包括视频剪辑、拼接、转码、特效、截图、水印、变速、音频处理等 20 种操作。当用户提到"FFmpeg""视频剪辑""视频拼接""视频压缩""视频格式转换""截图""水印""变速""倒放""GIF""音频提取""音频降噪""音量调节""画中画""裁剪""旋转""字幕""过渡特效"... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 182 次。

如何安装 ffmpeg剪辑大师？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install ffmpeg-multimedia-editing」即可一键安装，无需额外配置。

ffmpeg剪辑大师是免费的吗？

是的，ffmpeg剪辑大师完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

ffmpeg剪辑大师支持哪些平台？

ffmpeg剪辑大师跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 ffmpeg剪辑大师？

由王新平（Wang-Xin-ping）（@showtimewalker）开发并维护，当前版本 v1.0.0。

ffmpeg剪辑大师