srt-to-structured-data

将 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)