PianoAI 是一个在浏览器中运行的钢琴练习与谱面研究工具，项目代码与自制数据以 MIT 许可证开源。它把三类东西放进同一个界面：可交互的乐谱、作品结构分析、专业演绎对比。当前曲库包含 7 首内置作品、7 份静态乐谱分析和 41 份专业录音演绎记录。适合两类用户：想系统练习作品的钢琴学习者，以及喜欢对照录音研究演奏处理的爱乐者。正文依次介绍核心功能、安装与使用与使用感受，文末给出项目地址与仓库统计。
场景痛点
练琴的人大概都经历过这样的场景：摊开谱子练，对曲式结构一知半解，想搞懂主题在哪里再现，得另翻一本曲式分析书；想学大师的处理，只能反复听录音，靠耳朵猜哪句渐慢、哪里换了踏板，谱面上没有任何标记；跟弹练习更孤单，弹错一个音，注意力全花在重新对位上。工具也是散的——看谱一个软件、放录音一个软件、记笔记又换个地方。
把这些环节收拢到一张可交互的乐谱上，正是这款效率工具想解决的事，也是这次软件发现里最有价值的设计。
核心功能
练习模式
- 从内置曲库选择作品，或导入本地
MusicXML、XML、MXL文件。 - 左右手可分别设置跟弹，通过键盘或 MIDI 设备逐音、逐和弦导航。
- 点选或框选乐谱设定练习区间，可以循环练习或播放。
- 计划中的改进：更智能的跟弹定位，防止一个错误卡死整个跟弹。
分析模式
- 查看曲式分段、主题与动机，以及左手和弦和复调织体。
- 在分析条目与乐谱之间双向定位，快速跳转到对应小节。
- 选中分析范围后直接播放，结合听觉和谱面理解作品。
演绎模式
- 在同一作品赏析对比不同钢琴家的演奏。
- 在谱面上直观查看速度、力度、时值、和弦时序、踏板和装饰音等演绎信息。
- 在机械原谱、标准化演绎和原始录音之间随时切换，直观感受钢琴家的处理。
- 计划中的功能：钢琴家与用户自己演绎的对比，并针对性地给出建议。
AI 讨论
顶部导航栏的 Ask AI 提供一段可复制的提示词，交给外部 Agent 按需读取PianoAI已发布的曲谱、静态分析和参考演绎记录。可问的问题包括：肖邦《第一叙事曲》的整体结构如何划分、两个主题分别在哪里出现变形和回归；舒曼《梦幻曲》的三个核心动机如何贯穿全曲；齐默尔曼和阿格里奇演奏肖邦《第一叙事曲》时，在速度、力度、音符时值与踏板上有什么差异。这也是它在传统练琴软件之外，往 AI 工具方向迈出的一步。
安装与使用
前置条件
- Node.js
^22.12.0或>=24.0.0，以及 npm 10 或更高版本。 - 普通使用和前端开发不需要安装 Python、CUDA 或转录模型。
安装
从 GitHub 克隆仓库后，在项目目录执行：
浏览器打开 Vite 输出的 Local 地址即可。注意 dev 是本地开发服务器，不等同于把本地音频打包进 dist/ 的 build:local。曲谱与演绎数据的维护（导入标准谱面、转录对齐、生成演绎记录）全部在离线工具中完成，不会增加浏览器运行负担。官方快速开始写得简洁，可以直接当使用教程来用。
日常使用
| 场景 | 推荐用法 |
| 练习新作品 | 练习模式，框选区间循环，左右手分别跟弹 |
| 理解作品结构 | 分析模式，条目与乐谱双向定位，选中范围直接播放 |
| 研究演奏风格 | 演绎模式，在机械原谱、标准化演绎与原始录音间切换 |
| 曲式答疑 | 复制 Ask AI 提示词，交给外部 Agent 读取数据回答 |
我的使用感受
曲库规模不大，但每个作品都有完整链路：乐谱、结构分析、多份专业演绎记录，彼此对得上号。最讨喜的是版权边界写得清楚——代码与自制数据 MIT，第三方乐谱与录音保留各自条款并记录来源。它兼具实用软件的练习价值与有趣软件的研究乐趣，这次工具推荐想说的就是：小而认真的项目，值得在 GitHub精选 观察名单里留个位置。
官方网站
https://github.com/mikezhl/PianoAI
下载地址
https://pan.quark.cn/s/cc28296cec53
