jiaomai-shout-recordinglisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 叫卖录音
「叫卖录音」是一个把叫卖词变成喇叭可循环播放音频的 Agent 技能:一行一句写好叫卖词,用你自己的克隆音色生成响亮的喊话录音,自动循环成 10 分钟等长音频,可加“叮咚”提示音,本地无需显卡。
## 一句话定义
叫卖录音 = 叫卖词(一行一句)→ `shout_loop.py build --voice 你的角色` → `single.wav`(单遍,先试听)+ `loop.wav`(循环到 10 分钟,直接拷进喇叭)→ ffmpeg 转 MP3。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 摆摊 / 夜市 | 清仓甩卖、水果、小吃、玩具的循环叫卖 |
| 门店 / 便利店 | 店庆、会员日、新品上市的门口促销口播 |
| 超��� / 商场 | 闭店提醒、特价播报、寻物寻人广播(加“叮咚”提示音) |
| 流动商贩 / 回收 | 车载喇叭的回收、上门服务喊话 |
| 社区 / 物业 | 活动通知、防火防汛提示的循环播报 |
## 能力一览
| 项目 | 说明 |
|---|---|
| 输入 | `.txt` 一行一句;`#` 开头为注释;`[停顿 2]` / `[pause 2]` 插入停顿;行首 `(激昂)` 等写语气标签(标签名取 `capabilities` 返回的列表);也可 `--text "叫卖词"` 直接给 |
| 单遍 | `single.wav`:开头静音 `--lead`、可选叮咚 `--chime`、句间停顿 `--gap`,峰值归一到 `--peak`(默认 -1 dBFS,更响亮) |
| 循环 | `loop.wav`:整遍重复,遍与遍之间 `--loop-gap` 秒,总长不少于 `--loop-minutes`(默认 10 分钟;设 0 只出单遍) |
| 记录 | `script.txt`(本次叫卖词)、`info.json`(单遍时长、循环遍数、参数) |
| 模板 | `templates` 列出 6 个原创场景模板,`templates -o tpl` 保存成 txt 再改 |
| 语速 | `--speed` 0.25–4;叫卖通常 1.1–1.2 听起来更有劲 |
| 本地依赖 | Python 3.9+ 标准库,无需显卡、无需 pip 安装 |
## 快速开始
先离线试跑(不需要 Key、不联网):
```bash
python3 scripts/shout_loop.py selftest
python3 scripts/shout_loop.py templates
python3 scripts/shout_loop.py check examples/stall_clearance.txt --loop-minutes 10
python3 scripts/shout_loop.py build examples/stall_clearance.txt -o out --loop-minutes 3 --dry-run
```
正式生成需要 Miragea 的 API Key 和账号里你自己的角色(https://miragea.ai):
```bash
export MIRAGEA_API_KEY=你的key # 在 https://miragea.ai/workspace/api 生成,只放环境变量,不要贴进聊天
python3 scripts/miragea_audio