math-rap-videolisted
Install: claude install-skill Yari-tuber/math-rap-video
# 口诀说唱讲题视频
一支视频由四样东西拼成:**歌**(AI 音乐模型唱)、**时间表**(每个字第几秒唱)、**画面**(口诀、公式、题目图形)、**背景**。
所有步骤都用一个入口 `scripts/mrv.py`。**每条命令做完都会打印「下一步」的完整命令,照抄就行;不知道做到哪了就跑 `mrv.py next <作品目录>`。**
下面的 `mrv.py` 指本 skill 的 `scripts/mrv.py`(和这份 SKILL.md 在同一个文件夹下)。运行时写完整路径,路径有空格就加引号:
`python "<skill 文件夹>/scripts/mrv.py" <命令> "<作品目录>"`。Windows 上中文乱码时先设环境变量 `PYTHONUTF8=1`。
## 第一次用:检查环境
```
python mrv.py doctor
```
缺什么它会写「怎么办」。对时间要用 torch、transformers、demucs:`mrv.py doctor --fix` 会自动建一个独立环境装好(不碰系统的 Python,约 3 GB,对齐模型第一次用时再下 1.8 GB;国内网络先设 `HF_ENDPOINT=https://hf-mirror.com`)。
## 流程
```
1 new 新建 → 2 写口诀和歌词 → lyrics → 3 出歌(先问有没有 API)→ 4 song 对时间
→ 5 写画面(storyboard.json + graphics.py)→ 6 check 看预览图 → 7 render 出片 → 8 交付
```
第 2 步写完歌词、第 6 步出了预览图,都**先给用户看,用户点头再往下**。
### 1. 新建作品
```
python mrv.py new <作品目录> --example gougu # 照「勾股定理」样例(发光线条画风,不用下素材库)
python mrv.py new <作品目录> # 照「数线段」样例(暗色电影感画风)
python mrv.py new <作品目录> --blank # 空白模板
```
### 2. 写口诀和歌词
照 `prompts/写词.md` 写(这份提示词也可以原样交给别的 AI):先验算每个数字、写清口诀成立的前提、想好评论区会挑什么刺,再写歌词。90 BPM,一句一小节,每句 11–15 字,一韵到底。存成作品目录的 `lyrics.md`(格式见样例:`## [Verse 1]` 下面一行一句 `1. 歌词`,句号从 1 连续编到最后)。
```
python mrv.py lyrics <作品目录>
```
它做两件事:歌词体检(字数、押韵、容易听错的写法,比如「是五」会被听成「十五」);生成**送唱版**(数字写成汉字、去掉括号,`唱词.md`)和各平台的提示词(`给音乐模型/` 里的 Suno.md、海绵音乐.md、Mureka.md、通用.md,歌词已经填好)。
多音字唱错了就在作品目录写 `读音替换.json`(`{"原词": "同音字"}`,只影响唱的那份,字幕照旧)。
### 3. 出歌:先问用户「你有没有音乐模型的 API?」
- **有**(现在支持 ElevenLabs,Starter 档起):请用户给密钥,保存后直接生成。**生成会花用户的额度,先告诉用户大概多少**(一首 70 秒约