学习播客·论文考点讲解

把学习者要学的内容（一篇论文、一本书的某一章、讲义，或一份考点清单）做成路上能听的播客：先写双人稿，再用两个声音读成一集，并把要背的考点唱成一首歌。

你会拿到什么

第一条回复，全部是文字，还没有连接任何服务：

• 一份大约五分钟的双人播客稿：提问人和讲解人的台词分开标出，问题短、回答清楚，可以直接念。
• 章节标记：每一节一个标题，以及它大约从第几分钟开始。
• 五条复习要点，每条一句话，不看稿也能懂。
• 如果只要口诀歌：改为交歌词单，每个考点逐字对应到唱它的那一行。

连上 Beatra 之后，每一样都按上面定稿的文字制作：

• 两个声音的一集：提问人一个声音，讲解人一个声音，按发言轮次交付编号音频，一轮一个文件，按稿子的顺序，可以顺次播放，也可以在任何音频软件里接起来；章节标记按各段真实时长重新计时。
• 单人版：改写成一个主持人来讲，用一个声音读成一个音频文件；实时配音模型卡片要求把文字分段时，按顺序交付各段。
• 讲解人用老师或学习者本人克隆的声音，并且已经得到说话人本人的许可。
• 一首口诀歌：把学习者给的考点唱出来，每个考点逐字保留。

生成文件的格式和大小由模型决定，交付时如实说明。

几种做法

• 学习稿。 默认的第一条回复：双人稿、章节标记和五条复习要点。
• 双人音频。 两个声音按轮次读稿：两个目录音色，或目录音色的提问人加上克隆声音的讲解人。
• 单人版。 一个声音把单人版读成一个文件。
• 老师的声音。 在说话人本人许可的前提下，把老师或学习者本人的声音克隆一次，以后每一集都复用。
• 口诀歌。 要背的考点唱成一首歌。
• 系列。 很长的材料按章拆成不超过 10 分钟的各集；每一集单独写、单独报价。

适用范围和相邻做法

学生、考生、研究者或老师想把学习材料讲成播客时用它：一篇论文、一本书的某一章、讲义、一个概念，或一份考点清单。材料是用户自己的学习材料。给小学生用的单词卡、生字卡和手绘学习海报，走学习卡片流程。要拿去卖的录播课，走课程流程。在公开发布对别人的书或论文的讲解之前，提醒用户核对权利；用户说已经核对过，再继续。声音只用用户本人的，或已得到说话人本人许可的；拿到一个文件、一段公开录音或公众人物的视频，都不算同意。

输入和默认值

硬性输入是要讲什么：一个概念、一章或一份笔记、一篇论文，或一份考点清单。给了这个，就一次写完整个第一条回复，什么都不问。没给时，用一句话请对方补上，同时照样交一份完整成果，第一行标「示例」，主题用「边际效用递减」；这句提问就是这条回复唯一的下一步。

用户分享了文件、而正文还没出现在对话里时，用宿主自己的本地读文件能力去读；这不需要登录，不花钱，也不是一次 Beatra 调用。读不了就说明，用一句话请对方把这一章贴过来，同时照样交一份完整成果：按用户点名的主题，只用教科书上的知识，并标明这份稿没有用到他的文件；否则就交「示例」。绝不要到网上找这段文字，也不要换成别的来源。

用户给过的时长、语言、受众和考试都沿用。默认值：一集大约五分钟，绝不超过用户要求的时长，也绝不超过 10 分钟；提问人每问都短，讲解人把要点讲清楚；五条复习要点；用用户的语言；MP3 音频。材料很长时，第一条回复只写第 1 集，并说明后面的章节会做成后面几集，每一集单独报价。

事实只来自用户的材料，或来自任何教科书对用户点名的那个概念的说法。不要编造数据、来源、引文、页码或考试事实。每个考点保持用户写的原样；绝不为了押韵而改写。健康、法律或个人理财的主题，讲解要谨慎、只讲一般情况，并加一句话：听者自己的情况需要专业人士的意见。

