generate-narration-audio
GitHub为剧本分镜生成旁白配音，通过 MCP 工具入队 TTS 合成。支持全集补齐、批量或单分镜重生，处理音色语速变更及断点续传，并引导用户试听确认。
Trigger Scenarios
Install
npx skills add ArcReel/ArcReel --skill generate-narration-audio -g -y
SKILL.md
Frontmatter
{
"name": "generate-narration-audio",
"description": "为旁白\/解说剧本逐分镜生成旁白配音（TTS）。当 TTS 项目首轮自动剪辑需要补齐缺失配音、用户要求生成或重新生成某个分镜或某集旁白配音，或批量配音中断需要补齐时使用。"
}
生成旁白配音
为旁白/解说创作类型剧本的每个分镜，以该分镜的 novel_text 原文合成一段旁白配音，
写回该分镜的 generated_assets.narration_audio（输出 audio/segment_{segment_id}.wav）。
只依赖剧本，不依赖分镜图/视频——剧本生成后即可推进。
工具调用
重要：生成旁白配音必须调用下列 MCP 工具入队。此 skill 不提供任何 Python/Shell 脚本，不得用 BASH 调 python .../scripts/*.py。
通过 MCP 工具入队：
| 操作 | 工具 |
|---|---|
| 全集补齐（默认，所有缺旁白配音的分镜） | mcp__arcreel__generate_narration_audio({"script": "episode_1.json"}) |
| 指定批量范围 | mcp__arcreel__generate_narration_audio({"script": "episode_1.json", "segment_ids": ["E1S01", "E1S02"]}) |
| 单分镜重生 | mcp__arcreel__generate_narration_audio({"script": "episode_1.json", "segment_ids": ["E1S05"]}) |
选择规则：不传
segment_ids则只为缺narration_audio的分镜入队——已失效但仍可用的旧配音会被复用，不自动重生； 显式传入的分镜即使已有旁白配音也会重新合成（用于换音色/语速后重生）。调用时机：TTS 项目首轮自动剪辑时按缺失补齐，项目选择 TTS 即已授权，无需另行确认； 用户也可随时要求生成。stale 配音仅按用户要求重合成；后期配音项目无需 TTS。 视频生成不依赖旁白配音，两者互不等待。 新旁白配音完成后请用户试听确认。
依赖：generation worker 必须在线（audio 独立通道）；项目的旁白交付方式是「TTS 配音」。TTS 模型、音色与语速 都取自项目设置里的 TTS 快照，与全局默认无关。
改音色/语速：用户要求"这个项目旁白用 X 音色 / 语速 1.2"时，调
mcp__arcreel__patch_project({"settings": {"narration_voice": "X", "narration_speed": 1.2}})改项目的 TTS 快照（只影响当前项目；narration_speed传null表示不向供应商传语速）。改完后，按旧模型、音色或语速 生成的旁白配音读作 stale：仍可试听、参与剪辑，全集补齐不会重生它们；要换成新设置，点名这些分镜重新合成。
工作流程
- 状态检测 — 读取剧本，检查各分镜的
generated_assets.narration_audio，统计缺失分镜并告知用户 - 入队生成 — 调用 MCP 工具，任务经生成队列由 worker 处理，工具等待全部完成后返回逐分镜结果
- 汇报 — 汇总成功/失败明细展示给用户
断点续传
中断（服务重启、任务失败、会话断开）后重新调用不传 segment_ids 的全集补齐即可：
已有旁白配音的分镜自动跳过，只补缺失分镜，不重复扣费。
错误处理
- 单分镜失败不影响批次：工具返回
requested / succeeded / failed / blocked的逐 ID 结果 - 按
failed/blocked里每一项自带的问题码与下一步动作决定重试还是先改输入，不要读文本猜 - 可重试的分镜用
segment_ids精确重试 - 工具返回
narration_delivery_post_production时，告知用户这个项目的旁白由后期配音交付、视频不受影响； 用户主动想要 in-app 旁白时，请其在 Web 项目设置里把交付方式改为 TTS 配音后重试 - 工具返回
narration_tts_*项目配置问题时，同样说明后期配音这条路照常可用；继续做视频不需要 TTS。 只有用户主动想要 in-app 旁白时，才引导其到 Web 项目设置补齐 TTS 模型或音色后重试
Version History
-
8d9d3a0
Current 2026-10-19 08:06
工作流移除旁白交付步骤，改为视频剪辑流程；旁白缺口仅报告于 TTS 项目；同步 Agent 文档说明改 TTS 快照后旧配音状态及重试逻辑。
-
44d22bf
2026-08-28 10:40
统一领域术语与Agent命名，将“子任务”改为“子智能体”，修正凭证、草稿等术语残留及语义偏移。
-
feafcb4
2026-08-20 00:25
统一使用“旁白/解说”等正式产品术语；明确未配置 TTS 供应商时默认走后期配音，不再催促配置；细化制作计划动作与旁白问题码的处理逻辑对齐。
- 24a1f5c 2026-07-25 06:26
