Question 1

什么是悦谱 Dolce？

Accepted Answer

悦谱（Dolce）是一款开源的简谱与五线谱编辑、识谱与排版工具。左侧编辑源码、右侧实时渲染简谱，也能直接在谱面上改音符；支持 123、.jpwabc、文本谱、ABC、MusicXML 等格式，能识别简谱与五线谱图片 / PDF，可排成简谱、五线谱或两者混排，在线试听，导出 PPTX、MIDI、MusicXML、PDF、PNG。既有浏览器在线版，也有 Windows/macOS 桌面版。

Question 2

什么是 123 简谱格式？

Accepted Answer

123 是悦谱的简谱主格式（扩展名 .123），可以看作简谱的 ABC 方言：X:、T:、K:、M:、w: 等字段头以及反复、房号、多声部、演唱顺序沿用 ABC 记谱，音乐体换成简谱数字——1–7 是唱名、0 是休止，' 和 , 表示高低八度，_ 是减时线，- 是增时线，歌词写在 w: 行、汉字连写每字一音。它是 UTF-8 纯文本，适合手写，也能无损承载从 MusicXML、ABC、文本谱和图片识别转来的谱。完整规范见 https://github.com/lodebar2026/dolce/blob/main/docs/%E6%A0%BC%E5%BC%8F/123%E6%A0%BC%E5%BC%8F.md ，编辑器「帮助 → 123 格式」有带实时渲染的教程。

Question 3

能直接在谱面上修改音符吗？

Accepted Answer

可以。悦谱支持谱面可视化编辑：点选音符后用键盘、右键菜单或记号面板修改唱名、八度、升降号、时值、增时线、小节线、圆滑线 / 延音线、延长号、重音，以及插入、删除音符和换行换页。每次修改都写回源码（123 / ABC / .jpwabc / 文本谱均支持），与代码区共用撤销。

Question 4

.jpwabc 是什么格式？

Accepted Answer

.jpwabc 是 JP-Word 简谱软件使用的文本谱面格式，按 .Title/.Voice/.Words 等段描述标题、调号拍号、音符与歌词。悦谱可直接打开、编辑并存回 .jpwabc（UTF-16LE 带 BOM，与 JP-Word 兼容），也能另存为 123 等其它格式。

Question 5

悦谱能识别简谱图片吗？（OMR）

Accepted Answer

可以。把简谱照片、截图或扫描 PDF 拖进页面即可识别成 123 简谱并排版：数字与歌词用 PaddleOCR 模型识别，歌词逐字与音符对位，还能识别标题、词曲与调号，四声部简谱会按声部分开。识别完全在浏览器 / 桌面本地运行、可离线，图片不上传。识别后可在「原图对照」里把结果叠在源图上逐音核对（没把握的地方标黄）、直接改谱和试听，也可打开「并排原图」边看原图边校对；识别前后都能在「原图页」里旋转、裁剪、排序原图再重新识别。

Question 6

悦谱能识别五线谱吗？

Accepted Answer

文字层完整的五线谱 PDF（由制谱软件导出的那种）可以识别成 MusicXML；扫描或拍照的五线谱图片 / PDF 也能识别（独唱谱较可靠，合唱谱扫描件需要较多校对）。识别结果进入五线谱或混排视图，可在原图对照上逐音核对、直接在谱面上改，可试听、导出 MusicXML / MIDI / PDF / PNG。

Question 7

识别到一半能保存、下次接着校对吗？

Accepted Answer

能。识别过的谱可以保存为识别项目（.dolce）：原图、识别结果与正在修改的谱存在一起，重新打开后直接回到原图对照接着校对，不必重新识别。另外编辑器会自动保存草稿，意外关闭或刷新后重开时可恢复。

Question 8

悦谱能编辑合唱谱（多声部）吗？

Accepted Answer

能。「声部」面板可以增删、排序、改名声部，设谱号和移调乐器，把一行谱上的两个声部（闭合谱）按声线或按和弦拆开、或合并回去，在声部之间复制歌词，在五线谱 / 混排里隐藏某个声部；试听时可静音、独奏（练声部）、调各声部音量，还能选简谱旋律和歌词取自哪个声部。

Question 9

怎么给简谱移调？

Accepted Answer

在谱面上用「移调」（编辑菜单或快捷键）：可以全曲换调——简谱是首调唱名，只改调号、数字不变，ABC 和 MusicXML 的音一起移过去；也可以只把选中的音上下移几个半音。移调可撤销。

Question 10

如何把 MusicXML 转成简谱？

Accepted Answer

在悦谱中打开或拖入 .musicxml/.xml 文件：单声部谱可以选择转成 123、JPWABC、ABC 或文本谱继续编辑，也可以保持 MusicXML 用「五线谱」或「混排」视图查看；多声部谱直接进五线谱 / 混排视图，混排会在五线谱上叠一层简谱。

Question 11

悦谱支持 ABC 记谱（ABC notation）吗？

Accepted Answer

支持。.abc 文件由悦谱原生解析，打开即排为简谱，可以直接编辑、存回原文，源码与谱面双向定位到音符；支持多声部（含 & 临时多声部）、连奏、反复 / 房号、和弦、装饰音、歌词、调号变更等。也可以另存为 123 或其它格式。

Question 12

悦谱支持番茄简谱和诗歌本动态谱吗？

Accepted Answer

支持。悦谱把这两套「文本谱」当作第一等源格式：番茄简谱脚本，以及诗歌本文本谱——也就是《诗歌本》app 里所说的「动态谱」。打开或拖入即可直接编辑原文，编辑器自动识别方言并给出语法高亮与诊断，可在「原样」（与印刷版一致）和「展开」（16:9 分页，投影用）版面之间切换，支持四声部并排、和弦、力度、倚音、跳房子等记号；可另存为 123 / JPWABC / ABC，导出 MusicXML、MIDI、矢量 PPTX，也能直接试听。

Question 13

悦谱支持英文界面吗？

Accepted Answer

支持。界面有中文和英文两种，首次打开按浏览器语言自动选择，也可以在「设置 → 其他 → 界面语言」随时切换，即时生效。英文版入口：https://lodebar2026.github.io/dolce/en/

Question 14

macOS 提示「已损坏」或「无法验证开发者」怎么办？

Accepted Answer

因应用未购买苹果开发者签名，首次打开会被拦截。把 Dolce.app 拖入「应用程序」后，打开「终端」运行 xattr -cr /Applications/Dolce.app 清除隔离标记即可正常打开；该命令对所有 macOS 版本通用。或者直接使用浏览器在线版，无需安装。

把乐谱带进来，可编辑，可导出