feat(parser): 增强 ABC 解析器以支持分数时值和简写分数解析

- 更新音符和休止符的解析逻辑，支持整数、分数和简写形式的时值表示。
- 新增 parseDurationString 方法，处理不同格式的时值字符串，提升解析的灵活性。
- 更新文档注释，明确支持的时值格式，确保用户理解解析规则。

该变更提升了 ABC 解析器对音符时值的处理能力，确保乐谱信息的准确解析和存储。

Author: Encaik

packages/simple-notation/src/data/parser/abc/parsers/element-parser.ts

@@ -43,13 +43,14 @@ export class AbcElementParser {
    * @example
    * ```typescript
    * // 解析音符
-   * parser.parseElement('C');     // SNParserNote
+   * parser.parseElement('C');     // SNParserNote (默认长度)
    * parser.parseElement('C#');    // SNParserNote (升C)
-   * parser.parseElement('C4');    // SNParserNote (四分音符C)
+   * parser.parseElement('C4');    // SNParserNote (4倍默认长度，如默认为1/4时为全音符)
+   * parser.parseElement('C/2');   // SNParserNote (1/2倍默认长度，如默认为1/4时为八分音符)
    *
    * // 解析休止符
-   * parser.parseElement('z');     // SNParserRest
-   * parser.parseElement('z4');    // SNParserRest (四分休止符)
+   * parser.parseElement('z');     // SNParserRest (默认长度)
+   * parser.parseElement('z4');    // SNParserRest (4倍默认长度)
    *
    * // 解析连音线
    * parser.parseElement('-');     // SNParserTie
@@ -99,8 +100,9 @@ export class AbcElementParser {
     }
 
     // 4. 解析音符（带装饰符）
+    // 支持整数（C4）、分数（C/2, C3/2）和简写（C/）三种时值表示
     const noteMatch = noteStr.match(
-      /^(\^+\/?|_+\/?|=?)([A-Ga-g])([,']*)(\d*)(\.*)$/,
+      /^(\^+\/?|_+\/?|=?)([A-Ga-g])([,']*)(\d+\/\d+|\/\d*|\d*)(\.*)$/,
     );
     if (noteMatch) {
       const note = this.parseNote(
@@ -159,12 +161,14 @@ export class AbcElementParser {
 
     if (timeUnit) {
       const restStr = trimmed.slice(1);
-      const durationStr = restStr.match(/^(\d+)/)?.[1];
+      // 支持整数（z4）、分数（z/2, z3/2）和简写（z/）三种时值表示
+      const durationStr = restStr.match(/^(\d+\/\d+|\/\d*|\d+)/)?.[1];
       const dotCount = (restStr.match(/\./g) || []).length;
 
-      const noteValue = durationStr
-        ? 1 / parseInt(durationStr, 10)
-        : defaultNoteLength || 1 / 4;
+      const noteValue = this.parseDurationString(
+        durationStr,
+        defaultNoteLength,
+      );
 
       const dottedNoteValue = this.calculateDottedNoteValue(
         noteValue,
@@ -206,9 +210,10 @@ export class AbcElementParser {
     // 解析时值
     let duration: number;
     if (timeUnit) {
-      const noteValue = durationStr
-        ? 1 / parseInt(durationStr, 10)
-        : defaultNoteLength || 1 / 4;
+      const noteValue = this.parseDurationString(
+        durationStr,
+        defaultNoteLength,
+      );
 
       const dotCount = (trimmed.match(/\./g) || []).length;
       const dottedNoteValue = this.calculateDottedNoteValue(
@@ -257,6 +262,54 @@ export class AbcElementParser {
     }
   }
 
+  /**
+   * 解析时值字符串
+   *
+   * 支持三种格式：
+   * - 整数：4 表示 4倍默认长度（如 C4 表示全音符）
+   * - 分数：3/2 表示 3/2倍默认长度
+   * - 简写分数：/ 或 /2 表示 1/2倍默认长度
+   *
+   * @param durationStr - 时值字符串（如 "4", "/2", "3/2", "/"）
+   * @param defaultNoteLength - 默认音符长度
+   * @returns 音符时值（相对于全音符的比例）
+   */
+  private parseDurationString(
+    durationStr: string | undefined,
+    defaultNoteLength?: number,
+  ): number {
+    const defaultLength = defaultNoteLength || 1 / 4;
+
+    if (!durationStr) {
+      return defaultLength;
+    }
+
+    // 处理分数形式：3/2, /2, /
+    if (durationStr.includes('/')) {
+      if (durationStr === '/') {
+        // / 简写表示 1/2
+        return defaultLength * 0.5;
+      }
+
+      const parts = durationStr.split('/');
+      if (parts[0] === '') {
+        // /2 形式：表示默认长度的 1/2
+        // 例如：L:1/4 时，/2 = (1/4) × (1/2) = 1/8（八分音符）
+        const denominator = parseInt(parts[1], 10);
+        return defaultLength / denominator;
+      } else {
+        // 3/2 形式表示 3/2
+        const numerator = parseInt(parts[0], 10);
+        const denominator = parseInt(parts[1], 10);
+        return defaultLength * (numerator / denominator);
+      }
+    }
+
+    // 处理整数形式：4 表示 4倍默认长度
+    const multiplier = parseInt(durationStr, 10);
+    return defaultLength * multiplier;
+  }
+
   /**
    * 计算带附点的音符时值
    *

packages/simple-notation/src/data/parser/abc/utils/tokenizer.ts

@@ -262,10 +262,11 @@ export class AbcTokenizer {
     const len = measureData.length;
     let noteEnd = startPos;
 
-    // 音符后可跟：变音符号(^_=)、变音记号(#b)、八度符号(',")、时值(数字)、附点(.)
+    // 音符后可跟：变音符号(^_=)、变音记号(#b)、八度符号(',")、时值(数字/分数)、附点(.)
+    // 注意：必须包含 / 字符以支持分数时值（如 C/2, C3/2）
     while (
       noteEnd + 1 < len &&
-      /[\^_=#b',.\d]/.test(measureData[noteEnd + 1])
+      /[\^_=#b',./\d]/.test(measureData[noteEnd + 1])
     ) {
       noteEnd++;
     }