ai-musicify

v0.8.0

Published

a month ago

AI 驱动的歌词创作和音乐辅助工具 - 支持全流程创作、三种创作模式、作曲辅助、导出到 Suno/Tunee。Claude Code 专属 Skill 增强体验

Musicify - AI 驱动的歌词创作与旋律学习工具

从歌词到音乐的完整创作辅助工具，支持 Claude Code Skills 增强体验

核心价值: 帮助创作者从零完成歌曲创作，支持全类型歌曲、三种创作模式、旋律风格学习，并与 Suno/Tunee 等 AI 音乐平台无缝对接

⚠️ 产品边界

Musicify 专注于歌词创作和音乐辅助，与 Suno/Tunee 等平台互补。

✅ 做什么:

全类型歌词创作 (流行/摇滚/说唱/民谣/电子/古风等)
三种创作模式 (教练/快速/混合)
🆕 旋律风格学习 - 基于参考歌曲的 MIDI 分析与风格模仿
歌词质量评估与优化
押韵检查和优化
和弦进行生成
旋律提示和五线谱导出
导出到 Suno/Tunee 平台

❌ 不做什么:

生成实际音频文件 (交给 Suno/Tunee)
专业编曲制作
演唱录音
MV 制作

🎯 核心功能

1. 🎼 旋律风格学习助手 (v0.6.0+)

基于参考歌曲的 MIDI 和歌词，学习旋律风格并创作原创旋律

/melody-mimic        # 标准版 - 需要 MIDI 文件
/melody-mimic-easy   # 简易版 - 支持 MP3 文件 (v0.8.0+) 🆕

功能特点:

🔍 智能音轨识别 - 多维度评分匹配人声音轨
📊 深度特征提取 - 节奏型、音程、调式专业分析
🤖 AI 风格学习 - 生成风格相似的原创旋律
📋 双报告系统 - 旋律特征报告 + 歌词深度分析报告
🎵 MP3 支持 - 自动将 MP3 转换为 MIDI (v0.8.0+)

支持的调式/音阶 (v0.7.4+):

西方调式: 大调、小调、多利亚、混合利底亚、弗里几亚、利底亚
中国五声: 宫、商、角、徵、羽
其他音阶: 蓝调、和声小调、日本音阶、阿拉伯音阶

四种创作模式 (v0.7.0+):

| 模式 | 时间投入 | 确认次数 | 适用场景 | |------|----------|----------|----------| | ⚡ 快速模式 | 3-8分钟 | 1-2次 | 快速demo、灵感原型 | | 🎯 专业模式 | 10-18分钟 | 3-5次 | 专业创作、主题歌曲 | | 🎓 教练模式 | 20-35分钟 | 6-10次 | 学习创作、技能提升 | | 🔧 专家模式 | 30-60分钟 | 15-25次 | 精品制作、特殊需求 |

2. 全类型歌曲支持

支持主流歌曲类型:

🎵 流行 - 主流流行音乐
🎸 摇滚 - 摇滚/朋克风格
🎤 说唱 - Hip-Hop/Rap
🎻 民谣 - 民谣/独立音乐
🎹 电子 - EDM/电子音乐
🏮 古风 - 中国风/古风
🎺 R&B - 节奏布鲁斯
🎷 爵士 - 爵士乐
🤠 乡村 - 乡村音乐
🔥 金属 - 重金属/金属核

3. 三种创作模式

教练模式 (Coach) - 100%原创

AI 引导你思考，逐段创作
提问式激发创意
质量实时检查
适合: 追求原创的创作者

快速模式 (Express) - 快速迭代

AI 直接生成完整歌词
基于规格快速输出
适合: 快速原型，灵感激发

混合模式 (Hybrid) - 平衡效率与原创

AI 生成框架和关键句
用户填充细节
适合: 需要结构指引的创作者

4. 完整创作流程

从主题到音乐平台的完整工作流:

歌词创作阶段:

/spec - 定义歌曲规格
/theme - 主题构思
/mood - 情绪定位
/structure - 结构设计
/lyrics - 歌词创作
/rhyme - 押韵检查
/polish - 润色优化

音乐辅助阶段: 8. /compose - 生成和弦进行、旋律提示和五线谱 9. /melody-mimic - 🆕 旋律风格学习 10. /export - 导出到 Suno/Tunee 等平台

5. 专业功能

歌词功能:

