Menu
媒体处理工具集（基于 ffmpeg）。当用户需要视频转码、格式转换、压缩到指定大小、调整分辨率/帧率、添加 Logo 或图片水印、设置水印位置/尺寸/透明度、追加片头片尾、音频处理、视频裁剪/剪辑、合并/拼接、修复 m3u 下载损坏视频（faststart/moov atom）时使用。支持品牌视频一体化生成、目标 MB 两遍编码、H.264/H.265/AV1/VP9 批量转码、无损裁剪与合并、mp4 moov 前置修复。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | media-use |
| description | 媒体处理工具集（基于 ffmpeg）。当用户需要视频转码、格式转换、压缩到指定大小、调整分辨率/帧率、添加 Logo 或图片水印、设置水印位置/尺寸/透明度、追加片头片尾、音频处理、视频裁剪/剪辑、合并/拼接、修复 m3u 下载损坏视频（faststart/moov atom）时使用。支持品牌视频一体化生成、目标 MB 两遍编码、H.264/H.265/AV1/VP9 批量转码、无损裁剪与合并、mp4 moov 前置修复。 |
基于 ffmpeg 的媒体处理工具集，提供 5 个独立 CLI：转码、品牌包装、裁剪、合并、修复。
cd media-use/scripts
uv sync
所有命令通过 uv run <工具> 执行。依赖：Python 3.13+、ffmpeg / ffprobe（需预先安装）。
多种编码格式 + GPU 硬件加速，支持递归、并行、预览。
# 转码为 H.264 4Mbps，音频直接复制
uv run ffmpeg_batch /path/to/source /path/to/target -vc h264 -vb 4M
# NVIDIA GPU 加速转码 H.265
uv run ffmpeg_batch /path/to/source /path/to/target -vc hevc-nvenc -vb 5M --hwaccel-decode
# 查看支持的编码器
uv run ffmpeg_batch --list-codecs
常用参数：-vc/--video-codec、-ac/--audio-codec、-vb/--video-bitrate、
-ab/--audio-bitrate、--hwaccel-decode、-s/--suffix、-r/--recursive、
-e/--ext、-j/--jobs、--dry-run、--list-codecs。
为单个视频添加图片水印、追加片尾，并统一输出尺寸、帧率和编码。设置
--target-mb 时自动按主视频与片尾总时长计算码率，使用 H.264 两遍编码并预留
5% 封装余量；若第一次结果仍超出目标，会自动降低视频码率重试一次。
# 480P / 30fps，左下角半透明 Logo，并追加片尾
uv run ffmpeg_brand input.mp4 \
--watermark logo.png \
--outro outro.mp4 \
--height 480 --fps 30 \
--watermark-position bottom-left \
--watermark-width 15% \
--watermark-opacity 0.45 \
-o output.mp4
# 控制在 20MB 内；长视频可降低帧率与音频码率
uv run ffmpeg_brand input.mp4 \
--watermark logo.png \
--outro outro.mp4 \
--target-mb 20 \
--height 480 --fps 20 \
--audio-bitrate 64k \
--preset slow \
-o output_under20mb.mp4
常用参数：-w/--watermark、--outro、-o/--output、--target-mb、
-vb/--video-bitrate、-ab/--audio-bitrate、--height、--width、--fps、
--watermark-width（像素或百分比）、--watermark-opacity、
--watermark-position、--watermark-scope main|all、--margin、--preset、
--dry-run、--non-interactive。
--watermark-scope main，水印只覆盖主视频，追加的片尾保持原样；使用
--watermark-scope all 可覆盖完整成片。用 -c copy 裁剪片段（不重新编码）。-s/--start 与 -e/--end 至少指定其一：
省略 -s 表示从开头开始，省略 -e 表示裁剪到末尾。
uv run ffmpeg_cut input.mp4 -s 00:01:30 -e 00:03:15 -o clip.mp4 # 指定起止
uv run ffmpeg_cut input.mp4 -s 10 # 从 10s 裁到末尾
uv run ffmpeg_cut input.mp4 -e 25 # 从开头裁到 25s
参数：-s/--start、-e/--end（均支持 HH:MM:SS.ms / MM:SS / 秒数，二者至少传一个）、
-o/--output（默认 <stem>_cut.<ext>）、--dry-run。
注意：流复制裁剪的起点会对齐到最近的关键帧，开头可能偏差几秒； 输出时长以「结束 − 起始」为准。
将编码一致的视频文件合并为一个（concat demuxer + -c copy）。
uv run ffmpeg_merge part1.mp4 part2.mp4 -o merged.mp4
uv run ffmpeg_merge list.txt -o merged.mp4 # 也可传 concat 列表文件
参数：位置参数 ≥2 个文件（或单个 .txt 列表）、-o/--output（默认 merged.mp4）、
--dry-run。合并前自动用 ffprobe 校验编码 / 分辨率一致性，不一致时打印警告。
将 moov atom 移至文件头（faststart），修复 m3u 下载导致无法流式播放的 mp4。
uv run ffmpeg_fix broken.mp4 -o fixed.mp4 # 单文件
uv run ffmpeg_fix ./downloads -o ./fixed -e mp4 # 文件夹批量
参数：SOURCE（文件或文件夹）、-o/--output、-e/--ext（默认 mp4）、--dry-run。
底层：ffmpeg -i <input> -c copy -movflags +faststart <output>
-c copy（无损、极快），不重新编码将本地图像和视频上传到 Immich 服务器，支持批量上传、管理 Album 和公开链接。网络资源下载由 video-downloader 负责；当用户提到"上传到 Immich"、"上传图片"、"备份照片"、"上传视频"、"下载视频并上传 Immich"时使用此技能。
下载视频工具。处理抖音短链、抖音作品页、微信视频号 SPH 分享链接，以及 yt-dlp 支持的网站视频下载。 触发场景： - 用户发来视频链接并要求”下载这个视频” - 用户要求下载抖音视频、图文、封面、音乐、JSON、评论 - 用户要求下载 YouTube、Bilibili、X、TikTok 等 yt-dlp 支持站点的视频 - 用户要求下载 weixin.qq.com/sph/ 格式的微信视频号分享链接 - 用户提到”yt-dlp””douyin-downloader””视频下载””抖音短链” - 用户要求获取抖音热搜榜或搜索抖音作品 - 用户要求刷新抖音 Cookie - 用户要求刷新微信视频号或腾讯元宝 Cookie
AI 图片生成与编辑。使用统一 CLI 调用 OpenAI Images、Google Gemini 原生图片 API、火山方舟 Seedream，支持多参考图、mask、批量生成、透明背景后处理，以及 Seedream 5.0 Pro 点选/框选式连续交互编辑。当用户提到生成图片、画图、封面图、配图、AI 生图、改图、修图、参考图编辑、Gemini 生图、Seedream 或交互编辑时使用。
为 Sorb 的 Seedance 2.0 视频生成分析图片或参考视频，编写和优化中文视频提示词、图生视频方案、运镜设计、分镜板、首帧建议、长视频分段方案与剪辑节奏。用户明确提到 Seedance 2.0、图生视频、参考视频复刻、运镜、分镜、首尾帧、视频延长或长视频规划时使用；不要为普通图片生成或与 Seedance 无关的视频任务触发。
从静态图片中提取前景元素并分离 UI 组件，支持棋盘格背景去除、绿幕/蓝幕/白幕/黑幕关键色抠图、透视校正。当用户说"提取 UI 元素"、"分离组件"、"去除背景"、"棋盘格背景"、"绿幕抠图"、"checkerboard 抠图"、"抠图"时使用。
从视频中提取帧生成 spritesheet 和独立透明 PNG。当用户说"制作 spritesheet"、"视频转精灵图"、"提取动画帧"、"sprite sheet"、"循环动画"时使用。