前言¶
做短视频、课程或有声内容时，旁白往往卡在两条路上：要么自己录，改稿就要重录；要么用通用 TTS，音色和节奏难统一，导出格式也未必能直接进剪辑轨。若还要多语言或按章节交付，手工拆文件和命名会更费时间。
下面介绍 SkillHub 上的「配音与旁白工作室」（@beatra-ai/voiceover-narration-studio）。它把 AI 配音、文字转语音和语音生成收进一套 Agent Skill 工作流：从声音库选音色，或克隆品牌声线，把文稿合成成便于后期使用的音频，并按章节或语言组织交付。
这是什么¶
配音与旁白工作室 是发布者 beatra 在 SkillHub 上架的企业来源 Skill（enterprise），当前版本 0.2.4，分类为 content-creation。坐标为 @beatra-ai/voiceover-narration-studio。
Skill 的定位是统筹 AI 配音与旁白制作：从当前声音库选择合适音色，将文稿制作成可直接剪辑的语音合成音频；也可通过声音克隆创建并复用品牌专属声音。官方页面同时将其作为 AI 语音生成器与品牌声音工作台使用。
核心功能¶
以下能力均来自 SkillHub 与官方简介，未在资料中出现的接口或参数不作展开。
-
文字转语音 / AI 语音生成
将文稿转为合成语音，输出面向后期剪辑使用的音频形态（官方表述为「可直接剪辑的语音合成音频」）。 -
声音库选音色
从当前声音库中挑选与内容匹配的音色，用于统一旁白风格。 -
声音克隆
支持通过声音克隆创建品牌专属声音，并在后续项目中复用。 -
结构化交付
- 长篇内容：按章节拆分与交付。
- 多语言内容：按语言拆分与交付。
官方明确支持多语言配音与粤语配音等场景。 -
适用内容类型（官方列举）
文稿转语音、短视频配音、有声书旁白、课程配音、多语言配音、粤语配音等。
平台信息（SkillHub 页面，供选型参考）：评分 100000，下载 12722 次；标签标明 requires_api_key=true，使用前需准备并配置 API Key（具体环境变量或配置项以 Skill 包内 SKILL.md 为准）。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。安装方式以 SkillHub 官方说明为准。
方式一：让 AI 按文档安装¶
将下面意图发给已支持 Skill 的 Agent（如 Cursor、Claude Code 等）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@beatra-ai/voiceover-narration-studio`。
Agent 会按 SkillHub 安装文档检查 CLI、选择当前环境的 skills 目录并完成安装。
方式二：使用 skillhub CLI¶
若本机已有 skillhub，可直接安装到当前 Agent 识别的 skills 目录（必须用 --dir，否则默认装到 ./skills/ 可能无法被识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装（示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill：
skillhub install @beatra-ai/voiceover-narration-studio --dir <skills 目录>
常见 Agent 的 skills 路径（摘自 SkillHub 安装文档，按你实际使用的客户端选择）：
| 客户端 | skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装后按所用客户端要求重启或刷新 Agent，使 Skill 被加载。因 requires_api_key=true，安装完成后应在 Skill 说明中配置 API Key，再发起合成任务。
典型用法¶
公开页面未附带独立 CLI 示例子命令；实际流程是在启用 Skill 后，用自然语言向 Agent 描述文稿与交付要求，由 Skill 引导选音色、合成与分章/分语言输出。可按下列步骤复现工作方式：
-
准备文稿
提供完整旁白文本；长篇建议预先标好章节标题或分段，便于「按章节」交付。 -
说明音色需求
指定使用声音库中的某类音色，或说明需要基于样本做声音克隆以固定品牌声线。 -
声明场景与语言
例如短视频旁白、课程讲解、有声书；若涉及多语言或粤语，在任务中写清语言与文件组织方式（按语言分文件）。 -
确认输出形态
强调需要「可直接剪辑」的合成音频，并说明命名或目录结构，便于导入 NLE（非线性编辑）工具。
示例提示（可根据项目改写）：
使用配音与旁白工作室：将附件文稿按「第 1 章 / 第 2 章」合成旁白，音色从声音库选沉稳男声；
第 2 章需要粤语版，与普通话版分目录输出，音频格式便于导入 Premiere 时间线。
具体合成参数、支持格式与 API 调用方式以安装后的 SKILL.md 及 beatra 侧服务说明为准。
适用场景与注意¶
适合谁
- 需要把文稿快速变成旁白轨的内容创作者、课程制作者、有声书制作流程中的编辑或制片角色。
- 希望在多集、多语言项目中保持音色一致，或需要固定「品牌声音」的团队。
使用注意
- API Key：标签要求 API Key，未配置时合成类能力通常无法调用。
- 安装路径：
skillhub install必须指向当前 Agent 的 skills 目录。 - 版本：本文依据 SkillHub 展示的 v0.2.4；升级可用
skillhub的更新能力，以商店页为准。 - 资料边界：企业来源 Skill 的后端能力、配额与合规要求以 beatra 与 SkillHub 当前条款为准；本文不替代官方 Skill 包内文档。
结尾¶
配音与旁白工作室把选音色、TTS/语音生成、克隆声线与分章分语言交付放进同一套 Agent Skill，适合把「写稿」和「出旁白轨」衔接在同一对话工作流里。需要查看简介、版本与安装提示时，可打开 SkillHub 页面：
- https://www.skillhub.cn/skills/beatra-ai/voiceover-narration-studio
- https://api.skillhub.cn/beatra-ai/voiceover-narration-studio
