简谱文本格式（MHS DSL）
@id: demo-song
@title: 示例曲
@author: 佚名
@key: C ; 1=C
@octave: 5 ; do 的八度（C5 比中央 C 高八度）
@harp: C ; 口琴调性
@time: 4/4
@tempo: 88 4
@difficulty: 2
@tags: 示例, 自然音
@pickup: no ; 弱起曲请写 yes
@source.name: 来源名称
@source.checked: 2026-10-24
---
# 段落名
| 1 2 3 4 | 5 - - - | 1' 7 6 5 | 4. 3 2 1 |
| (56)5!m2 6~ | 0:8 0:8 1 2 | 3!a 4!t 5* 6 |
1–7 音级；0 休止。' 高八度、, 低八度，最多两个。#4 / b3 / n5 临时升、降、还原（同小节内有效，跨小节自动还原；延音线目标音继承）。:8 :16 :32 :2 :1 时值，:4. 附点。- 表示延长一拍（并入前一个音）。(56)5 前倚音（1–4 个，不占书面拍数）；!m2 顺波音（辅助音级 2）；!i7 逆波音；!a 重音；!t 保持音；* 自由延长；~ 延音线。|: :| 反复；|| 段落结束；[3/4] 该小节变拍；# 开头为段落名。
JSON 结构（节选）
{
"formatVersion": 1, "id": "demo-song", "title": "示例曲",
"key": "C", "octave": 5, "harpKey": "C",
"time": [4, 4], "tempo": {"bpm": 88, "beat": 4},
"difficulty": 2, "tags": ["示例"],
"source": {"name": "来源", "checkedAt": "2026-10-24"},
"lines": [{
"section": "A",
"measures": [{
"repeatStart": false, "repeatEnd": false, "time": null,
"events": [{"k": "n", "deg": 1, "acc": 0, "oct": 0,
"dur": {"t": 4, "dots": 0}, "tie": false,
"grace": [{"deg": 5}],
"orn": {"type": "mordent", "aux": {"deg": 2}}}]
}]
}]
}
支持边界
- 只支持单声部旋律：和弦、复调、鼓谱不在本版范围。
- 波音只支持单顺波音与单逆波音，必须给出明确辅助音；不支持颤音（tr）与回音。
- 不支持连音符（三连音）与自由节拍；遇到会明确报错，不会静默丢弃。
- 口琴只支持标准 Richter 十孔的 12 个常用调；Low / High 特殊调性会提示不支持。
- 把位根据主音推断。未写
@tonic 时标为“推定”，不做绝对断言。
- 本版无音频播放、录音识别与图片识谱。
