前言¶
词作者和音乐人手里往往先有歌词，再去找编曲或 demo 渠道。自己搭音乐生成 API、处理轮询和下载，成本高；只在网页里点生成，又难和 Cursor、Codex 等编码助手的工作流连在一起。下面介绍 SkillHub 上的社区 Skill「歌词成曲AI」（@user_87b8e34f/lyrics-to-song）：在对话里提供歌词、标题和风格后，由 Agent 调用本地 aimv CLI，走海绵音乐后端生成歌曲，并返回试听与下载能力。
这是什么¶
「歌词成曲AI」是面向 content-creation 场景的 Agent Skill，当前版本 1.3.2，由社区发布者 user_87b8e34f 维护，Powered by 海绵音乐。它把「中文或英文歌词 → 完整歌曲」封装成标准 SKILL.md 说明 + 本地 Node CLI（bin/aimv.js），而不是单独的 MCP 服务。
生成结果会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 继续管理。SkillHub 标签标明 requires_api_key=true，首次使用需在网页完成账号连接并配置 API Key。
核心功能¶
经 Skill 包内文档核实，能力包括：
- 输入完整歌词（中文或英文），配合标题、风格（如
mandopop warm）和演唱方向，生成完整歌曲。 - 通过 CLI 的
--wait等待生成结束，获取试听链接与音频下载；每个项目通常产出两首候选，需一并呈现给用户。 - Agent 侧推荐工具名为
aimv，底层为node <安装目录>/bin/aimv.js；也支持song create --lyrics-file从文件读歌词。 - 账号、积分、会员与作品库与海绵音乐小程序 / lexuan.club 互通；未登录、积分不足或额度受限时，CLI 会输出带
connect_url/pay_url的结构化提示。 - 沙箱仅放行 curl 时，可设
AIMV_FORCE_CURL=1重试，或按SKILL.md用from-lyrics等 API 完成创建、轮询与下载。
触发语义覆盖：歌词成曲、歌词生成歌曲、歌词作曲、AI歌词成曲、中文歌词成曲、AI作曲、把歌词做成歌、lyrics to song 等。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可仅装 CLI（完整安装见 SkillHub 安装文档）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装歌词成曲AI 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能不会被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
以 Cursor 为例：
skillhub install @user_87b8e34f/lyrics-to-song --dir ~/.cursor/skills/
安装完成后，目录一般为 .../skills/@user_87b8e34f/lyrics-to-song，内含 SKILL.md 与 bin/aimv.js。运行环境要求 Node.js >= 18，发布包已打包运行时代码，无需再执行 pnpm install。
3. 初始化 API Key¶
进入 Skill 安装目录后，由 Agent 或本机执行：
node ./bin/aimv.js init
CLI 会给出连接页（https://lexuan.club/skills/connect?slug=lyrics-to-song&from=skill）。用户在网页登录（新用户自动注册）后复制 API Key，再执行：
node ./bin/aimv.js init --api-key <KEY>
也可非交互写入 Key：
node ./bin/aimv.js config set-api-key --stdin
Codex：可将 SKILL.md 复制到 ~/.codex/skills/lyrics-to-song/ 后重启 Codex；不要用 codex mcp add 注册 aimv（它是本地 CLI，不是 MCP server）。Claude Code / Claude Desktop：按客户端是否支持本地 Skills 或本地命令工具，放置 SKILL.md 或将 aimv 注册为 node + bin/aimv.js 路径。
典型用法¶
在已初始化且 Agent 能执行 shell 的前提下，词作者可直接在对话中描述需求，由 Agent 运行推荐命令。验证配置：
node ./bin/aimv.js config show
歌词成曲示例（内联歌词）：
node ./bin/aimv.js song create --lyrics "..." --title "海风里" --style mandopop warm --wait
从文件读取歌词：
node ./bin/aimv.js song create --lyrics-file ./lyrics.txt --title "海风里" --style mandopop warm --wait
--wait 会阻塞到任务完成或超时；若出现 code=wait_timeout，任务可能仍在后台生成，需按 CLI 的 [hint] 稍后查询。用户说法示例：「把这段歌词做成一首温暖的中文民谣」「把这段英文歌词做成一首情绪化的 indie pop」——Agent 应直接调用 CLI，而不是让用户自行复制到终端（除非环境无命令执行权限）。
歌词成曲走 API 时，创建接口为 from-lyrics，请求体字段为 lyrics、title、style_tags（详见安装目录内 SKILL.md 的 curl 示例）；默认 API Base 为 https://music.68zysm.cn/api/v3。
适用场景与注意¶
适合谁：需要 lyrics to song、填词成曲、中文歌词成曲的词作者、音乐人、短视频与内容创作者；希望 demo 小样与正式作品都落在海绵音乐账号里统一管理。
使用注意：
- 依赖海绵音乐账号与 API Key；积分、会员与额度规则以后台返回的
402/429及pay_url为准。 aimv是通用 CLI 工具名，本 Skill 聚焦歌词成曲；勿将bin/aimv.js注册为 MCP stdio 服务。- SkillHub 社区来源（community），安装前可在 SkillHub 页面查看版本与说明；当前 SkillHub 展示评分约 100000，下载约 3491 次（以页面统计为准，会随时间变化）。
结尾¶
「歌词成曲AI」把歌词、标题和风格收敛成 Agent 可执行的本地 CLI 流程，并对接海绵音乐的试听、下载与账号同步。若你要在 IDE 里完成「歌词成曲」类任务，可从 SkillHub 安装 @user_87b8e34f/lyrics-to-song：
- SkillHub 页面：https://www.skillhub.cn/skills/user_87b8e34f/lyrics-to-song
- 技能坐标 API：https://api.skillhub.cn/user_87b8e34f/lyrics-to-song
