前言¶
做竖屏混剪、素材号或批量出片时，常见流程是：先按分辨率筛一批源片，再手工截取多段、拼接、去原声、叠 Logo、换背景音乐，最后按数量重复。步骤多且随机性（片段、音乐）不好复现。下面介绍的 video-merger 是 SkillHub 社区 Skill（@user_aa378cba/video-merger-pro，v1.0.2），把「筛分辨率 → 随机选段 → 合并 → 透明 Logo → 随机 BGM → 批量输出」写成 Agent 可执行的说明，并附带 helpers/generate_videos.py 供命令行直接跑。无需 API Key（requires_api_key=false）。
这是什么¶
video-merger 面向 design-media 类视频后期：从指定目录扫描视频，只保留与目标宽高一致的分辨率，为每条成片随机挑选若干片段与一首背景音乐，合并后底部居中叠加 Logo（取 Logo 目录中第一个图片），去掉原声，按数量批量导出 video_01.mp4、video_02.mp4 等文件。
维护方为社区发布者 user_aa378cba，来源标注为 community。SkillHub 页面当前版本为 1.0.2。
核心功能¶
以下能力均来自 Skill 自带的 SKILL.md 与辅助脚本说明：
- 按
video_width/video_height筛选源视频（依赖 ffprobe 读分辨率）。 - 从
music_dir随机选背景音乐；支持 mp3、wav、aac、m4a、flac。 - 每个成片随机选择片段数量与每段时长（可配置区间），从源视频中截取后合并。
- 使用
logo_dir中第一个 png/jpg/jpeg/bmp 作为透明水印（文档建议 Logo 用透明 PNG），叠在画面底部居中。 - 去除原视频音轨，仅保留所选 BGM。
- 通过
video_count控制批量生成条数（默认 10）。
运行依赖系统已安装 ffmpeg 与 ffprobe。
安装与启用¶
安装 SkillHub CLI¶
若尚未安装，可先检查版本：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 video-merger¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install video-merger-pro --namespace user_aa378cba --dir <你的 skills 目录>
常见路径示例（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示交给 AI，让其按官方安装说明拉取该 Skill：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_aa378cba/video-merger-pro`。
典型用法¶
在对话里指定参数¶
向 Agent 说明使用 video-merger，并给出目录与分辨率。必填项：video_source、video_width、video_height、logo_dir、music_dir、output_dir。
示例（基本）：
使用 video-merger 生成视频：
- 视频源目录: D:\videouse
- 视频分辨率: 720x1280
- Logo目录: D:\workspace
- 音乐目录: D:\workspace\music
- 输出目录: D:\videouse\output
- 视频数量: 10
可选参数包括：video_count（默认 10）、min_clips / max_clips（默认每片 3–5 段）、min_duration / max_duration（默认每段 3–5 秒）。完整参数表见 Skill 内 SKILL.md。
命令行调用辅助脚本¶
在已安装 Skill 的目录下，可直接运行 helpers/generate_videos.py（Linux/macOS 路径分隔符与 Windows 示例不同，按本机路径替换）：
python helpers/generate_videos.py \
--video-source /path/to/videos \
--video-width 720 \
--video-height 1280 \
--logo-dir /path/to/logos \
--music-dir /path/to/music \
--output-dir /path/to/output \
--video-count 10
文档中的工作流程概括为：扫描源目录 → 分辨率筛选 → 扫描音乐与 Logo → 为每条成片随机选段与 BGM → ffmpeg 截取与合并 → 叠 Logo 与配乐 → 写入 output_dir。
适用场景与注意¶
适合：已有大量同分辨率竖屏（或固定宽高）素材，需要快速批量产出多条「随机剪辑 + 统一 Logo + 换 BGM」的成片，且愿意用 ffmpeg 管线而非非线性剪辑软件手工操作。
注意：
- 分辨率不匹配的文件会被直接丢掉，源片需事先统一或接受筛选结果。
- Logo 仅使用目录中第一个匹配扩展名的图片，多 Logo 时需自行整理目录顺序。
- 原声一律去除；若需保留对白或环境音，本 Skill 不适用。
- 随机片段与音乐每次运行结果不同，若要可复现需自行改脚本或固定随机种子（当前 Skill 文档未提供种子参数）。
- SkillHub 页面对该 Skill 标注下载约 637 次、评分 100000（站内展示口径），安装前可在页面确认版本与坐标。
结尾¶
video-merger 把混剪里重复性最高的「筛片、切片、合并、水印、配乐、批量导出」收敛成一套参数化流程，适合交给 Agent 填路径与数量，或在本地用 generate_videos.py 跑批。官方入口与坐标：
- SkillHub 页面：https://www.skillhub.cn/skills/user_aa378cba/video-merger-pro
- API 坐标：https://api.skillhub.cn/user_aa378cba/video-merger-pro
- 安装坐标：
@user_aa378cba/video-merger-pro（v1.0.2）
