AgentSkillsCN

video-cut

按照固定时长将视频分割成多个片段。当用户提及“剪切”、“分割”、“切割”、“cut”或“split”时，可选用此功能。

SKILL.md
--- frontmatter
name: video-cut
description: 将视频按固定时长分割成多个片段。当用户提到"剪切"、"分割"、"切割"、"cut"、"split"时使用。

视频剪切

功能

将一个视频文件按固定时长分割成多个片段，并按“剧集序号 + 片段序号”命名。默认每段 120 秒（2 分钟）。

使用方式

bash
python scripts/cut.py --input "<视频文件路径>" --segment_time <秒数> --episode <剧集序号> --lang "<语言>" --title "<标题>" --output "output/3-剪切片段"

执行前提

  • •用户通过桌面软链接进入程序目录后，按当前目录执行相对路径命令。
  • •若当前目录不是项目目录（含 scripts/ 与 output/），先切换到项目目录再执行。

参数

  • •--input: 视频文件路径（必填）
  • •--segment_time: 每段时长（秒），默认 120。用户说"每段3分钟"→ 180
  • •--episode: 剧集序号。可选；若输入文件名是 1.mp4 这种纯数字名可自动推断为 1
  • •--lang: 语言标签（默认 未标注）
  • •--title: 剧名/标题（默认使用输入文件名）
  • •--output: 使用相对路径，例如 output/3-剪切片段

输出位置

分段视频 → output/3-剪切片段/ 文件名格式: [语言] 标题 - 剧集序号 - 片段序号.mp4 示例: [中文] 三国 - 12 - 1.mp4

环境要求

  • •ffmpeg 和 ffprobe
  • •路径: C:\Users\Administrator\AppData\Local\Microsoft\WinGet\Packages\Gyan.FFmpeg_Microsoft.Winget.Source_8wekyb3d8bbwe\ffmpeg-8.0.1-full_build\bin

经验库（Agent 遇到问题修复后请更新此区域）

  • •最后验证时间: 尚未验证
  • •已知问题与解决方案: 暂无

故障排除

  1. •ffmpeg/ffprobe 未找到：检查路径是否存在，FFmpeg 更新可能改变路径
  2. •进程卡住：脚本已使用 subprocess.DEVNULL 避免缓冲区阻塞
  3. •文件名含特殊字符：使用 copy 模式无影响