novel-video-voiceoverlisted
Install: claude install-skill yanghhu/miragea-voiceover-skills
# 小说推文配音
「小说推文配音」是一个把小说推文文案、网文章节和故事按旁白与角色分配不同音色、一键生成整段多角色 AI 配音(WAV)和带角色名 SRT 字幕的 Agent 技能,适合小说推文视频、有声书配音和故事号,本地无需显卡。
## 一句话定义
小说推文配音 = 推文文案 / 小说章节(旁白 + 角色,Markdown)→ 多角色整段配音 `voiceover.wav` + 带角色名的字幕 `voiceover.srt` + 每句起止时间 `manifest.json`,生成在 Miragea 云端,本地无需显卡。
## 适用人群与场景
| 谁在用 | 典型场景 |
|---|---|
| 小说推文号 | 每天几条推文视频:旁白 + 角色台词 + 竖屏字幕 |
| 故事号、睡前故事 | 慢语速、长停顿、温和声线 |
| 网文作者、原创小说作者 | 把自己的作品做成有声版,固定旁白声线 |
| 有声书工作室 | 先用 AI 做试听样章、角色选角小样 |
| 广播剧、音频剧社团 | 多角色对白先出 AI 版,确认节奏和分工 |
## 核心能力参数
| 项目 | 说明 |
|---|---|
| 输出文件 | `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 youshengshu`:句间停顿 0.5 秒、每条字幕最多 20 字、字幕带角色名;可再用 `--gap` / `--max-chars` 覆盖 |
| 单句字数、文件大小 / 时长上限、计费 | 以 `capabilities` 实时返回为准 |
| 本地依赖 | Python 3.9+ 标准库,无需 pip 安装、无需显卡 |
| 离线试跑 | `--dry-run`:不需要 Key、不调用接口,输出静音占位音频和时间轴,用来检查稿件格式 |
| 支持的 Agent | Claude Code、Codex、OpenClaw、Cursor、WorkBuddy 等能运行 Python 脚本的 Agent |
| 配音与字幕服务 |