前言¶

做短視頻配樂、活動 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