前言¶

做短视频配乐、活动 demo 或原创探索时，常见路径是：在网页里填表单、等生成、再手动下载音频。对话式 Agent 已经能写文案和脚本，但音乐往往还要切到另一套产品，brief 和成片素材也不好在同一条工作流里沉淀。

下面介绍 SkillHub 上的 AI歌曲（@user_87b8e34f/ai-song，v1.3.2）。它把「写需求 → 生成 → 试听与下载」接到 Agent 可执行的本地 aimv CLI（Node 入口 bin/aimv.js），作品同步海绵音乐账号，可在「海绵音乐AI写歌」小程序与 lexuan.club 继续管理。

这是什么¶

AI歌曲 是社区来源（community）的 design-media 类 Skill，由发布者 user_87b8e34f 维护，底层由海绵音乐提供账号与作品库能力。

一句话定位：面向中文创作者的 AI 歌曲创作工具，支持用 brief 写歌、歌词成曲，以及面向流行歌、品牌向内容与歌曲小样的生成方向（见 Skill 包内 SKILL.md 说明）。在助手里你提供主题、情绪、风格、歌词或使用场景，可得到完整歌曲、试听、下载与项目链接。

官方页面：SkillHub - AI歌曲
Skill 坐标：@user_87b8e34f/ai-song
标签：requires_api_key=true（需配置 API Key）

核心功能¶

以下能力均来自 v1.3.2 发布包中的 SKILL.md / INSTALL.md，可与官方简介对照：

1. 一句话 / brief 成曲：通过 song create --brief 描述主题与风格，等待生成后可试听、下载。
2. 歌词成曲：CLI 文档说明可用 API generations/from-lyrics（body 含 lyrics、title、style_tags）；沙箱受限时可用 curl 走同一套接口。
3. 完整交付：生成结果包含项目链接；每个项目固定两首候选歌，需一并呈现给用户。
4. 账号与作品同步：与海绵音乐小程序、lexuan.club 互通积分、会员与作品库。
5. Agent 侧执行：推荐工具名 aimv，实际命令为 node <安装目录>/bin/aimv.js ...（非 MCP server）。

触发语义包括：AI歌曲、AI歌曲生成、AI唱歌、AI写歌、AI作曲、生成歌曲、写一首歌等（完整列表见 SKILL.md）。

安装与启用¶

通过 SkillHub 安装¶

官方要求按 SkillHub 安装与优先源配置 操作。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

先检查 CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装（文档推荐）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill（将 <skills 目录> 换成你当前客户端的路径）：

skillhub install @user_87b8e34f/ai-song --dir <skills 目录>

常用 skills 目录（摘自 skillhub.md）：

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

SkillHub 页面也支持下载 Zip；包内已含可运行代码，无需再 pnpm install 或 build。最低 Node >= 18。

首次连接（API Key）¶

生成前需完成海绵音乐账号连接。Agent 应直接执行：

node <安装目录>/bin/aimv.js init

CLI 会给出连接页：https://lexuan.club/skills/connect?slug=ai-song&from=skill。用户网页登录（新用户可自动注册）后复制 API Key，再由 Agent 执行：

node <安装目录>/bin/aimv.js init --api-key <KEY>

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

各客户端差异（发布包 INSTALL.md）¶

• Codex：将 SKILL.md 复制到 ~/.codex/skills/ai-song/（Windows 为 %USERPROFILE%\.codex\skills\ai-song），重启 Codex；不要用 codex mcp add 注册 aimv。
• Claude / Claude Code：按当前版本支持的 Skills 目录或本地命令工具接入；工具配置为 command: node，args 指向 bin/aimv.js 绝对路径。
• OpenClaw 等：可注册名为 aimv 的本地工具，或让 Agent 读 SKILL.md 后直接跑 shell。

Cursor 未在 INSTALL.md 单独成章，按 skillhub.md 将包装到 ~/.cursor/skills/ 并确保 Agent 能读到 SKILL.md、能执行 node .../bin/aimv.js 即可。

典型用法¶

自然语言触发¶

在对话中可直接说（来自官方示例）：

• AI歌曲，帮我写一首轻快的中文流行歌，主题是夏天旅行
• 帮我生成一首适合毕业季的校园民谣
• 把这段歌词做成一首完整的 AI 歌曲

Agent 有 shell 权限时，应自行跑 CLI，而不是让用户手抄命令。

推荐 CLI 命令¶

用 brief 生成并等待完成：

node <安装目录>/bin/aimv.js song create --brief "AI歌曲，帮我写一首轻快的中文流行歌，主题是夏天旅行" --wait
node <安装目录>/bin/aimv.js song create --brief "帮我生成一首适合毕业季的校园民谣" --style folk mandopop --wait

验证环境与配置：

node <安装目录>/bin/aimv.js config show

沙箱仅放行 curl 时¶

1. 先设 AIMV_FORCE_CURL=1 重试原命令；
2. 若仍不可用，按 SKILL.md 用 from-brief / from-lyrics 调 https://music.68zysm.cn/api/v3，请求头需带 X-App-Id: ai-song 与 X-AIMV-Skill-Slug: ai-song，轮询项目状态后下载 audio_url。

适用场景与注意¶

适合谁：需要 AI 歌曲生成、AI 作曲或「写一首歌」的中文创作者；要为短视频、品牌内容做歌曲小样，或从歌词快速得到可试听成品的团队。

使用注意：

• 依赖海绵音乐账号与积分/会员策略；402 积分不足、429 额度受限时，CLI 会给出 pay_url，需在网页完成充值或开通后重试。
• auth_required 时按 connect_url 完成 Key 配置。
• wait_timeout 表示后台仍在生成，应稍后查询而非当作失败。
• 默认 API Base：https://music.68zysm.cn/api/v3；一般无需改，特殊环境可用 config set-base-url。

SkillHub 抓取数据（2026-10-19）：分类 design-media，评分 100000，下载 5903；腾讯云 SkillHub 镜像页显示约 5.9 千次下载、AI 评分 4.6/5.0，以你安装时商店页为准。

结尾¶

AI歌曲 把中文写歌需求收敛成 Agent 可调用的 aimv CLI：安装 @user_87b8e34f/ai-song、一次性连接海绵音乐 API Key，即可在对话里完成 brief 成曲、歌词成曲与试听下载，并在小程序与 lexuan.club 延续编辑与管理。

官方入口：https://www.skillhub.cn/skills/user_87b8e34f/ai-song
安装说明索引：https://skillhub.cn/install/skillhub.md