英语视频难度判定

问题：拿到一个英语视频，却说不清它有多难

用户常问「这个视频适合什么水平」「词汇量要多少」。靠印象回答不够，结论也不可复现。难点在于：YouTube / B 站视频未必有英文字幕，而难度本身又由词汇、句法、主题共同决定，单看标题或前几秒根本判断不了。

工作方式

技能拆成两条流水线：

• 获取文本：scripts/extract_transcript.py 先用 yt-dlp 拉英文字幕；没有字幕则自动下载音轨，交给本地 faster-whisper 转写成英文文本。全程不依赖任何外部 API，转写完成后临时文件立即删除。
• 文本分析：scripts/analyze_text.py 输出客观指标——tokens / types / ttr、平均句长、长词比例、常用词覆盖率，以及 95% / 98% 舒适阅读所需的词汇量（词族）。
• 合成报告：LLM 对照 references/difficulty_rubric.md 的档位定义，结合指标与文本语义给出最终等级；内容总结必须基于实际字幕或转写文本，不臆造。

环境方面也做了自举：ffmpeg 缺失时自动下载便携版，faster-whisper 未装则首次运行自动 pip install，并用 ctranslate2 探测 GPU，无显卡自动降级 CPU。

边界与注意点

• 仅支持 YouTube / Bilibili，不读取浏览器 cookies；无字幕时依赖音频可下载，视频下架或地区限制时会请用户直接粘贴台词。
• 词汇量是被动词汇估算，覆盖率插值结果 ±10% 属正常，不代表主动输出能力。
• 机器给的 suggested_band 仅供参考，最终难度档以语义判断为准。
• 转写音轨非英文时（如中文视频），报告会明确标注，避免给出错误结论；样本低于 50 词时结论仅供参考。