wjs-teaching-english

# Teach an English word as a video supercut Turn one English word into a self-contained HLS lesson: ``` intro.ts (word /IPA/ · 中文 gloss · usage + Volcano TTS) ⋯ EXT-X-DISCONTINUITY [supercut] every season2 clip where the word is spoken (search-app /api/playlist, COS URLs) ⋯ EXT-X-DISCONTINUITY cta.ts (关注王建硕 + Volcano TTS) = search-app/out/<word>.m3u8 ``` No MP4 is burned — only the two cards are rendered as tiny `.ts`, re-encoded to match the supercut's codec so they play in any HLS player. ## Prerequisites (check once) - `ffmpeg` / `ffprobe` on PATH (Homebrew). - Python `volcengine` SDK (declared in mira `requirements.txt`, used for TTS): `python3 -c "import volcengine"`. If missing, ask the user to allow `pip3 install volcengine==1.0.58` (it's a pinned repo dependency). - The deployed search-app at `https://search-app-three-kappa.vercel.app` (default). Override with `SEARCH_APP_BASE=http://localhost:3000` if running locally (needs Node ≥ 23.6 + `npm start`). ## Steps 1. **Get the word.** A single English word (or short phrase). If the user gave a sentence, pick the target word. 2. **Write the mini-lesson JSON.** YOU (Claude) author it — no dictionary API. Keep it accurate and concise. Save to a temp file, e.g. `/tmp/lesson.json`: ```json { "word": "love", "ipa": "/lʌv/", "pos": "v. / n.", "gloss": "爱，热爱", "usage": "下面是它在真实电影里的说法", "tts_text": "love. 爱。" } ``` - `tts_text` is read aloud over the ...