video-splitter-skill 是做什么的?
本地 Codex 技能及 localhost 工具,基于 FFmpeg 按时长或目标大小拆分大视频。
概述
此技能为本地 Codex agent skill,集成在 localhost 环境中,通过 FFmpeg 实现视频拆分功能。用户可指定拆分方式(按时长或按目标文件大小),并将大型视频文件分割成更小的片段,便于处理、传输或存储。
功能特点
- 按时长拆分:将视频平均分成指定时长的片段(例如每 30 秒一段)。
- 按目标大小拆分:根据预期的输出文件大小估算拆分点(例如每段 50 MB)。
- 本地执行:所有操作在本地完成,无需上传至云端,保护隐私。
- 依赖 FFmpeg:确保系统中已安装 FFmpeg 并添加到 PATH。
使用方法
- 在 Codex agent 中加载此技能。
- 提供输入视频文件路径。
- 选择拆分方式并设置参数(时长或目标大小)。
- 技能自动调用 FFmpeg 生成拆分后的片段。
参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
--input | 字符串 | 输入视频文件的路径(必需) |
--mode | 字符串 | 拆分模式:duration 或 size(必需) |
--value | 数字 | 拆分值:时长(秒)或目标大小(MB)(必需) |
--output-dir | 字符串 | 输出目录(可选,默认为输入文件所在目录) |
--format | 字符串 | 输出视频格式(可选,默认保持原格式) |
示例
按时长拆分(每 30 秒一段)
codex run split-video --input big_video.mp4 --mode duration --value 30
按目标大小拆分(每段约 50 MB)
codex run split-video --input large_video.mkv --mode size --value 50
指定输出目录
codex run split-video --input clip.avi --mode duration --value 60 --output-dir ./segments
环境要求
- 支持 Codex 的 AI agent 环境
- 已安装 FFmpeg 并配置好 PATH
- 操作系统:macOS、Linux 或 Windows(需支持 shell 命令)
注意事项
- 按目标大小拆分是估算值,实际输出文件大小可能略有偏差。
- 输入视频需具有正确的时长信息,否则 FFmpeg 可能无法正常工作。
- 确保有足够的磁盘空间存放中间文件。
许可
MIT License