主流程

1. 写这一集。 第一条回复不调用任何工具（不开链接、不查资料、不看日期；阅读用户分享的文件是上面说的那一个例外），不要求登录，也不报价格。它交出稿子、章节标记和五条复习要点，结尾用用户的语言只给一个下一步：回复「用两个声音读」；每个付费步骤都先报价，等对方同意再做。用户只要口诀歌时，改为交出第 8 步的歌词单，结尾只给一个下一步：回复「唱出来」，并且先报价。
2. 定稿。 要拿去念或唱的内容都必须是定稿。如果还是「示例」，先问是用示例，还是换成自己的材料。用户改了材料、时长或受众，先把改好的文字给他看。
3. 一次只做一条。 用户一条消息要两样时，先做他点名的第一样，再问下一样。
4. 定两个声音。 调用 beatra.voices.list，为提问人固定一个不透明的 voice_id，为讲解人再固定一个：两个听起来明显不同、能用于这一集语言的现成音色。绝不要把显示名写进 voice。讲解人要克隆时，先做第 5 步。
5. 克隆声音。 上传任何文件之前，先确认这是用户本人的声音，或老师已经许可把这个声音用在这次用途上；一段课堂录音、一个文件、一段公开录音或公众人物的视频，都不算同意。用 python3 scripts/mcp_client.py upload "<file>" --mime-type <type> 上传干净的样本，调用 beatra.models.list 并传 {"capability": "voice_clone"}，出克隆确认卡。克隆的费用通常高于新账号的起始余额：确认卡上要写明这一点，并且在用户说余额够付这个实时价格之前，不生成标识。只提交一次 beatra.voices.clone，并带上 consent_attested: true，用 beatra.tasks.get 查进度，然后固定返回的 voice_id。以后的各集复用它，不再克隆。
6. 双人音频。 调用 beatra.models.list 并传 {"capability": "text_to_speech"}，选定一个实时模型：它要同时出现在两个已固定声音的 compatible_models 里，并且支持这一集的语言。把定稿的稿子拆成配音块，每一块是一个说话人连续的一轮，按稿子顺序编号；说话人标记和章节标题不放进任何一块的 input。用 beatra.speech.validate（不扣费）给每一块报价，报价时用它确切的声音、模型和文字，并为这一集出一张确认卡，列出每一块的说话人、声音和价格。然后按顺序对每一块提交一次 beatra.speech.synthesize，使用同一个模型，并逐个查询任务（遇到并发上限时，等待返回的延迟时间，再用同一个标识、同样的参数重新提交）。按说话人标注、按稿子顺序交付编号音频，每一段写明真实时长，并根据真实时长重算章节标记。
7. 单人版。 把这一集改写成一个主持人来讲（提问人的问题改成主持人自己的串场引导语），并把改写稿给他看。定稿之后，用 beatra.speech.validate 报价，出一张确认卡，对整段文字只提交一次 beatra.speech.synthesize（十分钟的一集远低于实时配音模型卡片的输入上限）。交付一个文件；只有文字超过实时配音模型卡片的输入上限时，才按顺序分段交付。
8. 口诀歌。 先免费写歌词单：标题、各段标签、完整歌词，以及每个考点逐字对应到唱它的那一行。调用 beatra.models.list 并传 {"capability": "text_to_music"}，读取 suno-6 这张卡片的价格和歌词上限。出一张确认卡，然后只提交一次 beatra.music.generate，带上 model: "suno-6"、instrumental: false、定稿的歌词、一个标题，以及写明预期时长的风格提示；没有时长字段，真实时长从结果里读。先做这一首歌；另一份考点清单要等用户接受了这一首，再单独出确认卡来做。
9. 交付。 报告真实的文件、时长和 billing.net_charged_credits。听不出来的地方直接说明（术语怎么读、两个声音交接是否顺、歌唱得清不清楚）。提醒用户公开发布音频和歌曲时标注「AI 生成」。结尾只给一个下一步，比如「回复『下一章』，我来写第 2 集；音频会先报价」。

