从歌词到音乐的完整创作辅助工具，支持 Claude Code Skills 增强体验
核心价值: 帮助创作者从零完成歌曲创作，支持全类型歌曲、三种创作模式、旋律风格学习，并与 Suno/Tunee 等 AI 音乐平台无缝对接
Musicify 专注于歌词创作和音乐辅助，与 Suno/Tunee 等平台互补。
✅ 做什么:
- 全类型歌词创作 (流行/摇滚/说唱/民谣/电子/古风等)
- 三种创作模式 (教练/快速/混合)
- 🆕 旋律风格学习 - 基于参考歌曲的 MIDI 分析与风格模仿
- 歌词质量评估与优化
- 押韵检查和优化
- 和弦进行生成
- 旋律提示和五线谱导出
- 导出到 Suno/Tunee 平台
❌ 不做什么:
- 生成实际音频文件 (交给 Suno/Tunee)
- 专业编曲制作
- 演唱录音
- MV 制作
基于参考歌曲的 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次 | 精品制作、特殊需求 |
支持主流歌曲类型:
- 🎵 流行 - 主流流行音乐
- 🎸 摇滚 - 摇滚/朋克风格
- 🎤 说唱 - Hip-Hop/Rap
- 🎻 民谣 - 民谣/独立音乐
- 🎹 电子 - EDM/电子音乐
- 🏮 古风 - 中国风/古风
- 🎺 R&B - 节奏布鲁斯
- 🎷 爵士 - 爵士乐
- 🤠 乡村 - 乡村音乐
- 🔥 金属 - 重金属/金属核
教练模式 (Coach) - 100%原创
- AI 引导你思考，逐段创作
- 提问式激发创意
- 质量实时检查
- 适合: 追求原创的创作者
快速模式 (Express) - 快速迭代
- AI 直接生成完整歌词
- 基于规格快速输出
- 适合: 快速原型，灵感激发
混合模式 (Hybrid) - 平衡效率与原创
- AI 生成框架和关键句
- 用户填充细节
- 适合: 需要结构指引的创作者
从主题到音乐平台的完整工作流:
歌词创作阶段:
/spec- 定义歌曲规格/theme- 主题构思/mood- 情绪定位/structure- 结构设计/lyrics- 歌词创作/rhyme- 押韵检查/polish- 润色优化
音乐辅助阶段:
8. /compose - 生成和弦进行、旋律提示和五线谱
9. /melody-mimic - 🆕 旋律风格学习
10. /export - 导出到 Suno/Tunee 等平台
歌词功能:
- ✅ 押韵检查与优化
- ✅ 可唱性检测
- ✅ 意象丰富度分析
- ✅ 情感递进检查
音乐功能:
- ✅ 和弦进行生成 (基于音乐理论)
- ✅ 旋律音高提示
- ✅ 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使用 /melody-mimic-easy 处理 MP3 文件时的预计耗时:
| 设备 | 处理 3 分钟歌曲 |
|---|---|
| Mac M1/M2 | ~3 分钟 |
| Windows + NVIDIA GPU | ~2 分钟 |
| Windows + 集成显卡 | ~10 分钟 |
备选方案: 使用在线工具 basicpitch.spotify.com 转换
# 交互式选择 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
/spec # 1. 定义歌曲规格
/theme # 2. 构思核心主题
/mood # 3. 定位情绪氛围
/structure # 4. 设计歌曲结构
/lyrics # 5. 创作歌词（三种模式）
/rhyme # 6. 押韵检查
/polish # 7. 润色优化
/compose # 8. 生成和弦进行
/export # 9. 导出到平台# 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]
多少往事随风去
化作云烟散
只留一曲探故知
/init <项目名>- 创建新项目/export- 智能导出系统
/spec- 定义歌曲规格/theme- 主题构思/mood- 情绪定位/structure- 结构设计/lyrics- 歌词创作 (交互式选择模式)/fill- 填充混合模式框架/rhyme- 押韵检查/polish- 润色优化
/compose- 生成和弦进行、旋律提示和五线谱/melody-hint- 旋律提示 (已集成到 /compose)/melody-mimic- 旋律风格学习助手（需要 MIDI）/melody-mimic-easy- 🆕 旋律风格学习助手简易版（支持 MP3）
在创作前，系统会生成两份分析报告:
报告 1: 旋律特征分析报告 🎵
- 基本信息（总音符数、音域）
- 调式分析（检测结果、置信度、情感特征）
- 节奏型分布（可视化柱状图）
- 音程分布（大跳、小跳、同度、级进）
- 旋律轮廓（拱形、谷形、连续上行/下行）
报告 2: 歌词深度分析报告 📝
- 结构分析（段落划分、字数结构）
- 意象分析（分类、作用）
- 修辞手法分析
- 词曲契合度分析
- 创作启示
创作完成后可选择生成:
- 原曲与新作的风格一致性对比
- 结构/风格/旋律适配度评分 (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 分析和旋律学习
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!
MIT License
本项目架构参考了 Scriptify 项目。