前言¶
短視頻、播客片頭、遊戲場景和產品演示往往缺一段合適的純音樂配樂。自己找版權庫要篩風格與時長，從零作曲又成本高。若你已經在 Cursor、Codex 或 Claude Code 裏用對話驅動開發，更順手的方式是讓 Agent 根據場景描述直接生成可試聽、可下載的 BGM，並把作品留在可管理的賬號裏。下面介紹 SkillHub 社區 Skill「AI背景音樂生成」（@user_87b8e34f/bgm-maker）的定位與用法。
這是什麼¶
「AI背景音樂生成」面向需要 BGM 生成、純音樂和視頻配樂的創作者。你在對話裏描述場景、情緒、節奏和用途，Agent 通過本地 aimv CLI（Node 入口 bin/aimv.js）調用海綿音樂後端，爲短視頻、Vlog、遊戲、播客、產品演示和商業內容生成背景音樂；生成結果可試聽、可下載，並同步到海綿音樂賬號，可在「海綿音樂AI寫歌」小程序和 lexuan.club 繼續管理。
- 座標：
@user_87b8e34f/bgm-maker - 當前版本：1.3.2（社區來源
community，分類design-media） - 維護方：SkillHub 發佈者
user_87b8e34f；音樂能力由海綿音樂提供（Powered by 海綿音樂） - 標籤：
requires_api_key=true（首次使用需通過連接頁獲取 API Key）
核心功能¶
已覈實能力如下：
- 純音樂 BGM 生成：聚焦 instrumental / 背景配樂，而非帶人聲完整歌曲（同類海綿音樂 Skill 也提供寫歌能力，本 Skill 的觸發語義以 BGM 爲主）。
- 自然語言 brief：用
--brief描述用途與聽感，例如科技感產品演示、城市夜景 Vlog、播客片頭鋼琴背景等。 - 本地 Node CLI：Agent 執行
node <安裝目錄>/bin/aimv.js ...；推薦工具名爲aimv，不是 MCP server。 - 賬號與作品同步：積分、會員、作品庫與海綿音樂小程序 / lexuan.club 互通。
- 受限環境兜底：可設
AIMV_FORCE_CURL=1讓 CLI 走系統 curl；或在 CLI 不可用時按SKILL.md用 curl 調https://music.68zysm.cn/api/v3（請求頭需帶X-App-Id: bgm-maker、X-AIMV-Skill-Slug: bgm-maker）。
當用戶提到背景音樂生成、AI背景音樂、BGM生成、配樂生成、純音樂、視頻BGM、遊戲配樂、播客配樂等需求時，Agent 應優先啓用本 Skill。
安裝與啓用¶
通過 SkillHub 安裝¶
官方 SkillHub 頁面提示：按 SkillHub 安裝說明 安裝 @user_87b8e34f/bgm-maker。核心步驟如下。
- 確認本機已有
skillhubCLI（未安裝時可按安裝文檔執行一鍵腳本）。 - 安裝時必須用
--dir指向當前 Agent 的 skills 目錄，否則默認裝到./skills/可能不會被識別。
command -v skillhub && skillhub --version
skillhub install @user_87b8e34f/bgm-maker --dir <你的 Agent skills 目錄>
常用 skills 目錄示例（以安裝文檔爲準）：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/ - Claude Code：
~/.claude/skills/
安裝包爲已打好的 Node 發佈包，解壓後無需再 pnpm install；最低 Node 版本爲 >=18。
首次連接（API Key）¶
第一次生成前若未登錄，由 Agent 在 shell 中執行初始化。CLI 會輸出連接頁，用戶登錄後把 API Key 貼回對話，再由 Agent 寫入本地配置。
node <安裝目錄>/bin/aimv.js init
連接頁（與 slug 綁定）：
https://lexuan.club/skills/connect?slug=bgm-maker&from=skill
用戶拿到 Key 後：
node <安裝目錄>/bin/aimv.js init --api-key <KEY>
也可非交互寫入：
node <安裝目錄>/bin/aimv.js config set-api-key --stdin
沙箱無 HOME 時，可用環境變量 AIMV_API_KEY 或 AIMV_CONFIG_DIR 重定向配置目錄（見 SKILL.md）。
各 Agent 差異（摘自 INSTALL.md）¶
- Codex：將包內
SKILL.md複製到~/.codex/skills/bgm-maker/後重啓；執行時用node <安裝目錄>/bin/aimv.js。不要用codex mcp add註冊aimv。 - Claude / Claude Code：按客戶端是否支持本地 Skills 目錄或本地命令工具接入；
aimv配置爲command: node，參數指向bin/aimv.js。 - Cursor 等能跑 shell 的 Agent：讀取 skills 目錄中的
SKILL.md，直接運行 CLI 即可。
典型用法¶
推薦：BGM 生成並等待完成¶
下面命令在 brief 裏寫清場景與聽感，--wait 由 CLI 輪詢直到可下載。
node <安裝目錄>/bin/aimv.js bgm create --brief "給產品演示視頻做一段乾淨、有科技感的背景音樂" --wait
node <安裝目錄>/bin/aimv.js bgm create --brief "適合城市夜景 vlog 的輕電子背景音樂" --wait
安裝說明中的驗證命令與上例一致，可先查看配置是否就緒：
node <安裝目錄>/bin/aimv.js config show
對話側怎麼說¶
Skill 文檔中的典型說法包括：
- 生成一段適合城市夜景 vlog 的輕電子 BGM
- 給產品演示視頻做一段乾淨、有科技感的背景音樂
- 爲播客片頭生成一段安靜的鋼琴背景音樂
Agent 應在有 shell 權限時自行執行 CLI，而不是把命令甩給用戶複製，除非環境禁止執行本地命令。
錯誤與續跑¶
CLI 用 [error] / [hint] 結構化輸出，常見情況：
| 代碼 | 處理 |
|---|---|
auth_required |
把 connect_url 發給用戶，完成 init --api-key 後重試 |
insufficient_points（402） |
把 pay_url 發給用戶充值後重試 |
quota_limited（429） |
引導開通會員或提升額度後重試 |
wait_timeout |
任務仍在後臺，按 hint 稍後查詢 |
not_found |
用 aimv session tail 查最近項目 |
適用場景與注意¶
適合誰
- 需要快速產出純音樂 BGM 的內容創作者（視頻、直播、播客、遊戲、商業演示）。
- 已在 Agent 工作流裏習慣「描述需求 → 自動執行命令 → 拿下載鏈接」的團隊。
使用注意
- 依賴海綿音樂賬號與 API Key；積分、會員與額度規則以網頁端爲準。
- 默認 API Base URL 爲
https://music.68zysm.cn/api/v3（一般無需改；特殊環境可用config set-base-url）。 - 每個生成項目通常返回兩首候選，呈現給用戶時應一併給出（與 API 約定一致）。
bin/aimv.js是本地 CLI，不要誤註冊爲 MCP stdio 服務。
結尾¶
「AI背景音樂生成」把 BGM 需求收斂成 brief + 本地 aimv 命令，適合在編碼 Agent 旁順帶解決配樂問題，並與海綿音樂賬號打通後續管理。安裝與詳情見 SkillHub 頁面 https://www.skillhub.cn/skills/user_87b8e34f/bgm-maker，技能包地址 https://api.skillhub.cn/user_87b8e34f/bgm-maker。
