技能介绍

为什么需要这个技能？

对于习惯使用中文的创作者来说，直接操作国际 AI 音乐生成工具（如 Suno）时常面临语言障碍：提示词理解偏差、界面不友好，或需要复杂的 API 对接。本技能旨在提供一个纯中文的交互层，将底层 Suno 能力封装成可直接在 AI 助手中调用的命令，解决从创意到成品的「最后一公里」翻译和流程问题。

它是如何工作的？

本技能的核心是一个名为 aimv 的本地命令行工具，它通过以下步骤将你的中文指令转化为音乐：

初始化连接：首次使用需要完成一次性授权。Agent 会引导你通过一个网页链接登录并获取 API Key，之后所有操作都在本地完成。
指令解析与生成：当你用中文描述需求（例如「生成一首流行风格的毕业歌」），Agent 会调用 aimv 命令，将自然语言指令转化为对 Suno API 的结构化调用。关键参数包括：

主题/歌词：支持直接粘贴歌词或输入主题进行自动生成。
风格/BGM：可以指定音乐风格、情绪或具体场景（如「科技感背景音乐」）。
* 参考音频：支持上传一段参考音频来引导生成方向。

异步处理与状态管理：音乐生成是后台任务。CLI 会提供状态查询命令（如 aimv session tail），让你或 Agent 能够跟踪进度。生成完成后，作品会自动同步到关联的「海绵音乐」账号。
成果交付：生成结果包含可试听的音频和下载链接。对于每个项目，通常会生成两首候选歌曲供你选择。

适用边界与关键注意点

依赖特定后端：音乐生成质量完全由 Suno 模型决定，本技能负责流程管理与中文适配。
需要网络与账号：执行任何生成命令前，必须完成 aimv init 并绑定有效账号。生成会消耗账号积分。
环境兼容性：标准 CLI 工具。如果运行环境受限（如某些 Agent 沙箱禁止直接网络调用），需通过设置环境变量 AIMV_FORCE_CURL=1 来切换至 curl 传输模式。
错误处理：CLI 会返回结构化的错误标签（如 [error]、[hint]）。Agent 应遵循错误码进行引导，例如遇到 auth_required 时提供连接链接，遇到 insufficient_points 时提供充值页面，而非简单复述错误信息。