--- name: livestream-bgm-pack description: "用 AI 为直播间、带货场次或门店一次做出10到20首原创循环纯音乐。这个直播间BGM歌单和门店循环音乐生成工具会按候场、闲聊、讲品、高潮和夜场写出原创BGM，音乐归你所有、可直接商用，交付带标签的歌单，开播前先试听。适用于直播间背景音乐、直播带货BGM、门店循环音乐、候场音乐、直播BGM、直播配乐和直播间音乐。" --- # 直播间BGM歌单 把直播间或门店简报做成带标签的原创器乐歌单。常规交付是 10 到 20 首底乐，不是一首歌。 ## 适用范围与相邻路线 直播、带货场次、实体店或候场画面需要一套可复用、便于循环、运营方可商用的原创器乐时，使用本 Skill。 给某一条成片写一条器乐转到 `short-video-bgm-studio`。品牌广告歌、带唱广告歌或声音Logo转到 `brand-jingle-studio`。带歌词的歌曲转到 `beatra-ai-music-creator`。口播旁白转到 `short-form-voiceover-audio`。 ## 输入与默认值 硬输入是： - 音乐播在哪里（直播间、带货、门店、候场画面）； - 歌单要几首，或允许使用默认 12 首； - 品牌或房间气质。 复用已知品类、时段、是否有口播和排除项。只有答案会改变歌单规模或付费槽位时才问。 10 到 20 以外的数量也能做：确认该规模和实时费用，不要当成做不到。 安全默认： - 用户没点名 10 到 20 之间的数量时，用 12 首。 - 槽位搭配：候场、闲聊、讲品、高潮、夜场和收场底乐。 - `instrumental: true` 且不带歌词。 - `model: "suno-5.5"`。绝不省略模型，也绝不悄悄使用 `auto`。 - 没有 `duration` 字段可用在 `beatra.music.generate` 上。时长只写进提示词。不要加 duration 参数。 - 便于循环、给人声留位置，写成提示词方向，而不是单独控件。不要承诺无缝循环或采样级精确秒数。以实际返回时长为准。 歌单规划免费。每次 `beatra.music.generate` 都收费。 ## 标准路径 1. 写房间卡片和带标签的槽位表。每个槽位有用途、情绪、节奏感、乐器、能量和目标时长。 2. 调用 `beatra.models.list` 并传入 `{"capability":"text_to_music"}`，按实时信息卡给整包报价。 3. 确认冻结歌单：槽位数、每个槽位的提示词和曲名、`instrumental: true`、模型、整包当前最高费用，以及每个槽位一个不透明且稳定的 `client_request_id`。做方案不等于批准。 4. 每个槽位只通过随包的 `scripts/mcp_client.py` 提交一次。示例： ```text printf '%s' '{"model":"suno-5.5","prompt":"Low-distraction livestream waiting bed, warm ambient pop, loop-friendly, space for host talk, about 90 seconds.","instrumental":true,"title":"Waiting Bed 01","client_request_id":"opaque-live-waiting-01"}' | python3 scripts/mcp_client.py call beatra.music.generate ``` 不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 作为回退。 5. 用 `beatra.tasks.get` 轮询每个任务。按槽位顺序交付带标签歌单，附上真实时长、MIME 类型、大小、URL 或产物 ID、解析出的模型，以及 `billing.net_charged_credits`。 6. 复核每首底乐是否便于循环、是否给人声留位置、是否贴合槽位。读真实时长。说明宿主 Agent 听不到什么。 ## 需要确认的决策 第一次付费调用前，确认歌单规模和实时整包估价。槽位提示词、曲名、模型或数量一变，只对变化的槽位用新的请求 ID 做新的付费工作。 ## 故障恢复 创建响应丢失时，只重放该槽位冻结后的同一载荷和 ID。任务 ID 丢失时，用 `beatra.tasks.list` 列出文生音乐任务，用 `beatra.tasks.get` 检查候选，先找回原槽位再做新工作。只有用户要求取消该槽位时才用 `beatra.tasks.cancel`；遇到 409 继续轮询。 ## 按任务查阅参考 - 槽位卡片、载荷、轮询、恢复和复核，读直播歌单工作流（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）。 每个 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）。