🎼 ToMusicXML 使用帮助

ToMusicXML 是一站式乐谱智能识别与编辑平台。通过拍照、传音频或导入本地 MusicXML 文件， 即可秒变可编辑的五线谱，支持在线编辑、播放、导出。

核心能力：

使用步骤

1. 点击首页「图片转谱」卡片
2. 拖拽或点击上传乐谱图片（支持 PNG / JPG / BMP / TIFF / PDF）
3. 支持 Ctrl+V 直接粘贴截图
4. 点击「开始识别」等待 AI 处理
5. 识别完成后自动进入编辑页面

支持格式

类型	格式	大小限制
图片	PNG / JPG / JPEG / BMP / TIFF	≤ 20MB
文档	PDF	≤ 50MB

使用步骤

1. 点击首页「音频转谱」卡片
2. 上传 MP3 / WAV / M4A 等音频文件，或直接录音
3. 勾选要转录的音轨：人声主旋律（右手） / 伴奏（左手）
4. 可选：指定调性（不指定则自动识别）
5. 点击「开始转谱」，等待 1~3 分钟
6. 完成后自动进入编辑页面

选择音符

• 单击音符：选中单个音符（黄色高亮）
• 框选 / Ctrl+点击：多选多个音符（同时编辑）

编辑操作（顶部工具栏）

按钮	功能	说明
↑ / ↓ 音高	半音升降	每次移动 1 个半音
↑ / ↓ 八度	八度升降	每次移动 12 个半音
← / → 时值	音符时值	在全音符/二分/四分/八分/十六分之间切换
休止符	音 ↔ 休止符切换	把音符变休止符或反向
延音线 (Tie)	同音名连接	连接两个相邻的同音名音符
连音线 (Slur)	不同音名圆滑线	连接两个相邻的不同音名音符

快捷键

基础播放

• 播放 / 暂停：点击底部播放按钮或按 Space
• 停止：点击停止按钮回到开头
• 调速：0.5x ~ 2.0x 自由调整
• 循环：勾选循环自动重播

学曲模式（单步播放）

适合初学者逐小节学习：

1. 点击「学曲」按钮进入单步模式
2. 使用 ← / → 单步前进 / 后退
3. 当前小节高亮，便于定位
4. 再次点击「学曲」退出

播放音色

系统使用真实钢琴音色（Tone.js 合成），支持力度变化（来自识别的实际响度）。

• 曲谱自动保存到「我的曲谱」侧边栏，刷新不丢失
• 点击曲谱名称可重命名
• 支持导出为 MusicXML（兼容 MuseScore / Sibelius / Finale 等专业软件）
• 支持导出为 PNG 图片
• 点击「导入本地」可加载已有 MusicXML 文件继续编辑

Q：识别准确率不高怎么办？

A：建议使用更清晰的图片（分辨率 ≥ 1500px），确保五线谱完整、无遮挡。复杂谱面（多声部、密集音符）准确率会下降，可手动微调。

Q：音频转谱后主旋律不对？

A：音频转录会受伴奏 / 和声干扰。可在「音频转谱」关闭「伴奏」选项单独转主旋律，或指定调性提升准确率。

Q：编辑后怎么保存？

A：所有编辑自动保存到「我的曲谱」。导出使用顶部「导出」按钮。

Q：五线谱和简谱怎么区分？我该选哪个？

A：上传后系统会自动判断并帮你选好（依据是"有没有五条贯穿的谱线"），一般无需手动选择。若想自己确认：

• 🎼 五线谱：有五条横线贯穿整行，音符是画在线上/线间的小圆点（符头）。常见于钢琴谱、合唱谱、出版乐谱书。
• 🔢 简谱（数字谱）：没有五条横线，音符是数字 1~7，开头常写「1=C」这类调号，音符上下可能有小圆点（高低八度）、下方有短横线（减时线）。常见于民歌本、口琴/葫芦丝谱、教材简谱。

两者用的是不同的识别引擎，选错会识别失败——但失败会自动退还额度，且系统会提示"可能选错了类型"，按提示改选后重试即可。

Q：支持的乐器？

A：编辑功能专为五线谱设计。图片识别支持五线谱（钢琴谱 / 合唱谱等）与简谱（数字谱）——上传前请在「原谱类型」中选对类型，两者用的是不同的识别引擎。简谱为实验功能：音高识别较准，节奏（时值/附点）可能有偏差，建议识别后核对。音频转谱目前专注人声 + 钢琴伴奏。

Q：账号与数据

A：登录后曲谱同步到云端，可在多设备访问。本地曲谱存在浏览器中，清除缓存会丢失。