视频转写

视频转写工具

适用/能力

• 转写出文档：抓取字幕或音频转写 → 输出 Markdown 文档（有字幕优先）。
• 翻译视频：转写 → 翻译 → 烧录中文字幕 → 输出带字幕的视频文件。
• 支持精确模式（默认，large-v3-turbo，95% 精度）和快速模式（medium，90% 精度，快 81%）。
• 双版本输出：中文内容生成中文版，非中文内容生成原文版 + 中文翻译版。

意图识别（必须严格遵守）

• 用户说"转写""转文字""出文档" → 只生成 Markdown 文档
• 用户说"翻译""翻译视频""配字幕""加字幕" → 必须执行完整的翻译视频管线（提取音频 → Whisper 生成 SRT → 调用 subtitle-polish 翻译 → 烧录字幕到视频 → 同时生成 Markdown 文档），不能只输出文档就结束
• 输入是 URL → 先下载再处理
• 输入是本地文件路径 → 直接处理

字幕类型（翻译管线必须先确认）

• 中文字幕：只显示中文翻译
• 中英双语字幕：中文在上，英文在下

翻译视频时，除非用户在对话中明确指定了字幕类型（说了"中文""双语""中英"等），否则必须用 AskUserQuestion 弹选项让用户选择。 ARGUMENTS 里的字幕类型不算用户指定。示例：

AskUserQuestion(
  question="选择字幕类型",
  options=["中文字幕（只显示中文）", "中英双语字幕（中文在上，英文在下）"]
)

双语字幕 SRT 格式（每条两行）：

1
00:00:03,660 --> 00:00:06,360
中文翻译在上面
English original below

双语烧录走 ASS，不走 subtitles + force_style（中文大 / 英文小，形成反差）：

• subtitle-polish 翻译产出「双语 SRT」（中文在上、英文在下，时间戳一句对一句）后，调脚本转双语 ASS：

  python3 ~/.claude/skills/xiaohu-subtitle-polish/scripts/bilingual_ass.py \
    <双语SRT> --output <双语ASS> [--cn-size N] [--height 视频高度]
  

• 再用 ass=<双语ASS> 滤镜烧录（不是 subtitles=）。完整规则见 xiaohu-subtitle-polish SKILL.md「双语字幕模式」段。
• 字号：用户给了中文字号就传 --cn-size，英文自动按 中文 / 1.7 算；没给则脚本按分辨率选默认。中文︰英文 ≈ 1.7 是实测干净反差。

⛔ 为什么不用 subtitles force_style 做双语：force_style 的 FontSize 对整条统一，做不到一条内中文大英文小；SRT 里的 inline {\fsN} 会被 ffmpeg 剥离（2026-05-31 实测三档字号 md5 全同）。只有 ASS 喂 libass 才能一条内分字号。 ⛔ ASS FontSize 是相对值不是像素：libass 已按视频分辨率自动缩放，不要按分辨率线性放大（1080p 的 17 乘 2 变 34 会让 4K 字幕占满下半屏）。2026-05-26 Jony Ive 法拉利视频踩坑根治。

强制规则（先读配置再执行）

• 执行任何命令/写入任何文件前，必须先读取本技能目录 config.json，取 output_dir 作为 <输出根>（支持 ~ 展开）。
• 文档中的所有 <输出根>/... 在执行前必须替换为真实绝对路径；禁止把 <输出根> 原样带到命令里执行（否则会写到当前目录，表现为“乱保存”）。
• 若 config.json 缺失、output_dir 为空/相对路径/不可写：立即停止并提示用户在网页面板填写，或用 --outdir <绝对路径> 覆盖。
• 只有当用户明确给出“绝对路径输出位置”并确认时，才允许写入用户指定路径；否则默认只写 <输出根>/tmp/ 与 <输出根>/data/。

建议的“输出根解析”固定前置步骤（避免手打长路径导致误写目录）：

# 在本技能目录执行
OUTPUT_ROOT="$(python3 - <<'PY'
import json, os
from pathlib import Path

cfg = json.load(open("config.json", "r", encoding="utf-8"))
out = Path(os.path.expanduser(str(cfg.get("output_dir", ""))).strip())
if not out.is_absolute():
    raise SystemExit("config.json: output_dir 必须是绝对路径或以 ~ 开头")
print(str(out))
PY
)"
mkdir -p "$OUTPUT_ROOT/tmp" "$OUTPUT_ROOT/data"
echo "OUTPUT_ROOT=$OUTPUT_ROOT"

后续所有命令都必须使用 $OUTPUT_ROOT/...，不要在命令里手写/粘贴完整长路径。