srt-to-structured-data

SRT 字幕转结构化数据

将 SRT 字幕文件解析为结构化 JSON 格式，支持提取时间码、计算时长、生成统计信息。

快速开始

基础用法

# 解析 SRT 文件，输出到终端
python <skill_path>/scripts/parse_srt.py input.srt

# 输出到文件
python <skill_path>/scripts/parse_srt.py input.srt -o output.json

# 包含统计信息
python <skill_path>/scripts/parse_srt.py input.srt --stats

# 仅输出纯文本（去除时间码）
python <skill_path>/scripts/parse_srt.py input.srt --text-only

注意： <skill_path> 是此 skill 的安装路径，通常为 ~/.claude/plugins/srt-to-structured-data@claude-code-skills/skills/srt-to-structured-data

输出格式

JSON 结构化数据

{
  "subtitles": [
    {
      "index": 1,
      "start_time": "00:00:00,000",
      "end_time": "00:00:02,566",
      "start_ms": 0,
      "end_ms": 2566,
      "duration_ms": 2566,
      "text": "Clawdbot真的太火太火太火了"
    },
    {
      "index": 2,
      "start_time": "00:00:02,633",
      "end_time": "00:00:04,766",
      "start_ms": 2633,
      "end_ms": 4766,
      "duration_ms": 2133,
      "text": "Github一天直接涨了5万星"
    }
  ],
  "statistics": {
    "total_count": 2,
    "total_duration_ms": 4699,
    "total_duration_formatted": "00:04",
    "avg_duration_ms": 2349
  }
}

纯文本输出

使用 --text-only 参数时，仅输出字幕文本，每条一行：

Clawdbot真的太火太火太火了
Github一天直接涨了5万星

命令行参数

参数	说明
input.srt	输入的 SRT 字幕文件路径
-o, --output	输出文件路径（默认输出到终端）
--stats	在 JSON 输出中包含统计信息
--text-only	仅输出纯文本，去除时间码和序号

字段说明

字段	类型	说明
index	int	字幕序号
start_time	string	开始时间（原始格式）
end_time	string	结束时间（原始格式）
start_ms	int	开始时间（毫秒）
end_ms	int	结束时间（毫秒）
duration_ms	int	持续时长（毫秒）
text	string	字幕文本内容

使用示例

场景 1：分析字幕文件

python <skill_path>/scripts/parse_srt.py video.srt --stats -o analysis.json

场景 2：提取纯文本用于翻译

python <skill_path>/scripts/parse_srt.py video.srt --text-only -o transcript.txt

场景 3：在 Python 中直接使用

import subprocess
import json

result = subprocess.run(
    ['python', '<skill_path>/scripts/parse_srt.py',
     'input.srt', '--stats'],
    capture_output=True, text=True
)
data = json.loads(result.stdout)