[R] Chart相关重构（最后一步）——三种Chart合并为统一的ChuChart！

实际上，经过前几步之后，各种Chart的内容（无论是字段还是类型）都实现了完全统一了。所以这里只需要修改类名就可以了。

Author: Starrah

Program.cs

@@ -474,7 +474,7 @@ private static void RunConvertChuSingleFile(string filePath, string inputKind)
         var destNote = _outputSpec.Kind == OutputSinkKind.Stdout ? "（标准输出）" : outPath;
         Console.Error.WriteLine($"{inputKind.ToUpperInvariant()} → {targetFormat.ToUpperInvariant()}: {full} → {destNote}");
 
-        IChuChart chart;
+        ChuChart chart;
         List<Alert> parseAlerts;
         switch (inputKind)
         {

README.md

@@ -215,13 +215,7 @@ finally
 - **parser（解析器）**：把“源格式文本”解析成中间表示
   - `SimaiParser.Parse(string)` → `MaiChart`
   - `MA2Parser.Parse(string)` → `MaiChart`
-  - CHUNITHM的三种Parser(`C2sParser`、`UgcParser`、`SusParser`)：`Parse(string)` → `IChuChart`
-    > <details>
-    > <summary>关于IChuChart</summary>
-    > 当前实现IChuChart是一个通用的接口而非具体的类型，这是因为目前不同Parser解析出的谱面的IR尚未能够完全统一，所以只能都各自继承自IChuChart。  
-    > 不过不用担心，任意的Generator都接受任意IChuChart对象，因此你可以不在意它们之间的差异，直接拿来用就行了。  
-    > 未来如果有机会的话，我们会把它们进一步统一成同一个具体类型的IR，以进一步提升代码的可维护性和可读性。
-    > </details>
+  - CHUNITHM的三种Parser(`C2sParser`、`UgcParser`、`SusParser`)：`Parse(string)` → `ChuChart`
   - 解析成功时，**返回值会同时带有 `List<Alert>`**，这是转谱过程中可能遇到的警告等信息，建议打印出来（直接对`Alert`对象`ToString()`即可）。
   - 如果解析失败，会抛出 `ConversionException`；该异常对象中同样含有一个 `List<Alert>`，是导致转谱失败的错误信息，可以同上打印出来。
 
@@ -232,7 +226,7 @@ finally
 - **generator（生成器）**：把中间表示转回“目标格式文本”
   - `SimaiGenerator.Generate(MaiChart)` → Simai 单谱文本（可写入 `maidata.txt` 的 `&inote_*`）
   - `MA2Generator.Generate(MaiChart)` → MA2 文本
-  - CHUNITHM的三种Generator(`C2sGenerator`、`UgcGenerator`、`SusGenerator`)：`Generate(IChuChart)` → 目标格式的谱面文本
+  - CHUNITHM的三种Generator(`C2sGenerator`、`UgcGenerator`、`SusGenerator`)：`Generate(ChuChart)` → 目标格式的谱面文本
   - 与parser类似，成功生成时，**返回值会同时带有 `List<Alert>`**，这是转谱过程中可能遇到的警告等信息，建议打印出来（直接对`Alert`对象`ToString()`即可）。
   - 如果生成失败，会抛出 `ConversionException`；该异常对象中同样含有一个 `List<Alert>`，是导致转谱失败的错误信息，可以同上打印出来。
 

chart/chu/C2sChart.cs chart/chu/ChuChart.cschart/chu/C2sChart.cs renamed to chart/chu/ChuChart.cs

@@ -3,10 +3,7 @@
 
 namespace MuConvert.chu;
 
-/**
- * C2S 格式谱面 IR（官方格式，RESOLUTION=384 tick/小节）。
- */
-public class C2sChart : BaseChart<ChuNote>, IChuChart
+public class ChuChart : BaseChart<ChuNote>
 {
     public string Title { get; set; } = "";
     public string Artist { get; set; } = "";

chart/chu/IChuChart.cs

@@ -1,61 +1,21 @@
-using System.Globalization;
 using System.Text;
-using MuConvert.chart;
 using MuConvert.generator;
 using MuConvert.utils;
-using static MuConvert.utils.Alert.LEVEL;
 
 namespace MuConvert.chu;
 
-/**
- * C2S 格式生成器。
- * 输入 IChuChart，内部自动转换后输出 C2S 文本。
- */
-public class C2sGenerator : IGenerator<IChuChart>
+public class C2sGenerator : IGenerator<ChuChart>
 {
     private const int RSL = 384;
 
-    public (string, List<Alert>) Generate(IChuChart chart)
+    public (string, List<Alert>) Generate(ChuChart chart)
     {
         var alerts = new List<Alert>();
-        var c2s = ConvertToC2s(chart, alerts);
-        var text = Serialize(c2s);
+        var text = Serialize(chart);
         return (text, alerts);
     }
 
-    private static C2sChart ConvertToC2s(IChuChart chart, List<Alert> alerts)
-    {
-        if (chart is C2sChart c2s) return c2s;
-
-        if (chart is UgcChart ugc)
-        {
-            var result = new C2sChart
-            {
-                Designer = ugc.Designer,
-            };
-            result.BpmList.AddRange(ugc.BpmList);
-            result.MetList.AddRange(ugc.MetList);
-            result.SflList.AddRange(ugc.SflList);
-            result.Notes = ugc.Notes;
-            return result;
-        }
-
-        if (chart is SusChart sus)
-        {
-            var result = new C2sChart();
-            if (sus.BpmList.Count > 0)
-                result.BpmList.AddRange(sus.BpmList);
-            else
-                result.BpmList.Add(new BPM(0, 120m));
-            result.Notes = sus.Notes;
-            return result;
-        }
-
-        alerts.Add(new Alert(Error, string.Format(Locale.ChuGeneratorUnsupported, "→ C2S")));
-        throw new ConversionException(alerts);
-    }
-
-    private static string Serialize(C2sChart chart)
+    private static string Serialize(ChuChart chart)
     {
         chart.Sort();
 

chart/chu/SusChart.cs

@@ -1,57 +1,21 @@
 using System.Text;
-using MuConvert.chart;
 using MuConvert.generator;
 using MuConvert.utils;
-using static MuConvert.utils.Alert.LEVEL;
 
 namespace MuConvert.chu;
 
-/**
- * SUS 格式生成器。
- * 输入 IChuChart，内部自动转换后输出 SUS 文本。
- */
-public class SusGenerator : IGenerator<IChuChart>
+public class SusGenerator : IGenerator<ChuChart>
 {
     private static int RSL = 480 * 4;
 
-    public (string, List<Alert>) Generate(IChuChart chart)
+    public (string, List<Alert>) Generate(ChuChart chart)
     {
         var alerts = new List<Alert>();
-        var sus = ConvertToSus(chart, alerts);
-        var text = Serialize(sus);
+        var text = Serialize(chart);
         return (text, alerts);
     }
 
-    private static SusChart ConvertToSus(IChuChart chart, List<Alert> alerts)
-    {
-        if (chart is SusChart sus) return sus;
-
-        double bpm = 120.0;
-        string title = "", artist = "";
-
-        if (chart is C2sChart c2s)
-        {
-            bpm = c2s.BpmList.Count > 0 ? (double)c2s.BpmList[0].Bpm : 120.0;
-            var result = new SusChart { Title = title, Artist = artist };
-            result.BpmList.Add(new BPM(0, (decimal)bpm));
-            result.Notes = c2s.Notes;
-            return result;
-        }
-
-        if (chart is UgcChart ugc)
-        {
-            bpm = ugc.BpmList.Count > 0 ? (double)ugc.BpmList[0].Bpm : 120.0;
-            var result = new SusChart { Title = ugc.Title, Artist = ugc.Artist };
-            result.BpmList.Add(new BPM(0, (decimal)bpm));
-            result.Notes = ugc.Notes;
-            return result;
-        }
-
-        alerts.Add(new Alert(Error, string.Format(Locale.ChuGeneratorUnsupported, "→ SUS")));
-        throw new ConversionException(alerts);
-    }
-
-    private static string Serialize(SusChart sus)
+    private static string Serialize(ChuChart sus)
     {
         sus.Sort();
 

chart/chu/UgcChart.cs

@@ -1,50 +1,21 @@
 using System.Text;
 using MuConvert.generator;
 using MuConvert.utils;
-using static MuConvert.utils.Alert.LEVEL;
 
 namespace MuConvert.chu;
 
-/**
- * UGC 格式生成器。
- * 输入 IChuChart，内部自动转换后输出 UGC 文本。
- */
-public class UgcGenerator : IGenerator<IChuChart>
+public class UgcGenerator : IGenerator<ChuChart>
 {
     private static int RSL = 480 * 4;
 
-    public (string, List<Alert>) Generate(IChuChart chart)
+    public (string, List<Alert>) Generate(ChuChart chart)
     {
         var alerts = new List<Alert>();
-        var ugc = ConvertToUgc(chart, alerts);
-        var text = Serialize(ugc);
+        var text = Serialize(chart);
         return (text, alerts);
     }
 
-    private static UgcChart ConvertToUgc(IChuChart chart, List<Alert> alerts)
-    {
-        if (chart is UgcChart ugc) return ugc;
-
-        if (chart is C2sChart c2s)
-        {
-            var result = new UgcChart
-            {
-                Designer = c2s.Designer,
-                Difficulty = c2s.Difficulty,
-                MusicId = c2s.MusicId,
-            };
-            result.BpmList.AddRange(c2s.BpmList);
-            result.MetList.AddRange(c2s.MetList);
-            result.SflList.AddRange(c2s.SflList);
-            result.Notes = c2s.Notes;
-            return result;
-        }
-
-        alerts.Add(new Alert(Error, string.Format(Locale.ChuGeneratorUnsupported, "→ UGC")));
-        throw new ConversionException(alerts);
-    }
-
-    private static string Serialize(UgcChart ugc)
+    private static string Serialize(ChuChart ugc)
     {
         ugc.Sort();
 

generator/chu/C2sGenerator.cs

@@ -11,17 +11,17 @@ namespace MuConvert.chu;
  * C2S 格式解析器（官方格式，RESOLUTION=384 tick/小节）。
  * Tab 分隔文本，识别 HEADER / TIMING / NOTES 区段。
  */
-public class C2sParser : IParser<C2sChart>
+public class C2sParser : IParser<ChuChart>
 {
     private static int RSL = 384;
     private static readonly HashSet<string> HeadTags = new(StringComparer.OrdinalIgnoreCase)
         { "VERSION", "MUSIC", "SEQUENCEID", "DIFFICULT", "LEVEL", "CREATOR", "BPM_DEF", "MET_DEF", "RESOLUTION", "CLK_DEF", "PROGJUDGE_BPM", "PROGJUDGE_AER", "TUTORIAL" };
     private static readonly HashSet<string> TimingTags = new(StringComparer.OrdinalIgnoreCase)
         { "BPM", "MET", "SFL" };
 
-    public (C2sChart, List<Alert>) Parse(string text)
+    public (ChuChart, List<Alert>) Parse(string text)
     {
-        var chart = new C2sChart();
+        var chart = new ChuChart();
         var alerts = new List<Alert>();
         var lines = text.Replace("\r\n", "\n").Split('\n');
         bool inNotes = false;
@@ -54,7 +54,7 @@ public class C2sParser : IParser<C2sChart>
         return (chart, alerts);
     }
 
-    private static void ParseHeader(string[] p, C2sChart chart)
+    private static void ParseHeader(string[] p, ChuChart chart)
     {
         var tag = p[0].ToUpperInvariant();
         switch (tag)
@@ -66,7 +66,7 @@ private static void ParseHeader(string[] p, C2sChart chart)
         }
     }
 
-    private static void ParseTiming(string[] p, C2sChart chart)
+    private static void ParseTiming(string[] p, ChuChart chart)
     {
         var tag = p[0].ToUpperInvariant();
         switch (tag)
@@ -86,7 +86,7 @@ private static void ParseTiming(string[] p, C2sChart chart)
         }
     }
 
-    private static void ParseNote(string[] p, C2sChart chart, List<Alert> alerts, int lineNum)
+    private static void ParseNote(string[] p, ChuChart chart, List<Alert> alerts, int lineNum)
     {
         var tag = p[0].ToUpperInvariant();
         var note = new ChuNote { Type = tag, Time = Int(p, 1) + new Rational(Int(p, 2), RSL) };