Music Box 离线旋律生成器

离线旋律生成的取舍

多数旋律生成技能都绕不开云端 API：Suno 或 FAL.AI 要先配 API Key、联网、消耗额度，最后还得下载 MP3，网络一断或额度用完，工作流直接中断。Music Box 的思路相反——它用 Python 3 标准库在本地合成，不装依赖、不联网、不碰密钥，产出物本身就是文件，拿到哪都能播。

谱面即源码：从文本到声音

核心能力可以概括为三步：

• 写谱面：按 references/tune_format.md 里的极简记法，把音名、时值、和弦和歌词写成 my_tune.txt。格式接近逐行简谱，照着速查表填即可
• 编译：执行 scripts/build.py，纯标准库解析谱面，一次性产出两个文件
• 预览与迭代：HTML 是自包含的 Web Audio 播放器，双击即响；想改曲子，直接编辑 HTML 里的参数刷新即可

产出物分工明确：*.html 带播放/停止/循环/音量控件、钢琴卷帘可视化，谱面写了歌词时还会逐字高亮，像卡拉 OK；*.mid 是标准 MIDI，可导入 GarageBand、FL Studio、Ableton 换音色精修。风格参数有速查表：游戏 BGM 用方波 120–140 拍，lo-fi 用正弦波 70–90 拍多留白，播客片头用三角波 8–16 小节、起止明确。

边界与注意点

• 只做器乐旋律、BGM 和提示音效，不生成带真人声的完整歌曲，那种场景请走 song-generator 或 song-creator
• 只要歌词、不要声音时，直接写文字即可，用不上这个技能
• MIDI 只携带音符事件，音色和混音仍要靠 DAW 处理，它给的是编曲起点而非成品
• Windows 上若 python3 不在 PATH，用 python 或 WorkBuddy 内置解释器调用