未打开曲谱

从左侧曲谱库打开一首，或导入 MusicXML / ABC 文件

去「AI 写谱」还能自动生成练习曲

① 离线算法生成（无需联网）

② 大模型写谱（可选）

填入你自己的 API Key（OpenAI 兼容接口，如智谱 GLM）

预览

使用说明

导入曲谱

  • MusicXML（.musicxml / .xml）：MuseScore、西贝柳斯、Overture 等软件都能导出，这是五线谱的通用交换格式。
  • ABC 记谱（.abc / .txt）：纯文本记谱法，AI 生成也用它。

连接钢琴

  • 需要 Chrome / Edge 浏览器，通过 http://127.0.0.1:8321 访问（Web Bluetooth 安全要求）。
  • 点击「连接钢琴」，在弹窗中选择你的琴（名称以 MP / POP Keyboard / PianoProdigy / GPP / Xkey 开头）。
  • 协议已按泡泡钢琴 App 逆向：服务 03B80E5A-…，特征 7772E5DB-…，连接后自动发送控制权握手。
  • 测试时请先断开手机 App 与琴的连接，琴的 BLE 同一时间一般只接受一个连接。

练琴

  • 播放时曲谱上的音符会实时高亮；速度 50%~150% 可调，可循环。
  • 连接钢琴后勾选「琴发声」，播放的音符由钢琴音源演奏；勾选「跟灯」会在琴键上点亮当前音。
  • 节拍器仅对 MusicXML 曲谱生效（ABC 使用自带合成器）。

AI 写谱

  • 「离线算法生成」完全本地运行，按风格/调性/难度随机作曲，适合每天练新的。
  • 「大模型写谱」调用你自己的 OpenAI 兼容接口；浏览器直连失败时会自动走本地代理（serve.py）。