前言¶
短视频、播客片头、游戏场景和产品演示往往缺一段合适的纯音乐配乐。自己找版权库要筛风格与时长，从零作曲又成本高。若你已经在 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。
