diff --git a/JianpuEditor.Tests/Rendering/PdfRestMeasureRenderingTests.cs b/JianpuEditor.Tests/Rendering/PdfRestMeasureRenderingTests.cs new file mode 100644 index 0000000..0e0db2b --- /dev/null +++ b/JianpuEditor.Tests/Rendering/PdfRestMeasureRenderingTests.cs @@ -0,0 +1,105 @@ +using System.Drawing; +using System.Runtime.Versioning; +using JianpuEditor.Rendering; +using JianpuEditor.Tests.Helpers; +using Xunit; + +namespace JianpuEditor.Tests.Rendering +{ + [SupportedOSPlatform("windows")] + public sealed class PdfRestMeasureRenderingTests + { + [Fact] + public void PdfExportOptions_LeaveRestOnlyMeasuresBlank() + { + Assert.True(ScoreLayoutOptions.PdfExport.LeaveRestOnlyMeasuresBlank); + Assert.False(ScoreLayoutOptions.Editor.LeaveRestOnlyMeasuresBlank); + Assert.False(ScoreLayoutOptions.Default.LeaveRestOnlyMeasuresBlank); + } + + [Fact] + public void RenderPdfPageToBitmap_RestOnlyMeasure_LeavesMelodyRowBlank() + { + var restMeasure = ScoreTestHelper.Measure( + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest()); + var noteMeasure = ScoreTestHelper.Measure( + ScoreTestHelper.Note(1), + ScoreTestHelper.Note(2), + ScoreTestHelper.Note(3), + ScoreTestHelper.Note(4)); + var score = ScoreTestHelper.CreateScore(restMeasure, noteMeasure); + + using (var renderer = new JianpuRenderer()) + { + var options = ScoreLayoutOptions.PdfExport; + var bitmap = renderer.RenderPdfPageToBitmap( + score, + ScoreLayoutOptions.PdfRenderWidth, + options, + new PdfPageSlice { FirstLineIndex = 0, LineCount = 1, PageNumber = 1, TotalPages = 1 }); + var layouts = renderer.GetMeasureLayouts(score, ScoreLayoutOptions.PdfRenderWidth, options); + Assert.Equal(2, layouts.Count); + + var restInk = CountDarkPixels(bitmap, MelodySample(layouts[0])); + var noteInk = CountDarkPixels(bitmap, MelodySample(layouts[1])); + + Assert.True(noteInk > 80); + Assert.True(restInk < 20); + Assert.True(restInk < noteInk / 10); + } + } + + [Fact] + public void RenderToBitmap_Editor_StillDrawsRestZeros() + { + var restMeasure = ScoreTestHelper.Measure( + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest()); + var score = ScoreTestHelper.CreateScore(restMeasure); + + using (var renderer = new JianpuRenderer()) + { + var bitmap = renderer.RenderToBitmap(score, 1280, ScoreLayoutOptions.Editor); + var layouts = renderer.GetMeasureLayouts(score, 1280, ScoreLayoutOptions.Editor); + var restInk = CountDarkPixels(bitmap, MelodySample(layouts[0])); + Assert.True(restInk > 80); + } + } + + private static Rectangle MelodySample(JianpuRenderer.MeasureLayout layout) + { + return new Rectangle( + layout.X + 8, + layout.BlockTop + 16, + Math.Max(8, layout.Width - 16), + JianpuRenderer.MelodyRowHeight - 28); + } + + private static int CountDarkPixels(Bitmap bitmap, Rectangle bounds) + { + var count = 0; + var maxX = Math.Min(bitmap.Width, bounds.Right); + var maxY = Math.Min(bitmap.Height, bounds.Bottom); + var startX = Math.Max(0, bounds.Left); + var startY = Math.Max(0, bounds.Top); + for (var y = startY; y < maxY; y++) + { + for (var x = startX; x < maxX; x++) + { + var color = bitmap.GetPixel(x, y); + if (color.R < 200 || color.G < 200 || color.B < 200) + { + count++; + } + } + } + + return count; + } + } +} diff --git a/JianpuEditor.Tests/Services/MeasureRestServiceTests.cs b/JianpuEditor.Tests/Services/MeasureRestServiceTests.cs new file mode 100644 index 0000000..95c0539 --- /dev/null +++ b/JianpuEditor.Tests/Services/MeasureRestServiceTests.cs @@ -0,0 +1,61 @@ +using JianpuEditor.Models; +using JianpuEditor.Services; +using JianpuEditor.Tests.Helpers; +using Xunit; + +namespace JianpuEditor.Tests.Services +{ + public sealed class MeasureRestServiceTests + { + [Fact] + public void IsRestOnly_EmptyMeasure_IsTrue() + { + Assert.True(MeasureRestService.IsRestOnly(new JianpuMeasure())); + Assert.True(MeasureRestService.IsRestOnly(null)); + } + + [Fact] + public void IsRestOnly_AllRests_IsTrue() + { + var measure = ScoreTestHelper.Measure( + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(underlines: 1), + ScoreTestHelper.Rest(underlines: 2), + ScoreTestHelper.Rest()); + + Assert.True(MeasureRestService.IsRestOnly(measure)); + } + + [Fact] + public void IsRestOnly_ContainsMelodyNote_IsFalse() + { + var measure = ScoreTestHelper.Measure( + ScoreTestHelper.Rest(), + ScoreTestHelper.Note(1), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest()); + + Assert.False(MeasureRestService.IsRestOnly(measure)); + } + + [Fact] + public void IsRestOnly_SimultaneousSoundingNote_IsFalse() + { + var measure = ScoreTestHelper.Measure( + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest(), + ScoreTestHelper.Rest()); + measure.Chords = new List + { + new JianpuChord + { + BeatPosition = 0, + Notes = new List { ScoreTestHelper.Note(5) } + } + }; + + Assert.False(MeasureRestService.IsRestOnly(measure)); + } + } +} diff --git a/JianpuEditor/Rendering/JianpuRenderer.cs b/JianpuEditor/Rendering/JianpuRenderer.cs index bd2cd76..f6132f5 100644 --- a/JianpuEditor/Rendering/JianpuRenderer.cs +++ b/JianpuEditor/Rendering/JianpuRenderer.cs @@ -948,7 +948,8 @@ private void DrawTiesForLineRange( if (startLayout == null || endLayout == null || !visibleMeasures.Contains(startLayout) - || !visibleMeasures.Contains(endLayout)) + || !visibleMeasures.Contains(endLayout) + || ShouldHideTieOnBlankRestMeasure(score, tie)) { continue; } @@ -1047,7 +1048,8 @@ private void DrawTies(Graphics g, JianpuScore score, ScoreLayout layout, int sel for (var i = 0; i < score.Ties.Count; i++) { - if (!TryGetTieGeometry(score, layout, score.Ties[i], out var geometry)) + if (ShouldHideTieOnBlankRestMeasure(score, score.Ties[i]) + || !TryGetTieGeometry(score, layout, score.Ties[i], out var geometry)) { continue; } @@ -1095,6 +1097,26 @@ private void DrawTies(Graphics g, JianpuScore score, ScoreLayout layout, int sel } } + private bool ShouldHideTieOnBlankRestMeasure(JianpuScore score, JianpuTie tie) + { + if (_activeLayoutOptions == null + || !_activeLayoutOptions.LeaveRestOnlyMeasuresBlank + || score?.Measures == null + || tie == null) + { + return false; + } + + if (tie.StartMeasureIndex < 0 || tie.StartMeasureIndex >= score.Measures.Count + || tie.EndMeasureIndex < 0 || tie.EndMeasureIndex >= score.Measures.Count) + { + return false; + } + + return MeasureRestService.IsRestOnly(score.Measures[tie.StartMeasureIndex]) + || MeasureRestService.IsRestOnly(score.Measures[tie.EndMeasureIndex]); + } + private static bool TryGetTieGeometry(JianpuScore score, ScoreLayout layout, JianpuTie tie, out TieGeometry geometry) { geometry = default; @@ -1219,6 +1241,13 @@ private void DrawMelodyRow( DrawGapCaret(g, layout, selectedInsertIndex); } + if (_activeLayoutOptions != null + && _activeLayoutOptions.LeaveRestOnlyMeasuresBlank + && MeasureRestService.IsRestOnly(measure)) + { + return; + } + var melodyScale = layout.MelodyScale; var minDrawWidth = melodyScale < 0.999 ? Math.Max(6, (int)Math.Round(MinNoteWidth * melodyScale)) diff --git a/JianpuEditor/Rendering/ScoreLayoutOptions.cs b/JianpuEditor/Rendering/ScoreLayoutOptions.cs index cba96f5..7ecf16f 100644 --- a/JianpuEditor/Rendering/ScoreLayoutOptions.cs +++ b/JianpuEditor/Rendering/ScoreLayoutOptions.cs @@ -1,58 +1,62 @@ -namespace JianpuEditor.Rendering -{ - public sealed class ScoreLayoutOptions - { - public static readonly ScoreLayoutOptions Default = new ScoreLayoutOptions(); - - public static readonly ScoreLayoutOptions Editor = new ScoreLayoutOptions - { - ChordMarkersTextOnly = true, - ShowChordEditorAffordances = true, - CompactAccidentalGlyphs = true - }; - - public static readonly ScoreLayoutOptions PdfExport = new ScoreLayoutOptions - { - MeasuresPerLine = 4, - EqualizeMeasureWidths = true, - NoteWidthScale = 1.0, - HeaderMarginTop = 96, - TitleFontSize = 36f, - MetaFontSize = 18f, - HeaderMetaLeftAligned = true, - ChordMarkersTextOnly = true, - CompactAccidentalGlyphs = true, - RespectAppTheme = false - }; - - public const int PdfRenderWidth = 1280; - - /// 0 = wrap by page width; otherwise fixed measures per line. - public int MeasuresPerLine { get; set; } - - public bool EqualizeMeasureWidths { get; set; } - - public double NoteWidthScale { get; set; } = 1.0; - - /// 0 = use renderer default top margin. - public int HeaderMarginTop { get; set; } - - public float TitleFontSize { get; set; } = 22f; - - public float MetaFontSize { get; set; } = 11f; - - public bool HeaderMetaLeftAligned { get; set; } - - /// PDF 等导出场景：仅绘制和弦文字，不绘制编辑边框与手柄。 - public bool ChordMarkersTextOnly { get; set; } - - /// 编辑界面：显示拍位网格、提示，以及选中态的操作标记。 - public bool ShowChordEditorAffordances { get; set; } - - /// 为 false 时（如 PDF 导出）始终使用浅色纸面。 - public bool RespectAppTheme { get; set; } = true; - - /// 编辑器与 PDF：音符上方标注分层排布（升降号、高音点、装饰音纵向叠放）。 - public bool CompactAccidentalGlyphs { get; set; } - } -} +namespace JianpuEditor.Rendering +{ + public sealed class ScoreLayoutOptions + { + public static readonly ScoreLayoutOptions Default = new ScoreLayoutOptions(); + + public static readonly ScoreLayoutOptions Editor = new ScoreLayoutOptions + { + ChordMarkersTextOnly = true, + ShowChordEditorAffordances = true, + CompactAccidentalGlyphs = true + }; + + public static readonly ScoreLayoutOptions PdfExport = new ScoreLayoutOptions + { + MeasuresPerLine = 4, + EqualizeMeasureWidths = true, + NoteWidthScale = 1.0, + HeaderMarginTop = 96, + TitleFontSize = 36f, + MetaFontSize = 18f, + HeaderMetaLeftAligned = true, + ChordMarkersTextOnly = true, + CompactAccidentalGlyphs = true, + RespectAppTheme = false, + LeaveRestOnlyMeasuresBlank = true + }; + + public const int PdfRenderWidth = 1280; + + /// 0 = wrap by page width; otherwise fixed measures per line. + public int MeasuresPerLine { get; set; } + + public bool EqualizeMeasureWidths { get; set; } + + public double NoteWidthScale { get; set; } = 1.0; + + /// 0 = use renderer default top margin. + public int HeaderMarginTop { get; set; } + + public float TitleFontSize { get; set; } = 22f; + + public float MetaFontSize { get; set; } = 11f; + + public bool HeaderMetaLeftAligned { get; set; } + + /// PDF 等导出场景：仅绘制和弦文字，不绘制编辑边框与手柄。 + public bool ChordMarkersTextOnly { get; set; } + + /// 编辑界面：显示拍位网格、提示，以及选中态的操作标记。 + public bool ShowChordEditorAffordances { get; set; } + + /// 为 false 时（如 PDF 导出）始终使用浅色纸面。 + public bool RespectAppTheme { get; set; } = true; + + /// 编辑器与 PDF：音符上方标注分层排布（升降号、高音点、装饰音纵向叠放）。 + public bool CompactAccidentalGlyphs { get; set; } + + /// PDF：主旋律全为休止符 0 的小节留空，便于手写音符。 + public bool LeaveRestOnlyMeasuresBlank { get; set; } + } +} diff --git a/JianpuEditor/Services/MeasureRestService.cs b/JianpuEditor/Services/MeasureRestService.cs new file mode 100644 index 0000000..169c434 --- /dev/null +++ b/JianpuEditor/Services/MeasureRestService.cs @@ -0,0 +1,53 @@ +using JianpuEditor.Models; + +namespace JianpuEditor.Services +{ + public static class MeasureRestService + { + public static bool IsSoundingNote(JianpuNote note) + { + return note != null + && note.Type == NoteType.Note + && JianpuPitchCodec.IsValidMelodyPitch(note); + } + + public static bool IsRestOnly(JianpuMeasure measure) + { + if (measure?.MelodyNotes == null || measure.MelodyNotes.Count == 0) + { + return true; + } + + foreach (var note in measure.MelodyNotes) + { + if (IsSoundingNote(note)) + { + return false; + } + } + + if (measure.Chords == null) + { + return true; + } + + foreach (var chord in measure.Chords) + { + if (chord?.Notes == null) + { + continue; + } + + foreach (var note in chord.Notes) + { + if (IsSoundingNote(note)) + { + return false; + } + } + } + + return true; + } + } +} diff --git a/README.md b/README.md index 917c8e5..a315ad9 100644 --- a/README.md +++ b/README.md @@ -1,292 +1,292 @@ -# 简谱编辑器 (JianpuEditor) - -基于 C# WinForms 的简谱编辑工具，支持主旋律编辑、装饰音、和弦标识、歌词、连音线，以及 JSON 保存、PDF/MIDI 导出与谱面播放。 - -![简谱编辑器界面截图](Screen%20Sample.png) - -## 功能 - -- **主旋律编辑**：输入音符 1–7、休止符 0，点击音符间隙插入 -- **同时音 / 和弦音（v1.3 #57）** - - 同一拍位可包含多个旋律音符（如 MIDI 导入的和弦音） - - 画布垂直堆叠显示；播放与 MIDI 导出同时发声 - - JSON 以 `Chords[]` 存储；旧谱面仅含 `MelodyNotes` 时打开自动迁移 -- **多选音符** - - **Ctrl + 左键**：增选 / 减选单个音符 - - **Shift + 左键**：从锚点到当前音符范围批量增选 / 减选（可跨小节） - - 跨小节多选时，工具栏「从 / 到」小节范围自动同步高亮 - - 多选时工具栏修饰、删除等操作批量生效 -- **时值修饰** - - **增时+ / 减时-** 六档循环：1/16 → 1/8 → 1/4 → 延 1 拍 → 延 2 拍 → 延 3 拍 - - 高音点 / 低音点 / 附点 -- **音高调整** - - **升 key / 降 key**：在当前调内按音级升降选中音符（1–7 及八度点） -- **拆分 / 合并** - - **拆分**：1/4 音符拆为 2 个 1/8；长于 1/4 的音符拆成等长 1/4 段；1/16 不可拆 - - **合并**：小节内按音符序号两两配对 `(0,1)、(2,3)…` 合并；须谱面相邻、时值比 ≤ 2；音高取前一个；落单不处理 -- **撤回 / 重做** - - 菜单 **编辑 → 撤回**（**Ctrl+Z**）/ **重做**（**Ctrl+Y**），逐步恢复或重放谱面编辑 - - 覆盖音符编辑、删除、小节、转调、谱头 / 歌词 / 和弦内联编辑、连音线、装饰音、批量歌词编辑等；新建 / 打开 / 加载谱面后清空撤回 / 重做栈 -- **装饰音** - - 工具栏「装饰」区：**倚音** / **颤音** / **回音** / **延长**；菜单 **编辑 → 装饰音** 提供相同入口 - - 先选中一个或多个音符，再点击装饰按钮；多选时批量添加 - - 再次点击同类型按钮可取消该音符上的同类型装饰（其他类型保留） - - Delete / 「删除」优先移除选中音符上的装饰音 - - 画布与 PDF 导出在音符上方绘制占位符号（倚 / tr / 回 / 延） - - 谱面播放与 MIDI 导出会展开倚音、颤音、回音、波音与延长时值 -- **连音线** - - 点「连音线」→ 选起始音符 → 选结束音符；Esc 取消 - - 点击弧线可选中（蓝色高亮） - - Delete / 「删除」可移除选中的连音线 - - 删除连音线首/尾音符时，连音线自动清除 -- **和弦标识（副旋律行）** - - 每小节最多 4 个和弦标识，与四分拍位置对齐 - - 点击空白拍位新增；点击标识可内联编辑 - - 拖动 `::` 改变拍位；拖到另一标识拍位可交换顺序 - - 点击 `x` 或 Delete 删除；工具栏「和弦」框可同步编辑选中项 - - 仅识别为和弦符号的文本会参与播放与 MIDI 导出 -- **谱头编辑**：点击谱面标题、调号、速度、BPM、作曲者直接内联编辑（工具栏已精简） -- **和弦转调** - - 菜单「编辑 → 和弦转调...」 - - 输入目标调号后，自动转调副旋律中所有和弦符号（如 `C` → `G`、`Bm7` → `F#m7`、`G/D` → `D/A`） - -- **和弦建议（v2.0 #31）** - - 菜单「编辑 → 和弦建议...」 - - 单小节：根据调号与旋律音高推荐 1–3 个和弦（如 C 大调 I / V / vi） - - 连续多小节：综合旋律低音与和声走向，推荐 1–3 组进行（如 I–IV–V–I），一键写入各小节 - - 纯本地规则，无外部 LLM - - 同步更新曲谱调号字段；主旋律数字简谱不转调 - - 支持调号格式：`C`、`1=G`、`F#`、`Bb`、`D大调` 等 -- **歌词** - - 点击歌词行内联编辑整行 `LyricText` - - **批量编辑歌词**：菜单 **编辑 → 批量编辑歌词...**，按小节范围列出各行歌词，可一次修改多小节 - - 可选 **重新对齐当前范围**：将歌词按音节映射到主旋律音符（跳过休止符与连音线延续音），写入 `LyricSyllables` - - 对齐后画布逐字显示在对应音符下方；未对齐时仍显示整行歌词 - - 批量修改合并为单条撤回记录（**Ctrl+Z** 一步恢复） -- **三行排版**：主旋律、和弦标识、歌词 -- **小节操作** - - 新建小节；**编辑 → 新增小节（含占位符）**（**Ctrl+Shift+N**）可预填 4 个四分音符占位 - - **视图 → 新增小节默认填充占位符** 可让普通「新增小节」也带占位符 - - 工具栏设置「从 / 到」小节号后复制小节范围 -- **文件**：JSON 格式保存 / 打开 -- **PDF 导出**：A4 纵向，每行 4 小节；长谱面自动多页分页（首页完整谱头，续页显示标题与页码）；升降号、高音点、装饰音分层排布（避免窄音符重叠）；和弦仅输出文字，无编辑边框 -- **MIDI 导出** - - 主旋律按简谱时值与调号导出；装饰音展开为额外 MIDI 音符或延长时值 - - 和弦按拍位起止时间导出柱式和弦（如 `D`、`Bm7`、`G/D`） - - 速度由 BPM 控制（与谱面「速度」文字独立） -- **MIDI 导入（Spike）** - - **文件 → 导入 MIDI... (Spike)**：从 `.mid` 生成可编辑简谱 - - 自动检测调号（含 `1=B` 等）、十六分音符量化、4/4 小节规范化（拆分过长小节、补齐休止符） - - 同一时刻的多个音符合并为同时音槽位，不再丢失和弦音 - - 半音音高映射为 `.5` 表示（如 `1.5` = `#1`，`2.5` = `b3`），画布 / 播放 / MIDI 导出保持一致 -- **谱面播放** - - 工具栏「播放 / 停止」，按 BPM 实时播放主旋律与和弦 - - 可拖动蓝色进度条跳转；演奏逻辑与 MIDI 导出共用调度（含装饰音展开） - -## 环境要求 - -- Windows -- [.NET Framework 4.7.2](https://dotnet.microsoft.com/download/dotnet-framework/net472) 或更高 -- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)（用于单元测试；仓库根目录 `global.json` 指定版本） -- Rider 运行测试需安装 **.NET 8 x86 运行时**（32 位 ReSharper Test Runner 使用 `Program Files (x86)\dotnet`）；升级 TFM 后请 **Build → Rebuild Solution** 并清除旧的 `bin/Debug/net6.0` 缓存 -- 播放功能需要系统可用的 MIDI 合成器（如 Microsoft GS Wavetable Synth） - -## 构建与运行 - -```powershell -dotnet build JianpuEditor.sln -c Debug -dotnet test JianpuEditor.sln -c Debug # 需要 .NET 8 SDK -.\scripts\check-format.ps1 # 代码格式检查（CI 同款） -dotnet format JianpuEditor/JianpuEditor.csproj # 自动修复格式 - -构建时会自动运行 Roslyn 分析器（`Microsoft.CodeAnalysis.NetAnalyzers`，Recommended 规则集），规则见根目录 `Directory.Build.props` 与 `.editorconfig`。 -.\JianpuEditor\bin\Debug\net472\JianpuEditor.exe -``` - -Release 构建： - -```powershell -dotnet build JianpuEditor.sln -c Release -.\JianpuEditor\bin\Release\net472\JianpuEditor.exe -``` - -## 安装包 - -使用 Inno Setup 构建 Windows 安装程序： - -```powershell -.\scripts\build-installer.ps1 -``` - -输出文件：`installer/output/JianpuEditor-Setup-1.2.0.exe` - -## CI/CD - -GitHub Actions 工作流位于 `.github/workflows/`： - -| 工作流 | 触发 | 说明 | -|--------|------|------| -| **CI** | `main` 分支 push / PR | `dotnet format` 检查 + Roslyn 分析器 + Release 构建 + 单元测试 + MIDI 冒烟测试（含 NuGet / .NET 缓存） | -| **Release** | 推送标签 `v*` 或手动运行 | 构建安装包（`.exe` + `.zip`），标签发布时自动创建 GitHub Release | - -### 发布新版本 - -```powershell -git tag v1.2.0 -git push origin v1.2.0 -``` - -也可在 GitHub **Actions → Release → Run workflow** 中手动指定版本号，仅生成安装包 artifact（不创建 Release）。 - -## 基本操作 - -| 操作 | 说明 | -|------|------| -| 点击音符 | 选中并修改时值、八度、附点等 | -| Ctrl / Shift + 点击音符 | 多选音符；跨小节时同步高亮小节范围 | -| 点击音符间隙 | 在该位置插入新音符 | -| 点击谱头字段 | 内联编辑标题、调号、速度、BPM、作曲者 | -| 点击和弦标识 | 选中并内联编辑；工具栏「和弦」框同步 | -| 点击副旋律空白拍位 | 在该拍位添加和弦标识 | -| 点击歌词行 | 行内编辑整行歌词 | -| 批量编辑歌词 | **编辑 → 批量编辑歌词...**；可勾选重新对齐，对齐后逐字显示在音符下 | -| 增时+ / 减时- | 六档时值循环（1/16 至延 3 拍） | -| 升 key / 降 key | 在当前调内升降选中音符音高 | -| 拆分 / 合并 | 拆分或合并选中音符时值 | -| 工具栏「从 / 到」+ 复制小节 | 复制指定范围的小节 | -| 连音线 | 点「连音线」→ 选起始/结束音符；点击弧线选中，Delete 删除 | -| 装饰音 | 选中音符后点工具栏「倚音 / 颤音 / 回音 / 延长」；再次点击同按钮取消 | -| 撤回 / 重做 | **编辑 → 撤回 / 重做** 或 **Ctrl+Z** / **Ctrl+Y** | -| 播放 / 停止 | 按 BPM 播放谱面；拖动蓝色进度条可跳转 | -| 转调 | 菜单「编辑 → 和弦转调...」；仅转调和弦标识 | -| 导出 PDF / MIDI | 菜单「文件」导出 | -| 导入 MIDI | **文件 → 导入 MIDI... (Spike)** | -| 深色模式 | 菜单 **视图 → 深色模式**（设置会保存到本地，PDF 导出仍为浅色纸面） | - -启动后自动加载《欢乐颂》示例曲谱。`sample/` 目录提供更多示例（如《卡农》），可通过 **文件 → 示例曲库** 或工具栏 **曲库** 加载。 - -## 和弦标识 - -每小节最多 4 个标识，每个包含自由文本与拍位（`BeatPosition`，0 为第 1 拍）。 - -编辑界面示例（第 1 小节两个和弦）： - -``` -拍位: 0 2 - C G -``` - -播放与 MIDI 导出时，仅解析合法和弦符号；非和弦文字保留显示但不发声。 - -支持和弦类型：大三、小三、`7`、`maj7`、`m7`、转位（如 `G/D`）等常见写法。 - -### 和弦转调 - -从当前调号（如 `1=C`）转到目标调号（如 `G` 或 `1=G`）时，遍历各小节 `ChordMarkers`，仅对 `ChordParser` 识别为和弦符号的文本做半音转调；自由文字（如「间奏」）保持不变。转调后调号字段更新为 `1=目标音名` 格式。 - -主旋律简谱数字（1–7）不参与转调；若需移调旋律，请手动编辑。 - -## 歌词与对齐 - -每小节歌词有两种表示： - -- **`LyricText`**：整行文本，点击歌词行可直接编辑 -- **`LyricSyllables`**：音节列表，每个音节绑定一个主旋律音符索引 - -**重新对齐**规则： - -- 中文按字、英文按空格分词，依次映射到可对齐的旋律音符 -- 休止符、连音线延续音（tie 终点）不参与对齐 -- 歌词字数与音符数不一致时，对齐尽可能多的音节并在状态中提示超出 / 剩余 - -**批量编辑歌词**对话框支持指定「从第 N 到第 M 小节」，初始范围取自当前选中小节；修改后可选重新对齐，所有变更作为一条操作可撤回。 - -## 曲谱文件格式 - -曲谱保存为 JSON（`.json` / `.jianpu`），主要字段： - -- `Title`、`KeySignature`、`Tempo`、`Bpm`、`Composer` -- `Measures[]`：每小节含 `MelodyNotes`、`Chords`、`ChordMarkers`、`LyricText`、`LyricSyllables`、`Ornaments` -- `Ties[]`：连音线（起始/结束小节与音符索引） - -小节字段说明： - -| 字段 | 说明 | -|------|------| -| `MelodyNotes[]` | 主旋律槽位（每拍一个主音视图）；`Pitch` 为 `1`–`7` 或 `1.5` / `2.5` 等半音（配合 `Accidental`） | -| `Chords[]` | 同时音槽位：`{ "BeatPosition": 0, "Notes": [ ... ], "Text": "" }`；`Notes` 可含多个同时发声的音符 | -| `ChordMarkers[]` | `{ "Text": "C", "BeatPosition": 0 }`（副旋律行和弦符号，与 `Chords` 不同） | -| `LyricText` | 歌词整行文本 | -| `LyricSyllables[]` | 逐音节歌词，`{ "Text": "你", "NoteIndex": 0, "BeatPosition": 0 }`；有数据时画布按音符逐字绘制 | -| `Ornaments[]` | 装饰音，`{ "Type": "Trill", "NoteIndex": 0, "BeatPosition": 0 }`；`Type` 为枚举名（如 `GraceNote`、`Trill`、`Turn`、`Fermata`） | -| `Pitch` / `Accidental` | 自然音 `Pitch: 3`；半音如 `Pitch: 1.5, Accidental: "Sharp"`（显示 `#1`）或 `Pitch: 2.5, Accidental: "Flat"`（显示 `b3`） | - -打开旧谱面时，若仅有 `LyricText` 而无 `LyricSyllables`，仍按整行显示；执行重新对齐或批量编辑并勾选对齐后，会生成音节数据。无 `Ornaments` 或 `Chords` 字段的旧文件可正常打开；加载时 `MelodyChordService` 会将 `MelodyNotes` 自动迁移为 `Chords`。 - -`Tempo` 为谱面显示用语（如「中速」），`Bpm` 为播放与 MIDI 使用的每分钟拍数（默认 120）。 - -## 日志 - -运行日志写入： - -``` -%LocalAppData%\JianpuEditor\logs\jianpu-editor.log -``` - -播放或 MIDI 相关出错时，错误弹窗会提示上述日志路径。 - -## 架构（MVVM） - -本项目采用 **CommunityToolkit.Mvvm** + **Microsoft.Extensions.DependencyInjection**，将 WinForms 界面与编辑逻辑分离： - -| 层次 | 目录 | 职责 | -|------|------|------| -| **View** | `MainForm.cs`、`Views/`、`Controls/` | 菜单、工具栏、对话框；`ILayoutService` / `WinFormsLayoutService` 管理布局与 DPI；瘦 View 层仅处理 WinForms 与文件选择 | -| **Glue** | `Glue/` | `MainFormViewBinder`（控件 ↔ ViewModel 双向绑定）、`ScoreCanvasGlue`（画布刷新与选择同步）、`ScoreSelectionMapper` | -| **ViewModel** | `ViewModels/` | 编辑命令、谱面状态、选择协调；通过 `IAppMessenger` 发布 `ScoreEditedMessage` 等 | -| **Model** | `Models/` | 纯 POCO：`JianpuScore`、小节、音符、和弦标识 | -| **Core** | `Core/Abstractions/`、`Core/Messaging/` | 服务接口（`IScoreFileService`、`IScoreUndoService`、`IPdfExportService` 等）与消息总线 | -| **Services** | `Services/` | 静态业务实现 + DI 适配器；含 `MelodyChordService`（同时音槽位与迁移）、`EditCommandHistory`（撤回 / 重做）、`OrnamentService`、`OrnamentPlaybackService`、`LyricAlignmentService`、`BulkLyricEditService`、`NoteSplitMergeService`、`JianpuPitchService` 等 | -| **Rendering** | `Rendering/` | 布局、绘制、`AppTheme`（浅色/深色主题） | - -**数据流**：用户操作 → `MainForm` 调用 ViewModel 方法 → 返回 `ScoreEditResult` → `ScoreCanvasGlue` 更新画布 → `MainFormViewBinder` 同步控件。 - -**依赖注入**（`AppBootstrapper.cs`）：所有 ViewModel 与 Service 接口注册为 Singleton，`MainForm` 为 Transient。 - -## 项目结构 - -``` -JianpuEditor/ - Program.cs # 启动、DI 容器、主题加载 - AppBootstrapper.cs # 服务与 ViewModel 注册 - MainForm.cs # 主界面（瘦 View 层） - Views/ # ILayoutService、布局上下文 - Glue/ # View ↔ ViewModel 胶水层 - ViewModels/ # MVVM ViewModel（10 个） - Core/ # 接口抽象与消息 - Controls/ScoreCanvas.cs # 画布、选择、播放进度条、和弦内联编辑 - Models/ # 曲谱、小节、音符、连音线、和弦标识 - Rendering/ # 布局、绘制、AppTheme - Services/ # JSON/PDF/MIDI、播放、和弦解析/转调、连音线维护 - installer/ # Inno Setup 安装脚本 - scripts/ # 构建与测试脚本 - sample/ # 示例曲库（.jianpu / .json） -JianpuEditor.Tests/ # xUnit 单元测试（248 个；服务、ViewModel、Glue、绘制） -``` - -## 依赖 - -- [CommunityToolkit.Mvvm](https://www.nuget.org/packages/CommunityToolkit.Mvvm) 8.4.0 -- [Microsoft.Extensions.DependencyInjection](https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection) 8.0.1 -- [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json) 13.0.3 -- [PDFsharp](https://www.nuget.org/packages/PDFsharp) 6.2.0 - -MIDI 导出与谱面播放为自研实现，无第三方 MIDI 库。 - -## 贡献 - -欢迎通过 Issue 与 Pull Request 参与改进。提交代码前请阅读 [贡献者许可协议（CLA）](CLA.md)，并在首个 PR 中确认同意。 - -## 许可证 - +# 简谱编辑器 (JianpuEditor) + +基于 C# WinForms 的简谱编辑工具，支持主旋律编辑、装饰音、和弦标识、歌词、连音线，以及 JSON 保存、PDF/MIDI 导出与谱面播放。 + +![简谱编辑器界面截图](Screen%20Sample.png) + +## 功能 + +- **主旋律编辑**：输入音符 1–7、休止符 0，点击音符间隙插入 +- **同时音 / 和弦音（v1.3 #57）** + - 同一拍位可包含多个旋律音符（如 MIDI 导入的和弦音） + - 画布垂直堆叠显示；播放与 MIDI 导出同时发声 + - JSON 以 `Chords[]` 存储；旧谱面仅含 `MelodyNotes` 时打开自动迁移 +- **多选音符** + - **Ctrl + 左键**：增选 / 减选单个音符 + - **Shift + 左键**：从锚点到当前音符范围批量增选 / 减选（可跨小节） + - 跨小节多选时，工具栏「从 / 到」小节范围自动同步高亮 + - 多选时工具栏修饰、删除等操作批量生效 +- **时值修饰** + - **增时+ / 减时-** 六档循环：1/16 → 1/8 → 1/4 → 延 1 拍 → 延 2 拍 → 延 3 拍 + - 高音点 / 低音点 / 附点 +- **音高调整** + - **升 key / 降 key**：在当前调内按音级升降选中音符（1–7 及八度点） +- **拆分 / 合并** + - **拆分**：1/4 音符拆为 2 个 1/8；长于 1/4 的音符拆成等长 1/4 段；1/16 不可拆 + - **合并**：小节内按音符序号两两配对 `(0,1)、(2,3)…` 合并；须谱面相邻、时值比 ≤ 2；音高取前一个；落单不处理 +- **撤回 / 重做** + - 菜单 **编辑 → 撤回**（**Ctrl+Z**）/ **重做**（**Ctrl+Y**），逐步恢复或重放谱面编辑 + - 覆盖音符编辑、删除、小节、转调、谱头 / 歌词 / 和弦内联编辑、连音线、装饰音、批量歌词编辑等；新建 / 打开 / 加载谱面后清空撤回 / 重做栈 +- **装饰音** + - 工具栏「装饰」区：**倚音** / **颤音** / **回音** / **延长**；菜单 **编辑 → 装饰音** 提供相同入口 + - 先选中一个或多个音符，再点击装饰按钮；多选时批量添加 + - 再次点击同类型按钮可取消该音符上的同类型装饰（其他类型保留） + - Delete / 「删除」优先移除选中音符上的装饰音 + - 画布与 PDF 导出在音符上方绘制占位符号（倚 / tr / 回 / 延） + - 谱面播放与 MIDI 导出会展开倚音、颤音、回音、波音与延长时值 +- **连音线** + - 点「连音线」→ 选起始音符 → 选结束音符；Esc 取消 + - 点击弧线可选中（蓝色高亮） + - Delete / 「删除」可移除选中的连音线 + - 删除连音线首/尾音符时，连音线自动清除 +- **和弦标识（副旋律行）** + - 每小节最多 4 个和弦标识，与四分拍位置对齐 + - 点击空白拍位新增；点击标识可内联编辑 + - 拖动 `::` 改变拍位；拖到另一标识拍位可交换顺序 + - 点击 `x` 或 Delete 删除；工具栏「和弦」框可同步编辑选中项 + - 仅识别为和弦符号的文本会参与播放与 MIDI 导出 +- **谱头编辑**：点击谱面标题、调号、速度、BPM、作曲者直接内联编辑（工具栏已精简） +- **和弦转调** + - 菜单「编辑 → 和弦转调...」 + - 输入目标调号后，自动转调副旋律中所有和弦符号（如 `C` → `G`、`Bm7` → `F#m7`、`G/D` → `D/A`） + +- **和弦建议（v2.0 #31）** + - 菜单「编辑 → 和弦建议...」 + - 单小节：根据调号与旋律音高推荐 1–3 个和弦（如 C 大调 I / V / vi） + - 连续多小节：综合旋律低音与和声走向，推荐 1–3 组进行（如 I–IV–V–I），一键写入各小节 + - 纯本地规则，无外部 LLM + - 同步更新曲谱调号字段；主旋律数字简谱不转调 + - 支持调号格式：`C`、`1=G`、`F#`、`Bb`、`D大调` 等 +- **歌词** + - 点击歌词行内联编辑整行 `LyricText` + - **批量编辑歌词**：菜单 **编辑 → 批量编辑歌词...**，按小节范围列出各行歌词，可一次修改多小节 + - 可选 **重新对齐当前范围**：将歌词按音节映射到主旋律音符（跳过休止符与连音线延续音），写入 `LyricSyllables` + - 对齐后画布逐字显示在对应音符下方；未对齐时仍显示整行歌词 + - 批量修改合并为单条撤回记录（**Ctrl+Z** 一步恢复） +- **三行排版**：主旋律、和弦标识、歌词 +- **小节操作** + - 新建小节；**编辑 → 新增小节（含占位符）**（**Ctrl+Shift+N**）可预填 4 个四分音符占位 + - **视图 → 新增小节默认填充占位符** 可让普通「新增小节」也带占位符 + - 工具栏设置「从 / 到」小节号后复制小节范围 +- **文件**：JSON 格式保存 / 打开 +- **PDF 导出**：A4 纵向，每行 4 小节；长谱面自动多页分页（首页完整谱头，续页显示标题与页码）；升降号、高音点、装饰音分层排布（避免窄音符重叠）；和弦仅输出文字，无编辑边框；主旋律全为休止符 `0` 的小节留空，便于手写 +- **MIDI 导出** + - 主旋律按简谱时值与调号导出；装饰音展开为额外 MIDI 音符或延长时值 + - 和弦按拍位起止时间导出柱式和弦（如 `D`、`Bm7`、`G/D`） + - 速度由 BPM 控制（与谱面「速度」文字独立） +- **MIDI 导入（Spike）** + - **文件 → 导入 MIDI... (Spike)**：从 `.mid` 生成可编辑简谱 + - 自动检测调号（含 `1=B` 等）、十六分音符量化、4/4 小节规范化（拆分过长小节、补齐休止符） + - 同一时刻的多个音符合并为同时音槽位，不再丢失和弦音 + - 半音音高映射为 `.5` 表示（如 `1.5` = `#1`，`2.5` = `b3`），画布 / 播放 / MIDI 导出保持一致 +- **谱面播放** + - 工具栏「播放 / 停止」，按 BPM 实时播放主旋律与和弦 + - 可拖动蓝色进度条跳转；演奏逻辑与 MIDI 导出共用调度（含装饰音展开） + +## 环境要求 + +- Windows +- [.NET Framework 4.7.2](https://dotnet.microsoft.com/download/dotnet-framework/net472) 或更高 +- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)（用于单元测试；仓库根目录 `global.json` 指定版本） +- Rider 运行测试需安装 **.NET 8 x86 运行时**（32 位 ReSharper Test Runner 使用 `Program Files (x86)\dotnet`）；升级 TFM 后请 **Build → Rebuild Solution** 并清除旧的 `bin/Debug/net6.0` 缓存 +- 播放功能需要系统可用的 MIDI 合成器（如 Microsoft GS Wavetable Synth） + +## 构建与运行 + +```powershell +dotnet build JianpuEditor.sln -c Debug +dotnet test JianpuEditor.sln -c Debug # 需要 .NET 8 SDK +.\scripts\check-format.ps1 # 代码格式检查（CI 同款） +dotnet format JianpuEditor/JianpuEditor.csproj # 自动修复格式 + +构建时会自动运行 Roslyn 分析器（`Microsoft.CodeAnalysis.NetAnalyzers`，Recommended 规则集），规则见根目录 `Directory.Build.props` 与 `.editorconfig`。 +.\JianpuEditor\bin\Debug\net472\JianpuEditor.exe +``` + +Release 构建： + +```powershell +dotnet build JianpuEditor.sln -c Release +.\JianpuEditor\bin\Release\net472\JianpuEditor.exe +``` + +## 安装包 + +使用 Inno Setup 构建 Windows 安装程序： + +```powershell +.\scripts\build-installer.ps1 +``` + +输出文件：`installer/output/JianpuEditor-Setup-1.2.0.exe` + +## CI/CD + +GitHub Actions 工作流位于 `.github/workflows/`： + +| 工作流 | 触发 | 说明 | +|--------|------|------| +| **CI** | `main` 分支 push / PR | `dotnet format` 检查 + Roslyn 分析器 + Release 构建 + 单元测试 + MIDI 冒烟测试（含 NuGet / .NET 缓存） | +| **Release** | 推送标签 `v*` 或手动运行 | 构建安装包（`.exe` + `.zip`），标签发布时自动创建 GitHub Release | + +### 发布新版本 + +```powershell +git tag v1.2.0 +git push origin v1.2.0 +``` + +也可在 GitHub **Actions → Release → Run workflow** 中手动指定版本号，仅生成安装包 artifact（不创建 Release）。 + +## 基本操作 + +| 操作 | 说明 | +|------|------| +| 点击音符 | 选中并修改时值、八度、附点等 | +| Ctrl / Shift + 点击音符 | 多选音符；跨小节时同步高亮小节范围 | +| 点击音符间隙 | 在该位置插入新音符 | +| 点击谱头字段 | 内联编辑标题、调号、速度、BPM、作曲者 | +| 点击和弦标识 | 选中并内联编辑；工具栏「和弦」框同步 | +| 点击副旋律空白拍位 | 在该拍位添加和弦标识 | +| 点击歌词行 | 行内编辑整行歌词 | +| 批量编辑歌词 | **编辑 → 批量编辑歌词...**；可勾选重新对齐，对齐后逐字显示在音符下 | +| 增时+ / 减时- | 六档时值循环（1/16 至延 3 拍） | +| 升 key / 降 key | 在当前调内升降选中音符音高 | +| 拆分 / 合并 | 拆分或合并选中音符时值 | +| 工具栏「从 / 到」+ 复制小节 | 复制指定范围的小节 | +| 连音线 | 点「连音线」→ 选起始/结束音符；点击弧线选中，Delete 删除 | +| 装饰音 | 选中音符后点工具栏「倚音 / 颤音 / 回音 / 延长」；再次点击同按钮取消 | +| 撤回 / 重做 | **编辑 → 撤回 / 重做** 或 **Ctrl+Z** / **Ctrl+Y** | +| 播放 / 停止 | 按 BPM 播放谱面；拖动蓝色进度条可跳转 | +| 转调 | 菜单「编辑 → 和弦转调...」；仅转调和弦标识 | +| 导出 PDF / MIDI | 菜单「文件」导出 | +| 导入 MIDI | **文件 → 导入 MIDI... (Spike)** | +| 深色模式 | 菜单 **视图 → 深色模式**（设置会保存到本地，PDF 导出仍为浅色纸面） | + +启动后自动加载《欢乐颂》示例曲谱。`sample/` 目录提供更多示例（如《卡农》），可通过 **文件 → 示例曲库** 或工具栏 **曲库** 加载。 + +## 和弦标识 + +每小节最多 4 个标识，每个包含自由文本与拍位（`BeatPosition`，0 为第 1 拍）。 + +编辑界面示例（第 1 小节两个和弦）： + +``` +拍位: 0 2 + C G +``` + +播放与 MIDI 导出时，仅解析合法和弦符号；非和弦文字保留显示但不发声。 + +支持和弦类型：大三、小三、`7`、`maj7`、`m7`、转位（如 `G/D`）等常见写法。 + +### 和弦转调 + +从当前调号（如 `1=C`）转到目标调号（如 `G` 或 `1=G`）时，遍历各小节 `ChordMarkers`，仅对 `ChordParser` 识别为和弦符号的文本做半音转调；自由文字（如「间奏」）保持不变。转调后调号字段更新为 `1=目标音名` 格式。 + +主旋律简谱数字（1–7）不参与转调；若需移调旋律，请手动编辑。 + +## 歌词与对齐 + +每小节歌词有两种表示： + +- **`LyricText`**：整行文本，点击歌词行可直接编辑 +- **`LyricSyllables`**：音节列表，每个音节绑定一个主旋律音符索引 + +**重新对齐**规则： + +- 中文按字、英文按空格分词，依次映射到可对齐的旋律音符 +- 休止符、连音线延续音（tie 终点）不参与对齐 +- 歌词字数与音符数不一致时，对齐尽可能多的音节并在状态中提示超出 / 剩余 + +**批量编辑歌词**对话框支持指定「从第 N 到第 M 小节」，初始范围取自当前选中小节；修改后可选重新对齐，所有变更作为一条操作可撤回。 + +## 曲谱文件格式 + +曲谱保存为 JSON（`.json` / `.jianpu`），主要字段： + +- `Title`、`KeySignature`、`Tempo`、`Bpm`、`Composer` +- `Measures[]`：每小节含 `MelodyNotes`、`Chords`、`ChordMarkers`、`LyricText`、`LyricSyllables`、`Ornaments` +- `Ties[]`：连音线（起始/结束小节与音符索引） + +小节字段说明： + +| 字段 | 说明 | +|------|------| +| `MelodyNotes[]` | 主旋律槽位（每拍一个主音视图）；`Pitch` 为 `1`–`7` 或 `1.5` / `2.5` 等半音（配合 `Accidental`） | +| `Chords[]` | 同时音槽位：`{ "BeatPosition": 0, "Notes": [ ... ], "Text": "" }`；`Notes` 可含多个同时发声的音符 | +| `ChordMarkers[]` | `{ "Text": "C", "BeatPosition": 0 }`（副旋律行和弦符号，与 `Chords` 不同） | +| `LyricText` | 歌词整行文本 | +| `LyricSyllables[]` | 逐音节歌词，`{ "Text": "你", "NoteIndex": 0, "BeatPosition": 0 }`；有数据时画布按音符逐字绘制 | +| `Ornaments[]` | 装饰音，`{ "Type": "Trill", "NoteIndex": 0, "BeatPosition": 0 }`；`Type` 为枚举名（如 `GraceNote`、`Trill`、`Turn`、`Fermata`） | +| `Pitch` / `Accidental` | 自然音 `Pitch: 3`；半音如 `Pitch: 1.5, Accidental: "Sharp"`（显示 `#1`）或 `Pitch: 2.5, Accidental: "Flat"`（显示 `b3`） | + +打开旧谱面时，若仅有 `LyricText` 而无 `LyricSyllables`，仍按整行显示；执行重新对齐或批量编辑并勾选对齐后，会生成音节数据。无 `Ornaments` 或 `Chords` 字段的旧文件可正常打开；加载时 `MelodyChordService` 会将 `MelodyNotes` 自动迁移为 `Chords`。 + +`Tempo` 为谱面显示用语（如「中速」），`Bpm` 为播放与 MIDI 使用的每分钟拍数（默认 120）。 + +## 日志 + +运行日志写入： + +``` +%LocalAppData%\JianpuEditor\logs\jianpu-editor.log +``` + +播放或 MIDI 相关出错时，错误弹窗会提示上述日志路径。 + +## 架构（MVVM） + +本项目采用 **CommunityToolkit.Mvvm** + **Microsoft.Extensions.DependencyInjection**，将 WinForms 界面与编辑逻辑分离： + +| 层次 | 目录 | 职责 | +|------|------|------| +| **View** | `MainForm.cs`、`Views/`、`Controls/` | 菜单、工具栏、对话框；`ILayoutService` / `WinFormsLayoutService` 管理布局与 DPI；瘦 View 层仅处理 WinForms 与文件选择 | +| **Glue** | `Glue/` | `MainFormViewBinder`（控件 ↔ ViewModel 双向绑定）、`ScoreCanvasGlue`（画布刷新与选择同步）、`ScoreSelectionMapper` | +| **ViewModel** | `ViewModels/` | 编辑命令、谱面状态、选择协调；通过 `IAppMessenger` 发布 `ScoreEditedMessage` 等 | +| **Model** | `Models/` | 纯 POCO：`JianpuScore`、小节、音符、和弦标识 | +| **Core** | `Core/Abstractions/`、`Core/Messaging/` | 服务接口（`IScoreFileService`、`IScoreUndoService`、`IPdfExportService` 等）与消息总线 | +| **Services** | `Services/` | 静态业务实现 + DI 适配器；含 `MelodyChordService`（同时音槽位与迁移）、`EditCommandHistory`（撤回 / 重做）、`OrnamentService`、`OrnamentPlaybackService`、`LyricAlignmentService`、`BulkLyricEditService`、`NoteSplitMergeService`、`JianpuPitchService` 等 | +| **Rendering** | `Rendering/` | 布局、绘制、`AppTheme`（浅色/深色主题） | + +**数据流**：用户操作 → `MainForm` 调用 ViewModel 方法 → 返回 `ScoreEditResult` → `ScoreCanvasGlue` 更新画布 → `MainFormViewBinder` 同步控件。 + +**依赖注入**（`AppBootstrapper.cs`）：所有 ViewModel 与 Service 接口注册为 Singleton，`MainForm` 为 Transient。 + +## 项目结构 + +``` +JianpuEditor/ + Program.cs # 启动、DI 容器、主题加载 + AppBootstrapper.cs # 服务与 ViewModel 注册 + MainForm.cs # 主界面（瘦 View 层） + Views/ # ILayoutService、布局上下文 + Glue/ # View ↔ ViewModel 胶水层 + ViewModels/ # MVVM ViewModel（10 个） + Core/ # 接口抽象与消息 + Controls/ScoreCanvas.cs # 画布、选择、播放进度条、和弦内联编辑 + Models/ # 曲谱、小节、音符、连音线、和弦标识 + Rendering/ # 布局、绘制、AppTheme + Services/ # JSON/PDF/MIDI、播放、和弦解析/转调、连音线维护 + installer/ # Inno Setup 安装脚本 + scripts/ # 构建与测试脚本 + sample/ # 示例曲库（.jianpu / .json） +JianpuEditor.Tests/ # xUnit 单元测试（248 个；服务、ViewModel、Glue、绘制） +``` + +## 依赖 + +- [CommunityToolkit.Mvvm](https://www.nuget.org/packages/CommunityToolkit.Mvvm) 8.4.0 +- [Microsoft.Extensions.DependencyInjection](https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection) 8.0.1 +- [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json) 13.0.3 +- [PDFsharp](https://www.nuget.org/packages/PDFsharp) 6.2.0 + +MIDI 导出与谱面播放为自研实现，无第三方 MIDI 库。 + +## 贡献 + +欢迎通过 Issue 与 Pull Request 参与改进。提交代码前请阅读 [贡献者许可协议（CLA）](CLA.md)，并在首个 PR 中确认同意。 + +## 许可证 + 本项目采用 [Apache License 2.0](LICENSE) 开源协议。 \ No newline at end of file