剪口播

火山引擎转录 + AI 口误识别 + 网页审核 / 字幕格式化

模式

• 模式 A: 剪口播, 转录 → 口误识别 → 网页审核 → 剪辑
• 模式 B: 转字幕, 转录 → 格式化字幕文本（markdown，无时间戳）

输出目录结构

模式 A（剪口播）：

output/YYYY-MM-DD_HH-MM_视频名/剪口播/
├── 1_转录/   audio.mp3 · volcengine_v3_result.json · subtitles_words.json
├── 2_分析/   analysis.txt · sentence_map.json · speech_errors.json · auto_selected.json
└── 3_审核/   review.html · audio.mp3 · data.json · silence_periods.json
                <视频名>_cut.fcpxml   ← 网页点击「导出 FCPXML」后生成在此目录
                                       拖入剪映 / Final Cut Pro 完成最终剪辑

模式 B（转字幕）：

output/YYYY-MM-DD_HH-MM_视频名/剪口播/
├── 1_转录/   audio.mp3 · volcengine_v3_result.json · subtitles_words.json · raw_text.txt
└── 2_纠错/   corrected.txt · uncertain.md（可选）
视频所在目录/
└── subtitles_formatted.md   ← 最终输出

流程总览

-1. 首次引导（仅第一次：环境自检 + 配置火山引擎）
0. 确认视频路径 + 选择模式
1-4. run_transcribe.sh（自动，两模式共用）

模式 A（剪口播）:
  5.1 gen_analysis.js
  5.2 读规则.md + analysis.txt
  5.3 AI 判断整句口误 → speech_errors.json（只填 delete_sentences）
  5.4 auto_filler.js → 自动补充词级口癖 idx（快速预筛）
  5.5 AI 逐句扫剩余词级口癖（B2/B3/B4，脚本覆盖不到的部分）
  5.6 merge_selections.js
  6-7. 生成审核网页 + 启动服务器
  【等待用户确认】→ 网页点击「导出 FCPXML」→ 拖入剪映 / Final Cut Pro 完成剪辑
       （导出同时写 3_审核/review_log.json，供步骤 8 学习）
  8. 自进化学习（用户显式触发「已导出，学一下」）→ diff 抽规则 → 确认 → 写 经验规则.md

模式 B（转字幕）:
  B-1 提取纯文本
  B-2 第一步：纠错（只改词，不断行）→ corrected.txt
  B-3 第二步：断行（只格式化，不改字）→ subtitles_formatted.md

执行步骤

路径约定（重要）：本 skill 不绑定特定 agent，不要假设它装在 ~/.claude/skills/。 下面命令里的 SKILL_DIR 一律指本 skill 的安装目录（即你加载本 SKILL.md 的那个目录， 含 scripts/、用户习惯/）。执行前把它设成你实际加载 skill 的绝对路径即可：

SKILL_DIR="<本 skill 的安装目录>"   # 例：Claude Code 默认 ~/.claude/skills/AI剪口播

API Key 的查找顺序见 scripts/lib/load_api_key.sh： 环境变量 VOLCENGINE_API_KEY → $SKILL_DIR/.env →（兼容旧约定）上一级 .env。

步骤 -1: 首次引导（只在第一次跑）

目的：第一次用本 Skill 的人通常没装依赖、没配火山引擎 key。先做一次自检并手把手引导，配好后写标记文件，以后永久跳过，不再打扰。