SuperAPI AI 工具集

wjs-teaching-english

设计与创作

查看项目

更新于 10-15 23:32

技能介绍

用途:将单个英语单词(或短语)转化为一段自包含的 HLS 教学视频,用真实影视片段展示该词的实际发音,前后各接一张自制卡片。

主要能力:课程由三部分组成——intro.ts 介绍卡(单词、IPA 音标、中文释义、用法说明,配 Volcano TTS 朗读);中间为搜索应用中该词被说出的全部 season2 片段(超级剪辑,COS 链接);结尾 cta.ts 为关注卡片(配 TTS)。最终输出 search-app/out/<word>.m3u8,各段之间以 EXT-X-DISCONTINUITY 分隔。不烧录 MP4,只把两张卡片渲染成小型 .ts,并重编码以匹配超级剪辑的编码格式,从而可在任意 HLS 播放器中播放。

使用方式:需 ffmpeg / ffprobe 在 PATH 中,Python volcengine SDK(缺失时需用户许可 pip3 install volcengine==1.0.58),以及已部署的搜索应用(默认 https://search-app-three-kappa.vercel.app,可用 SEARCH_APP_BASE=http://localhost:3000 覆盖,本地需 Node ≥ 23.6 + npm start)。步骤:确定单词;由调用方编写 mini-lesson JSON(含 word、ipa、pos、gloss、usage、tts_text,无字典 API,须准确简洁);然后执行 cd /Users/jianshuo/code/mira/search-app 与 python3 scripts/build_lesson.py --word love --lesson /tmp/lesson.json。可用参数:--speaker zh_female_qingxin(默认)、--limit 300、--no-tts、--base <url>、--out <dir>。完成后报告输出路径与片段数量。本地播放可用 ffplay search-app/out/<word>.m3u8,或用 HTTP 提供 out/ 目录后由任意 HLS 播放器打开(Safari 原生支持 .m3u8)。

限制:若该词无匹配片段,脚本以“no clips match”退出且不写任何文件,此时应告知用户并建议换更常见的词;intro/CTA 按首个超级剪辑片段的分辨率、编码与帧率编码,以避免首处 discontinuity 需解码器重初始化。资料未提供收费、平台覆盖或效果数据。