用途
suno-lyrics-to-song 用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中，将完整歌词、粗略草稿或一个 hook 转化为结构化的歌曲。生成工作由托管的付费 Beatra 服务（mcp.beatra.ai）完成，输出包含清晰的段落结构、风格和演唱方向。
主要能力
- 将歌词、草稿或 hook 转化为带段落结构的歌曲。
- 提供风格与演唱方向。
- 通过 Beatra 托管服务生成音频。
- 支持免费、不计费的发现操作（如 beatra.models.list、任务列表），用于查看当前模型卡和积分估算。
- 支持一次付费调用：提交一次并轮询返回的任务，报告交付物和 billing.net_charged_credits。
使用方式
该目录条目是一个经过审查的指针，不是可执行包本身，不包含客户端代码，也不会自行执行任何 Beatra 操作。它指向的包捆绑了三个仅使用 Python 标准库的脚本，用于网络调用和存储凭据，没有自更新器，不会下载代码或修改自身文件。
安装需要经过两次批准：
- 将固定版本树获取到审查目录。使用 git clone 并 checkout 指定提交 36aeadd001574361b4375b0c977639c0d3a57ec8 下的 skills/suno-lyrics-to-song，并验证树 ID 为 1b266961fa89e702ec956ffac9724acd17efb643。如果验证未通过则停止。
- 在激活前检查：确认没有符号链接、可执行位或子模块条目；确认没有自更新入口点。
- 复制到宿主机的技能目录（例如 Claude Code 的 $HOME/.claude/skills/suno-lyrics-to-song）。
- 单独授权：运行 authorize.py，会打开浏览器登录并存储一个 bearer token。
使用流程：先阅读已安装包的 SKILL.md 及其引用，了解路由、载荷结构和审查循环；使用免费、不计费的发现操作；向用户展示恰好一次付费调用的成本卡（工具、模型、估算、将上传哪些文件），等待明确批准；只上传用户提供并批准的文件，使用稳定的 client_request_id 提交一次并轮询任务；报告交付物和净扣积分，与用户一起审查结果，任何后续付费阶段前再次询问。
免费连接检查：python3 "$HOME/.claude/skills/suno-lyrics-to-song/scripts/mcp_client.py" verify
卸载：先运行 uninstall.py --dry-run，再运行 uninstall.py。脚本不会删除包目录，确认路径后由用户删除。
适用场景
- 用户明确希望在 Beatra 上生成 Lyrics to Song 音频，并接受这是付费服务。
- 用户同意将歌词、主题或参考音频发送给第三方。
不适用场景：本地 DAW 工作，或未批准付费渲染。
限制
- 需要 Beatra 账户、网络访问、Python 3.10+ 和预付积分。
- 模型、价格、模式和可用性由 Beatra 及其上游模型提供商控制，可能变化；服务按原样提供。
- 输出是概率性的，不保证唯一或不侵权，发布前需要人工审查。
- 该目录条目只审查了上述固定版本树；更新版本属于不同的审查。
- 该固定版本无法自我更新；update 只报告安装副本的商店或工具提供的内容。
安全与安全说明
风险等级：critical 是刻意设定的。
网络：每个请求都是 HTTPS 并拒绝重定向。授权使用 api.beatra.ai，工具调用发往 mcp.beatra.ai；上传是将批准的文件 PUT 到服务器返回的 HTTPS 地址，不带 bearer token。除非缓存决定仍有效（10 分钟到 7 天），每次运行先询问 https://api.beatra.ai/skill-route，当第一个慢或回答 cn 时也询问 https://api.beatra.cn/skill-route。这些探测不携带凭据或包身份。当答案为 cn 时，授权和工具调用发往 api.beatra.cn 和 mcp.beatra.cn，使用相同的 bearer token，版本通知从 www.beatra.cn 读取。
版本通知，无自更新：此版本没有下载或替换包文件的代码，也不在安装目录内写入任何内容。在 verify、tools、upload 或 call 之前，每个安装路径最多每 24 小时记录一次检查时间，并只读地查找其他安装器留在包旁的记录。如果找到，读取 https://beatra.ai/skills/suno-lyrics-to-song/sources.json（无凭据，3 秒超时，64 KiB 上限），如果该安装器提供更新版本，向 stderr 打印一行，包含安装器自己的更新命令。它从不运行该命令。
上传与第三方：提示和上传的媒体发送给 Beatra，并转发给执行任务的第三方模型提供商。Beatra 在中国大陆以外运行服务；在 cn 路由下，请求通过 Beatra 在中国大陆的主机到达。
计费：付费工具消耗预付积分。因 Beatra 或上游模型原因失败的任务积分会自动返还；否则购买不可退款，实际使用可能超过估算并留下负余额。
凭据：authorize.py 运行 OAuth 设备流程，在批准页面打开浏览器，并在 ~/.beatra/credentials.json 中存储一个 bearer token（目录 0700，文件 0600）。token 不会进入 argv、环境变量或输出。它携带完整 Beatra 范围，包括 wallet:spend，具有滑动 15 天空闲生命周期，并由设备上每个 Beatra 技能共享。
本地状态：~/.beatra/ 还保存 installation.json、host.json、skills.json、network.json、balance-holds.json、短期的 .authorize.lock，以及每个安装路径的 updates/<id>/state.json、source.json 和 registration.json。
遥测：授权发送主机名作为设备名、包 slug 和版本、检测到的智能体平台和安装引用。连接后，最多每天一次，除非版本、平台、路由或安装源变化，客户端进行非计费的 beatra.installations.register 调用。每次工具调用添加 source_package_slug 和 source_platform。这些字段没有退出选项。
保留：账户数据在账户生命周期内保留。任务记录、工件和计费账本在账户关闭后为审计和税务目的保留。
内容权利：用户保留其输入的权利，并获得 Beatra 在输出中的权利；用户必须持有上传媒体的权利，且不得创建欺骗性模仿。