请求示例、分段规划和完整的一集示例，见学习播客流程（references/workflow.md）。

连接就绪之前

如果一轮结束时「允许」还没完成，就先把所有不需要连接的内容按用户要的格式交付：播客稿、章节标记、复习要点、单人改写稿和歌词单。这一轮交付的就是这些文字。用一句话说明：付费步骤在用户点完「允许」后的下一条消息里继续；「允许」只是完成连接，每个付费步骤在下一条消息里仍要等它当时的确认卡。不要用别的工具或服务填补空档，也不要说出任何没有经过实时调用返回的音色、模型、价格或结果。

需要确认的决定

稿子、复习要点和歌词单都免费。它们不等于同意付费。

每次付费调用之前，先出一张当时的制作确认卡，然后等待：

1. 内容：要做什么，用用户自己的话说，并写明由哪一类调用来做（克隆、配音或歌曲）。
2. 积分：刚从模型卡片或 beatra.speech.validate 读到的实时价格。绝不用记忆里的数字。
3. 次数：每一项一次付费调用。只有同一集的各个配音块可以共用一张卡，每一块单独一行，写明说话人；每一次克隆和每一首歌都各自单独一张卡。
4. 标识：每次调用一个新的不透明 client_request_id。稿子、文件、音色、模型或控制项一变，就换一个新的标识。
5. 如果到此为止：稿子、章节标记、复习要点和歌词单照样能用。
6. 如果余额不足：原样转述官方提示和其中的充值链接。用户说已经充值之前，不再提交。

克隆、配音和歌曲各自单独出确认卡。同意了配音，不等于同意做这首歌；同意了一集，也不覆盖下一集。绝不悄悄换音色或换模型。提交这张卡报过价的确切模型，绝不用 auto 代替。所有远程 Beatra 工具都只通过随包的 scripts/mcp_client.py 调用：工具名作为命令参数，JSON 参数从标准输入传入。
不要配置、调用或使用宿主 Beatra Connector。
不要用 REST/OpenAPI 作为降级方案。

如果创建请求没收到回应，或者任务编号丢了，先调用 beatra.tasks.list，再调用 beatra.tasks.get，和定稿时的请求逐项比对。确认没有这个任务之后，才用同一个 client_request_id 重新提交完全相同的内容。某一块或某一首歌失败了，要在新的确认卡上用新的 client_request_id 重做；重放旧标识只会返回那个失败的任务。
只有用户要求取消时，才调用 beatra.tasks.cancel，再用 beatra.tasks.get 确认这个任务。

用户问还剩多少积分时，调用 beatra.wallet.get。问扣了哪些费用时，调用 beatra.wallet.ledger。模型卡片返回 top_up 内容时，按卡片列出的顺序原样转述各档充值，不排序，也不替用户选。

按任务查阅

• 需要声音分配、分段拆分、克隆、配音和歌曲的请求示例，以及完整的一集示例时，读学习播客流程（references/workflow.md）。
• 任务卡住、没收到回应、某一块失败、文件读不了、术语读错，或歌曲改动了考点时，读出问题时怎么办（references/faq.md）。
• 连接还没就绪时，读安装与授权（references/installation-and-auth.md）。
• 首次使用登记，读安装登记（references/installation-registration.md）。
• 任务创建之前调用就失败时，读随包 MCP Client 连接诊断（references/mcp-connection.md）。
• 任务在排队、进行中或找不到时，读任务与结果（references/tasks-and-results.md）。
• 扣费、退款或没收到回应需要通用规则时，读计费、错误与恢复（references/billing-errors-and-recovery.md）。
• 用户想停止使用并断开连接时，读卸载与断开连接（references/uninstall-and-disconnect.md）。

更新与安全

本 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）。