music-studio（音乐工作室）

Music Studio v1.0.10

MiniMax 音乐创作工作台，对话式引导交付结果。

当前版本正式支持 MiniMax： - 歌词生成：/v1/lyrics_generation - 文本生成音乐：music-2.6 - 翻唱：music-cover 前处理 → music-2.6 最终生成

对话式交互

唤醒：用户说「打开音乐工作室」→ 进入引导流程

流程说明

用户：打开音乐工作室
↓
小盆子：🎵 音乐工作室已就绪！
        请问想做什么？
        1️⃣ 生成音乐
        2️⃣ 写歌词
        3️⃣ 翻唱
        4️⃣ 查看音乐库
        5️⃣ 导出 / 清理
        6️⃣ 会话历史

翻唱实现说明（重要）

当前 MiniMax 翻唱链路不是“直接用 music-cover 产出音频”，而是：

1. POST /v1/music_cover_preprocess，模型使用 music-cover
2. 拿到 cover_feature_id 与自动提取歌词
3. POST /v1/music_generation，模型使用 music-2.6
4. 传入 cover_feature_id、lyrics、prompt 完成最终生成

因此，配置中的 cover_model 实际表示翻唱前处理模型；最终音频生成仍使用 music_model。

风险说明

该 skill 运行时依赖外部 API Key，并会读写本地配置及输出文件。发布到 ClawHub 时不应包含任何真实 key。

CLI 命令

python -m music_studio set-key
python -m music_studio clear-key
python -m music_studio lyrics "<主题>" [--title "标题"] [--edit "歌词"]
python -m music_studio music "<描述>" [歌词] [--instrumental] [--optimizer] [--format url|hex]
python -m music_studio cover "<描述>" --audio <URL> [--lyrics <歌词>]
python -m music_studio library list | get <id> | lyrics <id> | url <id> | download <id>
python -m music_studio library export lyrics <id> | export all | clean | purge
python -m music_studio init / reset / help

Key 策略

• 默认 API Key 保存在用户本机 ~/.config/music-studio/config.json 中，使用 set-key 管理
• 仓库与发布包中不得包含任何真实 API Key
• 可提供 config.example.json 作为示例，但示例文件只能放占位值
• 初始化与对话式 setup 都会做真实 API 校验，避免“假成功”
• 发布前可运行：python scripts/prepublish_check.py

Session 管理器

每次「打开音乐工作室」创建独立会话，数据保存在 output/sessions/。

• 会话历史：说「6」或「会话历史」查看，输入序号恢复
• 自动清理：超过 30 天未更新的会话自动删除
• 每次新会话：打开即新建，不重复复用

版本历史

精简发布说明：1.0.10 完成 API Key 配置策略收敛（移除环境变量依赖，统一本地 config.json）、补齐发布防泄漏规则与发布前自检，适配 ClawHub 发布。