AI播客配音

作为一位为单一固定主播服务的单集制作人工作：先了解节目档案，把用户提供的材料整理成便于聆听的脚本，确定主播和模型路径，用一段短试听验证新方向，再制作并记录单集音频。

适用范围和路由

本工作流适合把用户提供的文章、笔记、大纲、新闻通讯或定稿，制作成单一主播的播客单集、预告、开场、收尾或按顺序交付的单集片段。节目会持续更新时，将主播方向、读音表和交付事实保留在一起。

将书稿或按章节组织的课程旁白交给
ai-audiobook-narration；单条短视频、广告或推广口播交给
short-form-voiceover-audio；已经批准且需要多语言版本的脚本交给
ai-multilingual-dubbing；自定义主播声音或混合声音项目交给
beatra-ai-voice-studio 及其专门的声音克隆路径。转换路由时，保留已有材料、单集顺序、语言和节目方向。

本包交付单主持集音频。把多主持混音、RSS 上架和专业母带路由出去。用户要配乐时留在本包，不要赶到别的音乐包。当用户需要指定说话人或混合、已组装的最终单集时，保留这些制作要求并选择相应的制作或编辑路径。只有用户选择更小的音频交付物时，才提供单一主播旁白。

打开节目档案

硬性输入是节目与听众：给谁听，以及这一集要完成什么。先查找 ./<show>/show-profile.json，档案已在就复用。只有再次核验已经确定的主播仍符合当前音色列表和模型路径时，才复用节目方向。对于新节目，在用户拥有的工作目录中确定预期听众、主播、语言、固定开场和收尾、读音表及交付约定。要配乐时，确认风格以及用户是否接受付费生成曲。参见节目档案。

准备单集脚本

接受文章、笔记、大纲或最终脚本，并将其整理为听众容易跟上的单集。先以节目的预期听众为准；如果所提供材料可服务于会明显不同的听众目标，先询问希望听众带走什么，再起草。否则在草稿中写出根据材料推断的单集重点，供批准。每一项事实、观点、数字和主张都以用户提供的材料为依据。请求只提供主题时，先索取文章、笔记或大纲，再继续准备单集内容。

按章节展示单集重点和口播草稿，包括开场、收尾和读音表，在提出音频制作前等待批准。用户只需要脚本时，交付已经批准的脚本即可。材料边界、听众重点、口语化整理、读音和长度处理参见单集脚本指引。

确定主播和模型路径

使用 beatra.voices.list 比较可用试听并确定一个不透明、状态就绪的 voice_id；合成时只提交该 ID，而不使用显示名称。决定模型、语言或价格前，调用 beatra.models.list 并传入 capability: "text_to_speech"。用户明确指定模型时，它应当处于当前可用状态、与已确定的主播兼容，并支持目标 BCP-47 语言。对 auto，只保留
models.list.auto.candidate_order ∩ voice.compatible_models 中当前可用的模型，并保持目录顺序。只有该集合非空且每个成员都支持目标语言时，才使用 auto；处于 candidate_order 之外的当前兼容模型属于明确选择，而不是自动候选。

除非节目档案或交付目的地需要受支持的其他设置，默认使用 model: "auto"、MP3、速度 1.0、音量 1.0、音高 0、不设置情绪和不明确设置采样率。选声、实时信息卡核验和当前价格计算参见声音、交付与恢复。

标准流程

先锁定节目与听众。为耳朵写稿。用用户听过的短样证明方向。然后出示整集成音确认卡。需要配乐时，在那之后单独出示音乐床确认卡——绝不要把 beatra.music.generate 折进配音卡。听过短样之后，方向才算成立。

估价和确认

脚本准备、音色试听、当前模型查询和价格估算均不收费。每次 beatra.speech.synthesize 请求都需要付费。每次 beatra.music.generate 请求都是独立的付费步骤，要有自己的当前制作卡。配音制作卡应列出准确文本、已确定的主播和设置、加权字符总数、实时价格计算、预计请求数量，以及每次逻辑请求对应的一个新的不透明 client_request_id。配乐获确认后，再出示第二张卡，冻结音乐提示词、风格、模型和它自己的新不透明 client_request_id。两笔付费都禁止自动重试。参数变了，就要新的 client_request_id 和新卡。

对于第一集，或声音、语言、控制项发生变化后的单集，先制作一段结合开场和最具挑战段落的小试听。已重新核验且没有变化的节目档案可直接展示单集制作卡。单集需要自身的批准；试听批准不包含单集。配乐批准不等于配音批准，配音批准也不等于配乐批准。脚本超过 50,000 个字符时，按批准的主题或章节划分片段，并在制作卡中列出每一个付费调用。

制作、交付和记录

首次使用或包版本变化后，进行尽力而为且不收费的安装注册。注册失败不会阻断单集工作流。

所有远程 Beatra 操作只能通过随包提供的
scripts/mcp_client.py 执行，工具名称作为 CLI 参数，JSON 参数通过标准输入传入。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。对每个已批准的逻辑付费请求，只用稳定请求标识提交一次，立即记录返回的任务 ID，并使用 beatra.tasks.get 轮询该任务直至终态。配乐已在自己的确认卡上获批时，在整集配音获批之后，用该卡的标识提交一次 beatra.music.generate。

交付返回的单集音频及其真实 artifact ID、时长、MIME 类型、存在时的采样率、解析后的模型、用量和返回的计费事实。生成过配乐时，同样单独交付那条素材——不要把单人 TTS 文件说成已经混好的成集。宿主可以试听时，检查实际节奏、读音和主播契合度；否则明确说明仍需试听。如果宿主获得用户批准访问节目的工作目录，可在那里追加已交付单集记录；否则把同一份事实记录和音频 URL 交给用户自己的节目台账。任务 ID 丢失时，先通过 beatra.tasks.list 核对，再考虑逐字段相同的重放。详细恢复路径参见声音、交付与恢复。

按任务选择参考资料

• 让已有文字更适合聆听、批准章节或记录读音：单集脚本指引
• 开始新节目、复用主播或记录已完成单集：节目档案
• 选声和模型、估价、提交音频、交付或恢复：声音、交付与恢复
• 首次安装或授权过期：安装与授权
• 不收费的包安装注册：安装注册
• 任务轮询、产物和结果字段：任务与结果
• 余额、校验和结构化错误：计费、错误与恢复
• 随包客户端无法连接时：随包 MCP Client 连接诊断
• 更新保证和控制：自动更新与安全
• 移除包或共享凭据：卸载与断开连接

运行时和安全自动更新

随包客户端在每个安装中静默检查更新，每 24 小时最多一次。发现更高版本时，会不另行确认自动安装。它只从为当前包、渠道和语言环境固定配置的官方发现地址和不可变 Beatra CDN 路径下载，并在替换前校验发现数据、压缩包、清单和每个文件的大小及校验和；它只替换本包拥有的文件。它会拒绝重定向、降级、与包、渠道、语言环境或版本不匹配的数据、意外 URL、不安全压缩包以及拥有目录外的文件。

更新检查、下载、校验、替换和回滚任一环节失败时，当前安装仍然可用，用户原本请求的命令继续执行。更新失败不允许重试已付费的语音合成。用户的设置会在本安装中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check