钢琴评估程序 · 英文版 v1.1

使用新版
解压本包，双击本包里的 PianoAssessment.app。
可将新版拖到“应用程序”文件夹使用。请先关闭旧版，避免打开旧包中的同名应用。
新版已经同步“英文版.py”的评分摘要、日志、实时统计、音频状态及提示文字。
保留独立应用所需的资源路径处理、主线程界面更新及录制退出修复。
评分算法、原始示例数据和 JSON 字段格式保持一致。

兼容范围
本包为 Apple Silicon（M1 及后续 M 系列）Mac 应用。
最低系统设置为 macOS 14；本次实测系统为 macOS 26.6.2。
无需 VS Code、Python 或网络连接即可运行。
Windows、Intel Mac、Linux 不能直接运行这个 .app；需要分别构建并测试对应版本。
参考 MIDI 试听无需键盘。录制新的演奏需要 MIDI 键盘。
当前界面不支持直接导入已保存的演奏 JSON 进行评分。
本次检查使用虚拟 CoreMIDI 端口，未连接实体键盘；仍需用你的键盘完成最终试用。
声音使用内置合成音。此版本尚未完成 Apple Developer ID 签名和公证。

多校申请的作品链接建议
建立一个英文作品展示页面或清晰的共享文件夹，并按以下顺序组织：

1. Project Overview / PDF
   说明项目解决什么问题、使用什么方法、主要结果，以及个人工作与团队分工。
   可以使用你已有的 Piano Performance Assessment System 项目 PDF。

2. English Software Demonstration
   按学校时长要求录制新版英文界面操作视频；通用展示可考虑约 1–3 分钟。
   建议展示：导入曲目 → 连接键盘并演奏 → 实时反馈 → 停止 → Overall 等评分 → 导出。
   如使用保存的案例演示，明确标为 saved example，避免让观众误以为是现场录制。
   保留原有团队演示视频时，请另标为 Team System Demonstration。

3. Listening Examples
   放入原有参考演奏与实际演奏的两段音频，清楚标注 Reference / Performance。

4. Optional App Download — Apple Silicon Mac, macOS 14+
   将本 ZIP 作为可选程序下载，写明支持的系统。
   未公证的应用在其他电脑上可能受系统限制，所以评审应能通过 PDF 和视频完成浏览。

5. Source Code & Sample Results
   本包已包含 Source_Code、Sample_Data、Validation 和英文 README。
   可将源码单独提供给希望了解实现的评审。

提交前检查
使用无痕窗口或退出账户后检查链接是否可查看，避免评审需要申请访问权限。
优先让 PDF 和视频可以直接预览，再提供 ZIP 下载。
各学校对外部链接、可执行文件、时长和大小的要求可能不同，请逐校核对。
本次没有创建或发布线上链接。

本包缺少的展示材料
原有外置 SSD 在本次更新时未连接，因此原项目 PDF、团队视频和试听音频未收入本 ZIP。
这些材料可从原始 6.Piano_Performance_Assessment 文件夹补入你的作品展示链接。
新版英文操作视频尚未录制。

英文说明：README_EN.txt
程序验证：Validation/validation.json
更新日期：2026-11-20
