键盘作曲家

要解决什么问题

脑子里蹦出一段旋律，手边只有键盘、没有乐器或记谱软件时，很难把「按键节奏 + 音高直觉」落成可回放、可分享的简谱或音频。纯手动写简谱又容易丢时值；只记字母序列也分不清半拍、休止和八度。这个技能把键盘输入当作「虚拟琴键 + 节拍器」，输出带时值的简谱文本，并能在本地生成 MIDI、播放和导出 MP3/WAV。

核心能力与工作方式

• 键盘记录：用 pynput 监听按键；节奏感知模式按按键间隔（默认 BPM 120）推断时值——按得快对应短音符，间隔长则插入休止。输出形如 1:2（Do 两拍）、0:1.5（休止 1.5 拍）。另有定时录制、实时监听等路径，ESC 结束、Backspace 删除。
• 文本转换：按固定映射把字母/数字键转为简谱（如 l→1、空格→0）；小写为一拍，大写为半拍（如 L→1_）；+/- 表示高低八度。
• 音乐播放：解析简谱文件，用 mido 生成 MIDI（中央 C=60 对应中音 Do），pygame.mixer 播放；BPM 与乐器参数（piano / guitar / violin / trumpet）顺序可任意。播放后可自动导出 MP3。

适用边界与注意点

• 映射表是固定键位→音高，不是真实钢琴布局；创作依赖记忆映射或对照表。
• macOS 需在「辅助功能」里授权终端/Python，否则键盘监听会失败。
• 无声音时检查是否已安装 mido、pygame 等播放依赖；调速可在播放时指定 BPM（如慢板 ~60、中板 ~120）。
• 预设曲目表当前为空，需通过 generate_presets.py 自行扩展；适合旋律草稿、教学记录和生成 MIDI 再进 DAW，而非专业制谱排版。