前言¶

做短視頻、品牌內容或獨立創作時，音樂往往卡在「有想法、沒成品」：要在 DAW 裏從零搭編曲，或反覆在網頁工具與本地素材之間切換，對話裏很難一次拿到可試聽、可下載的成曲。若希望 Agent 能直接根據 brief、歌詞或參考音頻發起生成，並把作品同步到統一賬號裏管理，就需要把海綿音樂的能力接到本地 Skills 工作流裏。下面介紹 SkillHub 上的 海綿音樂AI寫歌（@user_87b8e34f/haimian-music，當前版本 1.3.2）。

這是什麼¶

海綿音樂AI寫歌 是海綿音樂官方的 AI 音樂生成 Skill，歸類爲 SkillHub design-media，來源爲社區發佈（發佈者 user_87b8e34f）。它在 AI 助手中通過本地 Node CLI（入口 bin/aimv.js，推薦工具名 aimv）調用後端，而不是把 bin/aimv.js 註冊成 MCP stdio 服務。

你描述風格、情緒、歌詞或使用場景後，可在對話鏈路裏完成生成，並獲得試聽、下載和項目鏈接；作品會同步到海綿音樂賬號，並可在「海綿音樂AI寫歌」小程序與 lexuan.club 網頁繼續管理。賬號、積分、會員與作品庫與海綿音樂小程序 / lexuan.club 互通。SkillHub 標記該 Skill 需要 API Key（requires_api_key=true）。

核心功能¶

以下能力均來自官方 SKILL.md 與安裝說明，可按需組合使用：

1. AI 寫歌 / 原創歌曲：用 brief 描述主題與風格，生成完整歌曲候選。
2. 歌詞成曲：提供歌詞、標題與風格標籤，從文本生成成曲。
3. 純音樂 BGM：按場景生成背景音樂（如發佈會開場、短視頻鋪底）。
4. 參考音頻改編：上傳或引用參考素材，生成更貼近需求的版本（需關注參考素材就緒狀態）。
5. 查詢與下載：Agent 通過 CLI 輪詢項目狀態、獲取試聽鏈接並下載音頻；每個項目固定兩首候選，需一併呈現給用戶。

觸發語義包括：海綿音樂、AI音樂生成、AI寫歌、生成音樂、歌詞成曲、BGM生成、背景音樂、參考音頻改編等。

安裝與啓用¶

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. 安裝本 Skill 到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被 Agent 加載。常見路徑示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝命令（與 SkillHub 頁面說明一致）：

skillhub install @user_87b8e34f/haimian-music --dir ~/.cursor/skills

將 ~/.cursor/skills 換成你實際使用的目錄。安裝完成後，Agent 應能讀取包內 SKILL.md，並具備執行 node <安裝目錄>/bin/aimv.js 的能力。發佈包要求 Node >= 18，解壓即用，無需在包內再執行 pnpm install 或 pnpm build。

3. 首次連接（API Key）¶

第一次生成前若未登錄，由 Agent 運行初始化（路徑替換爲你的安裝目錄）：

node <安裝目錄>/bin/aimv.js init

CLI 會輸出連接頁：https://lexuan.club/skills/connect?slug=haimian-music&from=skill。用戶在網頁登錄（新用戶可自動註冊）後複製 API Key，Agent 再執行：

node <安裝目錄>/bin/aimv.js init --api-key <KEY>

Key 長期有效，一般只需配置一次。也可用 node ./bin/aimv.js config set-api-key --stdin 非交互寫入。

Codex：可將 SKILL.md 複製到 ~/.codex/skills/haimian-music/SKILL.md 後重啓 Codex；執行時仍用 node <安裝目錄>/bin/aimv.js，不要用 codex mcp add 把 aimv 當成 MCP server。

Claude 系列：以當前客戶端是否支持本地 Skills / 本地命令工具爲準，按 INSTALL.md 將工具配置爲 command: node + args 指向 bin/aimv.js 的絕對路徑。

典型用法¶

在已連接 API Key、且 Agent 能執行 shell 的前提下，初始化、生成、查詢、下載應由 Agent 直接跑 CLI，而不是讓用戶手動複製一長串命令（除非環境禁止執行本地命令）。

官方推薦示例：

node <安裝目錄>/bin/aimv.js song create --brief "寫一首輕快的中文流行歌，主題是夏天旅行" --wait
node <安裝目錄>/bin/aimv.js song create --lyrics "..." --title "夏天旅行" --style mandopop --wait
node <安裝目錄>/bin/aimv.js bgm create --brief "適合產品發佈會開場的電子 BGM" --wait

驗證環境與配置時可先執行：

node <安裝目錄>/bin/aimv.js config show

若沙箱只允許 curl 聯網，可設 AIMV_FORCE_CURL=1 後重試原命令；或在 CLI 不可用時按 SKILL.md 用 curl 調用 https://music.68zysm.cn/api/v3，請求頭需包含 X-API-Key、X-App-Id: haimian-music、X-AIMV-Skill-Slug: haimian-music 等字段。無 HOME 的環境可用 AIMV_CONFIG_DIR、AIMV_API_KEY 替代本地配置。

適用場景與注意¶

適合誰：需要把「寫歌、成曲、BGM、參考改編」嵌進 Agent 工作流的專業創作者與內容團隊；希望在對話裏拿到雙候選成曲，並在小程序 / lexuan.club 延續編輯的團隊。

使用注意：

1. 積分與會員：insufficient_points（402）或 quota_limited（429）時，CLI 的 [error] 會帶 pay_url=，需在網頁完成充值或開通會員後重試。
2. 鑑權：auth_required 時按 connect_url 完成連接，勿跳過 API Key。
3. 長任務：wait_timeout 表示後臺仍在生成，應按 [hint] 稍後查詢，不等於失敗。
4. 參考改編：reference_not_ready 時需先確認參考素材或項目狀態。
5. 網絡環境：默認 API Base 爲 https://music.68zysm.cn/api/v3；特殊環境可用 node ./bin/aimv.js config set-base-url 調整（一般用戶用不到）。

SkillHub 頁面顯示該 Skill 評分 100000、下載 7324 次（統計以 SkillHub 爲準，會隨時間變化）。

結尾¶

海綿音樂AI寫歌 把海綿音樂官方的寫歌、歌詞成曲、BGM、參考改編與下載能力，收斂成 SKILL.md + 本地 aimv CLI 的標準 Skill 形態，便於在 Cursor、Codex、Claude Code 等環境裏用自然語言驅動成曲。安裝與說明入口：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_87b8e34f/haimian-music
• 官方座標：https://api.skillhub.cn/user_87b8e34f/haimian-music