✅ 押韵检查与优化
✅ 可唱性检测
✅ 意象丰富度分析
✅ 情感递进检查

音乐功能:

✅ 和弦进行生成 (基于音乐理论)
✅ 旋律音高提示
✅ ABC 格式五线谱导出
✅ Suno AI 提示词生成
✅ Tunee AI 对话素材包
✅ 通用格式导出 (给乐手)

旋律学习功能 (v0.6.0+):

✅ MIDI 文件专业分析
✅ 人声音轨智能识别
✅ 节奏型/音程/调式分析
✅ 双报告系统 (旋律+歌词)
✅ 创作成果报告 (可选)
✅ 一致性评分系统

📦 安装

npm install -g ai-musicify

或本地开发:

git clone https://github.com/wordflowlab/musicify.git
cd musicify
npm install
npm run build

旋律学习功能依赖 (可选)

如需使用 /melody-mimic 功能，需要安装 Python 依赖:

# 1. 检查 Python 环境
python3 --version

# 2. 安装必需依赖（MIDI 分析）
pip install mido music21 numpy

# 3. 配置 music21（重要！）
python3 -c "from music21 import configure; configure.run()"

# 4. 【可选】安装 MP3 转 MIDI 依赖（仅 /melody-mimic-easy 需要）
pip install demucs basic-pitch

MP3 转 MIDI 硬件要求 (v0.8.0+)

使用 /melody-mimic-easy 处理 MP3 文件时的预计耗时:

| 设备 | 处理 3 分钟歌曲 | |------|----------------| | Mac M1/M2 | ~3 分钟 | | Windows + NVIDIA GPU | ~2 分钟 | | Windows + 集成显卡 | ~10 分钟 |

备选方案: 使用在线工具 basicpitch.spotify.com 转换

🚀 快速开始

1. 初始化歌曲项目

# 交互式选择 AI 助手、歌曲类型、脚本类型
musicify init "我的第一首歌"

cd "我的第一首歌"

支持13个AI编程助手:

Claude Code, Cursor, Gemini CLI
Windsurf, Roo Code, GitHub Copilot
Qwen Code, OpenCode, Codex CLI
Kilo Code, Auggie CLI, CodeBuddy, Amazon Q Developer

2. 歌词创作流程

/spec         # 1. 定义歌曲规格
/theme        # 2. 构思核心主题
/mood         # 3. 定位情绪氛围
/structure    # 4. 设计歌曲结构
/lyrics       # 5. 创作歌词（三种模式）
/rhyme        # 6. 押韵检查
/polish       # 7. 润色优化
/compose      # 8. 生成和弦进行
/export       # 9. 导出到平台

3. 旋律风格学习

# 1. 准备参考文件
workspace/references/{歌曲名}/
├── {歌曲名}.mid     # MIDI 文件（推荐）
├── {歌曲名}.mp3     # 或 MP3 文件（v0.8.0+ 支持）
└── {歌曲名}.txt     # 歌词文件

# 2. 启动旋律学习
/melody-mimic        # 标准版（需要 MIDI）
/melody-mimic-easy   # 简易版（支持 MP3）🆕

# 3. Claude 将自动:
#    - 检测文件类型（MP3 会自动转换为 MIDI）
#    - 分析 MIDI 文件
#    - 生成旋律特征报告
#    - 生成歌词深度分析报告
#    - 引导创作风格相似的原创作品

歌词文件格式 (兼容 Suno/Tunee):

[Verse 1]
三两笔着墨迟迟
不为记事
随手便成诗

[Chorus]
多少往事随风去
化作云烟散
只留一曲探故知

📚 完整命令列表

项目管理 (2个)

/init <项目名> - 创建新项目
/export - 智能导出系统

歌词创作流程 (8个)

/spec - 定义歌曲规格
/theme - 主题构思
/mood - 情绪定位
/structure - 结构设计
/lyrics - 歌词创作 (交互式选择模式)
/fill - 填充混合模式框架
/rhyme - 押韵检查
/polish - 润色优化

音乐辅助功能 (4个)

/compose - 生成和弦进行、旋律提示和五线谱
/melody-hint - 旋律提示 (已集成到 /compose)
/melody-mimic - 旋律风格学习助手（需要 MIDI）
/melody-mimic-easy - 🆕 旋律风格学习助手简易版（支持 MP3）

🎼 旋律风格学习详解

双报告系统 (v0.7.3+)

