菜单
媒体处理工具集（基于 ffmpeg）。当用户需要视频转码、格式转换、压缩到指定大小、调整分辨率/帧率、添加 Logo 或图片水印、设置水印位置/尺寸/透明度、追加片头片尾、音频处理、视频裁剪/剪辑、合并/拼接、修复 m3u 下载损坏视频（faststart/moov atom）时使用。支持品牌视频一体化生成、目标 MB 两遍编码、H.264/H.265/AV1/VP9 批量转码、无损裁剪与合并、mp4 moov 前置修复。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
AI 图片生成与编辑。使用统一 CLI 调用 OpenAI Images、Google Gemini 原生图片 API、火山方舟 Seedream，支持多参考图、mask、批量生成、透明背景后处理，以及 Seedream 5.0 Pro 点选/框选式连续交互编辑。当用户提到生成图片、画图、封面图、配图、AI 生图、改图、修图、参考图编辑、Gemini 生图、Seedream 或交互编辑时使用。
为 Sorb 的 Seedance 2.0 视频生成分析图片或参考视频，编写和优化中文视频提示词、图生视频方案、运镜设计、分镜板、首帧建议、长视频分段方案与剪辑节奏。用户明确提到 Seedance 2.0、图生视频、参考视频复刻、运镜、分镜、首尾帧、视频延长或长视频规划时使用；不要为普通图片生成或与 Seedance 无关的视频任务触发。
下载视频工具。处理抖音短链、抖音作品页、微信视频号 SPH 分享链接，以及 yt-dlp 支持的网站视频下载。 触发场景： - 用户发来视频链接并要求”下载这个视频” - 用户要求下载抖音视频、图文、封面、音乐、JSON、评论 - 用户要求下载 YouTube、Bilibili、X、TikTok 等 yt-dlp 支持站点的视频 - 用户要求下载 weixin.qq.com/sph/ 格式的微信视频号分享链接 - 用户提到”yt-dlp””douyin-downloader””视频下载””抖音短链” - 用户要求获取抖音热搜榜或搜索抖音作品 - 用户要求刷新抖音 Cookie - 用户要求刷新微信视频号或腾讯元宝 Cookie
将本地图像和视频上传到 Immich 服务器，支持批量上传、管理 Album 和公开链接。网络资源下载由 video-downloader 负责；当用户提到"上传到 Immich"、"上传图片"、"备份照片"、"上传视频"、"下载视频并上传 Immich"时使用此技能。
从静态图片中提取前景元素并分离 UI 组件，支持棋盘格背景去除、绿幕/蓝幕/白幕/黑幕关键色抠图、透视校正。当用户说"提取 UI 元素"、"分离组件"、"去除背景"、"棋盘格背景"、"绿幕抠图"、"checkerboard 抠图"、"抠图"时使用。
从视频中提取帧生成 spritesheet 和独立透明 PNG。当用户说"制作 spritesheet"、"视频转精灵图"、"提取动画帧"、"sprite sheet"、"循环动画"时使用。
| 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（无损、极快），不重新编码