Communitygithub.com

foongyq097/video-splitter-skill

本地 Codex 技能及 localhost 工具,基于 FFmpeg 按时长或目标大小拆分大视频。

video-splitter-skill 是什么?

这是一个专为本地 Codex 环境设计的 AI 技能(“agent skill”),允许开发者使用 FFmpeg 将大视频文件按指定时长或目标文件大小拆分为多个片段。该技能运行在 localhost 上,避免了上传到云端,适合处理敏感或大型媒体文件。它通过提供简单的指令接口,自动调用 FFmpeg 命令,支持多种常见视频格式,并可灵活调整拆分参数。适用于需要将长视频剪辑成小段、或者压缩大视频以便传输和存储的场景。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add foongyq097/video-splitter-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

video-splitter-skill 是做什么的?

本地 Codex 技能及 localhost 工具,基于 FFmpeg 按时长或目标大小拆分大视频。

概述

此技能为本地 Codex agent skill,集成在 localhost 环境中,通过 FFmpeg 实现视频拆分功能。用户可指定拆分方式(按时长或按目标文件大小),并将大型视频文件分割成更小的片段,便于处理、传输或存储。

功能特点

  • 按时长拆分:将视频平均分成指定时长的片段(例如每 30 秒一段)。
  • 按目标大小拆分:根据预期的输出文件大小估算拆分点(例如每段 50 MB)。
  • 本地执行:所有操作在本地完成,无需上传至云端,保护隐私。
  • 依赖 FFmpeg:确保系统中已安装 FFmpeg 并添加到 PATH。

使用方法

  1. 在 Codex agent 中加载此技能。
  2. 提供输入视频文件路径。
  3. 选择拆分方式并设置参数(时长或目标大小)。
  4. 技能自动调用 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

相关技能