在创作前，系统会生成两份分析报告:

报告 1: 旋律特征分析报告 🎵

基本信息（总音符数、音域）
调式分析（检测结果、置信度、情感特征）
节奏型分布（可视化柱状图）
音程分布（大跳、小跳、同度、级进）
旋律轮廓（拱形、谷形、连续上行/下行）

报告 2: 歌词深度分析报告 📝

结构分析（段落划分、字数结构）
意象分析（分类、作用）
修辞手法分析
词曲契合度分析
创作启示

创作成果报告 (v0.7.5+, 可选)

创作完成后可选择生成:

原曲与新作的风格一致性对比
结构/风格/旋律适配度评分 (0-100分)
创作参数记录
优化建议

输出文件

workspace/output/{new-song-name}/
├── {new-song-name}.txt           # 新歌词
├── {new-song-name}.jianpu        # 简谱
├── {new-song-name}.mid           # MIDI
└── {new-song-name}-创作报告.md   # 创作成果报告（可选）

🏗 架构设计

Musicify 基于三层架构:

Markdown指令层 (templates/commands/*.md)
  → 定义AI提示词和工作流程
  → 引导AI如何与用户交互

TypeScript CLI层 (src/cli.ts)
  → 命令行界面
  → 调用Bash脚本

Bash脚本层 (scripts/bash/*.sh)
  → 文件操作和项目管理
  → 输出JSON供AI使用

Skills层 (skills/*.md) 🆕
  → Claude Code 专属增强功能
  → 专业 MIDI 分析和旋律学习

Claude Code Skills 系统

Musicify 提供 4 个专业 Skills:

lyrics - 歌词创作引导助手
compose - 音乐理论与作曲助手
melody-gen - 国风旋律生成助手
melody-mimic - 旋律风格学习助手

🛣 开发路线图

Phase 1-3: ✅ 已完成

核心命令实现、三种创作模式
用户体验优化、交互式设计
音乐辅助集成、Suno/Tunee 对接

Phase 4: Claude Code Skills (已完成 ✅ v0.4.0-v0.5.0)

Skills 系统架构
歌词创作引导助手
国风旋律生成助手

Phase 5: 旋律风格学习 (已完成 ✅ v0.6.0-v0.7.5)

MIDI 专业分析
人声音轨智能识别
双报告系统
多模式确认优化
多风格支持
创作成果报告

Phase 5.5: MP3 支持 (已完成 ✅ v0.8.0)

MP3 转 MIDI 自动转换
Demucs 人声分离集成
Basic Pitch 音频转 MIDI
跨平台硬件检测
在线工具备选方案

Phase 6: 增强功能 (规划中 📋)

更智能的押韵建议
方言支持 (粤语/四川话等)
音节统计和节奏对齐
可唱性深度分析

Phase 7: 生态扩展 (未来 🔮)

支持更多 AI 音乐平台 (Udio, MusicGen 等)
旋律参考库
风格化示例库
社区分享功能

📋 版本历史

| 版本 | 日期 | 主要更新 | |------|------|----------| | v0.8.0 | 2025-12-20 | 🆕 MP3 转 MIDI 支持（/melody-mimic-easy） | | v0.7.6 | 2025-12-19 | Windows PowerShell 编码修复 | | v0.7.5 | 2025-12-19 | 创作成果报告（可选） | | v0.7.4 | 2025-12-19 | 多风格支持（西方调式、蓝调等） | | v0.7.3 | 2025-12-19 | 双报告分析系统 | | v0.7.2 | 2025-12-19 | 歌词格式标准化（Suno/Tunee兼容） | | v0.7.1 | 2025-12-19 | 简谱生成清理 | | v0.7.0 | 2025-12-19 | 多模式确认优化系统 | | v0.6.2 | 2025-12-19 | Claude Code 斜杠命令集成 | | v0.6.0 | 2025-12-19 | 旋律风格学习助手系统 | | v0.5.0 | 2025-12-19 | 国风旋律生成系统 | | v0.4.0 | 2025-12-19 | Claude Code Skill 系统集成 | | v0.3.0 | 2025-11-01 | 作曲辅助与音乐平台集成 |

详细更新日志请查看 CHANGELOG.md

🤝 贡献

欢迎提交 Issue 和 Pull Request!

📄 License

MIT License

🙏 致谢

本项目架构参考了 Scriptify 项目。