前言¶
文章、公众号稿或笔记写完后，若还要再录一集口播，常见做法是单独开 DAW、找主播或自己重录。书面语和口播节奏往往对不上，人名、术语、数字的读法也容易在录音时才发现问题。下面介绍 SkillHub 上的 Agent Skill「播客配音·AI文字转语音」，它把「改稿 → 定主播与读音 → 合成 MP3」收进一套可复用的工作流，由 Agent 按 SKILL.md 引导执行，而不是让你从零拼 API。
这是什么¶
「播客配音·AI文字转语音」是坐标 @beatra-ai/ai-podcast-voiceover 的内容创作类 Skill（分类 content-creation，当前版本 0.2.2，来源标注为 enterprise，发布者 beatra）。它面向单人播客单集：先把用户提供的文章、笔记、大纲或定稿整理成适合聆听的脚本，明确读音表与节目档案，再经 Beatra 的文字转语音能力生成自然口播，默认交付 MP3 单集音频。
SkillHub 标签标明 requires_api_key=true：实际运行时依赖 Beatra 侧授权（设备令牌存放在本机 ~/.beatra/，见下文安装与授权），远程合成按字符计费，脚本准备与试听查询本身不收费。
核心功能¶
以下能力均来自官方简介与包内 SKILL.md（0.2.2），不展开未在文档中出现的接口细节。
-
节目档案（show profile）
在工作目录维护./<show>/show-profile.json，记录听众、语言、固定开场/收尾、读音表与交付约定，便于多集复用同一主播方向。 -
单集脚本化
将书面材料改为口播结构（开场、正文章节、收尾），事实与观点以用户材料为准；超长稿（超过 50,000 字符）按批准的主题或章节拆分，并在制作确认卡中列出每次付费调用。 -
主播与模型选择
通过随包 MCP 客户端调用beatra.voices.list选就绪的voice_id，用beatra.models.list（capability: "text_to_speech"）核对模型与 BCP-47 语言；默认model: "auto"、MP3、速度 1.0 等交付参数见 Skill 内「声音、交付与恢复」参考文档。 -
试听与整集合成
新节目或音色/语言变更时，先做短试听再出整集制作卡；每次beatra.speech.synthesize为付费步骤，需用户确认后的不透明client_request_id，禁止自动重试。可选配乐走独立的beatra.music.generate确认卡。 -
任务与产物
所有远程 Beatra 操作仅通过包内scripts/mcp_client.py执行（连接https://mcp.beatra.cn/mcp），用beatra.tasks.get轮询至终态，交付音频 URL、时长、MIME、用量等事实。 -
路由边界
书稿/章节旁白、短视频口播、多语言配音、自定义声线等场景，Skill 文档明确应交给同系列的其它 Beatra Skill，本包专注单主持、单集 TTS 交付。
安装与启用¶
SkillHub 官方安装说明是：让 Agent 按通用安装文档操作，并指明技能坐标。
请根据 https://skillhub.cn/install/skillhub.md，安装 @beatra-ai/ai-podcast-voiceover。
若本机已有 SkillHub CLI，可按安装文档第三节装到当前 Agent 的 skills 目录（须带 --dir，否则默认 ./skills/ 可能不被识别）。Cursor 常用路径示例：
skillhub install beatra-ai/ai-podcast-voiceover --dir ~/.cursor/skills/
也可从 SkillHub 页面下载 Zip（0.2.2）后解压到对应 skills 目录：
https://api.skillhub.cn/api/v1/download?slug=@beatra-ai/ai-podcast-voiceover
安装完成后，在 Skill 目录内完成 Beatra 授权（Python 3.10+，仅用标准库）：
python3 scripts/authorize.py
授权成功会输出 Beatra is ready；令牌只写入 ~/.beatra/credentials.json，不应出现在对话或日志中。验证连接可执行：
python3 scripts/mcp_client.py verify
Codex、Claude Code 等其它客户端的 skills 路径以 SkillHub 安装文档 第四节列表为准；未在文档列出的客户端，请查阅其官方 skills 目录说明，本文不臆测路径。
典型用法¶
经过上面的安装与授权，在 Cursor 等支持 Skills 的 Agent 中启用本 Skill 后，可按文档中的标准流程与 Agent 协作。下面是一条与 SKILL.md 一致的简化路径，便于复现理解（具体工具参数以包内 references/ 为准）。
-
提供材料
给出文章、公众号定稿、笔记或大纲，并说明这一集要给谁听、希望听众带走什么；仅给主题而无正文时，Agent 会先索取材料。 -
批准脚本与读音
Agent 按章节展示单集重点、口播稿与读音表，等你批准后再进入音频制作；若你只需要脚本，可在此步结束。 -
锁定主播并（必要时）短试听
Agent 列出候选音色与制作确认卡（含加权字符数、实时估价、每次合成的client_request_id）。方向变化时先听短样，再批准整集合成。 -
合成与交付
Agent 通过scripts/mcp_client.py提交已批准的合成请求，轮询任务完成后交付 MP3 及元数据；若你允许写入节目工作目录，会同步记录单集事实。
示例：向 Agent 发送的自然语言请求可以是：
用 @beatra-ai/ai-podcast-voiceover，把下面这篇公众号定稿做成一集单人播客 MP3。
听众是熟悉行业的开发者；主播偏沉稳男声；请先给口播稿和读音表，我确认后再合成。
Agent 会在 Skill 约束下调用 Beatra MCP，而不是让你手动配置宿主 Connector。
适用场景与注意¶
适合谁
- 文字转播客、公众号文章转音频、知识解说、新闻评论或个人栏目等单人口播单集。
- 需要固定主播音色、读音表和多集节目档案的连续更新栏目。
限制与注意
- 依赖 Beatra 账号与设备授权； mainland 网络下 MCP 连接可能有专门说明，见包内
references/mcp-connection.md。 beatra.speech.synthesize与配乐生成均为付费调用，参数变更需新的client_request_id与确认卡，文档禁止对付费请求自动重试。- 多主持混音、RSS 上架、专业母带等不在本包交付范围内；书稿旁白、短视频口播等应按 Skill 文档路由到其它 Beatra Skill。
- SkillHub 页面显示本 Skill 累计下载约 143847 次（数据随平台更新）；使用前请自行评估内容与合规风险。
结尾¶
「播客配音·AI文字转语音」把播客单集制作拆成可审查的脚本阶段与可计价的合成阶段，并把 Beatra TTS 封装进 Agent 工作流，适合已有文稿、希望稳定产出 MP3 单集的场景。官方入口与 Skill 包说明见：
- SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/ai-podcast-voiceover
- API 坐标页：https://api.skillhub.cn/beatra-ai/ai-podcast-voiceover
