前言¶
做音樂二創時，常見路徑是：把 demo 或參考曲丟進網頁工具，手寫提示詞，再在多個頁面裏等生成、挑版本、下載。若你已經在 Cursor、Codex 或 Claude Code 裏用 Agent 寫代碼、改文檔，更希望用自然語言描述「保留律動、改副歌」這類意圖，由 Agent 直接調本地命令完成上傳、生成和輪詢。
下面介紹 SkillHub 社區 Skill「參考音頻改編AI」（座標 @user_87b8e34f/reference-music-remix，當前版本 1.3.2）。它把海綿音樂的生成能力封裝成本地 Node CLI aimv，Agent 通過 SKILL.md 學會在合適時機調用，而不是讓你反覆複製終端命令。
這是什麼¶
「參考音頻改編AI」是一條面向 design-media（子類：音頻處理）的 Agent Skill，由社區發佈者 user_87b8e34f（SkillHub 展示名「AI音樂人」）維護，底層能力由海綿音樂提供。賬號、積分、會員與作品庫與「海綿音樂AI寫歌」小程序及 lexuan.club 互通。
一句話定位：基於參考音頻、demo、歌曲 ID 或項目 ID 繼續創作、改編和生成新音樂；生成結果會同步到海綿音樂賬號，便於在小程序或網頁繼續管理。
Skill 元數據標記 requires_api_key=true，首次使用需通過網頁連接頁獲取 API Key 並完成本地初始化。
核心功能¶
以下能力均來自官方 SKILL.md 與發佈包說明，可與 SkillHub 頁面摘要交叉覈對。
- 多類輸入繼續創作：支持本地參考文件（如 demo）、已有歌曲、項目 ID，在保留律動、情緒或風格方向的前提下產出新的歌曲候選。
- 本地 CLI，非 MCP：推薦工具名爲
aimv，入口爲安裝目錄下的bin/aimv.js，執行方式爲node <安裝目錄>/bin/aimv.js ...。這是通用 Node CLI，不是 MCP stdio 服務，不應使用codex mcp add等方式把aimv註冊成 MCP server。 - Agent 側閉環：具備 shell 權限時，初始化、生成、查詢、下載應由 Agent 直接運行 CLI；未登錄時 Agent 運行
init，把連接頁鏈接發給用戶，用戶登錄後貼回 API Key，再由 Agent 執行init --api-key。 - 結構化錯誤引導：CLI 輸出
[error]/[hint]標籤，覆蓋鑑權（auth_required）、積分（insufficient_points/ 402）、額度（quota_limited/ 429）、等待超時（wait_timeout）等場景，並附帶connect_url或pay_url。 - 受限環境備選：可設置
AIMV_FORCE_CURL=1讓 CLI 走系統 curl；或在 CLI 不可用時按文檔用 curl 調用https://music.68zysm.cn/api/v3下接口完成創建、輪詢與下載。
觸發語義（用戶說法或英文關鍵詞）包括：參考音頻改編、音樂改編、旋律參考、demo改編、參考音樂生成、AI改編歌曲、參考音頻生成、續寫歌曲，以及 reference audio、music remix AI 等。
安裝與啓用¶
通過 SkillHub 安裝¶
SkillHub 官方安裝說明爲：先閱讀 https://skillhub.cn/install/skillhub.md，再安裝座標 @user_87b8e34f/reference-music-remix。也可將下列提示詞發給支持 Skill 安裝的 Agent：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_87b8e34f/reference-music-remix。
頁面還提供 v1.3.2 的 Zip 包下載地址：
https://api.skillhub.cn/api/v1/download?slug=@user_87b8e34f/reference-music-remix
解壓後爲已構建的 Node 發佈包，無需再執行 pnpm install 或 pnpm build。運行環境要求 Node.js >= 18。
本地初始化¶
進入解壓目錄後，先做賬號連接：
node ./bin/aimv.js init
CLI 會輸出連接頁鏈接（形如 https://lexuan.club/skills/connect?slug=reference-music-remix&from=skill）。用戶在該頁登錄（新用戶可自動註冊）並複製 API Key 後，由 Agent 執行：
node ./bin/aimv.js init --api-key <KEY>
也可非交互寫入 Key：
node ./bin/aimv.js config set-api-key --stdin
默認 API Base URL 爲 https://music.68zysm.cn/api/v3，網頁入口爲 https://lexuan.club（見包內 runtime-defaults.json）。
不同 Agent 的差異¶
- Codex：將發佈包內
SKILL.md複製到$HOME/.codex/skills/reference-music-remix/SKILL.md，重啓 Codex；命令使用node <安裝目錄>/bin/aimv.js。 - Claude / Claude Code：按當前客戶端支持的 Skills 目錄或本地命令工具接入；工具名建議
aimv，command爲node，args指向bin/aimv.js的絕對路徑。若僅支持 MCP，需額外 wrapper，本包本身不是 MCP server。 - Cursor 等具備 shell 的 Agent：確保能讀取
SKILL.md，並可直接執行node ./bin/aimv.js ...；有工具註冊能力時，可按INSTALL.md中的 JSON 示例註冊aimv。
驗證配置是否生效：
node ./bin/aimv.js config show
典型用法¶
官方在 SKILL.md 中給出的推薦命令如下。第一條基於本地參考文件；第二條基於已有項目 ID 做延續改編。
node <安裝目錄>/bin/aimv.js song create --brief "保留律動但讓副歌更抓耳" --reference-file ./demo.mp3 --wait
node <安裝目錄>/bin/aimv.js song create --brief "延續這個項目，但副歌更抓耳" --project-id 123456 --wait
--wait 會在 CLI 側等待任務完成；若出現 wait_timeout，任務可能仍在後臺生成，需按 hint 查詢狀態。每個項目通常固定兩首候選，呈現給用戶時應一併說明。
參考音頻上傳也可走 API（需與 CLI 相同的鑑權頭），例如：
curl -F "file=@./demo.mp3" https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload \
-H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
-H "X-App-Id: reference-music-remix" -H "X-AIMV-Skill-Slug: reference-music-remix"
沙箱缺少 HOME 時，可用環境變量 AIMV_CONFIG_DIR 重定向配置目錄，或用 AIMV_API_KEY 替代本地配置文件中的 Key。
適用場景與注意¶
適合誰
- 需要 reference music remix、demo 改編、歌曲二創，且希望在對話裏描述意圖、由 Agent 執行全流程的創作者。
- 已在海綿音樂體系內有賬號/作品，希望生成結果自動同步到小程序或 lexuan.club 的用戶。
使用注意
- API Key 與計費：Skill 依賴海綿音樂賬號；積分不足或觸達額度上限時，需按 CLI 提供的
pay_url在網頁完成充值或會員開通後重試。 - 不要誤註冊 MCP：
aimv是本地 Node 進程，與 MCP server 模型不同；錯誤註冊會導致 Agent 無法按文檔路徑調用。 - 網絡受限沙箱：優先嚐試
AIMV_FORCE_CURL=1；仍失敗時再按SKILL.md中的 curl 三步閉環直接調 API。 - 社區來源：SkillHub 標註來源爲 community，分類 design-media；截至資料抓取時，頁面統計約 9468 次下載、Skill 標籤要求 API Key。使用前請自行評估賬號與內容合規風險。
結尾¶
「參考音頻改編AI」把「參考音頻 / demo / 項目 ID 續寫改編」收斂成 Agent 可執行的 aimv CLI 與一份標準 SKILL.md，適合想把音樂二創留在編碼環境裏、又需要與海綿音樂作品庫打通的場景。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_87b8e34f/reference-music-remix
- 官方 API 入口（Skill 元數據）：https://api.skillhub.cn/user_87b8e34f/reference-music-remix
