课件配音
给课件的每一页配上口头讲解：按老师的口吻为每一页写讲稿，用老师自己的声音或选定的音色来读。
你会得到
- 每一页一个音频文件（
out/L01-audio/p001.mp3、p002.mp3，……），按课件页顺序命名，并在元数据里标明为 AI 生成。 - 每一页的讲稿，在生成任何声音之前先确认。
- 若需要：整份课件一条配音视频（1920×1080），字幕在画面上，旁边有 SRT 字幕文件。
用法
- 按页音频（默认）。 给老师放进 PowerPoint 或 WPS 的每一页。
- 配音视频。 课件按配音播放，字幕在画面上，带 AI 标识，视频旁边有 SRT 文件。
- 老师自己的声音。 用一段干净样本克隆一次。
- 没有课件的讲稿。 定稿讲稿的每一段按顺序各成一个音频文件。
适用范围与相邻路线
课件或定稿讲稿已经有了，只缺口头讲解时用它。要整门课的讲课视频、并可选数字人老师出镜，走数字人讲课；从一个知识点做一节微课，走微课制作。只有讲稿、老师却要视频时，AI课件先做课件。指向另一个 Skill 时，用课件配音工作流（references/workflow.md#pointing-to-another-skill）里的安装说明，并且只在用户要求之后才安装。
输入与默认值
硬输入：课件（.pptx、PDF，或导出的课件图片），没有课件时用定稿讲稿，以及口播语言。只有老师要用自己的声音时，才要声音样本和说话人的同意；反复出现的人名、术语和缩写，才要读音。默认：有备注时用备注当这一页的讲稿，否则根据这一页写讲稿；用适合学科的目录音色；按页交付音频。课件和备注没有支持的事实不要加进去，把缺口标给老师。
标准路径
每个 Beatra 调用都通过随包的 scripts/mcp_client.py。不要配置宿主 Beatra Connector。不要使用 REST/OpenAPI 作为回退。
课件在这台电脑上读取，视频在这台电脑上合成，用课件文件（references/deck-files.md）和讲课视频合成（references/lesson-video.md）。
- 读课件，并建立课程项目（整份课件算一讲）。只有讲稿时，每一段成一页。
- 写讲稿，为每一页写好，连同读音表一起出示。此时不提交任何东西。
- 先配前面几页。 选定声音（老师自己的声音先克隆，单独一张卡），读实时语音卡，只估算前 3 到 6 页（
--pages），出示这几页的卡，逐页配音，逐页记入项目，然后交付它们的音频。只有用户要求时，才把这几页渲染成视频（plan --pages）。 - 配剩下的页，先为剩余页出示一张卡，然后逐页配音。任何付费步骤遇到
insufficient_balance，停掉整次运行，原样转述这条错误的消息和 URL，只有用户说已经充值之后才继续。 - 交付按页排好的音频、怎样放进 PowerPoint 或 WPS，以及用户要求时在本地渲染的配音视频（字幕在画面上）和它的 SRT；报告时长和加总的
billing.net_charged_credits。说明这些音频是 AI 生成的配音。
需要确认的决策
每次付费调用都遵循课件配音工作流（references/workflow.md#production-cards）里的当前制作卡：前面几页、课件剩下的页，以及声音克隆。讲稿和估算是免费的，不算批准。声音是老师自己的，或有说话人的许可；拿到文件不等于同意。讲稿改了或重录，只为那一页重新配音，单独一张卡；读音改了，适用于整份课件，每一页已经配过、且含这个术语的都要重新配音，所以先跑 estimate，并报出会重开多少页；换声音则是每一页已经配过的都要重新配音。
故障恢复
每一页的配音在课程项目里有一个 client_request_id；讲稿、读音、声音和这一遍都没变时，这个 ID 保持不变。再次提交之前，用 beatra.tasks.list 和 beatra.tasks.get 找回丢失的响应。配音任务以 failed 或 canceled 结束时，这一页走 retake 并新开一张卡；这个 ID 绝不再发送。渲染失败是本地的，再跑一遍，不产生付费调用。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他面前。任何时候都不要凭记忆报档位。
按任务查阅参考
- 制作卡、载荷、把音频放进 PowerPoint 或 WPS、克隆和交付，读课件配音工作流（references/workflow.md）。
- 读课件、导出课件图片，或安装读取器的可选辅助工具时，读课件文件（references/deck-files.md）。
- 课程项目、读音、字幕、版式、AI 标识和渲染，读讲课视频合成（references/lesson-video.md）。
- 授权需要处理时，再读安装与认证（references/installation-and-auth.md）。
- 首次注册读安装注册（references/installation-registration.md）。
- 任务和计费事实读任务与结果（references/tasks-and-results.md）和计费、错误与恢复（references/billing-errors-and-recovery.md）。
- 随包客户端连不上时读随包 MCP Client 连接诊断（references/mcp-connection.md）。
- 更新与安全：更新与安全（references/updates-and-security.md）
- 用户要求停用并移除凭证时，再读卸载与断开连接（references/uninstall-and-disconnect.md）。
每个 Beatra 操作都使用或调用随包的 scripts/mcp_client.py。
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
