1. 转录视频（本地 FunASR）
    ↓
2. 词典纠错 + 分句
    ↓
3. 输出字幕稿（纯文本，一句一行）
    ↓
【用户审核修改】
    ↓
4. 用户给回修改后的文本
    ↓
5. 我匹配时间戳 → 生成 SRT
    ↓
6. 烧录字幕（FFmpeg）

python 剪口播/scripts/transcribe_local.py video.mp4 --output=transcript.json

/**
 * 将字符数组分割为字幕句
 * @param {Array} chars - 字符数组 [{char, start, end}, ...]
 * @param {number} maxLen - 每行最大字数，默认 15
 * @param {number} pauseThreshold - 停顿阈值（秒），默认 0.5
 */
function splitToSubtitles(chars, maxLen = 15, pauseThreshold = 0.5) {
  const subtitles = [];
  let current = { text: '', start: 0, end: 0 };

  for (let i = 0; i < chars.length; i++) {
    const char = chars[i];
    const prevEnd = i > 0 ? chars[i - 1].end : 0;
    const gap = char.start - prevEnd;

    // 分句条件：标点 / 停顿 / 超长
    const isPunc = /[，。？！、：；]/.test(char.char);
    const isPause = gap >= pauseThreshold;
    const isTooLong = current.text.length >= maxLen;

    if ((isPunc || isPause || isTooLong) && current.text.length > 0) {
      // 如果是标点，加上标点再分句
      if (isPunc) {
        current.text += char.char;
        current.end = char.end;
      }
      subtitles.push({ ...current });
      current = { text: '', start: char.start, end: char.end };
      if (isPunc) continue;
    }

    if (current.text.length === 0) {
      current.start = char.start;
    }
    current.text += char.char;
    current.end = char.end;
  }

  // 最后一句
  if (current.text.length > 0) {
    subtitles.push(current);
  }

  return subtitles;
}

skills
Claude
iPhone

今天给大家分享一个技巧
很多人可能不知道
其实这个功能
藏在设置里面
你只要点击这里
就能看到了

/**
 * 生成 SRT 格式字幕
 */
function generateSRT(subtitles) {
  return subtitles.map((sub, i) => {
    const start = formatTime(sub.start);
    const end = formatTime(sub.end);
    // 去掉句尾标点
    const text = sub.text.replace(/[，。？！、：；]$/, '');
    return `${i + 1}\n${start} --> ${end}\n${text}\n`;
  }).join('\n');
}

function formatTime(seconds) {
  const h = Math.floor(seconds / 3600);
  const m = Math.floor((seconds % 3600) / 60);
  const s = Math.floor(seconds % 60);
  const ms = Math.floor((seconds % 1) * 1000);
  return `${pad(h)}:${pad(m)}:${pad(s)},${pad(ms, 3)}`;
}

function pad(n, len = 2) {
  return String(n).padStart(len, '0');
}

ffmpeg -i video.mp4 -vf "subtitles=video.srt:force_style='FontSize=24,FontName=PingFang SC,OutlineColour=&H000000&,Outline=2,MarginV=30'" -c:a copy output.mp4

01-xxx_字幕稿.txt   # 纯文本，用户编辑
01-xxx.srt          # 字幕文件
01-xxx-字幕.mp4     # 带字幕视频