这个项目能做什么

ScaleForge 是一款面向钢琴演奏者的交互式练耳与音阶练习应用，由实时 MIDI 输入驱动。它并非静态的参考图表，而是聆听你的演奏并实时响应，旨在将音阶模式转化为肌肉记忆。 README 中描述的核心能力： - 实时 MIDI 反馈：识别 USB 或蓝牙 MIDI 控制器，并在屏幕键盘上高亮显示目标音符与实际演奏音符，声称延迟低于 10ms。 - 自适应节拍器与时序分析：速度会根据准确度自动调整，应用会报告时序偏差（抢拍/拖拍），并提供每次练习的精确度评分和一致性迷你趋势图。 - 音阶库：48 种音阶，涵盖大调、自然小调、和声小调和旋律小调，按 Novice、Adept 和 Virtuoso 难度分级组织，可选指法数字叠加显示。 - 练习日志：练习会话本地记录（无云端），提供趋势分析、每周热力图和面向教师的 CSV 导出。 - 多语言界面：英语、西班牙语、法语、德语、日语、简体中文和韩语。 - 支持：故障排除向导、社区 FAQ 和电子邮件工单，并注明了响应时间窗口。 所述架构：Rust 核心引擎，使用无锁环形缓冲区进行 MIDI 解析；Electron 外壳，搭配 React 19 前端和虚拟化 88 键键盘；可选的基于 FluidSynth 的内部合成，用于无硬件练习；以及 SQLite 持久化，支持 JSON 导入/导出。README 声称提供适用于 Windows 10/11、macOS 12+ 和 Linux 的跨平台二进制文件。 安装被描述为独立目录方式：下载、解压、运行可执行文件、连接 MIDI 设备、选择音阶并按空格键。无需包管理器或终端步骤。 路线图提到五声音阶和布鲁斯音阶、渐隐式“Ghost Practice”节拍器模式、向外部合成器的 MIDI 输出，以及爵士声部连接训练器。该项目声明采用 MIT 许可证，不收集遥测数据，日志本地存储。README 还指出，它是练习辅助工具，不能替代专业指导，且结果取决于 MIDI 硬件和音频缓冲区设置。