ringback-ivr-promptslisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 彩铃制作
「彩铃制作」是一个批量生成企业彩铃和 IVR 语音导航提示音的 Agent 技能:话术一行一条,用你自己的克隆音色生成,按 id 命名导出 8k / 16k、PCM 或 A-law / μ-law 电话格式,并能拼出循环彩铃,本地无需显卡。
## 一句话定义
彩铃制作 = 话术清单(`id: 文本`)→ `phone_prompts.py build --voice 你的角色 --rate 8000 --codec alaw` → `phone/welcome.wav`、`phone/menu.wav` …(电话格式)+ `hq/`(高清母版)+ `prompts.csv` + 可选 `ringback.wav`(彩铃)。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 企业行政 / IT | 总机欢迎语、按键菜单、转接提示,上传到 IP-PBX / 云总机 |
| 客服中心 | 排队提示、满意度邀请、节假日通知,一次生成一整套 |
| 门店 / 小微企业 | 来电彩铃:品牌口号 + 营业时间,循环播放 |
| 呼叫中心实施 | 按交换机要求导出 8 kHz A-law / μ-law 文件,`inspect` 批量核对 |
## 能力一览
| 项目 | 说明 |
|---|---|
| 输入 | `.txt` 每行 `id: 文本`(id 用字母、数字、`_`、`-`,同时作为文件名,不能重复);或 `.csv`(列 `id,text`);`#` 开头为注释 |
| 电话格式 | `--rate 8000\|16000`,`--codec pcm`(16 位)/ `alaw` / `ulaw`(8 位 G.711),单声道;先低通滤波再降采样,避免 8 kHz 下刺耳 |
| 母版 | `hq/id.wav`:24 kHz、16 位,留作以后换格式 |
| 清单 | `prompts.csv`:id、文本、秒数、文件路径(UTF-8 带 BOM,Excel 直接打开) |
| 彩铃 | `--ringback id1,id2`:按顺序拼接、条间 `--ringback-gap` 秒,整段重复到不超过 `--ringback-seconds` 秒,输出 `ringback.wav`(同样是所选电话格式) |
| 前后留白 | `--lead`(默认 0.2 秒)/ `--tail`(默认 0.3 秒),避免按键菜单首字被吞 |
| 核对 | `inspect 文件.wav` 显示编码、采样率、声道、位深、时长 |
| 本地依赖 | Python 3.9+ 标准库,无需显卡、无需 pip 安装;A-law / μ-law 编码为脚本自带实现 |
## 快速开始
先离线试跑(不需要 Key、不联网):
```bash
python3 scripts/phone_prompts.py selftest
python3 scripts/phone_prompts.py check examples/company_ivr.txt
python3 scripts/phone_prompts.py build examples/company_ivr.txt -o out --codec alaw --ringback welcome,slogan --ringback-seconds 30 --dry-run
python3 scripts/phone_prompts.py inspect ou