meditation-sleep-guidelisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 冥想引导
「冥想引导」是一个把引导语稿子做成冥想 / 助眠音频的 Agent 技能:用你自己的克隆音色慢语速朗读,按目标分钟数自动排布段间长停顿,输出音频、字幕和时间表,本地无需显卡。
## 一句话定义
冥想引导 = 引导语稿子(空行分段,`[停顿 秒数]` 固定停顿)→ `sleep_guide.py build --minutes N` → 慢语速朗读 + 按目标分钟数排布的长停顿 → `guide.wav` + SRT / LRC 字幕 + `plan.txt` 时间表。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 冥想 / 瑜伽老师 | 把课堂引导语做成可重复播放的练习音频 |
| 睡眠、助眠类自媒体 | 批量做睡前放松、身体扫描、呼吸练习音频 |
| 心理咨询师、健康教练 | 给来访者配套放松练习,用自己的声音而不是机器腔 |
| 课程、小程序运营 | 为课程章节做配套引导音频,附字幕或歌词文件 |
## 能力一览
| 项目 | 说明 |
|---|---|
| 输入 | UTF-8 文本:段落之间空一行;单独一行 `[停顿 8]` 或 `[pause 8]` 是固定静音 8 秒;`#` 开头的行是备注,不朗读 |
| 目标时长 | `--minutes 10`:总时长减去朗读和固定停顿后,剩余时间平均分给段间停顿;`--gap` 为基础停顿(默认 3 秒),`--max-gap` 为单处上限(默认 20 秒) |
| 语速 | 默认 0.85,`--speed` 可在 0.25–4 之间调整;语气、模式可用 `--model expressive\|standard` 切换 |
| 输出 | `OUT/guide.wav`、`guide.srt`、`guide.lrc`、`plan.txt`(每段起始时间) |
| 增量 | 每句按内容缓存在 `cache/`,改一段重跑只重配这一段;断网后直接重跑续做 |
| 预估 | `plan` 离线按字数粗估朗读时长并给出时间表,不联网、不需要 Key |
| 本地依赖 | Python 3.9+ 标准库,无需显卡 |
## 快速开始
先离线试跑(不需要 Key、不联网):
```bash
python3 scripts/sleep_guide.py selftest
python3 scripts/sleep_guide.py plan examples/body_scan.txt --minutes 5
python3 scripts/sleep_guide.py build examples/body_scan.txt -o guide --minutes 5 --voice 默认 --dry-run
```
正式生成需要 Miragea 的 API Key 和账号里你自己的角色(https://miragea.ai):
```bash
export MIRAGEA_API_KEY=你的key # 在 https://miragea.ai/workspace/api 生成,只放环境变量,不要贴进聊天
python3 scripts/miragea_audio.py capabilities # 当前可用模式、语气标签、单句字数上限和计费,以实时返回为准
python3 scripts/miragea_audio.py actors --limit 20 # 账号里已有