新年配乐·零售歌单

把已经写好的新年档期气氛，做成带标签的原创器乐歌单。常规交付是 8 到 15 首底乐，不是一首歌。

适用范围与相邻路线

零售楼层需要一套可复用的原创器乐，覆盖新年档期时，使用本 Skill。

日间办公或联合办公歌单转到 coworking-day-pack。
直播、夜班或带货歌单转到 livestream-bgm-pack。
品牌广告歌或带唱广告转到 brand-jingle-studio。
带词歌曲转到 beatra-ai-music-creator。

收集楼层

硬输入是：

• 音乐播在哪里（精品店、商场铺位、商超通道，或其他已点名的零售楼层）；
• 歌单要几首，或允许使用默认 10 首；
• 卖方已经写好的新年气氛。

复用已知时段、是否要盖过人声、以及排除项。只补问缺失的硬输入。8 到 15 以外的数量也能做：确认该规模和实时费用。

不要编造促销日期、促销价、品牌口号或歌词。

先做免费分轨表

任何付费写曲前，先写带标签的新年分轨表。卖方没有另报 8 到 15 之间的数量时，默认十首：开门、逛店、试穿或取货、午间、下午和收工，其余用安静的档期重置补齐。每首记下用途、气质、节奏感、乐器、能量，以及写成提示词方向的目标时长。

这份清单就是免费可见结果。规划不是批准。

安全默认：

• instrumental: true 且不带歌词。
• model: "suno-5.5"。绝不省略模型，也绝不悄悄使用
  auto。
• 没有 duration 字段可用在 beatra.music.generate 上。时长只写进提示词。不要加 duration 参数。以实际返回时长为准。

确认生成

任何计费曲目前，读取当前的 beatra.models.list 卡片，能力为
text_to_music。出示一张当前生成生产卡，覆盖冻结后的整包，并等待：

1. 做什么 — 每个点名分轨一首新年器乐，一次生成
   调用（beatra.music.generate）。
2. 积分 — 刚读到的 text_to_music 价格乘以首数。不要复用记忆中的数字。
3. 几笔 — 每首一次付费调用。不要把多首塞进同一次提交。
4. 身份 — 每首一个新的不透明 client_request_id。提示词、曲名、模型或数量变了，就只给变化的分轨换新标识。
5. 若停在这里 — 带标签的分轨表仍然可用。
6. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。卖方说已充值之前不要重试。

每首只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。交付实际字节、实际时长和
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_music"}

printf '%s' '{"model":"suno-5.5","prompt":"Warm new-year retail browse bed, light bells and soft strings, no vocals, about 90 seconds.","instrumental":true,"title":"Browse 01","client_request_id":"opaque-ny-browse-01"}' | python3 scripts/mcp_client.py call beatra.music.generate

不要配置或调用宿主 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