shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

口诀歌·考证知识点成曲

按已有知识点做成一首可跟唱的考证口诀，再把同一科目做成一套。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

口诀歌·考证知识点成曲

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

适用范围与相邻路线

培训机构、考证教练或考生，要把已经写好的知识点做成口诀歌时，使用本 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）。
  2. 积分 — 刚读到的 text_to_music 价格。不要复用记忆中的数字。
  3. 几笔 — 第一首一次付费调用。不要把其余讲义塞进这次提交。
  4. 身份 — 一个新的不透明 client_request_id。歌词、提示词、曲名或模型变了，就换新标识。
  5. 若停在这里 — 带标签的口诀词仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 （https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。老师说已充值之前不要重试。不要推荐 ¥198。

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

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

  1. 做什么 — 每个剩余点名知识点一首考证口诀歌，每次生成 调用（beatra.music.generate）。
  2. 积分 — 刚读到的 text_to_music 价格乘以剩余槽位数。不要复用记忆中的数字。
  3. 几笔 — 每个剩余槽位一次付费调用。不要把多首塞进同一次提交。
  4. 身份 — 每个槽位一个新的不透明 client_request_id。歌词、提示词、曲名或模型变了，就只给变化的槽位换新标识。
  5. 若停在这里 — 已接受的第一首和其余口诀词仍然可用。
  6. 若余额不足 — 原样转达官方说明和 https://console.beatra.ai/wallet?intent=buy。老师说已充值之前不要重试。不要推荐 ¥198。

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

审听、交付与恢复

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

拿到 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 lines\n[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 作为降级。

按任务查阅的参考

  • 口诀词、载荷和恢复，读 考证口诀工作流（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/automatic-updates-and-safety.md）。移除时读 卸载与断开（references/uninstall-and-disconnect.md）。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费写曲请求的理由。这个设置会在本安装中持续生效。见 自动更新与安全（references/automatic-updates-and-safety.md）。

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