口诀歌·考证知识点成曲

概述

把一个考证知识点做成能跟唱的口诀，再把同一科目做成带标签的一套。第一次交付是一首完整的知识点歌曲，学员能反复听。

适用范围与相邻路线

培训机构、考证教练或考生，要把已经写好的知识点做成口诀歌时，使用本 Skill：法考口诀、教资口诀、会计证口诀，或其他考证记忆歌单。

不是考证口诀的普通作曲转到music-generation-studio。课程正文朗读、不是唱口诀，转到course-narration-studio。给人的故事写成礼物歌转到personalized-song-maker。

收集知识点

硬输入是：

• 考试或科目（法考、教资、会计证，或其他点名的考试）；
• 一个知识点，以及必须记住的原句；
• 歌曲要唱的语言。

复用已知曲风、气质和人声方向。只补问缺失的硬输入。不要编造法条、日期、构成要件或考点来凑歌词。

整本讲义也可以。第一次付费仍只做这一个知识点。其余点等第一首被接受后再做。

先做免费口诀词

任何付费写曲前，先写带标签的口诀词：曲名、段落标签、完整歌词、必须保留的原句对应到哪一行、曲风、气质和人声方向。必须记住的原句逐字保留。这份口诀词就是免费可见结果。规划不是批准。

安全默认：

• model: "suno-5.5"。绝不省略模型，也绝不悄悄使用

auto。

• instrumental: false 且带已确认歌词。
• model_options.suno.custom_mode: true。
• 没有 duration 字段可用在 beatra.music.generate 上。时长只写进提示词。不要加 duration 参数。以实际返回时长为准。
• 风格只写进 prompt。歌词正文只写进 lyrics。

先确认第一首，再做成套

任何计费曲目前，读取当前的 beatra.models.list 卡片，能力为text_to_music。出示一张当前生成生产卡，覆盖第一首知识点歌曲，并等待：

1. 做什么 — 为点名的知识点做一首考证口诀歌，一次生成

调用（beatra.music.generate）。

1. 积分 — 刚读到的 text_to_music 价格。不要复用记忆中的数字。
2. 几笔 — 第一首一次付费调用。不要把其余讲义塞进这次提交。
3. 身份 — 一个新的不透明 client_request_id。歌词、提示词、曲名或模型变了，就换新标识。
4. 若停在这里 — 带标签的口诀词仍然可用。
5. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。老师说已充值之前不要重试。

只通过随包 scripts/mcp_client.py 提交一次。用beatra.tasks.get 轮询。交付实际字节、实际时长和billing.net_charged_credits。

第一首被接受后，其余知识点是新的一套。再出示一张新的六字段卡，覆盖冻结后的剩余套，并等待：

1. 做什么 — 每个剩余点名知识点一首考证口诀歌，每次生成

调用（beatra.music.generate）。

1. 积分 — 刚读到的 text_to_music 价格乘以剩余槽位数。不要复用记忆中的数字。
2. 几笔 — 每个剩余槽位一次付费调用。不要把多首塞进同一次提交。
3. 身份 — 每个槽位一个新的不透明 client_request_id。歌词、提示词、曲名或模型变了，就只给变化的槽位换新标识。
4. 若停在这里 — 已接受的第一首和其余口诀词仍然可用。
5. 若余额不足 — 原样转达官方说明和充值链接。老师说已充值之前不要重试。

不要把第一首的接受当成对其余套的批准。

审听、交付与恢复

对照必须保留的原句复核唱出来的词。只报告宿主实际听得到的内容。不要承诺咬字完美或精确秒数。

拿到 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_music"}

printf '%s' '{"model":"suno-5.5","prompt":"Clear-diction mnemonic song, moderate tempo, memorable hook, about two minutes.","lyrics":"[Verse 1]nApproved mnemonic linesn[Chorus]nApproved hook","instrumental":false,"title":"Knowledge Point Hook","model_options":{"suno":{"custom_mode":true}},"client_request_id":"opaque-exam-song-01"}' | python3 scripts/mcp_client.py call beatra.music.generate

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

账户余额

用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他面前。任何时候都不要凭记忆报档位。

按任务查阅的参考

• 口诀词、载荷和恢复，读

考证口诀工作流（references/workflow.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）。

更新与安全

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