ai-podcast-voiceoverlisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# AI播客
「AI播客」是一个把文章、笔记或对谈稿做成单人或双人播客音频的 Agent 技能:逐句配音拼成整期节目,同时输出 SRT 字幕、带时间戳的节目章节和完整文字稿,本地无需显卡。
## 一句话定义
AI播客 = 播客稿(单人或双人,`## 章节` 分段)→ `voiceover.py script` 生成整期 `voiceover.wav` + `voiceover.srt` + `manifest.json` → `shownotes.py` 生成 `chapters.txt`、`chapters.json` 和 `shownotes.md`。语音由 Miragea 云端生成,本地无需显卡。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 公众号 / 博客作者 | 文章出一个音频版,读者通勤时听 |
| 知识博主 | 读书笔记、行业观察做成每周节目 |
| 品牌 / 企业 | 品牌播客、内部周报、员工通讯音频版 |
| 播客主理人 | 预告片、片头片尾、补录口误的句子 |
| 老师 / 培训师 | 把讲义做成对谈式复习音频 |
| 不方便录音的人 | 用账号里的角色或本人授权的声音出节目 |
## 核心能力参数
| 项目 | 说明 |
|---|---|
| 输出文件 | `voiceover.wav`(整段配音)、`voiceover.srt`(带时间轴字幕)、`manifest.json`(每句说话人、文本、起止秒数)、`lines/`(每句音频,改稿时复用) |
| 音色来源 | 账号里的角色:`voice=角色名称` 或 `actor_id=角色ID`(用 `actors` 查询);还没有角色时,用本人或已获授权的录音 `create-actor` 创建私有角色(声音克隆),之后每次都用这个角色配音 |
| 生成模式 | `expressive`(客户端「默认」)/ `standard`(客户端「更像」);省略时用服务端默认,以 `capabilities` 实时返回为准 |
| 语气标签 | `tags=标签名`,取 `capabilities` 里所选模式的 `tags[].label` |
| 语速 | `speed=` 0.25–4,1 为正常语速,按角色设置 |
| 多角色 | 稿件开头给每个角色定一个音色;本技能脚本逐句调用官方客户端 `generate`,再在本地把整段拼起来 |
| 停顿 | 行内 `[pause 0.6]` / `[停顿 0.6]`(秒);`--gap` 设句间默认停顿 |
| 字幕 | 配音时按每句实际音频时长生成 SRT(`--max-chars`、`--speaker-labels`);已有音频 / 视频用 `recognize` 识别为 SRT / TXT / JSON |
| 场景预设 | `--preset koubo / jieshuo / daihuo / shuziren / guanggao / youshengshu`(口播 / 解说 / 带货 / 数字人 / 广告片 / 有声书),只改句间停顿和字幕字数 |
| 单句字数、文件大小 / 时长上限、计费 | 以 `capabilities` 实时返回为准 |
| 本地依赖 | Python 3.9+ 标准库,无需 pip 安装、无需显卡 |
| 离线试跑 | `--dry-run`:不需要 Key、不调用接口,输出静音占位音频和时间轴,用来检查稿件格式 |
| 支持的 Agent