feat(parser): 增强音符解析以支持升降号和装饰符的处理

Encaik · Encaik · commit d9353ba33fa2 · 2025-11-15T10:00:07.000+08:00
- 更新 SNPitch 接口，允许 accidental 属性为可选，支持未标记的音符。
- 修改音符解析逻辑，合并升降号与音符，确保解析时的准确性。
- 增强装饰符提取逻辑，确保升降号不被误识别为装饰符。
- 在渲染过程中添加升降号的绘制逻辑，确保视觉表现的准确性。

该变更提升了音符解析的灵活性和准确性，确保乐谱信息的完整性和可视化效果。
diff --git a/packages/simple-notation/src/core/model/music.ts b/packages/simple-notation/src/core/model/music.ts
@@ -32,8 +32,8 @@ export interface SNPitch {
   letter: string;
   /** 八度（例如：4 表示中央 C） */
   octave: number;
-  /** 变音记号 */
-  accidental: SNAccidental;
+  /** 变音记号（undefined 表示没有升降号标记，NATURAL 表示明确写了还原号 =） */
+  accidental?: SNAccidental;
 }
 
 /**
diff --git a/packages/simple-notation/src/core/utils/key-signature.ts b/packages/simple-notation/src/core/utils/key-signature.ts
@@ -0,0 +1,165 @@
+import type { SNKeySignature } from '@core/model/music';
+import { SNAccidental } from '@core/model/music';
+
+/**
+ * 调号到音符升降号的映射工具
+ *
+ * 根据调号计算每个音名字母应该的升降号
+ */
+
+/**
+ * 大调调号的升降号序列
+ * 升号调：F C G D A E B（顺序）
+ * 降号调：B E A D G C F（顺序，与升号相反）
+ */
+const SHARP_ORDER = ['F', 'C', 'G', 'D', 'A', 'E', 'B'];
+const FLAT_ORDER = ['B', 'E', 'A', 'D', 'G', 'C', 'F'];
+
+/**
+ * 根据调号主音计算调号类型和升降号数量
+ *
+ * @param keySignature - 调号对象
+ * @returns 调号类型和升降号数量
+ */
+function calculateKeySignatureInfo(keySignature: SNKeySignature): {
+  type: 'sharp' | 'flat' | 'natural';
+  count: number;
+} {
+  const { letter, symbol } = keySignature;
+
+  // 如果 symbol 明确指定了 sharp 或 flat，直接使用
+  if (symbol === 'sharp') {
+    // 升号调：根据 letter 计算升号数量
+    const sharpKeys: Record<string, number> = {
+      G: 1,
+      D: 2,
+      A: 3,
+      E: 4,
+      B: 5,
+      'F#': 6,
+      'C#': 7,
+    };
+    const count = sharpKeys[letter] || 0;
+    return { type: 'sharp', count };
+  }
+
+  if (symbol === 'flat') {
+    // 降号调：根据 letter 计算降号数量
+    const flatKeys: Record<string, number> = {
+      F: 1,
+      Bb: 2,
+      Eb: 3,
+      Ab: 4,
+      Db: 5,
+      Gb: 6,
+      Cb: 7,
+    };
+    const count = flatKeys[letter] || 0;
+    return { type: 'flat', count };
+  }
+
+  // symbol === 'natural' 的情况，需要根据 letter 判断调号类型
+  // C大调或A小调（无升降号）
+  if (letter === 'C' || letter === 'A') {
+    return { type: 'natural', count: 0 };
+  }
+
+  // 根据 letter 判断是大调还是小调，然后确定调号类型
+  // 大调升号调：G, D, A, E, B, F#, C#
+  // 大调降号调：F, Bb, Eb, Ab, Db, Gb, Cb
+  // 小调升号调：E, B, F#, C#, G#, D#, A#（关系小调）
+  // 小调降号调：D, G, C, F, Bb, Eb, Ab（关系小调）
+
+  const majorSharpKeys: Record<string, number> = {
+    G: 1,
+    D: 2,
+    A: 3,
+    E: 4,
+    B: 5,
+    'F#': 6,
+    'C#': 7,
+  };
+
+  const majorFlatKeys: Record<string, number> = {
+    F: 1,
+    Bb: 2,
+    Eb: 3,
+    Ab: 4,
+    Db: 5,
+    Gb: 6,
+    Cb: 7,
+  };
+
+  // 优先检查大调
+  if (majorSharpKeys[letter]) {
+    return { type: 'sharp', count: majorSharpKeys[letter] };
+  }
+  if (majorFlatKeys[letter]) {
+    return { type: 'flat', count: majorFlatKeys[letter] };
+  }
+
+  // 小调（关系小调）
+  const minorSharpKeys: Record<string, number> = {
+    E: 1, // E小调（G大调的关系小调）
+    B: 2, // B小调（D大调的关系小调）
+    'F#': 3, // F#小调（A大调的关系小调）
+    'C#': 4, // C#小调（E大调的关系小调）
+    'G#': 5, // G#小调（B大调的关系小调）
+    'D#': 6, // D#小调（F#大调的关系小调）
+    'A#': 7, // A#小调（C#大调的关系小调）
+  };
+
+  const minorFlatKeys: Record<string, number> = {
+    D: 1, // D小调（F大调的关系小调）
+    G: 2, // G小调（Bb大调的关系小调）
+    C: 3, // C小调（Eb大调的关系小调）
+    F: 4, // F小调（Ab大调的关系小调）
+    Bb: 5, // Bb小调（Db大调的关系小调）
+    Eb: 6, // Eb小调（Gb大调的关系小调）
+    Ab: 7, // Ab小调（Cb大调的关系小调）
+  };
+
+  if (minorSharpKeys[letter]) {
+    return { type: 'sharp', count: minorSharpKeys[letter] };
+  }
+  if (minorFlatKeys[letter]) {
+    return { type: 'flat', count: minorFlatKeys[letter] };
+  }
+
+  // 默认无升降号
+  return { type: 'natural', count: 0 };
+}
+
+/**
+ * 根据调号获取指定音名字母的升降号
+ *
+ * @param keySignature - 调号对象
+ * @param noteLetter - 音名字母（A-G）
+ * @returns 该音在调号中应该的升降号
+ */
+export function getAccidentalFromKeySignature(
+  keySignature: SNKeySignature,
+  noteLetter: string,
+): SNAccidental {
+  const { type, count } = calculateKeySignatureInfo(keySignature);
+
+  if (type === 'natural' || count === 0) {
+    return SNAccidental.NATURAL;
+  }
+
+  if (type === 'sharp') {
+    // 升号调：取前count个音
+    const sharpNotes = SHARP_ORDER.slice(0, count);
+    if (sharpNotes.includes(noteLetter)) {
+      return SNAccidental.SHARP;
+    }
+  } else if (type === 'flat') {
+    // 降号调：取前count个音
+    const flatNotes = FLAT_ORDER.slice(0, count);
+    if (flatNotes.includes(noteLetter)) {
+      return SNAccidental.FLAT;
+    }
+  }
+
+  return SNAccidental.NATURAL;
+}
diff --git a/packages/simple-notation/src/data/parser/abc/parsers/element-parser.ts b/packages/simple-notation/src/data/parser/abc/parsers/element-parser.ts
@@ -127,13 +127,22 @@ function parseElementInternal(
 
   // 4. 解析音符（带装饰符）
   // 支持整数（C4）、分数（C/2, C3/2）和简写（C/）三种时值表示
+  // 升降号格式：^ (升号), ^^ (重升号), _ (降号), __ (重降号), = (还原号)
   const noteMatch = noteStr.match(
-    /^(\^+\/?|_+\/?|=?)([A-Ga-g])([,']*)(\d+\/\d+|\/\d*|\d*)(\.*)$/,
+    /^(\^+|_+|=?)([A-Ga-g])([,']*)(\d+\/\d+|\/\d*|\d*)(\.*)$/,
   );
   if (noteMatch) {
+    // 构建完整的 originStr，包含装饰符（如果有）和音符
+    // 装饰符在音符前面，所以格式是：装饰符 + 音符
+    const fullOriginStr =
+      decorations.length > 0
+        ? decorations.map((d) => d.text).join('') + noteStr
+        : noteStr;
+
     const note = parseNote(
       noteMatch,
       noteStr,
+      fullOriginStr, // 传入完整的 originStr（包含装饰符和音符）
       timeUnit,
       defaultNoteLength,
       getNextId,
@@ -212,10 +221,18 @@ function parseRest(
 
 /**
  * 解析音符
+ *
+ * @param match - 正则匹配结果
+ * @param noteStr - 音符字符串（用于解析，不包含装饰符）
+ * @param originStr - 完整的原始字符串（包含装饰符和音符，用于 originStr）
+ * @param timeUnit - 时间单位
+ * @param defaultNoteLength - 默认音符长度
+ * @param getNextId - ID 生成器
  */
 function parseNote(
   match: RegExpMatchArray,
-  trimmed: string,
+  noteStr: string,
+  originStr: string,
   timeUnit: SNTimeUnit | undefined,
   defaultNoteLength: number | undefined,
   getNextId: (prefix: string) => string,
@@ -238,18 +255,18 @@ function parseNote(
   if (timeUnit) {
     const noteValue = parseDurationString(durationStr, defaultNoteLength);
 
-    dotCount = (trimmed.match(/\./g) || []).length;
+    dotCount = (noteStr.match(/\./g) || []).length;
     const dottedNoteValue = calculateDottedNoteValue(noteValue, dotCount);
     duration = noteValueToDuration(dottedNoteValue, timeUnit);
   } else {
     duration = durationStr ? parseInt(durationStr, 10) : 1;
-    // 即使没有 timeUnit，也尝试从 originStr 中提取附点数量
-    dotCount = (trimmed.match(/\./g) || []).length;
+    // 即使没有 timeUnit，也尝试从 noteStr 中提取附点数量
+    dotCount = (noteStr.match(/\./g) || []).length;
   }
 
   return new SNParserNote({
     id: getNextId('note'),
-    originStr: trimmed,
+    originStr, // 使用完整的 originStr（包含装饰符和音符）
     pitch: {
       letter: letter.toUpperCase(),
       octave,
@@ -264,10 +281,11 @@ function parseNote(
  * 解析变音记号
  *
  * @param accidentalStr - 变音记号字符串
- * @returns 变音记号枚举值
+ * @returns 变音记号枚举值（undefined 表示没有升降号标记，NATURAL 表示明确写了还原号 =）
  */
-function parseAccidental(accidentalStr: string): SNAccidental {
-  if (!accidentalStr) return SNAccidental.NATURAL;
+function parseAccidental(accidentalStr: string): SNAccidental | undefined {
+  // 如果没有升降号标记，返回 undefined
+  if (!accidentalStr) return undefined;
 
   switch (accidentalStr) {
     case '^':
@@ -279,9 +297,11 @@ function parseAccidental(accidentalStr: string): SNAccidental {
     case '__':
       return SNAccidental.DOUBLE_FLAT;
     case '=':
+      // 明确写了还原号，返回 NATURAL
       return SNAccidental.NATURAL;
     default:
-      return SNAccidental.NATURAL;
+      // 未知格式，返回 undefined（不显示升降号）
+      return undefined;
   }
 }
 
diff --git a/packages/simple-notation/src/data/parser/abc/utils/decoration-parser.ts b/packages/simple-notation/src/data/parser/abc/utils/decoration-parser.ts
@@ -57,6 +57,14 @@ export class DecorationParser {
       }
 
       // 2. 尝试提取符号形式装饰符
+      // 注意：升降号符号（^, _, =）不应该被识别为装饰符
+      // 它们应该在音符解析时处理
+      const firstChar = remaining[0];
+      if (firstChar === '^' || firstChar === '_' || firstChar === '=') {
+        // 遇到升降号符号，停止提取装饰符
+        break;
+      }
+
       const symbolResult = this.extractSymbolDecoration(remaining);
       if (symbolResult) {
         decorations.push(symbolResult.decoration);
diff --git a/packages/simple-notation/src/data/parser/abc/utils/tokenizer.ts b/packages/simple-notation/src/data/parser/abc/utils/tokenizer.ts
@@ -86,17 +86,52 @@ export class AbcTokenizer {
         continue;
       }
 
-      // 2. 捕获普通音符/休止符（A-G/z开头，含变音、八度等）
+      // 2. 捕获升降号符号（^, _, =），它们应该和后面的音符一起提取
+      if (
+        measureData[pos] === '^' ||
+        measureData[pos] === '_' ||
+        measureData[pos] === '='
+      ) {
+        // 查找后面的音符字母
+        let notePos = pos + 1;
+        // 跳过连续的升降号符号（如 ^^, __）
+        while (
+          notePos < len &&
+          (measureData[notePos] === '^' ||
+            measureData[notePos] === '_' ||
+            measureData[notePos] === '=')
+        ) {
+          notePos++;
+        }
+        // 如果后面是音符字母，一起提取
+        if (notePos < len && noteRegex.test(measureData[notePos])) {
+          const note = this.extractNote(measureData, notePos);
+          // 将升降号符号和音符合并
+          const accidentalPart = measureData.slice(pos, notePos);
+          tokens.push(accidentalPart + note.token);
+          pos = note.endPos;
+          continue;
+        }
+        // 如果后面不是音符字母，将升降号符号作为独立 token（这种情况不应该发生，但为了安全）
+        tokens.push(measureData[pos]);
+        pos++;
+        continue;
+      }
+
+      // 3. 捕获普通音符/休止符（A-G/z开头，含变音、八度等）
       if (noteRegex.test(measureData[pos])) {
         const note = this.extractNote(measureData, pos);
         tokens.push(note.token);
         pos = note.endPos;
         continue;
       }
 
-      // 3. 捕获其他符号（小节线等）
+      // 4. 捕获其他符号（小节线等）
       let tokenEnd = pos;
-      while (tokenEnd < len && !/\s|[A-Ga-gz([]/.test(measureData[tokenEnd])) {
+      while (
+        tokenEnd < len &&
+        !/\s|[A-Ga-gz([^_=]/.test(measureData[tokenEnd])
+      ) {
         tokenEnd++;
       }
 
diff --git a/packages/simple-notation/src/render/renderer/svg/node/element.ts b/packages/simple-notation/src/render/renderer/svg/node/element.ts
diff --git a/packages/web/src/pages/Home.vue b/packages/web/src/pages/Home.vue
