前言¶
詞作者和音樂人手裏往往先有歌詞，再去找編曲或 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
