班主任周语音·本周安排转语音
按已经写好的本周安排，做成每条带标签口播一条语音。
交付 8 到 20 条。先覆盖周一到周五。
适用范围与相邻路线
教师需要按已经写好的本周安排做带标签、可转发的班级口播时，使用本 Skill。
通用讲述转到 voiceover-narration-studio。整课讲述转到
course-narration-studio。假期作业清单转到
holiday-homework-voice。
只读已经提供的本周安排。不要补安排上没有的事项、分数、等第或绩效结论。
收集本周安排
硬输入是：
- 教师已经写好的班主任本周安排；
- 出现人名、班级称呼或自造词时的读音表；
- 这包要几条，或允许使用默认 10 条；
- 克隆教师声音会出现时的形象和声音权利。
复用已知语言，以及冻结的 voice_id。只补问缺失的硬输入。8 到 20 以外的数量也能做：确认该规模和实时费用。
不要编造本周事项、分数、等第或绩效结论。拿到文件不等于同意。
名字存在而读音表为空时，停下来收集读法。
先做免费槽表
任何付费克隆或旁白前，先写带标签的班主任周口播清单。教师没有另报 8 到 20 之间的数量时，默认十个槽位：周一、周二、周三、周四、周五、作业、材料、集会、家长说明和放学。每个槽位记下由已写本周安排写出的口播句，以及用目录音色还是克隆。
这份清单就是免费可见结果。规划不是批准。
安全默认：
- 每个槽位一次
beatra.speech.synthesize； - 仅当每张实时旁白卡都支持该语言时，才用
model: "auto"； format: "mp3"；speed: 1.0；- 整包一把品牌声音。
每次提交的 input 不超过 50,000 字。按句拆。按安排写成短口语句。
教师要克隆时，先查看其可授权样本。本地文件检查后，只通过随包客户端上传
（scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给
beatra.voices.clone 或
beatra.speech.synthesize。
确认克隆，再确认旁白
克隆和旁白是分开的付费阶段。每个阶段各自一张六字段卡，各自一个不透明 client_request_id。
教师要克隆教师音色时，先查看其可授权样本，读取当前的 voice_clone 卡片，并在 beatra.voices.clone 之前等在克隆卡上。找到的文件不是克隆同意。出示克隆卡并等待：
- 做什么 — 一份可授权声音样本（
beatra.voices.clone）。 - 积分 — 刚读到的
voice_clone价格。不要复用记忆中的数字。 - 几笔 — 这份样本一次付费克隆。
- 身份 — 一个新的不透明
client_request_id。 - 若停在这里 — 带标签的槽表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。教师说已充值之前不要重试。
旁白前，调用 beatra.models.list，能力为 text_to_speech：
{"capability": "text_to_speech"}
目录音色还没定时再用 beatra.voices.list。绝不要把显示名放进 voice。出示旁白卡并等待：
- 做什么 — 每个点名槽位一条本周安排口播
（beatra.speech.synthesize）。 - 积分 — 刚读到的
text_to_speech价格乘以槽位数。不要复用记忆中的数字。 - 几笔 — 每个槽位一次付费旁白。
- 身份 — 每个槽位一个新的不透明
client_request_id。 - 若停在这里 — 带标签的槽表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。教师说已充值之前不要重试。
每个旁白槽位只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。读取实际音频 MIME、时长和大小，以及
billing.net_charged_credits。不要承诺预付估价就是最终扣费。文稿预览不是音频审听。
审听、交付与恢复
核对每条口播用同一把声音，且名字与读音表和已写本周安排一致。只报告宿主实际听得到的内容。不要给学生评分。不要写绩效结论。
拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用
beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。口播句、音色或语速变了就是新卡和新标识。只有教师要求时才取消。
执行
每个远程 Beatra 操作都只通过本包随附的
scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "text_to_speech"}
printf '%s' '{"input":"<the written line for this slot>","voice":"voice_...","format":"mp3","client_request_id":"opaque-homeroom-speech-01"}' | python3 scripts/mcp_client.py call beatra.speech.synthesize
不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少
时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把
wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要
贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他
面前。任何时候都不要凭记忆报档位。
按任务查阅的参考
- 槽表、载荷和恢复，读
班主任周语音工作流。 - 授权和非计费注册步骤，读
安装与认证
和 安装注册。 - 共用的任务、计费和连接细节，读 任务与结果、计费、错误与恢复 和 随包 MCP Client 连接诊断。
- 更新保证和控制，读 自动更新与安全。移除时读 卸载与断开。
运行时与安全的自动更新
随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。
更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费克隆或旁白请求的理由。这个设置会在本安装中持续生效。见
自动更新与安全。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
